Contract Source Code (Solidity)

IDE

• Blockscan IDE
• 🤖 Code ReaderBeta

Outline

• interface IERC20
•    - function totalSupply()
•    - function balanceOf(address account)
•    - function transfer(address recipient, ...
•    - function allowance(address owner, add ...
•    - function approve(address spender, uin ...
•    - function transferFrom(
• library Address
•    - function isContract(address account)
•    - function sendValue(address payable re ...
•    - function functionCall(address target, ...
•    - function functionCall(
•    - function functionCallWithValue(
•    - function functionCallWithValue(
•    - function functionStaticCall(address t ...
•    - function functionStaticCall(
•    - function functionDelegateCall(address ...
•    - function functionDelegateCall(
•    - function verifyCallResult(
• library SafeERC20
•    - function safeTransfer(
•    - function safeTransferFrom(
•    - function safeApprove(
•    - function safeIncreaseAllowance(
•    - function safeDecreaseAllowance(
•    - function _callOptionalReturn(IERC20 t ...
• interface IERC20Permit
•    - function permit(
•    - function nonces(address owner)
•    - function DOMAIN_SEPARATOR()
• interface IERC20Metadata is IERC20
•    - function name()
•    - function symbol()
•    - function decimals()
•    - function _msgSender()
•    - function _msgData()
•  contract ERC20 is Context, IERC20, ...
•    - function name()
•    - function symbol()
•    - function decimals()
•    - function totalSupply()
•    - function balanceOf(address account)
•    - function transfer(address recipient, ...
•    - function allowance(address owner, add ...
•    - function approve(address spender, uin ...
•    - function transferFrom(
•    - function increaseAllowance(address sp ...
•    - function decreaseAllowance(address sp ...
•    - function _transfer(
•    - function _mint(address account, uint2 ...
•    - function _burn(address account, uint2 ...
•    - function _approve(
•    - function _beforeTokenTransfer(
•    - function _afterTokenTransfer(
• library ECDSA
•    - function _throwError(RecoverError err ...
•    - function tryRecover(bytes32 hash, byt ...
•    - function recover(bytes32 hash, bytes ...
•    - function tryRecover(
•    - function recover(
•    - function tryRecover(
•    - function recover(
•    - function toEthSignedMessageHash(bytes ...
•    - function toTypedDataHash(bytes32 doma ...
•    - function _domainSeparatorV4()
•    - function _buildDomainSeparator(
•    - function _hashTypedDataV4(bytes32 str ...
• library Counters
•    - function current(Counter storage coun ...
•    - function increment(Counter storage co ...
•    - function decrement(Counter storage co ...
•    - function reset(Counter storage counte ...
•    - function permit(
•    - function nonces(address owner)
•    - function DOMAIN_SEPARATOR()
•    - function _useNonce(address owner)
• interface IGovernable
•    - function governance()
•    - function pendingGovernance()
•    - function governanceIsLocked()
•    - function setPendingGovernance(address ...
•    - function acceptGovernance()
•    - function lockGovernance()
•  contract Governable is IGovernable
•    - function governance()
•    - function pendingGovernance()
•    - function governanceIsLocked()
•    - function setPendingGovernance(address ...
•    - function acceptGovernance()
•    - function lockGovernance()
• interface ISOLACE is IERC20Metadata
•    - function isMinter(address account)
•    - function mint(address account, uint25 ...
•    - function burn(uint256 amount)
•    - function addMinter(address minter)
•    - function removeMinter(address minter)
•  contract SOLACE is ISOLACE, ERC20P ... *
•    - function isMinter(address account)
•    - function mint(address account, uint25 ...
•    - function burn(uint256 amount)
•    - function addMinter(address minter)
•    - function removeMinter(address minter)

More Options

• Similar
• Submit Audit
• Compare

/**
 *Submitted for verification at polygonscan.com on 2022-02-04
*/

// SPDX-License-Identifier: GPL-3.0-or-later

// Sources flattened with hardhat v2.6.2 https://hardhat.org

// File @openzeppelin/contracts/token/ERC20/[email protected]



pragma solidity 0.8.6;

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


// File @openzeppelin/contracts/utils/[email protected]



pragma solidity 0.8.6;

/**
 * @dev Collection of functions related to the address type
 */
library Address {
    /**
     * @dev Returns true if `account` is a contract.
     *
     * [IMPORTANT]
     * ====
     * It is unsafe to assume that an address for which this function returns
     * false is an externally-owned account (EOA) and not a contract.
     *
     * Among others, `isContract` will return false for the following
     * types of addresses:
     *
     *  - an externally-owned account
     *  - a contract in construction
     *  - an address where a contract will be created
     *  - an address where a contract lived, but was destroyed
     * ====
     */
    function isContract(address account) internal view returns (bool) {
        // This method relies on extcodesize, which returns 0 for contracts in
        // construction, since the code is only stored at the end of the
        // constructor execution.

        uint256 size;
        assembly {
            size := extcodesize(account)
        }
        return size > 0;
    }

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

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

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

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

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

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

        (bool success, bytes memory returndata) = target.call{value: value}(data);
        return verifyCallResult(success, returndata, errorMessage);
    }

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

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
     * but performing a static call.
     *
     * _Available since v3.3._
     */
    function functionStaticCall(
        address target,
        bytes memory data,
        string memory errorMessage
    ) internal view returns (bytes memory) {
        require(isContract(target), "Address: static call to non-contract");

        (bool success, bytes memory returndata) = target.staticcall(data);
        return verifyCallResult(success, returndata, errorMessage);
    }

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

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
     * but performing a delegate call.
     *
     * _Available since v3.4._
     */
    function functionDelegateCall(
        address target,
        bytes memory data,
        string memory errorMessage
    ) internal returns (bytes memory) {
        require(isContract(target), "Address: delegate call to non-contract");

        (bool success, bytes memory returndata) = target.delegatecall(data);
        return verifyCallResult(success, returndata, errorMessage);
    }

    /**
     * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the
     * revert reason using the provided one.
     *
     * _Available since v4.3._
     */
    function verifyCallResult(
        bool success,
        bytes memory returndata,
        string memory errorMessage
    ) internal pure returns (bytes memory) {
        if (success) {
            return returndata;
        } else {
            // Look for revert reason and bubble it up if present
            if (returndata.length > 0) {
                // The easiest way to bubble the revert reason is using memory via assembly

                assembly {
                    let returndata_size := mload(returndata)
                    revert(add(32, returndata), returndata_size)
                }
            } else {
                revert(errorMessage);
            }
        }
    }
}


// File @openzeppelin/contracts/token/ERC20/utils/[email protected]



pragma solidity 0.8.6;


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

    function safeTransfer(
        IERC20 token,
        address to,
        uint256 value
    ) internal {
        _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));
    }

    function safeTransferFrom(
        IERC20 token,
        address from,
        address to,
        uint256 value
    ) internal {
        _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));
    }

    /**
     * @dev Deprecated. This function has issues similar to the ones found in
     * {IERC20-approve}, and its usage is discouraged.
     *
     * Whenever possible, use {safeIncreaseAllowance} and
     * {safeDecreaseAllowance} instead.
     */
    function safeApprove(
        IERC20 token,
        address spender,
        uint256 value
    ) internal {
        // safeApprove should only be called when setting an initial allowance,
        // or when resetting it to zero. To increase and decrease it, use
        // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'
        require(
            (value == 0) || (token.allowance(address(this), spender) == 0),
            "SafeERC20: approve from non-zero to non-zero allowance"
        );
        _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));
    }

    function safeIncreaseAllowance(
        IERC20 token,
        address spender,
        uint256 value
    ) internal {
        uint256 newAllowance = token.allowance(address(this), spender) + value;
        _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
    }

    function safeDecreaseAllowance(
        IERC20 token,
        address spender,
        uint256 value
    ) internal {
        unchecked {
            uint256 oldAllowance = token.allowance(address(this), spender);
            require(oldAllowance >= value, "SafeERC20: decreased allowance below zero");
            uint256 newAllowance = oldAllowance - value;
            _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
        }
    }

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

        bytes memory returndata = address(token).functionCall(data, "SafeERC20: low-level call failed");
        if (returndata.length > 0) {
            // Return data is optional
            require(abi.decode(returndata, (bool)), "SafeERC20: ERC20 operation did not succeed");
        }
    }
}


// File @openzeppelin/contracts/token/ERC20/extensions/[email protected]



pragma solidity 0.8.6;

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


// File @openzeppelin/contracts/token/ERC20/extensions/[email protected]



pragma solidity 0.8.6;

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


// File @openzeppelin/contracts/utils/[email protected]



pragma solidity 0.8.6;

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

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


// File @openzeppelin/contracts/token/ERC20/[email protected]



pragma solidity 0.8.6;



/**
 * @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}.
     *
     * 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}.
     *
     * 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) {
        _transfer(sender, recipient, amount);

        uint256 currentAllowance = _allowances[sender][_msgSender()];
        require(currentAllowance >= amount, "ERC20: transfer amount exceeds allowance");
        unchecked {
            _approve(sender, _msgSender(), currentAllowance - 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 {}
}


// File @openzeppelin/contracts/utils/cryptography/[email protected]



pragma solidity 0.8.6;

/**
 * @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;
        uint8 v;
        assembly {
            s := and(vs, 0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff)
            v := add(shr(255, vs), 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 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));
    }
}


// File @openzeppelin/contracts/utils/cryptography/[email protected]



pragma solidity 0.8.6;

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

    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);
        _TYPE_HASH = typeHash;
    }

    /**
     * @dev Returns the domain separator for the current chain.
     */
    function _domainSeparatorV4() internal view returns (bytes32) {
        if (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);
    }
}


// File @openzeppelin/contracts/utils/[email protected]



pragma solidity 0.8.6;

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


// File @openzeppelin/contracts/token/ERC20/extensions/[email protected]



pragma solidity 0.8.6;





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


// File contracts/interfaces/utils/IGovernable.sol


pragma solidity 0.8.6;

/**
 * @title IGovernable
 * @author solace.fi
 * @notice Enforces access control for important functions to [**governor**](/docs/protocol/governance).
 *
 * Many contracts contain functionality that should only be accessible to a privileged user. The most common access control pattern is [OpenZeppelin's `Ownable`](https://docs.openzeppelin.com/contracts/4.x/access-control#ownership-and-ownable). We instead use `Governable` with a few key differences:
 * - Transferring the governance role is a two step process. The current governance must [`setPendingGovernance(pendingGovernance_)`](#setpendinggovernance) then the new governance must [`acceptGovernance()`](#acceptgovernance). This is to safeguard against accidentally setting ownership to the wrong address and locking yourself out of your contract.
 * - `governance` is a constructor argument instead of `msg.sender`. This is especially useful when deploying contracts via a [`SingletonFactory`](./ISingletonFactory).
 * - We use `lockGovernance()` instead of `renounceOwnership()`. `renounceOwnership()` is a prerequisite for the reinitialization bug because it sets `owner = address(0x0)`. We also use the `governanceIsLocked()` flag.
 */
interface IGovernable {

    /***************************************
    EVENTS
    ***************************************/

    /// @notice Emitted when pending Governance is set.
    event GovernancePending(address pendingGovernance);
    /// @notice Emitted when Governance is set.
    event GovernanceTransferred(address oldGovernance, address newGovernance);
    /// @notice Emitted when Governance is locked.
    event GovernanceLocked();

    /***************************************
    VIEW FUNCTIONS
    ***************************************/

    /// @notice Address of the current governor.
    function governance() external view returns (address);

    /// @notice Address of the governor to take over.
    function pendingGovernance() external view returns (address);

    /// @notice Returns true if governance is locked.
    function governanceIsLocked() external view returns (bool);

    /***************************************
    MUTATORS
    ***************************************/

    /**
     * @notice Initiates transfer of the governance role to a new governor.
     * Transfer is not complete until the new governor accepts the role.
     * Can only be called by the current [**governor**](/docs/protocol/governance).
     * @param pendingGovernance_ The new governor.
     */
    function setPendingGovernance(address pendingGovernance_) external;

    /**
     * @notice Accepts the governance role.
     * Can only be called by the new governor.
     */
    function acceptGovernance() external;

    /**
     * @notice Permanently locks this contract's governance role and any of its functions that require the role.
     * This action cannot be reversed.
     * Before you call it, ask yourself:
     *   - Is the contract self-sustaining?
     *   - Is there a chance you will need governance privileges in the future?
     * Can only be called by the current [**governor**](/docs/protocol/governance).
     */
    function lockGovernance() external;
}


// File contracts/utils/Governable.sol


pragma solidity 0.8.6;

/**
 * @title Governable
 * @author solace.fi
 * @notice Enforces access control for important functions to [**governor**](/docs/protocol/governance).
 *
 * Many contracts contain functionality that should only be accessible to a privileged user. The most common access control pattern is [OpenZeppelin's `Ownable`](https://docs.openzeppelin.com/contracts/4.x/access-control#ownership-and-ownable). We instead use `Governable` with a few key differences:
   * - Transferring the governance role is a two step process. The current governance must [`setPendingGovernance(pendingGovernance_)`](#setpendinggovernance) then the new governance must [`acceptGovernance()`](#acceptgovernance). This is to safeguard against accidentally setting ownership to the wrong address and locking yourself out of your contract.
 * - `governance` is a constructor argument instead of `msg.sender`. This is especially useful when deploying contracts via a [`SingletonFactory`](./../interfaces/utils/ISingletonFactory).
 * - We use `lockGovernance()` instead of `renounceOwnership()`. `renounceOwnership()` is a prerequisite for the reinitialization bug because it sets `owner = address(0x0)`. We also use the `governanceIsLocked()` flag.
 */
contract Governable is IGovernable {

    /***************************************
    GLOBAL VARIABLES
    ***************************************/

    // Governor.
    address private _governance;

    // governance to take over.
    address private _pendingGovernance;

    bool private _locked;

    /**
     * @notice Constructs the governable contract.
     * @param governance_ The address of the [governor](/docs/protocol/governance).
     */
    constructor(address governance_) {
        require(governance_ != address(0x0), "zero address governance");
        _governance = governance_;
        _pendingGovernance = address(0x0);
        _locked = false;
    }

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

    // can only be called by governor
    // can only be called while unlocked
    modifier onlyGovernance() {
        require(!_locked, "governance locked");
        require(msg.sender == _governance, "!governance");
        _;
    }

    // can only be called by pending governor
    // can only be called while unlocked
    modifier onlyPendingGovernance() {
        require(!_locked, "governance locked");
        require(msg.sender == _pendingGovernance, "!pending governance");
        _;
    }

    /***************************************
    VIEW FUNCTIONS
    ***************************************/

    /// @notice Address of the current governor.
    function governance() external view override returns (address) {
        return _governance;
    }

    /// @notice Address of the governor to take over.
    function pendingGovernance() external view override returns (address) {
        return _pendingGovernance;
    }

    /// @notice Returns true if governance is locked.
    function governanceIsLocked() external view override returns (bool) {
        return _locked;
    }

    /***************************************
    MUTATOR FUNCTIONS
    ***************************************/

    /**
     * @notice Initiates transfer of the governance role to a new governor.
     * Transfer is not complete until the new governor accepts the role.
     * Can only be called by the current [**governor**](/docs/protocol/governance).
     * @param pendingGovernance_ The new governor.
     */
    function setPendingGovernance(address pendingGovernance_) external override onlyGovernance {
        _pendingGovernance = pendingGovernance_;
        emit GovernancePending(pendingGovernance_);
    }

    /**
     * @notice Accepts the governance role.
     * Can only be called by the pending governor.
     */
    function acceptGovernance() external override onlyPendingGovernance {
        // sanity check against transferring governance to the zero address
        // if someone figures out how to sign transactions from the zero address
        // consider the entirety of ethereum to be rekt
        require(_pendingGovernance != address(0x0), "zero governance");
        address oldGovernance = _governance;
        _governance = _pendingGovernance;
        _pendingGovernance = address(0x0);
        emit GovernanceTransferred(oldGovernance, _governance);
    }

    /**
     * @notice Permanently locks this contract's governance role and any of its functions that require the role.
     * This action cannot be reversed.
     * Before you call it, ask yourself:
     *   - Is the contract self-sustaining?
     *   - Is there a chance you will need governance privileges in the future?
     * Can only be called by the current [**governor**](/docs/protocol/governance).
     */
    function lockGovernance() external override onlyGovernance {
        _locked = true;
        // intentionally not using address(0x0), see re-initialization exploit
        _governance = address(0xFFfFfFffFFfffFFfFFfFFFFFffFFFffffFfFFFfF);
        _pendingGovernance = address(0xFFfFfFffFFfffFFfFFfFFFFFffFFFffffFfFFFfF);
        emit GovernanceTransferred(msg.sender, address(0xFFfFfFffFFfffFFfFFfFFFFFffFFFffffFfFFFfF));
        emit GovernanceLocked();
    }
}


// File contracts/interfaces/ISOLACE.sol



pragma solidity 0.8.6;

/**
 * @title Solace Token (SOLACE)
 * @author solace.fi
 * @notice The native governance token of the Solace Coverage Protocol.
 */
interface ISOLACE is IERC20Metadata {

    /***************************************
    EVENTS
    ***************************************/

    /// @notice Emitted when a minter is added.
    event MinterAdded(address indexed minter);
    /// @notice Emitted when a minter is removed.
    event MinterRemoved(address indexed minter);

    /***************************************
    MINT FUNCTIONS
    ***************************************/

    /**
     * @notice Returns true if `account` is authorized to mint [**SOLACE**](../SOLACE).
     * @param account Account to query.
     * @return status True if `account` can mint, false otherwise.
     */
    function isMinter(address account) external view returns (bool status);

    /**
     * @notice Mints new [**SOLACE**](../SOLACE) to the receiver account.
     * Can only be called by authorized minters.
     * @param account The receiver of new tokens.
     * @param amount The number of new tokens.
     */
    function mint(address account, uint256 amount) external;

    /**
     * @notice Burns [**SOLACE**](../SOLACE) from msg.sender.
     * @param amount Amount to burn.
     */
    function burn(uint256 amount) external;

    /**
     * @notice Adds a new minter.
     * Can only be called by the current [**governor**](/docs/protocol/governance).
     * @param minter The new minter.
     */
    function addMinter(address minter) external;

    /**
     * @notice Removes a minter.
     * Can only be called by the current [**governor**](/docs/protocol/governance).
     * @param minter The minter to remove.
     */
    function removeMinter(address minter) external;
}


// File contracts/SOLACE.sol


pragma solidity 0.8.6;





/**
 * @title Solace Token (SOLACE)
 * @author solace.fi
 * @notice The native governance token of the Solace Coverage Protocol.
 */
contract SOLACE is ISOLACE, ERC20Permit, Governable {
    using SafeERC20 for IERC20;
    using Address for address;

    // Minters
    mapping (address => bool) internal _minters;

    /**
     * @notice Constructs the Solace Token contract.
     * @param governance_ The address of the [governor](/docs/protocol/governance).
     */
    constructor(address governance_) ERC20("solace", "SOLACE") ERC20Permit("solace") Governable(governance_) { }

    /**
     * @notice Returns true if `account` is authorized to mint [**SOLACE**](./SOLACE).
     * @param account Account to query.
     * @return status True if `account` can mint, false otherwise.
     */
    function isMinter(address account) external view override returns (bool status) {
        return _minters[account];
    }

    /**
     * @notice Mints new [**SOLACE**](./SOLACE) to the receiver account.
     * Can only be called by authorized minters.
     * @param account The receiver of new tokens.
     * @param amount The number of new tokens.
     */
    function mint(address account, uint256 amount) external override {
        // can only be called by authorized minters
        require(_minters[msg.sender], "!minter");
        // mint
        _mint(account, amount);
    }

    /**
     * @notice Burns [**SOLACE**](./SOLACE) from msg.sender.
     * @param amount Amount to burn.
     */
    function burn(uint256 amount) external override {
        _burn(msg.sender, amount);
    }

    /**
     * @notice Adds a new minter.
     * Can only be called by the current [**governor**](/docs/protocol/governance).
     * @param minter The new minter.
     */
    function addMinter(address minter) external onlyGovernance override {
        require(minter != address(0x0), "zero address");
        _minters[minter] = true;
        emit MinterAdded(minter);
    }

    /**
     * @notice Removes a minter.
     * Can only be called by the current [**governor**](/docs/protocol/governance).
     * @param minter The minter to remove.
     */
    function removeMinter(address minter) external onlyGovernance override {
        _minters[minter] = false;
        emit MinterRemoved(minter);
    }
}

• No Contract Security Audit Submitted- Submit Audit Here

[{"inputs":[{"internalType":"address","name":"governance_","type":"address"}],"stateMutability":"nonpayable","type":"constructor"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"spender","type":"address"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[],"name":"GovernanceLocked","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"pendingGovernance","type":"address"}],"name":"GovernancePending","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"oldGovernance","type":"address"},{"indexed":false,"internalType":"address","name":"newGovernance","type":"address"}],"name":"GovernanceTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"minter","type":"address"}],"name":"MinterAdded","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"minter","type":"address"}],"name":"MinterRemoved","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"Transfer","type":"event"},{"inputs":[],"name":"DOMAIN_SEPARATOR","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"acceptGovernance","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"minter","type":"address"}],"name":"addMinter","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"spender","type":"address"}],"name":"allowance","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"approve","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"burn","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"decimals","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"subtractedValue","type":"uint256"}],"name":"decreaseAllowance","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"governance","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"governanceIsLocked","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"addedValue","type":"uint256"}],"name":"increaseAllowance","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"isMinter","outputs":[{"internalType":"bool","name":"status","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"lockGovernance","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"mint","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"nonces","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pendingGovernance","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"value","type":"uint256"},{"internalType":"uint256","name":"deadline","type":"uint256"},{"internalType":"uint8","name":"v","type":"uint8"},{"internalType":"bytes32","name":"r","type":"bytes32"},{"internalType":"bytes32","name":"s","type":"bytes32"}],"name":"permit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"minter","type":"address"}],"name":"removeMinter","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"pendingGovernance_","type":"address"}],"name":"setPendingGovernance","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"recipient","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"transfer","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"sender","type":"address"},{"internalType":"address","name":"recipient","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"transferFrom","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"}]

6101406040527f6e71edae12b1b97f4d1f60370fef10105fa2faae0126114a169c64845d6126c9610120523480156200003757600080fd5b5060405162001dc238038062001dc28339810160408190526200005a91620002c6565b8060405180604001604052806006815260200165736f6c61636560d01b81525080604051806040016040528060018152602001603160f81b81525060405180604001604052806006815260200165736f6c61636560d01b81525060405180604001604052806006815260200165534f4c41434560d01b8152508160039080519060200190620000eb92919062000220565b5080516200010190600490602084019062000220565b5050825160209384012082519284019290922060c083815260e08290524660a0818152604080517f8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f818a018190528183019890985260608101959095526080808601939093523085830152805180860390920182529390920190925280519401939093209092526101005250506001600160a01b038116620001e95760405162461bcd60e51b815260206004820152601760248201527f7a65726f206164647265737320676f7665726e616e6365000000000000000000604482015260640160405180910390fd5b600680546001600160a01b0319166001600160a01b039290921691909117905550600780546001600160a81b031916905562000335565b8280546200022e90620002f8565b90600052602060002090601f0160209004810192826200025257600085556200029d565b82601f106200026d57805160ff19168380011785556200029d565b828001600101855582156200029d579182015b828111156200029d57825182559160200191906001019062000280565b50620002ab929150620002af565b5090565b5b80821115620002ab5760008155600101620002b0565b600060208284031215620002d957600080fd5b81516001600160a01b0381168114620002f157600080fd5b9392505050565b600181811c908216806200030d57607f821691505b602082108114156200032f57634e487b7160e01b600052602260045260246000fd5b50919050565b60805160a05160c05160e0516101005161012051611a3d620003856000396000610d2e015260006111b701526000611206015260006111e1015260006111650152600061118e0152611a3d6000f3fe608060405234801561001057600080fd5b50600436106101a35760003560e01c806342966c68116100ee578063a457c2d711610097578063abbf4b1711610071578063abbf4b171461036e578063d505accf14610376578063dd62ed3e14610389578063f39c38a0146103c257600080fd5b8063a457c2d71461031c578063a9059cbb1461032f578063aa271e1a1461034257600080fd5b80637ecebe00116100c85780637ecebe00146102ee57806395d89b4114610301578063983b2d561461030957600080fd5b806342966c681461028d5780635aa6e675146102a057806370a08231146102c557600080fd5b806323b872dd116101505780633644e5151161012a5780633644e5151461025f578063395093511461026757806340c10f191461027a57600080fd5b806323b872dd1461022a5780633092afd51461023d578063313ce5671461025057600080fd5b806318160ddd1161018157806318160ddd146101fe5780631c93022114610210578063238efcbc1461022257600080fd5b806306fdde03146101a8578063095ea7b3146101c65780630abb6035146101e9575b600080fd5b6101b06103d3565b6040516101bd9190611922565b60405180910390f35b6101d96101d43660046118df565b610465565b60405190151581526020016101bd565b6101fc6101f73660046117db565b61047b565b005b6002545b6040519081526020016101bd565b600754600160a01b900460ff166101d9565b6101fc610578565b6101d9610238366004611830565b6106eb565b6101fc61024b3660046117db565b6107aa565b604051601281526020016101bd565b610202610889565b6101d96102753660046118df565b610898565b6101fc6102883660046118df565b6108d4565b6101fc61029b366004611909565b610941565b6006546001600160a01b03165b6040516001600160a01b0390911681526020016101bd565b6102026102d33660046117db565b6001600160a01b031660009081526020819052604090205490565b6102026102fc3660046117db565b61094e565b6101b061096e565b6101fc6103173660046117db565b61097d565b6101d961032a3660046118df565b610ab5565b6101d961033d3660046118df565b610b66565b6101d96103503660046117db565b6001600160a01b031660009081526008602052604090205460ff1690565b6101fc610b73565b6101fc61038436600461186c565b610cda565b6102026103973660046117fd565b6001600160a01b03918216600090815260016020908152604080832093909416825291909152205490565b6007546001600160a01b03166102ad565b6060600380546103e2906119a6565b80601f016020809104026020016040519081016040528092919081815260200182805461040e906119a6565b801561045b5780601f106104305761010080835404028352916020019161045b565b820191906000526020600020905b81548152906001019060200180831161043e57829003601f168201915b5050505050905090565b6000610472338484610e3e565b50600192915050565b600754600160a01b900460ff16156104ce5760405162461bcd60e51b815260206004820152601160248201527019dbdd995c9b985b98d9481b1bd8dad959607a1b60448201526064015b60405180910390fd5b6006546001600160a01b031633146105165760405162461bcd60e51b815260206004820152600b60248201526a21676f7665726e616e636560a81b60448201526064016104c5565b6007805473ffffffffffffffffffffffffffffffffffffffff19166001600160a01b0383169081179091556040519081527fd61ed858909d3cb796547804c47dc1550d27455f8a0037b6b487e46212392396906020015b60405180910390a150565b600754600160a01b900460ff16156105c65760405162461bcd60e51b815260206004820152601160248201527019dbdd995c9b985b98d9481b1bd8dad959607a1b60448201526064016104c5565b6007546001600160a01b031633146106205760405162461bcd60e51b815260206004820152601360248201527f2170656e64696e6720676f7665726e616e63650000000000000000000000000060448201526064016104c5565b6007546001600160a01b03166106785760405162461bcd60e51b815260206004820152600f60248201527f7a65726f20676f7665726e616e6365000000000000000000000000000000000060448201526064016104c5565b60068054600780546001600160a01b0380821673ffffffffffffffffffffffffffffffffffffffff19808616821790965594909116909155604080519190921680825260208201939093527f5f56bee8cffbe9a78652a74a60705edede02af10b0bbb888ca44b79a0d42ce80910161056d565b60006106f8848484610f63565b6001600160a01b0384166000908152600160209081526040808320338452909152902054828110156107925760405162461bcd60e51b815260206004820152602860248201527f45524332303a207472616e7366657220616d6f756e742065786365656473206160448201527f6c6c6f77616e636500000000000000000000000000000000000000000000000060648201526084016104c5565b61079f8533858403610e3e565b506001949350505050565b600754600160a01b900460ff16156107f85760405162461bcd60e51b815260206004820152601160248201527019dbdd995c9b985b98d9481b1bd8dad959607a1b60448201526064016104c5565b6006546001600160a01b031633146108405760405162461bcd60e51b815260206004820152600b60248201526a21676f7665726e616e636560a81b60448201526064016104c5565b6001600160a01b038116600081815260086020526040808220805460ff19169055517fe94479a9f7e1952cc78f2d6baab678adc1b772d936c6583def489e524cb666929190a250565b6000610893611161565b905090565b3360008181526001602090815260408083206001600160a01b038716845290915281205490916104729185906108cf908690611977565b610e3e565b3360009081526008602052604090205460ff166109335760405162461bcd60e51b815260206004820152600760248201527f216d696e7465720000000000000000000000000000000000000000000000000060448201526064016104c5565b61093d8282611254565b5050565b61094b3382611333565b50565b6001600160a01b0381166000908152600560205260408120545b92915050565b6060600480546103e2906119a6565b600754600160a01b900460ff16156109cb5760405162461bcd60e51b815260206004820152601160248201527019dbdd995c9b985b98d9481b1bd8dad959607a1b60448201526064016104c5565b6006546001600160a01b03163314610a135760405162461bcd60e51b815260206004820152600b60248201526a21676f7665726e616e636560a81b60448201526064016104c5565b6001600160a01b038116610a695760405162461bcd60e51b815260206004820152600c60248201527f7a65726f2061646472657373000000000000000000000000000000000000000060448201526064016104c5565b6001600160a01b038116600081815260086020526040808220805460ff19166001179055517f6ae172837ea30b801fbfcdd4108aa1d5bf8ff775444fd70256b44e6bf3dfc3f69190a250565b3360009081526001602090815260408083206001600160a01b038616845290915281205482811015610b4f5760405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f7760448201527f207a65726f00000000000000000000000000000000000000000000000000000060648201526084016104c5565b610b5c3385858403610e3e565b5060019392505050565b6000610472338484610f63565b600754600160a01b900460ff1615610bc15760405162461bcd60e51b815260206004820152601160248201527019dbdd995c9b985b98d9481b1bd8dad959607a1b60448201526064016104c5565b6006546001600160a01b03163314610c095760405162461bcd60e51b815260206004820152600b60248201526a21676f7665726e616e636560a81b60448201526064016104c5565b60078054600680546001600160a01b0373ffffffffffffffffffffffffffffffffffffffff1990911681179091557fffffffffffffffffffffff0000000000000000000000000000000000000000009091167401ffffffffffffffffffffffffffffffffffffffff179091556040805133815260208101929092527f5f56bee8cffbe9a78652a74a60705edede02af10b0bbb888ca44b79a0d42ce80910160405180910390a16040517fd572292b9e5d684b0719ae2d0e210513b477e303c975ed1c63b6fcac1607672790600090a1565b83421115610d2a5760405162461bcd60e51b815260206004820152601d60248201527f45524332305065726d69743a206578706972656420646561646c696e6500000060448201526064016104c5565b60007f0000000000000000000000000000000000000000000000000000000000000000888888610d598c611479565b6040805160208101969096526001600160a01b0394851690860152929091166060840152608083015260a082015260c0810186905260e0016040516020818303038152906040528051906020012090506000610db4826114a1565b90506000610dc4828787876114ef565b9050896001600160a01b0316816001600160a01b031614610e275760405162461bcd60e51b815260206004820152601e60248201527f45524332305065726d69743a20696e76616c6964207369676e6174757265000060448201526064016104c5565b610e328a8a8a610e3e565b50505050505050505050565b6001600160a01b038316610ea05760405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b60648201526084016104c5565b6001600160a01b038216610f015760405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b60648201526084016104c5565b6001600160a01b0383811660008181526001602090815260408083209487168084529482529182902085905590518481527f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591015b60405180910390a3505050565b6001600160a01b038316610fdf5760405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f20616460448201527f647265737300000000000000000000000000000000000000000000000000000060648201526084016104c5565b6001600160a01b0382166110415760405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b60648201526084016104c5565b6001600160a01b038316600090815260208190526040902054818110156110d05760405162461bcd60e51b815260206004820152602660248201527f45524332303a207472616e7366657220616d6f756e742065786365656473206260448201527f616c616e6365000000000000000000000000000000000000000000000000000060648201526084016104c5565b6001600160a01b03808516600090815260208190526040808220858503905591851681529081208054849290611107908490611977565b92505081905550826001600160a01b0316846001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef8460405161115391815260200190565b60405180910390a350505050565b60007f00000000000000000000000000000000000000000000000000000000000000004614156111b057507f000000000000000000000000000000000000000000000000000000000000000090565b50604080517f00000000000000000000000000000000000000000000000000000000000000006020808301919091527f0000000000000000000000000000000000000000000000000000000000000000828401527f000000000000000000000000000000000000000000000000000000000000000060608301524660808301523060a0808401919091528351808403909101815260c0909201909252805191012090565b6001600160a01b0382166112aa5760405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f20616464726573730060448201526064016104c5565b80600260008282546112bc9190611977565b90915550506001600160a01b038216600090815260208190526040812080548392906112e9908490611977565b90915550506040518181526001600160a01b038316906000907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef9060200160405180910390a35050565b6001600160a01b0382166113935760405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b60648201526084016104c5565b6001600160a01b038216600090815260208190526040902054818110156114075760405162461bcd60e51b815260206004820152602260248201527f45524332303a206275726e20616d6f756e7420657863656564732062616c616e604482015261636560f01b60648201526084016104c5565b6001600160a01b038316600090815260208190526040812083830390556002805484929061143690849061198f565b90915550506040518281526000906001600160a01b038516907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef90602001610f56565b6001600160a01b03811660009081526005602052604090208054600181018255905b50919050565b60006109686114ae611161565b8360405161190160f01b6020820152602281018390526042810182905260009060620160405160208183030381529060405280519060200120905092915050565b600080600061150087878787611517565b9150915061150d81611604565b5095945050505050565b6000807f7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a083111561154e57506000905060036115fb565b8460ff16601b1415801561156657508460ff16601c14155b1561157757506000905060046115fb565b6040805160008082526020820180845289905260ff881692820192909252606081018690526080810185905260019060a0016020604051602081039080840390855afa1580156115cb573d6000803e3d6000fd5b5050604051601f1901519150506001600160a01b0381166115f4576000600192509250506115fb565b9150600090505b94509492505050565b6000816004811115611618576116186119f1565b14156116215750565b6001816004811115611635576116356119f1565b14156116835760405162461bcd60e51b815260206004820152601860248201527f45434453413a20696e76616c6964207369676e6174757265000000000000000060448201526064016104c5565b6002816004811115611697576116976119f1565b14156116e55760405162461bcd60e51b815260206004820152601f60248201527f45434453413a20696e76616c6964207369676e6174757265206c656e6774680060448201526064016104c5565b60038160048111156116f9576116f96119f1565b14156117525760405162461bcd60e51b815260206004820152602260248201527f45434453413a20696e76616c6964207369676e6174757265202773272076616c604482015261756560f01b60648201526084016104c5565b6004816004811115611766576117666119f1565b141561094b5760405162461bcd60e51b815260206004820152602260248201527f45434453413a20696e76616c6964207369676e6174757265202776272076616c604482015261756560f01b60648201526084016104c5565b80356001600160a01b03811681146117d657600080fd5b919050565b6000602082840312156117ed57600080fd5b6117f6826117bf565b9392505050565b6000806040838503121561181057600080fd5b611819836117bf565b9150611827602084016117bf565b90509250929050565b60008060006060848603121561184557600080fd5b61184e846117bf565b925061185c602085016117bf565b9150604084013590509250925092565b600080600080600080600060e0888a03121561188757600080fd5b611890886117bf565b965061189e602089016117bf565b95506040880135945060608801359350608088013560ff811681146118c257600080fd5b9699959850939692959460a0840135945060c09093013592915050565b600080604083850312156118f257600080fd5b6118fb836117bf565b946020939093013593505050565b60006020828403121561191b57600080fd5b5035919050565b600060208083528351808285015260005b8181101561194f57858101830151858201604001528201611933565b81811115611961576000604083870101525b50601f01601f1916929092016040019392505050565b6000821982111561198a5761198a6119db565b500190565b6000828210156119a1576119a16119db565b500390565b600181811c908216806119ba57607f821691505b6020821081141561149b57634e487b7160e01b600052602260045260246000fd5b634e487b7160e01b600052601160045260246000fd5b634e487b7160e01b600052602160045260246000fdfea2646970667358221220b63aec4ab6ec78dc412cdd794db187234c60fb87ce69ccf224f584799c04a9c564736f6c63430008060033000000000000000000000000501ace0e8d16b92236763e2ded7ae3bc2dffa276

0x608060405234801561001057600080fd5b50600436106101a35760003560e01c806342966c68116100ee578063a457c2d711610097578063abbf4b1711610071578063abbf4b171461036e578063d505accf14610376578063dd62ed3e14610389578063f39c38a0146103c257600080fd5b8063a457c2d71461031c578063a9059cbb1461032f578063aa271e1a1461034257600080fd5b80637ecebe00116100c85780637ecebe00146102ee57806395d89b4114610301578063983b2d561461030957600080fd5b806342966c681461028d5780635aa6e675146102a057806370a08231146102c557600080fd5b806323b872dd116101505780633644e5151161012a5780633644e5151461025f578063395093511461026757806340c10f191461027a57600080fd5b806323b872dd1461022a5780633092afd51461023d578063313ce5671461025057600080fd5b806318160ddd1161018157806318160ddd146101fe5780631c93022114610210578063238efcbc1461022257600080fd5b806306fdde03146101a8578063095ea7b3146101c65780630abb6035146101e9575b600080fd5b6101b06103d3565b6040516101bd9190611922565b60405180910390f35b6101d96101d43660046118df565b610465565b60405190151581526020016101bd565b6101fc6101f73660046117db565b61047b565b005b6002545b6040519081526020016101bd565b600754600160a01b900460ff166101d9565b6101fc610578565b6101d9610238366004611830565b6106eb565b6101fc61024b3660046117db565b6107aa565b604051601281526020016101bd565b610202610889565b6101d96102753660046118df565b610898565b6101fc6102883660046118df565b6108d4565b6101fc61029b366004611909565b610941565b6006546001600160a01b03165b6040516001600160a01b0390911681526020016101bd565b6102026102d33660046117db565b6001600160a01b031660009081526020819052604090205490565b6102026102fc3660046117db565b61094e565b6101b061096e565b6101fc6103173660046117db565b61097d565b6101d961032a3660046118df565b610ab5565b6101d961033d3660046118df565b610b66565b6101d96103503660046117db565b6001600160a01b031660009081526008602052604090205460ff1690565b6101fc610b73565b6101fc61038436600461186c565b610cda565b6102026103973660046117fd565b6001600160a01b03918216600090815260016020908152604080832093909416825291909152205490565b6007546001600160a01b03166102ad565b6060600380546103e2906119a6565b80601f016020809104026020016040519081016040528092919081815260200182805461040e906119a6565b801561045b5780601f106104305761010080835404028352916020019161045b565b820191906000526020600020905b81548152906001019060200180831161043e57829003601f168201915b5050505050905090565b6000610472338484610e3e565b50600192915050565b600754600160a01b900460ff16156104ce5760405162461bcd60e51b815260206004820152601160248201527019dbdd995c9b985b98d9481b1bd8dad959607a1b60448201526064015b60405180910390fd5b6006546001600160a01b031633146105165760405162461bcd60e51b815260206004820152600b60248201526a21676f7665726e616e636560a81b60448201526064016104c5565b6007805473ffffffffffffffffffffffffffffffffffffffff19166001600160a01b0383169081179091556040519081527fd61ed858909d3cb796547804c47dc1550d27455f8a0037b6b487e46212392396906020015b60405180910390a150565b600754600160a01b900460ff16156105c65760405162461bcd60e51b815260206004820152601160248201527019dbdd995c9b985b98d9481b1bd8dad959607a1b60448201526064016104c5565b6007546001600160a01b031633146106205760405162461bcd60e51b815260206004820152601360248201527f2170656e64696e6720676f7665726e616e63650000000000000000000000000060448201526064016104c5565b6007546001600160a01b03166106785760405162461bcd60e51b815260206004820152600f60248201527f7a65726f20676f7665726e616e6365000000000000000000000000000000000060448201526064016104c5565b60068054600780546001600160a01b0380821673ffffffffffffffffffffffffffffffffffffffff19808616821790965594909116909155604080519190921680825260208201939093527f5f56bee8cffbe9a78652a74a60705edede02af10b0bbb888ca44b79a0d42ce80910161056d565b60006106f8848484610f63565b6001600160a01b0384166000908152600160209081526040808320338452909152902054828110156107925760405162461bcd60e51b815260206004820152602860248201527f45524332303a207472616e7366657220616d6f756e742065786365656473206160448201527f6c6c6f77616e636500000000000000000000000000000000000000000000000060648201526084016104c5565b61079f8533858403610e3e565b506001949350505050565b600754600160a01b900460ff16156107f85760405162461bcd60e51b815260206004820152601160248201527019dbdd995c9b985b98d9481b1bd8dad959607a1b60448201526064016104c5565b6006546001600160a01b031633146108405760405162461bcd60e51b815260206004820152600b60248201526a21676f7665726e616e636560a81b60448201526064016104c5565b6001600160a01b038116600081815260086020526040808220805460ff19169055517fe94479a9f7e1952cc78f2d6baab678adc1b772d936c6583def489e524cb666929190a250565b6000610893611161565b905090565b3360008181526001602090815260408083206001600160a01b038716845290915281205490916104729185906108cf908690611977565b610e3e565b3360009081526008602052604090205460ff166109335760405162461bcd60e51b815260206004820152600760248201527f216d696e7465720000000000000000000000000000000000000000000000000060448201526064016104c5565b61093d8282611254565b5050565b61094b3382611333565b50565b6001600160a01b0381166000908152600560205260408120545b92915050565b6060600480546103e2906119a6565b600754600160a01b900460ff16156109cb5760405162461bcd60e51b815260206004820152601160248201527019dbdd995c9b985b98d9481b1bd8dad959607a1b60448201526064016104c5565b6006546001600160a01b03163314610a135760405162461bcd60e51b815260206004820152600b60248201526a21676f7665726e616e636560a81b60448201526064016104c5565b6001600160a01b038116610a695760405162461bcd60e51b815260206004820152600c60248201527f7a65726f2061646472657373000000000000000000000000000000000000000060448201526064016104c5565b6001600160a01b038116600081815260086020526040808220805460ff19166001179055517f6ae172837ea30b801fbfcdd4108aa1d5bf8ff775444fd70256b44e6bf3dfc3f69190a250565b3360009081526001602090815260408083206001600160a01b038616845290915281205482811015610b4f5760405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f7760448201527f207a65726f00000000000000000000000000000000000000000000000000000060648201526084016104c5565b610b5c3385858403610e3e565b5060019392505050565b6000610472338484610f63565b600754600160a01b900460ff1615610bc15760405162461bcd60e51b815260206004820152601160248201527019dbdd995c9b985b98d9481b1bd8dad959607a1b60448201526064016104c5565b6006546001600160a01b03163314610c095760405162461bcd60e51b815260206004820152600b60248201526a21676f7665726e616e636560a81b60448201526064016104c5565b60078054600680546001600160a01b0373ffffffffffffffffffffffffffffffffffffffff1990911681179091557fffffffffffffffffffffff0000000000000000000000000000000000000000009091167401ffffffffffffffffffffffffffffffffffffffff179091556040805133815260208101929092527f5f56bee8cffbe9a78652a74a60705edede02af10b0bbb888ca44b79a0d42ce80910160405180910390a16040517fd572292b9e5d684b0719ae2d0e210513b477e303c975ed1c63b6fcac1607672790600090a1565b83421115610d2a5760405162461bcd60e51b815260206004820152601d60248201527f45524332305065726d69743a206578706972656420646561646c696e6500000060448201526064016104c5565b60007f6e71edae12b1b97f4d1f60370fef10105fa2faae0126114a169c64845d6126c9888888610d598c611479565b6040805160208101969096526001600160a01b0394851690860152929091166060840152608083015260a082015260c0810186905260e0016040516020818303038152906040528051906020012090506000610db4826114a1565b90506000610dc4828787876114ef565b9050896001600160a01b0316816001600160a01b031614610e275760405162461bcd60e51b815260206004820152601e60248201527f45524332305065726d69743a20696e76616c6964207369676e6174757265000060448201526064016104c5565b610e328a8a8a610e3e565b50505050505050505050565b6001600160a01b038316610ea05760405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b60648201526084016104c5565b6001600160a01b038216610f015760405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b60648201526084016104c5565b6001600160a01b0383811660008181526001602090815260408083209487168084529482529182902085905590518481527f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591015b60405180910390a3505050565b6001600160a01b038316610fdf5760405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f20616460448201527f647265737300000000000000000000000000000000000000000000000000000060648201526084016104c5565b6001600160a01b0382166110415760405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b60648201526084016104c5565b6001600160a01b038316600090815260208190526040902054818110156110d05760405162461bcd60e51b815260206004820152602660248201527f45524332303a207472616e7366657220616d6f756e742065786365656473206260448201527f616c616e6365000000000000000000000000000000000000000000000000000060648201526084016104c5565b6001600160a01b03808516600090815260208190526040808220858503905591851681529081208054849290611107908490611977565b92505081905550826001600160a01b0316846001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef8460405161115391815260200190565b60405180910390a350505050565b60007f00000000000000000000000000000000000000000000000000000000000000894614156111b057507fb63d9e4f8a51a65afb31a6f9dfc6170a6e9479a80d07605dc97d4722070ee0ce90565b50604080517f8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f6020808301919091527fe23724f3c7ff89fb3c77bcea05cae1deaaecfab8404bcbd2b15c5482909e4f5a828401527fc89efdaa54c0f20c7adf612882df0950f5a951637e0307cdcb4c672f298b8bc660608301524660808301523060a0808401919091528351808403909101815260c0909201909252805191012090565b6001600160a01b0382166112aa5760405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f20616464726573730060448201526064016104c5565b80600260008282546112bc9190611977565b90915550506001600160a01b038216600090815260208190526040812080548392906112e9908490611977565b90915550506040518181526001600160a01b038316906000907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef9060200160405180910390a35050565b6001600160a01b0382166113935760405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b60648201526084016104c5565b6001600160a01b038216600090815260208190526040902054818110156114075760405162461bcd60e51b815260206004820152602260248201527f45524332303a206275726e20616d6f756e7420657863656564732062616c616e604482015261636560f01b60648201526084016104c5565b6001600160a01b038316600090815260208190526040812083830390556002805484929061143690849061198f565b90915550506040518281526000906001600160a01b038516907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef90602001610f56565b6001600160a01b03811660009081526005602052604090208054600181018255905b50919050565b60006109686114ae611161565b8360405161190160f01b6020820152602281018390526042810182905260009060620160405160208183030381529060405280519060200120905092915050565b600080600061150087878787611517565b9150915061150d81611604565b5095945050505050565b6000807f7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a083111561154e57506000905060036115fb565b8460ff16601b1415801561156657508460ff16601c14155b1561157757506000905060046115fb565b6040805160008082526020820180845289905260ff881692820192909252606081018690526080810185905260019060a0016020604051602081039080840390855afa1580156115cb573d6000803e3d6000fd5b5050604051601f1901519150506001600160a01b0381166115f4576000600192509250506115fb565b9150600090505b94509492505050565b6000816004811115611618576116186119f1565b14156116215750565b6001816004811115611635576116356119f1565b14156116835760405162461bcd60e51b815260206004820152601860248201527f45434453413a20696e76616c6964207369676e6174757265000000000000000060448201526064016104c5565b6002816004811115611697576116976119f1565b14156116e55760405162461bcd60e51b815260206004820152601f60248201527f45434453413a20696e76616c6964207369676e6174757265206c656e6774680060448201526064016104c5565b60038160048111156116f9576116f96119f1565b14156117525760405162461bcd60e51b815260206004820152602260248201527f45434453413a20696e76616c6964207369676e6174757265202773272076616c604482015261756560f01b60648201526084016104c5565b6004816004811115611766576117666119f1565b141561094b5760405162461bcd60e51b815260206004820152602260248201527f45434453413a20696e76616c6964207369676e6174757265202776272076616c604482015261756560f01b60648201526084016104c5565b80356001600160a01b03811681146117d657600080fd5b919050565b6000602082840312156117ed57600080fd5b6117f6826117bf565b9392505050565b6000806040838503121561181057600080fd5b611819836117bf565b9150611827602084016117bf565b90509250929050565b60008060006060848603121561184557600080fd5b61184e846117bf565b925061185c602085016117bf565b9150604084013590509250925092565b600080600080600080600060e0888a03121561188757600080fd5b611890886117bf565b965061189e602089016117bf565b95506040880135945060608801359350608088013560ff811681146118c257600080fd5b9699959850939692959460a0840135945060c09093013592915050565b600080604083850312156118f257600080fd5b6118fb836117bf565b946020939093013593505050565b60006020828403121561191b57600080fd5b5035919050565b600060208083528351808285015260005b8181101561194f57858101830151858201604001528201611933565b81811115611961576000604083870101525b50601f01601f1916929092016040019392505050565b6000821982111561198a5761198a6119db565b500190565b6000828210156119a1576119a16119db565b500390565b600181811c908216806119ba57607f821691505b6020821081141561149b57634e487b7160e01b600052602260045260246000fd5b634e487b7160e01b600052601160045260246000fd5b634e487b7160e01b600052602160045260246000fdfea2646970667358221220b63aec4ab6ec78dc412cdd794db187234c60fb87ce69ccf224f584799c04a9c564736f6c63430008060033

000000000000000000000000501ace0e8d16b92236763e2ded7ae3bc2dffa276

-----Decoded View---------------
Arg [0] : governance_ (address): 0x501AcE0e8D16B92236763E2dEd7aE3bc2DFfA276

-----Encoded View---------------
1 Constructor Arguments found :
Arg [0] : 000000000000000000000000501ace0e8d16b92236763e2ded7ae3bc2dffa276

59451:2229:0:-:0;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;20864:100;;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;23031:169;;;;;;:::i;:::-;;:::i;:::-;;;3271:14:1;;3264:22;3246:41;;3234:2;3219:18;23031:169:0;3201:92:1;55539:202:0;;;;;;:::i;:::-;;:::i;:::-;;21984:108;22072:12;;21984:108;;;3444:25:1;;;3432:2;3417:18;21984:108:0;3399:76:1;55007:101:0;55093:7;;-1:-1:-1;;;55093:7:0;;;;55007:101;;55864:563;;;:::i;23682:492::-;;;;;;:::i;:::-;;:::i;61526:151::-;;;;;;:::i;:::-;;:::i;21826:93::-;;;21909:2;14240:36:1;;14228:2;14213:18;21826:93:0;14195:87:1;48058:115:0;;;:::i;24583:215::-;;;;;;:::i;:::-;;:::i;60505:227::-;;;;;;:::i;:::-;;:::i;60858:92::-;;;;;;:::i;:::-;;:::i;54667:100::-;54748:11;;-1:-1:-1;;;;;54748:11:0;54667:100;;;-1:-1:-1;;;;;2707:55:1;;;2689:74;;2677:2;2662:18;54667:100:0;2644:125:1;22155:127:0;;;;;;:::i;:::-;-1:-1:-1;;;;;22256:18:0;22229:7;22256:18;;;;;;;;;;;;22155:127;47800:128;;;;;;:::i;:::-;;:::i;21083:104::-;;;:::i;61134:203::-;;;;;;:::i;:::-;;:::i;25301:413::-;;;;;;:::i;:::-;;:::i;22495:175::-;;;;;;:::i;:::-;;:::i;60133:123::-;;;;;;:::i;:::-;-1:-1:-1;;;;;60231:17:0;60200:11;60231:17;;;:8;:17;;;;;;;;;60133:123;56860:467;;;:::i;47089:645::-;;;;;;:::i;:::-;;:::i;22733:151::-;;;;;;:::i;:::-;-1:-1:-1;;;;;22849:18:0;;;22822:7;22849:18;;;:11;:18;;;;;;;;:27;;;;;;;;;;;;;22733:151;54830:114;54918:18;;-1:-1:-1;;;;;54918:18:0;54830:114;;20864:100;20918:13;20951:5;20944:12;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;20864:100;:::o;23031:169::-;23114:4;23131:39;18652:10;23154:7;23163:6;23131:8;:39::i;:::-;-1:-1:-1;23188:4:0;23031:169;;;;:::o;55539:202::-;54112:7;;-1:-1:-1;;;54112:7:0;;;;54111:8;54103:38;;;;-1:-1:-1;;;54103:38:0;;8421:2:1;54103:38:0;;;8403:21:1;8460:2;8440:18;;;8433:30;-1:-1:-1;;;8479:18:1;;;8472:47;8536:18;;54103:38:0;;;;;;;;;54174:11;;-1:-1:-1;;;;;54174:11:0;54160:10;:25;54152:49;;;;-1:-1:-1;;;54152:49:0;;7678:2:1;54152:49:0;;;7660:21:1;7717:2;7697:18;;;7690:30;-1:-1:-1;;;7736:18:1;;;7729:41;7787:18;;54152:49:0;7650:161:1;54152:49:0;55641:18:::1;:39:::0;;-1:-1:-1;;55641:39:0::1;-1:-1:-1::0;;;;;55641:39:0;::::1;::::0;;::::1;::::0;;;55696:37:::1;::::0;2689:74:1;;;55696:37:0::1;::::0;2677:2:1;2662:18;55696:37:0::1;;;;;;;;55539:202:::0;:::o;55864:563::-;54371:7;;-1:-1:-1;;;54371:7:0;;;;54370:8;54362:38;;;;-1:-1:-1;;;54362:38:0;;8421:2:1;54362:38:0;;;8403:21:1;8460:2;8440:18;;;8433:30;-1:-1:-1;;;8479:18:1;;;8472:47;8536:18;;54362:38:0;8393:167:1;54362:38:0;54433:18;;-1:-1:-1;;;;;54433:18:0;54419:10;:32;54411:64;;;;-1:-1:-1;;;54411:64:0;;11791:2:1;54411:64:0;;;11773:21:1;11830:2;11810:18;;;11803:30;11869:21;11849:18;;;11842:49;11908:18;;54411:64:0;11763:169:1;54411:64:0;56167:18:::1;::::0;-1:-1:-1;;;;;56167:18:0::1;56159:62;;;::::0;-1:-1:-1;;;56159:62:0;;9935:2:1;56159:62:0::1;::::0;::::1;9917:21:1::0;9974:2;9954:18;;;9947:30;10013:17;9993:18;;;9986:45;10048:18;;56159:62:0::1;9907:165:1::0;56159:62:0::1;56256:11;::::0;;56292:18:::1;::::0;;-1:-1:-1;;;;;56292:18:0;;::::1;-1:-1:-1::0;;56278:32:0;;::::1;::::0;::::1;::::0;;;56321:33;;;::::1;::::0;;;56370:49:::1;::::0;;56256:11;;;::::1;3009:34:1::0;;;3074:2;3059:18;;3052:43;;;;56370:49:0::1;::::0;2921:18:1;56370:49:0::1;2903:198:1::0;23682:492:0;23822:4;23839:36;23849:6;23857:9;23868:6;23839:9;:36::i;:::-;-1:-1:-1;;;;;23915:19:0;;23888:24;23915:19;;;:11;:19;;;;;;;;18652:10;23915:33;;;;;;;;23967:26;;;;23959:79;;;;-1:-1:-1;;;23959:79:0;;11041:2:1;23959:79:0;;;11023:21:1;11080:2;11060:18;;;11053:30;11119:34;11099:18;;;11092:62;11190:10;11170:18;;;11163:38;11218:19;;23959:79:0;11013:230:1;23959:79:0;24074:57;24083:6;18652:10;24124:6;24105:16;:25;24074:8;:57::i;:::-;-1:-1:-1;24162:4:0;;23682:492;-1:-1:-1;;;;23682:492:0:o;61526:151::-;54112:7;;-1:-1:-1;;;54112:7:0;;;;54111:8;54103:38;;;;-1:-1:-1;;;54103:38:0;;8421:2:1;54103:38:0;;;8403:21:1;8460:2;8440:18;;;8433:30;-1:-1:-1;;;8479:18:1;;;8472:47;8536:18;;54103:38:0;8393:167:1;54103:38:0;54174:11;;-1:-1:-1;;;;;54174:11:0;54160:10;:25;54152:49;;;;-1:-1:-1;;;54152:49:0;;7678:2:1;54152:49:0;;;7660:21:1;7717:2;7697:18;;;7690:30;-1:-1:-1;;;7736:18:1;;;7729:41;7787:18;;54152:49:0;7650:161:1;54152:49:0;-1:-1:-1;;;;;61608:16:0;::::1;61627:5;61608:16:::0;;;:8:::1;:16;::::0;;;;;:24;;-1:-1:-1;;61608:24:0::1;::::0;;61648:21;::::1;::::0;61627:5;61648:21:::1;61526:151:::0;:::o;48058:115::-;48118:7;48145:20;:18;:20::i;:::-;48138:27;;48058:115;:::o;24583:215::-;18652:10;24671:4;24720:25;;;:11;:25;;;;;;;;-1:-1:-1;;;;;24720:34:0;;;;;;;;;;24671:4;;24688:80;;24711:7;;24720:47;;24757:10;;24720:47;:::i;:::-;24688:8;:80::i;60505:227::-;60651:10;60642:20;;;;:8;:20;;;;;;;;60634:40;;;;-1:-1:-1;;;60634:40:0;;6176:2:1;60634:40:0;;;6158:21:1;6215:1;6195:18;;;6188:29;6253:9;6233:18;;;6226:37;6280:18;;60634:40:0;6148:156:1;60634:40:0;60702:22;60708:7;60717:6;60702:5;:22::i;:::-;60505:227;;:::o;60858:92::-;60917:25;60923:10;60935:6;60917:5;:25::i;:::-;60858:92;:::o;47800:128::-;-1:-1:-1;;;;;47896:14:0;;47869:7;47896:14;;;:7;:14;;;;;45201;47896:24;47889:31;47800:128;-1:-1:-1;;47800:128:0:o;21083:104::-;21139:13;21172:7;21165:14;;;;;:::i;61134:203::-;54112:7;;-1:-1:-1;;;54112:7:0;;;;54111:8;54103:38;;;;-1:-1:-1;;;54103:38:0;;8421:2:1;54103:38:0;;;8403:21:1;8460:2;8440:18;;;8433:30;-1:-1:-1;;;8479:18:1;;;8472:47;8536:18;;54103:38:0;8393:167:1;54103:38:0;54174:11;;-1:-1:-1;;;;;54174:11:0;54160:10;:25;54152:49;;;;-1:-1:-1;;;54152:49:0;;7678:2:1;54152:49:0;;;7660:21:1;7717:2;7697:18;;;7690:30;-1:-1:-1;;;7736:18:1;;;7729:41;7787:18;;54152:49:0;7650:161:1;54152:49:0;-1:-1:-1;;;;;61221:22:0;::::1;61213:47;;;::::0;-1:-1:-1;;;61213:47:0;;11450:2:1;61213:47:0::1;::::0;::::1;11432:21:1::0;11489:2;11469:18;;;11462:30;11528:14;11508:18;;;11501:42;11560:18;;61213:47:0::1;11422:162:1::0;61213:47:0::1;-1:-1:-1::0;;;;;61271:16:0;::::1;;::::0;;;:8:::1;:16;::::0;;;;;:23;;-1:-1:-1;;61271:23:0::1;61290:4;61271:23;::::0;;61310:19;::::1;::::0;61271:16;61310:19:::1;61134:203:::0;:::o;25301:413::-;18652:10;25394:4;25438:25;;;:11;:25;;;;;;;;-1:-1:-1;;;;;25438:34:0;;;;;;;;;;25491:35;;;;25483:85;;;;-1:-1:-1;;;25483:85:0;;13352:2:1;25483:85:0;;;13334:21:1;13391:2;13371:18;;;13364:30;13430:34;13410:18;;;13403:62;13501:7;13481:18;;;13474:35;13526:19;;25483:85:0;13324:227:1;25483:85:0;25604:67;18652:10;25627:7;25655:15;25636:16;:34;25604:8;:67::i;:::-;-1:-1:-1;25702:4:0;;25301:413;-1:-1:-1;;;25301:413:0:o;22495:175::-;22581:4;22598:42;18652:10;22622:9;22633:6;22598:9;:42::i;56860:467::-;54112:7;;-1:-1:-1;;;54112:7:0;;;;54111:8;54103:38;;;;-1:-1:-1;;;54103:38:0;;8421:2:1;54103:38:0;;;8403:21:1;8460:2;8440:18;;;8433:30;-1:-1:-1;;;8479:18:1;;;8472:47;8536:18;;54103:38:0;8393:167:1;54103:38:0;54174:11;;-1:-1:-1;;;;;54174:11:0;54160:10;:25;54152:49;;;;-1:-1:-1;;;54152:49:0;;7678:2:1;54152:49:0;;;7660:21:1;7717:2;7697:18;;;7690:30;-1:-1:-1;;;7736:18:1;;;7729:41;7787:18;;54152:49:0;7650:161:1;54152:49:0;56930:7:::1;:14:::0;;57035:11:::1;:65:::0;;-1:-1:-1;;;;;;;57035:65:0;;::::1;::::0;::::1;::::0;;;57111:72;;;;;;;;;57199:86:::1;::::0;;57221:10:::1;3009:34:1::0;;3074:2;3059:18;;3052:43;;;;57199:86:0::1;::::0;2921:18:1;57199:86:0::1;;;;;;;57301:18;::::0;::::1;::::0;;;::::1;56860:467::o:0;47089:645::-;47333:8;47314:15;:27;;47306:69;;;;-1:-1:-1;;;47306:69:0;;8767:2:1;47306:69:0;;;8749:21:1;8806:2;8786:18;;;8779:30;8845:31;8825:18;;;8818:59;8894:18;;47306:69:0;8739:179:1;47306:69:0;47388:18;47430:16;47448:5;47455:7;47464:5;47471:16;47481:5;47471:9;:16::i;:::-;47419:79;;;;;;3767:25:1;;;;-1:-1:-1;;;;;3889:15:1;;;3869:18;;;3862:43;3941:15;;;;3921:18;;;3914:43;3973:18;;;3966:34;4016:19;;;4009:35;4060:19;;;4053:35;;;3739:19;;47419:79:0;;;;;;;;;;;;47409:90;;;;;;47388:111;;47512:12;47527:28;47544:10;47527:16;:28::i;:::-;47512:43;;47568:14;47585:28;47599:4;47605:1;47608;47611;47585:13;:28::i;:::-;47568:45;;47642:5;-1:-1:-1;;;;;47632:15:0;:6;-1:-1:-1;;;;;47632:15:0;;47624:58;;;;-1:-1:-1;;;47624:58:0;;10682:2:1;47624:58:0;;;10664:21:1;10721:2;10701:18;;;10694:30;10760:32;10740:18;;;10733:60;10810:18;;47624:58:0;10654:180:1;47624:58:0;47695:31;47704:5;47711:7;47720:5;47695:8;:31::i;:::-;47295:439;;;47089:645;;;;;;;:::o;28985:380::-;-1:-1:-1;;;;;29121:19:0;;29113:68;;;;-1:-1:-1;;;29113:68:0;;12947:2:1;29113:68:0;;;12929:21:1;12986:2;12966:18;;;12959:30;13025:34;13005:18;;;12998:62;-1:-1:-1;;;13076:18:1;;;13069:34;13120:19;;29113:68:0;12919:226:1;29113:68:0;-1:-1:-1;;;;;29200:21:0;;29192:68;;;;-1:-1:-1;;;29192:68:0;;8018:2:1;29192:68:0;;;8000:21:1;8057:2;8037:18;;;8030:30;8096:34;8076:18;;;8069:62;-1:-1:-1;;;8147:18:1;;;8140:32;8189:19;;29192:68:0;7990:224:1;29192:68:0;-1:-1:-1;;;;;29273:18:0;;;;;;;:11;:18;;;;;;;;:27;;;;;;;;;;;;;:36;;;29325:32;;3444:25:1;;;29325:32:0;;3417:18:1;29325:32:0;;;;;;;;28985:380;;;:::o;26204:733::-;-1:-1:-1;;;;;26344:20:0;;26336:70;;;;-1:-1:-1;;;26336:70:0;;12541:2:1;26336:70:0;;;12523:21:1;12580:2;12560:18;;;12553:30;12619:34;12599:18;;;12592:62;12690:7;12670:18;;;12663:35;12715:19;;26336:70:0;12513:227:1;26336:70:0;-1:-1:-1;;;;;26425:23:0;;26417:71;;;;-1:-1:-1;;;26417:71:0;;6511:2:1;26417:71:0;;;6493:21:1;6550:2;6530:18;;;6523:30;6589:34;6569:18;;;6562:62;-1:-1:-1;;;6640:18:1;;;6633:33;6683:19;;26417:71:0;6483:225:1;26417:71:0;-1:-1:-1;;;;;26585:17:0;;26561:21;26585:17;;;;;;;;;;;26621:23;;;;26613:74;;;;-1:-1:-1;;;26613:74:0;;9125:2:1;26613:74:0;;;9107:21:1;9164:2;9144:18;;;9137:30;9203:34;9183:18;;;9176:62;9274:8;9254:18;;;9247:36;9300:19;;26613:74:0;9097:228:1;26613:74:0;-1:-1:-1;;;;;26723:17:0;;;:9;:17;;;;;;;;;;;26743:22;;;26723:42;;26787:20;;;;;;;;:30;;26759:6;;26723:9;26787:30;;26759:6;;26787:30;:::i;:::-;;;;;;;;26852:9;-1:-1:-1;;;;;26835:35:0;26844:6;-1:-1:-1;;;;;26835:35:0;;26863:6;26835:35;;;;3444:25:1;;3432:2;3417:18;;3399:76;26835:35:0;;;;;;;;26325:612;26204:733;;;:::o;42917:281::-;42970:7;43011:16;42994:13;:33;42990:201;;;-1:-1:-1;43051:24:0;;42917:281::o;42990:201::-;-1:-1:-1;43387:73:0;;;43137:10;43387:73;;;;4358:25:1;;;;43149:12:0;4399:18:1;;;4392:34;43163:15:0;4442:18:1;;;4435:34;43431:13:0;4485:18:1;;;4478:34;43454:4:0;4528:19:1;;;;4521:84;;;;43387:73:0;;;;;;;;;;4330:19:1;;;;43387:73:0;;;43377:84;;;;;;48058:115::o;27224:399::-;-1:-1:-1;;;;;27308:21:0;;27300:65;;;;-1:-1:-1;;;27300:65:0;;13758:2:1;27300:65:0;;;13740:21:1;13797:2;13777:18;;;13770:30;13836:33;13816:18;;;13809:61;13887:18;;27300:65:0;13730:181:1;27300:65:0;27456:6;27440:12;;:22;;;;;;;:::i;:::-;;;;-1:-1:-1;;;;;;;27473:18:0;;:9;:18;;;;;;;;;;:28;;27495:6;;27473:9;:28;;27495:6;;27473:28;:::i;:::-;;;;-1:-1:-1;;27517:37:0;;3444:25:1;;;-1:-1:-1;;;;;27517:37:0;;;27534:1;;27517:37;;3432:2:1;3417:18;27517:37:0;;;;;;;60505:227;;:::o;27956:591::-;-1:-1:-1;;;;;28040:21:0;;28032:67;;;;-1:-1:-1;;;28032:67:0;;12139:2:1;28032:67:0;;;12121:21:1;12178:2;12158:18;;;12151:30;12217:34;12197:18;;;12190:62;-1:-1:-1;;;12268:18:1;;;12261:31;12309:19;;28032:67:0;12111:223:1;28032:67:0;-1:-1:-1;;;;;28199:18:0;;28174:22;28199:18;;;;;;;;;;;28236:24;;;;28228:71;;;;-1:-1:-1;;;28228:71:0;;6915:2:1;28228:71:0;;;6897:21:1;6954:2;6934:18;;;6927:30;6993:34;6973:18;;;6966:62;-1:-1:-1;;;7044:18:1;;;7037:32;7086:19;;28228:71:0;6887:224:1;28228:71:0;-1:-1:-1;;;;;28335:18:0;;:9;:18;;;;;;;;;;28356:23;;;28335:44;;28401:12;:22;;28373:6;;28335:9;28401:22;;28373:6;;28401:22;:::i;:::-;;;;-1:-1:-1;;28441:37:0;;3444:25:1;;;28467:1:0;;-1:-1:-1;;;;;28441:37:0;;;;;3432:2:1;3417:18;28441:37:0;3399:76:1;48311:207:0;-1:-1:-1;;;;;48432:14:0;;48371:15;48432:14;;;:7;:14;;;;;45201;;45338:1;45320:19;;;;45201:14;48493:17;48388:130;48311:207;;;:::o;44111:167::-;44188:7;44215:55;44237:20;:18;:20::i;:::-;44259:10;39765:57;;-1:-1:-1;;;39765:57:0;;;2404:27:1;2447:11;;;2440:27;;;2483:12;;;2476:28;;;39728:7:0;;2520:12:1;;39765:57:0;;;;;;;;;;;;39755:68;;;;;;39748:75;;39635:196;;;;;38437:279;38565:7;38586:17;38605:18;38627:25;38638:4;38644:1;38647;38650;38627:10;:25::i;:::-;38585:67;;;;38663:18;38675:5;38663:11;:18::i;:::-;-1:-1:-1;38699:9:0;38437:279;-1:-1:-1;;;;;38437:279:0:o;36666:1632::-;36797:7;;37731:66;37718:79;;37714:163;;;-1:-1:-1;37830:1:0;;-1:-1:-1;37834:30:0;37814:51;;37714:163;37891:1;:7;;37896:2;37891:7;;:18;;;;;37902:1;:7;;37907:2;37902:7;;37891:18;37887:102;;;-1:-1:-1;37942:1:0;;-1:-1:-1;37946:30:0;37926:51;;37887:102;38103:24;;;38086:14;38103:24;;;;;;;;;4843:25:1;;;4916:4;4904:17;;4884:18;;;4877:45;;;;4938:18;;;4931:34;;;4981:18;;;4974:34;;;38103:24:0;;4815:19:1;;38103:24:0;;;;;;;;;;;;;;;;;;;;;;;;;;;-1:-1:-1;;38103:24:0;;-1:-1:-1;;38103:24:0;;;-1:-1:-1;;;;;;;38142:20:0;;38138:103;;38195:1;38199:29;38179:50;;;;;;;38138:103;38261:6;-1:-1:-1;38269:20:0;;-1:-1:-1;36666:1632:0;;;;;;;;:::o;31328:643::-;31406:20;31397:5;:29;;;;;;;;:::i;:::-;;31393:571;;;31328:643;:::o;31393:571::-;31504:29;31495:5;:38;;;;;;;;:::i;:::-;;31491:473;;;31550:34;;-1:-1:-1;;;31550:34:0;;5823:2:1;31550:34:0;;;5805:21:1;5862:2;5842:18;;;5835:30;5901:26;5881:18;;;5874:54;5945:18;;31550:34:0;5795:174:1;31491:473:0;31615:35;31606:5;:44;;;;;;;;:::i;:::-;;31602:362;;;31667:41;;-1:-1:-1;;;31667:41:0;;7318:2:1;31667:41:0;;;7300:21:1;7357:2;7337:18;;;7330:30;7396:33;7376:18;;;7369:61;7447:18;;31667:41:0;7290:181:1;31602:362:0;31739:30;31730:5;:39;;;;;;;;:::i;:::-;;31726:238;;;31786:44;;-1:-1:-1;;;31786:44:0;;9532:2:1;31786:44:0;;;9514:21:1;9571:2;9551:18;;;9544:30;9610:34;9590:18;;;9583:62;-1:-1:-1;;;9661:18:1;;;9654:32;9703:19;;31786:44:0;9504:224:1;31726:238:0;31861:30;31852:5;:39;;;;;;;;:::i;:::-;;31848:116;;;31908:44;;-1:-1:-1;;;31908:44:0;;10279:2:1;31908:44:0;;;10261:21:1;10318:2;10298:18;;;10291:30;10357:34;10337:18;;;10330:62;-1:-1:-1;;;10408:18:1;;;10401:32;10450:19;;31908:44:0;10251:224:1;14:196;82:20;;-1:-1:-1;;;;;131:54:1;;121:65;;111:2;;200:1;197;190:12;111:2;63:147;;;:::o;215:186::-;274:6;327:2;315:9;306:7;302:23;298:32;295:2;;;343:1;340;333:12;295:2;366:29;385:9;366:29;:::i;:::-;356:39;285:116;-1:-1:-1;;;285:116:1:o;406:260::-;474:6;482;535:2;523:9;514:7;510:23;506:32;503:2;;;551:1;548;541:12;503:2;574:29;593:9;574:29;:::i;:::-;564:39;;622:38;656:2;645:9;641:18;622:38;:::i;:::-;612:48;;493:173;;;;;:::o;671:328::-;748:6;756;764;817:2;805:9;796:7;792:23;788:32;785:2;;;833:1;830;823:12;785:2;856:29;875:9;856:29;:::i;:::-;846:39;;904:38;938:2;927:9;923:18;904:38;:::i;:::-;894:48;;989:2;978:9;974:18;961:32;951:42;;775:224;;;;;:::o;1004:693::-;1115:6;1123;1131;1139;1147;1155;1163;1216:3;1204:9;1195:7;1191:23;1187:33;1184:2;;;1233:1;1230;1223:12;1184:2;1256:29;1275:9;1256:29;:::i;:::-;1246:39;;1304:38;1338:2;1327:9;1323:18;1304:38;:::i;:::-;1294:48;;1389:2;1378:9;1374:18;1361:32;1351:42;;1440:2;1429:9;1425:18;1412:32;1402:42;;1494:3;1483:9;1479:19;1466:33;1539:4;1532:5;1528:16;1521:5;1518:27;1508:2;;1559:1;1556;1549:12;1508:2;1174:523;;;;-1:-1:-1;1174:523:1;;;;1582:5;1634:3;1619:19;;1606:33;;-1:-1:-1;1686:3:1;1671:19;;;1658:33;;1174:523;-1:-1:-1;;1174:523:1:o;1702:254::-;1770:6;1778;1831:2;1819:9;1810:7;1806:23;1802:32;1799:2;;;1847:1;1844;1837:12;1799:2;1870:29;1889:9;1870:29;:::i;:::-;1860:39;1946:2;1931:18;;;;1918:32;;-1:-1:-1;;;1789:167:1:o;1961:180::-;2020:6;2073:2;2061:9;2052:7;2048:23;2044:32;2041:2;;;2089:1;2086;2079:12;2041:2;-1:-1:-1;2112:23:1;;2031:110;-1:-1:-1;2031:110:1:o;5019:597::-;5131:4;5160:2;5189;5178:9;5171:21;5221:6;5215:13;5264:6;5259:2;5248:9;5244:18;5237:34;5289:1;5299:140;5313:6;5310:1;5307:13;5299:140;;;5408:14;;;5404:23;;5398:30;5374:17;;;5393:2;5370:26;5363:66;5328:10;;5299:140;;;5457:6;5454:1;5451:13;5448:2;;;5527:1;5522:2;5513:6;5502:9;5498:22;5494:31;5487:42;5448:2;-1:-1:-1;5600:2:1;5579:15;-1:-1:-1;;5575:29:1;5560:45;;;;5607:2;5556:54;;5140:476;-1:-1:-1;;;5140:476:1:o;14287:128::-;14327:3;14358:1;14354:6;14351:1;14348:13;14345:2;;;14364:18;;:::i;:::-;-1:-1:-1;14400:9:1;;14335:80::o;14420:125::-;14460:4;14488:1;14485;14482:8;14479:2;;;14493:18;;:::i;:::-;-1:-1:-1;14530:9:1;;14469:76::o;14550:380::-;14629:1;14625:12;;;;14672;;;14693:2;;14747:4;14739:6;14735:17;14725:27;;14693:2;14800;14792:6;14789:14;14769:18;14766:38;14763:2;;;14846:10;14841:3;14837:20;14834:1;14827:31;14881:4;14878:1;14871:15;14909:4;14906:1;14899:15;14935:127;14996:10;14991:3;14987:20;14984:1;14977:31;15027:4;15024:1;15017:15;15051:4;15048:1;15041:15;15067:127;15128:10;15123:3;15119:20;15116:1;15109:31;15159:4;15156:1;15149:15;15183:4;15180:1;15173:15

ipfs://b63aec4ab6ec78dc412cdd794db187234c60fb87ce69ccf224f584799c04a9c5