Contract Source Code (Solidity)

IDE

• Blockscan IDE
• 🤖 Code ReaderBeta
• Remix IDE

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(address sender, ... 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(address sender, ...    - function increaseAllowance(address sp ...    - function decreaseAllowance(address sp ...    - function _transfer(address sender, ad ...    - function _mint(address account, uint2 ...    - function _burn(address account, uint2 ...    - function _approve(address owner, addr ...    - function _beforeTokenTransfer(address ... library Strings    - function toString(uint256 value)    - function toHexString(uint256 value)    - function toHexString(uint256 value, u ... interface IAccessControl    - function hasRole(bytes32 role, addres ...    - function getRoleAdmin(bytes32 role)    - function grantRole(bytes32 role, addr ...    - function revokeRole(bytes32 role, add ...    - function renounceRole(bytes32 role, a ... interface IERC165    - function supportsInterface(bytes4 int ...    - function supportsInterface(bytes4 int ...    - function supportsInterface(bytes4 int ...    - function hasRole(bytes32 role, addres ...    - function _checkRole(bytes32 role, add ...    - function getRoleAdmin(bytes32 role)    - function grantRole(bytes32 role, addr ...    - function revokeRole(bytes32 role, add ...    - function renounceRole(bytes32 role, a ...    - function _setupRole(bytes32 role, add ...    - function _setRoleAdmin(bytes32 role, ...    - function _grantRole(bytes32 role, add ...    - function _revokeRole(bytes32 role, ad ...  contract RibbonToken is AccessCont ... *    - function mint(address _recipient, uin ...    - function setTransfersAllowed(bool _tr ...    - function _beforeTokenTransfer(

More Options

• Similar
• Sol2Uml
• Submit Audit
• Compare

/**
 *Submitted for verification at Etherscan.io on 2021-05-24
*/

// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.0;

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

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

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

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

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

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

    /**
     * @dev Emitted when `value` tokens are moved from one account (`from`) to
     * another (`to`).
     *
     * Note that `value` may be zero.
     */
    event Transfer(address indexed from, address indexed to, uint256 value);

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

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);
}


/*
 * @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) {
        this; // silence state mutability warning without generating bytecode - see https://github.com/ethereum/solidity/issues/2691
        return msg.data;
    }
}

/**
 * @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 guidelines: functions revert instead
 * of 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 defaut 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");
        _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");
        _approve(_msgSender(), spender, currentAllowance - subtractedValue);

        return true;
    }

    /**
     * @dev Moves tokens `amount` from `sender` to `recipient`.
     *
     * This is 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");
        _balances[sender] = senderBalance - amount;
        _balances[recipient] += amount;

        emit Transfer(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:
     *
     * - `to` 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);
    }

    /**
     * @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");
        _balances[account] = accountBalance - amount;
        _totalSupply -= amount;

        emit Transfer(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 to 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 String operations.
 */
library Strings {
    bytes16 private constant alphabet = "0123456789abcdef";

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

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

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

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

}



/**
 * @dev External interface of AccessControl declared to support ERC165 detection.
 */
interface IAccessControl {
    function hasRole(bytes32 role, address account) external view returns (bool);
    function getRoleAdmin(bytes32 role) external view returns (bytes32);
    function grantRole(bytes32 role, address account) external;
    function revokeRole(bytes32 role, address account) external;
    function renounceRole(bytes32 role, address account) external;
}

interface IERC165 {
    /**
     * @dev Returns true if this contract implements the interface defined by
     * `interfaceId`. See the corresponding
     * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
     * to learn more about how these ids are created.
     *
     * This function call must use less than 30 000 gas.
     */
    function supportsInterface(bytes4 interfaceId) external view returns (bool);
}


abstract contract ERC165 is IERC165 {
    /**
     * @dev See {IERC165-supportsInterface}.
     */
    function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
        return interfaceId == type(IERC165).interfaceId;
    }
}

/**
 * @dev Contract module that allows children to implement role-based access
 * control mechanisms. This is a lightweight version that doesn't allow enumerating role
 * members except through off-chain means by accessing the contract event logs. Some
 * applications may benefit from on-chain enumerability, for those cases see
 * {AccessControlEnumerable}.
 *
 * Roles are referred to by their `bytes32` identifier. These should be exposed
 * in the external API and be unique. The best way to achieve this is by
 * using `public constant` hash digests:
 *
 * ```
 * bytes32 public constant MY_ROLE = keccak256("MY_ROLE");
 * ```
 *
 * Roles can be used to represent a set of permissions. To restrict access to a
 * function call, use {hasRole}:
 *
 * ```
 * function foo() public {
 *     require(hasRole(MY_ROLE, msg.sender));
 *     ...
 * }
 * ```
 *
 * Roles can be granted and revoked dynamically via the {grantRole} and
 * {revokeRole} functions. Each role has an associated admin role, and only
 * accounts that have a role's admin role can call {grantRole} and {revokeRole}.
 *
 * By default, the admin role for all roles is `DEFAULT_ADMIN_ROLE`, which means
 * that only accounts with this role will be able to grant or revoke other
 * roles. More complex role relationships can be created by using
 * {_setRoleAdmin}.
 *
 * WARNING: The `DEFAULT_ADMIN_ROLE` is also its own admin: it has permission to
 * grant and revoke this role. Extra precautions should be taken to secure
 * accounts that have been granted it.
 */
abstract contract AccessControl is Context, IAccessControl, ERC165 {
    struct RoleData {
        mapping (address => bool) members;
        bytes32 adminRole;
    }

    mapping (bytes32 => RoleData) private _roles;

    bytes32 public constant DEFAULT_ADMIN_ROLE = 0x00;

    /**
     * @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole`
     *
     * `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite
     * {RoleAdminChanged} not being emitted signaling this.
     *
     * _Available since v3.1._
     */
    event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole);

    /**
     * @dev Emitted when `account` is granted `role`.
     *
     * `sender` is the account that originated the contract call, an admin role
     * bearer except when using {_setupRole}.
     */
    event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender);

    /**
     * @dev Emitted when `account` is revoked `role`.
     *
     * `sender` is the account that originated the contract call:
     *   - if using `revokeRole`, it is the admin role bearer
     *   - if using `renounceRole`, it is the role bearer (i.e. `account`)
     */
    event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender);

    /**
     * @dev Modifier that checks that an account has a specific role. Reverts
     * with a standardized message including the required role.
     *
     * The format of the revert reason is given by the following regular expression:
     *
     *  /^AccessControl: account (0x[0-9a-f]{20}) is missing role (0x[0-9a-f]{32})$/
     *
     * _Available since v4.1._
     */
    modifier onlyRole(bytes32 role) {
        _checkRole(role, _msgSender());
        _;
    }

    /**
     * @dev See {IERC165-supportsInterface}.
     */
    function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
        return interfaceId == type(IAccessControl).interfaceId
            || super.supportsInterface(interfaceId);
    }

    /**
     * @dev Returns `true` if `account` has been granted `role`.
     */
    function hasRole(bytes32 role, address account) public view override returns (bool) {
        return _roles[role].members[account];
    }

    /**
     * @dev Revert with a standard message if `account` is missing `role`.
     *
     * The format of the revert reason is given by the following regular expression:
     *
     *  /^AccessControl: account (0x[0-9a-f]{20}) is missing role (0x[0-9a-f]{32})$/
     */
    function _checkRole(bytes32 role, address account) internal view {
        if(!hasRole(role, account)) {
            revert(string(abi.encodePacked(
                "AccessControl: account ",
                Strings.toHexString(uint160(account), 20),
                " is missing role ",
                Strings.toHexString(uint256(role), 32)
            )));
        }
    }

    /**
     * @dev Returns the admin role that controls `role`. See {grantRole} and
     * {revokeRole}.
     *
     * To change a role's admin, use {_setRoleAdmin}.
     */
    function getRoleAdmin(bytes32 role) public view override returns (bytes32) {
        return _roles[role].adminRole;
    }

    /**
     * @dev Grants `role` to `account`.
     *
     * If `account` had not been already granted `role`, emits a {RoleGranted}
     * event.
     *
     * Requirements:
     *
     * - the caller must have ``role``'s admin role.
     */
    function grantRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) {
        _grantRole(role, account);
    }

    /**
     * @dev Revokes `role` from `account`.
     *
     * If `account` had been granted `role`, emits a {RoleRevoked} event.
     *
     * Requirements:
     *
     * - the caller must have ``role``'s admin role.
     */
    function revokeRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) {
        _revokeRole(role, account);
    }

    /**
     * @dev Revokes `role` from the calling account.
     *
     * Roles are often managed via {grantRole} and {revokeRole}: this function's
     * purpose is to provide a mechanism for accounts to lose their privileges
     * if they are compromised (such as when a trusted device is misplaced).
     *
     * If the calling account had been granted `role`, emits a {RoleRevoked}
     * event.
     *
     * Requirements:
     *
     * - the caller must be `account`.
     */
    function renounceRole(bytes32 role, address account) public virtual override {
        require(account == _msgSender(), "AccessControl: can only renounce roles for self");

        _revokeRole(role, account);
    }

    /**
     * @dev Grants `role` to `account`.
     *
     * If `account` had not been already granted `role`, emits a {RoleGranted}
     * event. Note that unlike {grantRole}, this function doesn't perform any
     * checks on the calling account.
     *
     * [WARNING]
     * ====
     * This function should only be called from the constructor when setting
     * up the initial roles for the system.
     *
     * Using this function in any other way is effectively circumventing the admin
     * system imposed by {AccessControl}.
     * ====
     */
    function _setupRole(bytes32 role, address account) internal virtual {
        _grantRole(role, account);
    }

    /**
     * @dev Sets `adminRole` as ``role``'s admin role.
     *
     * Emits a {RoleAdminChanged} event.
     */
    function _setRoleAdmin(bytes32 role, bytes32 adminRole) internal virtual {
        emit RoleAdminChanged(role, getRoleAdmin(role), adminRole);
        _roles[role].adminRole = adminRole;
    }

    function _grantRole(bytes32 role, address account) private {
        if (!hasRole(role, account)) {
            _roles[role].members[account] = true;
            emit RoleGranted(role, account, _msgSender());
        }
    }

    function _revokeRole(bytes32 role, address account) private {
        if (hasRole(role, account)) {
            _roles[role].members[account] = false;
            emit RoleRevoked(role, account, _msgSender());
        }
    }
}



/**
 * RIBBON FINANCE: STRUCTURED PRODUCTS FOR THE PEOPLE
 */
contract RibbonToken is AccessControl, ERC20 {
    /// @dev The identifier of the role which maintains other roles.
    bytes32 public constant ADMIN_ROLE = keccak256("ADMIN");
    /// @dev The identifier of the role which allows accounts to mint tokens.
    bytes32 public constant MINTER_ROLE = keccak256("MINTER");
    /// @dev The identifier of the role which allows special transfer privileges.
    bytes32 public constant TRANSFER_ROLE = keccak256("TRANSFER");

    /// @dev bool flag of whether transfer is currently allowed for all people.
    bool public transfersAllowed = false;

    constructor(
        string memory name,
        string memory symbol,
        uint256 totalSupply,
        address beneficiary
    ) ERC20(name, symbol) {
        // We are minting initialSupply number of tokens
        _mint(beneficiary, totalSupply);
        // Add beneficiary as minter
        _setupRole(MINTER_ROLE, beneficiary);
        // Add beneficiary as transferer
        _setupRole(TRANSFER_ROLE, beneficiary);
        // Add beneficiary as admin
        _setupRole(ADMIN_ROLE, beneficiary);
        // Set ADMIN role as admin of transfer role
        _setRoleAdmin(TRANSFER_ROLE, ADMIN_ROLE);
    }

    /// @dev A modifier which checks that the caller has the minter role.
    modifier onlyMinter() {
        require(hasRole(MINTER_ROLE, msg.sender), "RibbonToken: only minter");
        _;
    }

    /// @dev A modifier which checks that the caller has the admin role.
    modifier onlyAdmin() {
        require(hasRole(ADMIN_ROLE, msg.sender), "RibbonToken: only admin");
        _;
    }

    /// @dev A modifier which checks that the caller has transfer privileges.
    modifier onlyTransferer(address from) {
        require(
            transfersAllowed ||
                from == address(0) ||
                hasRole(TRANSFER_ROLE, msg.sender),
            "RibbonToken: no transfer privileges"
        );
        _;
    }

    /// @dev Mints tokens to a recipient.
    ///
    /// This function reverts if the caller does not have the minter role.
    function mint(address _recipient, uint256 _amount) external onlyMinter {
        _mint(_recipient, _amount);
    }

    /// @dev Toggles transfer allowed flag.
    ///
    /// This function reverts if the caller does not have the admin role.
    function setTransfersAllowed(bool _transfersAllowed) external onlyAdmin {
        transfersAllowed = _transfersAllowed;
        emit TransfersAllowed(transfersAllowed);
    }

    /// @dev Hook that is called before any transfer of tokens.
    function _beforeTokenTransfer(
        address from,
        address to,
        uint256 amount
    ) internal virtual override onlyTransferer(from) {}

    /// @dev Emitted when transfer toggle is switched
    event TransfersAllowed(bool transfersAllowed);
}

• No Contract Security Audit Submitted- Submit Audit Here

[{"inputs":[{"internalType":"string","name":"name","type":"string"},{"internalType":"string","name":"symbol","type":"string"},{"internalType":"uint256","name":"totalSupply","type":"uint256"},{"internalType":"address","name":"beneficiary","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":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"previousAdminRole","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"newAdminRole","type":"bytes32"}],"name":"RoleAdminChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"RoleGranted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"RoleRevoked","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"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"bool","name":"transfersAllowed","type":"bool"}],"name":"TransfersAllowed","type":"event"},{"inputs":[],"name":"ADMIN_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEFAULT_ADMIN_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MINTER_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"TRANSFER_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","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":[],"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":[{"internalType":"bytes32","name":"role","type":"bytes32"}],"name":"getRoleAdmin","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"grantRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"hasRole","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":"_recipient","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":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"renounceRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"revokeRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bool","name":"_transfersAllowed","type":"bool"}],"name":"setTransfersAllowed","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"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"},{"inputs":[],"name":"transfersAllowed","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"}]

60806040526006805460ff191690553480156200001b57600080fd5b5060405162001b4b38038062001b4b8339810160408190526200003e91620004c7565b8351849084906200005790600490602085019062000376565b5080516200006d90600590602084019062000376565b5050506200008281836200011860201b60201c565b620000ae7ff0887ba65ee2024ea881d91b74c2450ef19e1557f03bed3ea9f16b037cbe2dc982620001ec565b620000c960008051602062001b2b83398151915282620001ec565b620000e460008051602062001b0b83398151915282620001ec565b6200010e60008051602062001b2b83398151915260008051602062001b0b833981519152620001fc565b5050505062000653565b6001600160a01b0382166200014a5760405162461bcd60e51b815260040162000141906200059b565b60405180910390fd5b620001586000838362000248565b80600360008282546200016c9190620005db565b90915550506001600160a01b038216600090815260016020526040812080548392906200019b908490620005db565b90915550506040516001600160a01b038316906000907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef90620001e0908590620005d2565b60405180910390a35050565b620001f88282620002aa565b5050565b80620002088362000334565b60405184907fbd79b86ffe0ab8e8776151514217cd7cacd52c909f66475c3af44e129f0b00ff90600090a460009182526020829052604090912060010155565b600654839060ff16806200026357506001600160a01b038116155b806200028557506200028560008051602062001b2b8339815191523362000349565b620002a45760405162461bcd60e51b8152600401620001419062000558565b50505050565b620002b6828262000349565b620001f8576000828152602081815260408083206001600160a01b03851684529091529020805460ff19166001179055620002f062000372565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b60009081526020819052604090206001015490565b6000918252602082815260408084206001600160a01b0393909316845291905290205460ff1690565b3390565b828054620003849062000600565b90600052602060002090601f016020900481019282620003a85760008555620003f3565b82601f10620003c357805160ff1916838001178555620003f3565b82800160010185558215620003f3579182015b82811115620003f3578251825591602001919060010190620003d6565b506200040192915062000405565b5090565b5b8082111562000401576000815560010162000406565b600082601f8301126200042d578081fd5b81516001600160401b03808211156200044a576200044a6200063d565b6040516020601f8401601f19168201810183811183821017156200047257620004726200063d565b604052838252858401810187101562000489578485fd5b8492505b83831015620004ac57858301810151828401820152918201916200048d565b83831115620004bd57848185840101525b5095945050505050565b60008060008060808587031215620004dd578384fd5b84516001600160401b0380821115620004f4578586fd5b62000502888389016200041c565b9550602087015191508082111562000518578485fd5b5062000527878288016200041c565b60408701516060880151919550935090506001600160a01b03811681146200054d578182fd5b939692955090935050565b60208082526023908201527f526962626f6e546f6b656e3a206e6f207472616e736665722070726976696c6560408201526267657360e81b606082015260800190565b6020808252601f908201527f45524332303a206d696e7420746f20746865207a65726f206164647265737300604082015260600190565b90815260200190565b60008219821115620005fb57634e487b7160e01b81526011600452602481fd5b500190565b6002810460018216806200061557607f821691505b602082108114156200063757634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052604160045260246000fd5b6114a880620006636000396000f3fe608060405234801561001057600080fd5b50600436106101585760003560e01c806370a08231116100c3578063a9059cbb1161007c578063a9059cbb146102a5578063b0660c3d146102b8578063d5391393146102c0578063d547741f146102c8578063dd62ed3e146102db578063f3cd1c28146102ee57610158565b806370a082311461025457806375b238fc1461026757806391d148541461026f57806395d89b4114610282578063a217fddf1461028a578063a457c2d71461029257610158565b8063248a9ca311610115578063248a9ca3146101de5780632f2ff15d146101f1578063313ce5671461020657806336568abe1461021b578063395093511461022e57806340c10f191461024157610158565b806301ffc9a71461015d57806306fdde0314610186578063095ea7b31461019b57806318160ddd146101ae578063206b60f9146101c357806323b872dd146101cb575b600080fd5b61017061016b366004610f51565b610301565b60405161017d9190610fee565b60405180910390f35b61018e61032e565b60405161017d9190611002565b6101706101a9366004610ece565b6103c0565b6101b66103dd565b60405161017d9190610ff9565b6101b66103e3565b6101706101d9366004610e93565b610407565b6101b66101ec366004610f17565b6104a7565b6102046101ff366004610f2f565b6104bc565b005b61020e6104e5565b60405161017d9190611382565b610204610229366004610f2f565b6104ea565b61017061023c366004610ece565b610530565b61020461024f366004610ece565b61057f565b6101b6610262366004610e47565b6105cf565b6101b66105ea565b61017061027d366004610f2f565b61060e565b61018e610637565b6101b6610646565b6101706102a0366004610ece565b61064b565b6101706102b3366004610ece565b6106c6565b6101706106da565b6101b66106e3565b6102046102d6366004610f2f565b610707565b6101b66102e9366004610e61565b610726565b6102046102fc366004610ef7565b610751565b60006001600160e01b03198216637965db0b60e01b14806103265750610326826107e6565b90505b919050565b60606004805461033d90611421565b80601f016020809104026020016040519081016040528092919081815260200182805461036990611421565b80156103b65780601f1061038b576101008083540402835291602001916103b6565b820191906000526020600020905b81548152906001019060200180831161039957829003601f168201915b5050505050905090565b60006103d46103cd6107ff565b8484610803565b50600192915050565b60035490565b7f9143236d81225394f3bd65b44e6e29fdf4d7ba0773d9bb3f5cc15eb80ba3777781565b60006104148484846108b7565b6001600160a01b0384166000908152600260205260408120816104356107ff565b6001600160a01b03166001600160a01b03168152602001908152602001600020549050828110156104815760405162461bcd60e51b8152600401610478906111e6565b60405180910390fd5b61049c8561048d6107ff565b61049786856113c7565b610803565b506001949350505050565b60009081526020819052604090206001015490565b6104c5826104a7565b6104d6816104d16107ff565b6109df565b6104e08383610a43565b505050565b601290565b6104f26107ff565b6001600160a01b0316816001600160a01b0316146105225760405162461bcd60e51b8152600401610478906112fc565b61052c8282610ac8565b5050565b60006103d461053d6107ff565b84846002600061054b6107ff565b6001600160a01b03908116825260208083019390935260409182016000908120918b16815292529020546104979190611390565b6105a97ff0887ba65ee2024ea881d91b74c2450ef19e1557f03bed3ea9f16b037cbe2dc93361060e565b6105c55760405162461bcd60e51b815260040161047890611132565b61052c8282610b4b565b6001600160a01b031660009081526001602052604090205490565b7fdf8b4c520ffe197c5343c6f5aec59570151ef9a492f2c624fd45ddde6135ec4281565b6000918252602082815260408084206001600160a01b0393909316845291905290205460ff1690565b60606005805461033d90611421565b600081565b6000806002600061065a6107ff565b6001600160a01b03908116825260208083019390935260409182016000908120918816815292529020549050828110156106a65760405162461bcd60e51b8152600401610478906112b7565b6106bc6106b16107ff565b8561049786856113c7565b5060019392505050565b60006103d46106d36107ff565b84846108b7565b60065460ff1681565b7ff0887ba65ee2024ea881d91b74c2450ef19e1557f03bed3ea9f16b037cbe2dc981565b610710826104a7565b61071c816104d16107ff565b6104e08383610ac8565b6001600160a01b03918216600090815260026020908152604080832093909416825291909152205490565b61077b7fdf8b4c520ffe197c5343c6f5aec59570151ef9a492f2c624fd45ddde6135ec423361060e565b6107975760405162461bcd60e51b8152600401610478906111af565b6006805460ff191682151517908190556040517f5854ddf9a9b69cf8f2802ec78fb8d6bbf299e949955d9361212e652f4fec0e82916107db9160ff90911690610fee565b60405180910390a150565b6001600160e01b031981166301ffc9a760e01b14919050565b3390565b6001600160a01b0383166108295760405162461bcd60e51b815260040161047890611273565b6001600160a01b03821661084f5760405162461bcd60e51b8152600401610478906110f0565b6001600160a01b0380841660008181526002602090815260408083209487168084529490915290819020849055517f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925906108aa908590610ff9565b60405180910390a3505050565b6001600160a01b0383166108dd5760405162461bcd60e51b81526004016104789061122e565b6001600160a01b0382166109035760405162461bcd60e51b81526004016104789061106a565b61090e838383610c0b565b6001600160a01b038316600090815260016020526040902054818110156109475760405162461bcd60e51b815260040161047890611169565b61095182826113c7565b6001600160a01b038086166000908152600160205260408082209390935590851681529081208054849290610987908490611390565b92505081905550826001600160a01b0316846001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef846040516109d19190610ff9565b60405180910390a350505050565b6109e9828261060e565b61052c57610a01816001600160a01b03166014610c77565b610a0c836020610c77565b604051602001610a1d929190610f79565b60408051601f198184030181529082905262461bcd60e51b825261047891600401611002565b610a4d828261060e565b61052c576000828152602081815260408083206001600160a01b03851684529091529020805460ff19166001179055610a846107ff565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b610ad2828261060e565b1561052c576000828152602081815260408083206001600160a01b03851684529091529020805460ff19169055610b076107ff565b6001600160a01b0316816001600160a01b0316837ff6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b60405160405180910390a45050565b6001600160a01b038216610b715760405162461bcd60e51b81526004016104789061134b565b610b7d60008383610c0b565b8060036000828254610b8f9190611390565b90915550506001600160a01b03821660009081526001602052604081208054839290610bbc908490611390565b90915550506040516001600160a01b038316906000907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef90610bff908590610ff9565b60405180910390a35050565b600654839060ff1680610c2557506001600160a01b038116155b80610c555750610c557f9143236d81225394f3bd65b44e6e29fdf4d7ba0773d9bb3f5cc15eb80ba377773361060e565b610c715760405162461bcd60e51b8152600401610478906110ad565b50505050565b60606000610c868360026113a8565b610c91906002611390565b67ffffffffffffffff811115610cb757634e487b7160e01b600052604160045260246000fd5b6040519080825280601f01601f191660200182016040528015610ce1576020820181803683370190505b509050600360fc1b81600081518110610d0a57634e487b7160e01b600052603260045260246000fd5b60200101906001600160f81b031916908160001a905350600f60fb1b81600181518110610d4757634e487b7160e01b600052603260045260246000fd5b60200101906001600160f81b031916908160001a9053506000610d6b8460026113a8565b610d76906001611390565b90505b6001811115610e0a576f181899199a1a9b1b9c1cb0b131b232b360811b85600f1660108110610db857634e487b7160e01b600052603260045260246000fd5b1a60f81b828281518110610ddc57634e487b7160e01b600052603260045260246000fd5b60200101906001600160f81b031916908160001a90535060049490941c93610e038161140a565b9050610d79565b508315610e295760405162461bcd60e51b815260040161047890611035565b9392505050565b80356001600160a01b038116811461032957600080fd5b600060208284031215610e58578081fd5b610e2982610e30565b60008060408385031215610e73578081fd5b610e7c83610e30565b9150610e8a60208401610e30565b90509250929050565b600080600060608486031215610ea7578081fd5b610eb084610e30565b9250610ebe60208501610e30565b9150604084013590509250925092565b60008060408385031215610ee0578182fd5b610ee983610e30565b946020939093013593505050565b600060208284031215610f08578081fd5b81358015158114610e29578182fd5b600060208284031215610f28578081fd5b5035919050565b60008060408385031215610f41578182fd5b82359150610e8a60208401610e30565b600060208284031215610f62578081fd5b81356001600160e01b031981168114610e29578182fd5b60007f416363657373436f6e74726f6c3a206163636f756e742000000000000000000082528351610fb18160178501602088016113de565b7001034b99036b4b9b9b4b733903937b6329607d1b6017918401918201528351610fe28160288401602088016113de565b01602801949350505050565b901515815260200190565b90815260200190565b60006020825282518060208401526110218160408501602087016113de565b601f01601f19169190910160400192915050565b6020808252818101527f537472696e67733a20686578206c656e67746820696e73756666696369656e74604082015260600190565b60208082526023908201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260408201526265737360e81b606082015260800190565b60208082526023908201527f526962626f6e546f6b656e3a206e6f207472616e736665722070726976696c6560408201526267657360e81b606082015260800190565b60208082526022908201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604082015261737360f01b606082015260800190565b60208082526018908201527f526962626f6e546f6b656e3a206f6e6c79206d696e7465720000000000000000604082015260600190565b60208082526026908201527f45524332303a207472616e7366657220616d6f756e7420657863656564732062604082015265616c616e636560d01b606082015260800190565b60208082526017908201527f526962626f6e546f6b656e3a206f6e6c792061646d696e000000000000000000604082015260600190565b60208082526028908201527f45524332303a207472616e7366657220616d6f756e74206578636565647320616040820152676c6c6f77616e636560c01b606082015260800190565b60208082526025908201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604082015264647265737360d81b606082015260800190565b60208082526024908201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646040820152637265737360e01b606082015260800190565b60208082526025908201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604082015264207a65726f60d81b606082015260800190565b6020808252602f908201527f416363657373436f6e74726f6c3a2063616e206f6e6c792072656e6f756e636560408201526e103937b632b9903337b91039b2b63360891b606082015260800190565b6020808252601f908201527f45524332303a206d696e7420746f20746865207a65726f206164647265737300604082015260600190565b60ff91909116815260200190565b600082198211156113a3576113a361145c565b500190565b60008160001904831182151516156113c2576113c261145c565b500290565b6000828210156113d9576113d961145c565b500390565b60005b838110156113f95781810151838201526020016113e1565b83811115610c715750506000910152565b6000816114195761141961145c565b506000190190565b60028104600182168061143557607f821691505b6020821081141561145657634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052601160045260246000fdfea2646970667358221220cbdf4d24037437ded46f28fea2c5650c1b010d7150ff416b5454d2bebd2d16c064736f6c63430008000033df8b4c520ffe197c5343c6f5aec59570151ef9a492f2c624fd45ddde6135ec429143236d81225394f3bd65b44e6e29fdf4d7ba0773d9bb3f5cc15eb80ba37777000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000c00000000000000000000000000000000000000000033b2e3c9fd0803ce8000000000000000000000000000000daeada3d210d2f45874724beea03c7d4bbd416740000000000000000000000000000000000000000000000000000000000000006526962626f6e0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000352424e0000000000000000000000000000000000000000000000000000000000

0x608060405234801561001057600080fd5b50600436106101585760003560e01c806370a08231116100c3578063a9059cbb1161007c578063a9059cbb146102a5578063b0660c3d146102b8578063d5391393146102c0578063d547741f146102c8578063dd62ed3e146102db578063f3cd1c28146102ee57610158565b806370a082311461025457806375b238fc1461026757806391d148541461026f57806395d89b4114610282578063a217fddf1461028a578063a457c2d71461029257610158565b8063248a9ca311610115578063248a9ca3146101de5780632f2ff15d146101f1578063313ce5671461020657806336568abe1461021b578063395093511461022e57806340c10f191461024157610158565b806301ffc9a71461015d57806306fdde0314610186578063095ea7b31461019b57806318160ddd146101ae578063206b60f9146101c357806323b872dd146101cb575b600080fd5b61017061016b366004610f51565b610301565b60405161017d9190610fee565b60405180910390f35b61018e61032e565b60405161017d9190611002565b6101706101a9366004610ece565b6103c0565b6101b66103dd565b60405161017d9190610ff9565b6101b66103e3565b6101706101d9366004610e93565b610407565b6101b66101ec366004610f17565b6104a7565b6102046101ff366004610f2f565b6104bc565b005b61020e6104e5565b60405161017d9190611382565b610204610229366004610f2f565b6104ea565b61017061023c366004610ece565b610530565b61020461024f366004610ece565b61057f565b6101b6610262366004610e47565b6105cf565b6101b66105ea565b61017061027d366004610f2f565b61060e565b61018e610637565b6101b6610646565b6101706102a0366004610ece565b61064b565b6101706102b3366004610ece565b6106c6565b6101706106da565b6101b66106e3565b6102046102d6366004610f2f565b610707565b6101b66102e9366004610e61565b610726565b6102046102fc366004610ef7565b610751565b60006001600160e01b03198216637965db0b60e01b14806103265750610326826107e6565b90505b919050565b60606004805461033d90611421565b80601f016020809104026020016040519081016040528092919081815260200182805461036990611421565b80156103b65780601f1061038b576101008083540402835291602001916103b6565b820191906000526020600020905b81548152906001019060200180831161039957829003601f168201915b5050505050905090565b60006103d46103cd6107ff565b8484610803565b50600192915050565b60035490565b7f9143236d81225394f3bd65b44e6e29fdf4d7ba0773d9bb3f5cc15eb80ba3777781565b60006104148484846108b7565b6001600160a01b0384166000908152600260205260408120816104356107ff565b6001600160a01b03166001600160a01b03168152602001908152602001600020549050828110156104815760405162461bcd60e51b8152600401610478906111e6565b60405180910390fd5b61049c8561048d6107ff565b61049786856113c7565b610803565b506001949350505050565b60009081526020819052604090206001015490565b6104c5826104a7565b6104d6816104d16107ff565b6109df565b6104e08383610a43565b505050565b601290565b6104f26107ff565b6001600160a01b0316816001600160a01b0316146105225760405162461bcd60e51b8152600401610478906112fc565b61052c8282610ac8565b5050565b60006103d461053d6107ff565b84846002600061054b6107ff565b6001600160a01b03908116825260208083019390935260409182016000908120918b16815292529020546104979190611390565b6105a97ff0887ba65ee2024ea881d91b74c2450ef19e1557f03bed3ea9f16b037cbe2dc93361060e565b6105c55760405162461bcd60e51b815260040161047890611132565b61052c8282610b4b565b6001600160a01b031660009081526001602052604090205490565b7fdf8b4c520ffe197c5343c6f5aec59570151ef9a492f2c624fd45ddde6135ec4281565b6000918252602082815260408084206001600160a01b0393909316845291905290205460ff1690565b60606005805461033d90611421565b600081565b6000806002600061065a6107ff565b6001600160a01b03908116825260208083019390935260409182016000908120918816815292529020549050828110156106a65760405162461bcd60e51b8152600401610478906112b7565b6106bc6106b16107ff565b8561049786856113c7565b5060019392505050565b60006103d46106d36107ff565b84846108b7565b60065460ff1681565b7ff0887ba65ee2024ea881d91b74c2450ef19e1557f03bed3ea9f16b037cbe2dc981565b610710826104a7565b61071c816104d16107ff565b6104e08383610ac8565b6001600160a01b03918216600090815260026020908152604080832093909416825291909152205490565b61077b7fdf8b4c520ffe197c5343c6f5aec59570151ef9a492f2c624fd45ddde6135ec423361060e565b6107975760405162461bcd60e51b8152600401610478906111af565b6006805460ff191682151517908190556040517f5854ddf9a9b69cf8f2802ec78fb8d6bbf299e949955d9361212e652f4fec0e82916107db9160ff90911690610fee565b60405180910390a150565b6001600160e01b031981166301ffc9a760e01b14919050565b3390565b6001600160a01b0383166108295760405162461bcd60e51b815260040161047890611273565b6001600160a01b03821661084f5760405162461bcd60e51b8152600401610478906110f0565b6001600160a01b0380841660008181526002602090815260408083209487168084529490915290819020849055517f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925906108aa908590610ff9565b60405180910390a3505050565b6001600160a01b0383166108dd5760405162461bcd60e51b81526004016104789061122e565b6001600160a01b0382166109035760405162461bcd60e51b81526004016104789061106a565b61090e838383610c0b565b6001600160a01b038316600090815260016020526040902054818110156109475760405162461bcd60e51b815260040161047890611169565b61095182826113c7565b6001600160a01b038086166000908152600160205260408082209390935590851681529081208054849290610987908490611390565b92505081905550826001600160a01b0316846001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef846040516109d19190610ff9565b60405180910390a350505050565b6109e9828261060e565b61052c57610a01816001600160a01b03166014610c77565b610a0c836020610c77565b604051602001610a1d929190610f79565b60408051601f198184030181529082905262461bcd60e51b825261047891600401611002565b610a4d828261060e565b61052c576000828152602081815260408083206001600160a01b03851684529091529020805460ff19166001179055610a846107ff565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b610ad2828261060e565b1561052c576000828152602081815260408083206001600160a01b03851684529091529020805460ff19169055610b076107ff565b6001600160a01b0316816001600160a01b0316837ff6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b60405160405180910390a45050565b6001600160a01b038216610b715760405162461bcd60e51b81526004016104789061134b565b610b7d60008383610c0b565b8060036000828254610b8f9190611390565b90915550506001600160a01b03821660009081526001602052604081208054839290610bbc908490611390565b90915550506040516001600160a01b038316906000907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef90610bff908590610ff9565b60405180910390a35050565b600654839060ff1680610c2557506001600160a01b038116155b80610c555750610c557f9143236d81225394f3bd65b44e6e29fdf4d7ba0773d9bb3f5cc15eb80ba377773361060e565b610c715760405162461bcd60e51b8152600401610478906110ad565b50505050565b60606000610c868360026113a8565b610c91906002611390565b67ffffffffffffffff811115610cb757634e487b7160e01b600052604160045260246000fd5b6040519080825280601f01601f191660200182016040528015610ce1576020820181803683370190505b509050600360fc1b81600081518110610d0a57634e487b7160e01b600052603260045260246000fd5b60200101906001600160f81b031916908160001a905350600f60fb1b81600181518110610d4757634e487b7160e01b600052603260045260246000fd5b60200101906001600160f81b031916908160001a9053506000610d6b8460026113a8565b610d76906001611390565b90505b6001811115610e0a576f181899199a1a9b1b9c1cb0b131b232b360811b85600f1660108110610db857634e487b7160e01b600052603260045260246000fd5b1a60f81b828281518110610ddc57634e487b7160e01b600052603260045260246000fd5b60200101906001600160f81b031916908160001a90535060049490941c93610e038161140a565b9050610d79565b508315610e295760405162461bcd60e51b815260040161047890611035565b9392505050565b80356001600160a01b038116811461032957600080fd5b600060208284031215610e58578081fd5b610e2982610e30565b60008060408385031215610e73578081fd5b610e7c83610e30565b9150610e8a60208401610e30565b90509250929050565b600080600060608486031215610ea7578081fd5b610eb084610e30565b9250610ebe60208501610e30565b9150604084013590509250925092565b60008060408385031215610ee0578182fd5b610ee983610e30565b946020939093013593505050565b600060208284031215610f08578081fd5b81358015158114610e29578182fd5b600060208284031215610f28578081fd5b5035919050565b60008060408385031215610f41578182fd5b82359150610e8a60208401610e30565b600060208284031215610f62578081fd5b81356001600160e01b031981168114610e29578182fd5b60007f416363657373436f6e74726f6c3a206163636f756e742000000000000000000082528351610fb18160178501602088016113de565b7001034b99036b4b9b9b4b733903937b6329607d1b6017918401918201528351610fe28160288401602088016113de565b01602801949350505050565b901515815260200190565b90815260200190565b60006020825282518060208401526110218160408501602087016113de565b601f01601f19169190910160400192915050565b6020808252818101527f537472696e67733a20686578206c656e67746820696e73756666696369656e74604082015260600190565b60208082526023908201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260408201526265737360e81b606082015260800190565b60208082526023908201527f526962626f6e546f6b656e3a206e6f207472616e736665722070726976696c6560408201526267657360e81b606082015260800190565b60208082526022908201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604082015261737360f01b606082015260800190565b60208082526018908201527f526962626f6e546f6b656e3a206f6e6c79206d696e7465720000000000000000604082015260600190565b60208082526026908201527f45524332303a207472616e7366657220616d6f756e7420657863656564732062604082015265616c616e636560d01b606082015260800190565b60208082526017908201527f526962626f6e546f6b656e3a206f6e6c792061646d696e000000000000000000604082015260600190565b60208082526028908201527f45524332303a207472616e7366657220616d6f756e74206578636565647320616040820152676c6c6f77616e636560c01b606082015260800190565b60208082526025908201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604082015264647265737360d81b606082015260800190565b60208082526024908201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646040820152637265737360e01b606082015260800190565b60208082526025908201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604082015264207a65726f60d81b606082015260800190565b6020808252602f908201527f416363657373436f6e74726f6c3a2063616e206f6e6c792072656e6f756e636560408201526e103937b632b9903337b91039b2b63360891b606082015260800190565b6020808252601f908201527f45524332303a206d696e7420746f20746865207a65726f206164647265737300604082015260600190565b60ff91909116815260200190565b600082198211156113a3576113a361145c565b500190565b60008160001904831182151516156113c2576113c261145c565b500290565b6000828210156113d9576113d961145c565b500390565b60005b838110156113f95781810151838201526020016113e1565b83811115610c715750506000910152565b6000816114195761141961145c565b506000190190565b60028104600182168061143557607f821691505b6020821081141561145657634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052601160045260246000fdfea2646970667358221220cbdf4d24037437ded46f28fea2c5650c1b010d7150ff416b5454d2bebd2d16c064736f6c63430008000033

26097:2899:0:-:0;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;21562:217;;;;;;:::i;:::-;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;6060:100;;;:::i;:::-;;;;;;;:::i;8227:169::-;;;;;;:::i;:::-;;:::i;7180:108::-;;;:::i;:::-;;;;;;;:::i;26507:61::-;;;:::i;8878:422::-;;;;;;:::i;:::-;;:::i;22873:123::-;;;;;;:::i;:::-;;:::i;23258:147::-;;;;;;:::i;:::-;;:::i;:::-;;7022:93;;;:::i;:::-;;;;;;;:::i;24306:218::-;;;;;;:::i;:::-;;:::i;9709:215::-;;;;;;:::i;:::-;;:::i;28226:116::-;;;;;;:::i;:::-;;:::i;7351:127::-;;;;;;:::i;:::-;;:::i;26219:55::-;;;:::i;21871:139::-;;;;;;:::i;:::-;;:::i;6279:104::-;;;:::i;19836:49::-;;;:::i;10427:377::-;;;;;;:::i;:::-;;:::i;7691:175::-;;;;;;:::i;:::-;;:::i;26658:36::-;;;:::i;26360:57::-;;;:::i;23650:149::-;;;;;;:::i;:::-;;:::i;7929:151::-;;;;;;:::i;:::-;;:::i;28479:177::-;;;;;;:::i;:::-;;:::i;21562:217::-;21647:4;-1:-1:-1;;;;;;21671:47:0;;-1:-1:-1;;;21671:47:0;;:100;;;21735:36;21759:11;21735:23;:36::i;:::-;21664:107;;21562:217;;;;:::o;6060:100::-;6114:13;6147:5;6140:12;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6060:100;:::o;8227:169::-;8310:4;8327:39;8336:12;:10;:12::i;:::-;8350:7;8359:6;8327:8;:39::i;:::-;-1:-1:-1;8384:4:0;8227:169;;;;:::o;7180:108::-;7268:12;;7180:108;:::o;26507:61::-;26547:21;26507:61;:::o;8878:422::-;8984:4;9001:36;9011:6;9019:9;9030:6;9001:9;:36::i;:::-;-1:-1:-1;;;;;9077:19:0;;9050:24;9077:19;;;:11;:19;;;;;9050:24;9097:12;:10;:12::i;:::-;-1:-1:-1;;;;;9077:33:0;-1:-1:-1;;;;;9077:33:0;;;;;;;;;;;;;9050:60;;9149:6;9129:16;:26;;9121:79;;;;-1:-1:-1;;;9121:79:0;;;;;;;:::i;:::-;;;;;;;;;9211:57;9220:6;9228:12;:10;:12::i;:::-;9242:25;9261:6;9242:16;:25;:::i;:::-;9211:8;:57::i;:::-;-1:-1:-1;9288:4:0;;8878:422;-1:-1:-1;;;;8878:422:0:o;22873:123::-;22939:7;22966:12;;;;;;;;;;:22;;;;22873:123::o;23258:147::-;23341:18;23354:4;23341:12;:18::i;:::-;21440:30;21451:4;21457:12;:10;:12::i;:::-;21440:10;:30::i;:::-;23372:25:::1;23383:4;23389:7;23372:10;:25::i;:::-;23258:147:::0;;;:::o;7022:93::-;7105:2;7022:93;:::o;24306:218::-;24413:12;:10;:12::i;:::-;-1:-1:-1;;;;;24402:23:0;:7;-1:-1:-1;;;;;24402:23:0;;24394:83;;;;-1:-1:-1;;;24394:83:0;;;;;;;:::i;:::-;24490:26;24502:4;24508:7;24490:11;:26::i;:::-;24306:218;;:::o;9709:215::-;9797:4;9814:80;9823:12;:10;:12::i;:::-;9837:7;9883:10;9846:11;:25;9858:12;:10;:12::i;:::-;-1:-1:-1;;;;;9846:25:0;;;;;;;;;;;;;;;;;-1:-1:-1;9846:25:0;;;:34;;;;;;;;;;:47;;;;:::i;28226:116::-;27457:32;26398:19;27478:10;27457:7;:32::i;:::-;27449:69;;;;-1:-1:-1;;;27449:69:0;;;;;;;:::i;:::-;28308:26:::1;28314:10;28326:7;28308:5;:26::i;7351:127::-:0;-1:-1:-1;;;;;7452:18:0;7425:7;7452:18;;;:9;:18;;;;;;;7351:127::o;26219:55::-;26256:18;26219:55;:::o;21871:139::-;21949:4;21973:12;;;;;;;;;;;-1:-1:-1;;;;;21973:29:0;;;;;;;;;;;;;;;21871:139::o;6279:104::-;6335:13;6368:7;6361:14;;;;;:::i;19836:49::-;19881:4;19836:49;:::o;10427:377::-;10520:4;10537:24;10564:11;:25;10576:12;:10;:12::i;:::-;-1:-1:-1;;;;;10564:25:0;;;;;;;;;;;;;;;;;-1:-1:-1;10564:25:0;;;:34;;;;;;;;;;;-1:-1:-1;10617:35:0;;;;10609:85;;;;-1:-1:-1;;;10609:85:0;;;;;;;:::i;:::-;10705:67;10714:12;:10;:12::i;:::-;10728:7;10737:34;10756:15;10737:16;:34;:::i;10705:67::-;-1:-1:-1;10792:4:0;;10427:377;-1:-1:-1;;;10427:377:0:o;7691:175::-;7777:4;7794:42;7804:12;:10;:12::i;:::-;7818:9;7829:6;7794:9;:42::i;26658:36::-;;;;;;:::o;26360:57::-;26398:19;26360:57;:::o;23650:149::-;23734:18;23747:4;23734:12;:18::i;:::-;21440:30;21451:4;21457:12;:10;:12::i;21440:30::-;23765:26:::1;23777:4;23783:7;23765:11;:26::i;7929:151::-:0;-1:-1:-1;;;;;8045:18:0;;;8018:7;8045:18;;;:11;:18;;;;;;;;:27;;;;;;;;;;;;;7929:151::o;28479:177::-;27660:31;26256:18;27680:10;27660:7;:31::i;:::-;27652:67;;;;-1:-1:-1;;;27652:67:0;;;;;;;:::i;:::-;28562:16:::1;:36:::0;;-1:-1:-1;;28562:36:0::1;::::0;::::1;;;::::0;;;;28614:34:::1;::::0;::::1;::::0;::::1;::::0;28562:36:::1;28631:16:::0;;::::1;::::0;28614:34:::1;:::i;:::-;;;;;;;;28479:177:::0;:::o;17868:157::-;-1:-1:-1;;;;;;17977:40:0;;-1:-1:-1;;;17977:40:0;17868:157;;;:::o;3742:98::-;3822:10;3742:98;:::o;13783:346::-;-1:-1:-1;;;;;13885:19:0;;13877:68;;;;-1:-1:-1;;;13877:68:0;;;;;;;:::i;:::-;-1:-1:-1;;;;;13964:21:0;;13956:68;;;;-1:-1:-1;;;13956:68:0;;;;;;;:::i;:::-;-1:-1:-1;;;;;14037:18:0;;;;;;;:11;:18;;;;;;;;:27;;;;;;;;;;;;;;:36;;;14089:32;;;;;14067:6;;14089:32;:::i;:::-;;;;;;;;13783:346;;;:::o;11294:604::-;-1:-1:-1;;;;;11400:20:0;;11392:70;;;;-1:-1:-1;;;11392:70:0;;;;;;;:::i;:::-;-1:-1:-1;;;;;11481:23:0;;11473:71;;;;-1:-1:-1;;;11473:71:0;;;;;;;:::i;:::-;11557:47;11578:6;11586:9;11597:6;11557:20;:47::i;:::-;-1:-1:-1;;;;;11641:17:0;;11617:21;11641:17;;;:9;:17;;;;;;11677:23;;;;11669:74;;;;-1:-1:-1;;;11669:74:0;;;;;;;:::i;:::-;11774:22;11790:6;11774:13;:22;:::i;:::-;-1:-1:-1;;;;;11754:17:0;;;;;;;:9;:17;;;;;;:42;;;;11807:20;;;;;;;;:30;;11831:6;;11754:17;11807:30;;11831:6;;11807:30;:::i;:::-;;;;;;;;11872:9;-1:-1:-1;;;;;11855:35:0;11864:6;-1:-1:-1;;;;;11855:35:0;;11883:6;11855:35;;;;;;:::i;:::-;;;;;;;;11294:604;;;;:::o;22300:384::-;22380:22;22388:4;22394:7;22380;:22::i;:::-;22376:301;;22512:41;22540:7;-1:-1:-1;;;;;22512:41:0;22550:2;22512:19;:41::i;:::-;22610:38;22638:4;22645:2;22610:19;:38::i;:::-;22433:230;;;;;;;;;:::i;:::-;;;;-1:-1:-1;;22433:230:0;;;;;;;;;;-1:-1:-1;;;22419:246:0;;;;;;;:::i;25554:229::-;25629:22;25637:4;25643:7;25629;:22::i;:::-;25624:152;;25668:6;:12;;;;;;;;;;;-1:-1:-1;;;;;25668:29:0;;;;;;;;;:36;;-1:-1:-1;;25668:36:0;25700:4;25668:36;;;25751:12;:10;:12::i;:::-;-1:-1:-1;;;;;25724:40:0;25742:7;-1:-1:-1;;;;;25724:40:0;25736:4;25724:40;;;;;;;;;;25554:229;;:::o;25791:230::-;25866:22;25874:4;25880:7;25866;:22::i;:::-;25862:152;;;25937:5;25905:12;;;;;;;;;;;-1:-1:-1;;;;;25905:29:0;;;;;;;;;:37;;-1:-1:-1;;25905:37:0;;;25989:12;:10;:12::i;:::-;-1:-1:-1;;;;;25962:40:0;25980:7;-1:-1:-1;;;;;25962:40:0;25974:4;25962:40;;;;;;;;;;25791:230;;:::o;12180:338::-;-1:-1:-1;;;;;12264:21:0;;12256:65;;;;-1:-1:-1;;;12256:65:0;;;;;;;:::i;:::-;12334:49;12363:1;12367:7;12376:6;12334:20;:49::i;:::-;12412:6;12396:12;;:22;;;;;;;:::i;:::-;;;;-1:-1:-1;;;;;;;12429:18:0;;;;;;:9;:18;;;;;:28;;12451:6;;12429:18;:28;;12451:6;;12429:28;:::i;:::-;;;;-1:-1:-1;;12473:37:0;;-1:-1:-1;;;;;12473:37:0;;;12490:1;;12473:37;;;;12503:6;;12473:37;:::i;:::-;;;;;;;;12180:338;;:::o;28729:155::-;27897:16;;28876:4;;27897:16;;;:55;;-1:-1:-1;;;;;;27934:18:0;;;27897:55;:110;;;;27973:34;26547:21;27996:10;27973:7;:34::i;:::-;27875:195;;;;-1:-1:-1;;;27875:195:0;;;;;;;:::i;:::-;28729:155;;;;:::o;16356:447::-;16431:13;16457:19;16489:10;16493:6;16489:1;:10;:::i;:::-;:14;;16502:1;16489:14;:::i;:::-;16479:25;;;;;;-1:-1:-1;;;16479:25:0;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;-1:-1:-1;16479:25:0;;16457:47;;-1:-1:-1;;;16515:6:0;16522:1;16515:9;;;;;;-1:-1:-1;;;16515:9:0;;;;;;;;;;;;:15;-1:-1:-1;;;;;16515:15:0;;;;;;;;;-1:-1:-1;;;16541:6:0;16548:1;16541:9;;;;;;-1:-1:-1;;;16541:9:0;;;;;;;;;;;;:15;-1:-1:-1;;;;;16541:15:0;;;;;;;;-1:-1:-1;16572:9:0;16584:10;16588:6;16584:1;:10;:::i;:::-;:14;;16597:1;16584:14;:::i;:::-;16572:26;;16567:131;16604:1;16600;:5;16567:131;;;-1:-1:-1;;;16648:5:0;16656:3;16648:11;16639:21;;;;;-1:-1:-1;;;16639:21:0;;;;;;;;;;;;16627:6;16634:1;16627:9;;;;;;-1:-1:-1;;;16627:9:0;;;;;;;;;;;;:33;-1:-1:-1;;;;;16627:33:0;;;;;;;;-1:-1:-1;16685:1:0;16675:11;;;;;16607:3;;;:::i;:::-;;;16567:131;;;-1:-1:-1;16716:10:0;;16708:55;;;;-1:-1:-1;;;16708:55:0;;;;;;;:::i;:::-;16788:6;16356:447;-1:-1:-1;;;16356:447:0:o;14:175:1:-;84:20;;-1:-1:-1;;;;;133:31:1;;123:42;;113:2;;179:1;176;169:12;194:198;;306:2;294:9;285:7;281:23;277:32;274:2;;;327:6;319;312:22;274:2;355:31;376:9;355:31;:::i;397:274::-;;;526:2;514:9;505:7;501:23;497:32;494:2;;;547:6;539;532:22;494:2;575:31;596:9;575:31;:::i;:::-;565:41;;625:40;661:2;650:9;646:18;625:40;:::i;:::-;615:50;;484:187;;;;;:::o;676:342::-;;;;822:2;810:9;801:7;797:23;793:32;790:2;;;843:6;835;828:22;790:2;871:31;892:9;871:31;:::i;:::-;861:41;;921:40;957:2;946:9;942:18;921:40;:::i;:::-;911:50;;1008:2;997:9;993:18;980:32;970:42;;780:238;;;;;:::o;1023:266::-;;;1152:2;1140:9;1131:7;1127:23;1123:32;1120:2;;;1173:6;1165;1158:22;1120:2;1201:31;1222:9;1201:31;:::i;:::-;1191:41;1279:2;1264:18;;;;1251:32;;-1:-1:-1;;;1110:179:1:o;1294:293::-;;1403:2;1391:9;1382:7;1378:23;1374:32;1371:2;;;1424:6;1416;1409:22;1371:2;1468:9;1455:23;1521:5;1514:13;1507:21;1500:5;1497:32;1487:2;;1548:6;1540;1533:22;1592:190;;1704:2;1692:9;1683:7;1679:23;1675:32;1672:2;;;1725:6;1717;1710:22;1672:2;-1:-1:-1;1753:23:1;;1662:120;-1:-1:-1;1662:120:1:o;1787:266::-;;;1916:2;1904:9;1895:7;1891:23;1887:32;1884:2;;;1937:6;1929;1922:22;1884:2;1978:9;1965:23;1955:33;;2007:40;2043:2;2032:9;2028:18;2007:40;:::i;2058:306::-;;2169:2;2157:9;2148:7;2144:23;2140:32;2137:2;;;2190:6;2182;2175:22;2137:2;2221:23;;-1:-1:-1;;;;;;2273:32:1;;2263:43;;2253:2;;2325:6;2317;2310:22;2369:786;;2780:25;2775:3;2768:38;2835:6;2829:13;2851:62;2906:6;2901:2;2896:3;2892:12;2885:4;2877:6;2873:17;2851:62;:::i;:::-;-1:-1:-1;;;2972:2:1;2932:16;;;2964:11;;;2957:40;3022:13;;3044:63;3022:13;3093:2;3085:11;;3078:4;3066:17;;3044:63;:::i;:::-;3127:17;3146:2;3123:26;;2758:397;-1:-1:-1;;;;2758:397:1:o;3160:187::-;3325:14;;3318:22;3300:41;;3288:2;3273:18;;3255:92::o;3352:177::-;3498:25;;;3486:2;3471:18;;3453:76::o;3534:383::-;;3683:2;3672:9;3665:21;3715:6;3709:13;3758:6;3753:2;3742:9;3738:18;3731:34;3774:66;3833:6;3828:2;3817:9;3813:18;3808:2;3800:6;3796:15;3774:66;:::i;:::-;3901:2;3880:15;-1:-1:-1;;3876:29:1;3861:45;;;;3908:2;3857:54;;3655:262;-1:-1:-1;;3655:262:1:o;3922:356::-;4124:2;4106:21;;;4143:18;;;4136:30;4202:34;4197:2;4182:18;;4175:62;4269:2;4254:18;;4096:182::o;4283:399::-;4485:2;4467:21;;;4524:2;4504:18;;;4497:30;4563:34;4558:2;4543:18;;4536:62;-1:-1:-1;;;4629:2:1;4614:18;;4607:33;4672:3;4657:19;;4457:225::o;4687:399::-;4889:2;4871:21;;;4928:2;4908:18;;;4901:30;4967:34;4962:2;4947:18;;4940:62;-1:-1:-1;;;5033:2:1;5018:18;;5011:33;5076:3;5061:19;;4861:225::o;5091:398::-;5293:2;5275:21;;;5332:2;5312:18;;;5305:30;5371:34;5366:2;5351:18;;5344:62;-1:-1:-1;;;5437:2:1;5422:18;;5415:32;5479:3;5464:19;;5265:224::o;5494:348::-;5696:2;5678:21;;;5735:2;5715:18;;;5708:30;5774:26;5769:2;5754:18;;5747:54;5833:2;5818:18;;5668:174::o;5847:402::-;6049:2;6031:21;;;6088:2;6068:18;;;6061:30;6127:34;6122:2;6107:18;;6100:62;-1:-1:-1;;;6193:2:1;6178:18;;6171:36;6239:3;6224:19;;6021:228::o;6254:347::-;6456:2;6438:21;;;6495:2;6475:18;;;6468:30;6534:25;6529:2;6514:18;;6507:53;6592:2;6577:18;;6428:173::o;6606:404::-;6808:2;6790:21;;;6847:2;6827:18;;;6820:30;6886:34;6881:2;6866:18;;6859:62;-1:-1:-1;;;6952:2:1;6937:18;;6930:38;7000:3;6985:19;;6780:230::o;7015:401::-;7217:2;7199:21;;;7256:2;7236:18;;;7229:30;7295:34;7290:2;7275:18;;7268:62;-1:-1:-1;;;7361:2:1;7346:18;;7339:35;7406:3;7391:19;;7189:227::o;7421:400::-;7623:2;7605:21;;;7662:2;7642:18;;;7635:30;7701:34;7696:2;7681:18;;7674:62;-1:-1:-1;;;7767:2:1;7752:18;;7745:34;7811:3;7796:19;;7595:226::o;7826:401::-;8028:2;8010:21;;;8067:2;8047:18;;;8040:30;8106:34;8101:2;8086:18;;8079:62;-1:-1:-1;;;8172:2:1;8157:18;;8150:35;8217:3;8202:19;;8000:227::o;8232:411::-;8434:2;8416:21;;;8473:2;8453:18;;;8446:30;8512:34;8507:2;8492:18;;8485:62;-1:-1:-1;;;8578:2:1;8563:18;;8556:45;8633:3;8618:19;;8406:237::o;8648:355::-;8850:2;8832:21;;;8889:2;8869:18;;;8862:30;8928:33;8923:2;8908:18;;8901:61;8994:2;8979:18;;8822:181::o;9190:184::-;9362:4;9350:17;;;;9332:36;;9320:2;9305:18;;9287:87::o;9379:128::-;;9450:1;9446:6;9443:1;9440:13;9437:2;;;9456:18;;:::i;:::-;-1:-1:-1;9492:9:1;;9427:80::o;9512:168::-;;9618:1;9614;9610:6;9606:14;9603:1;9600:21;9595:1;9588:9;9581:17;9577:45;9574:2;;;9625:18;;:::i;:::-;-1:-1:-1;9665:9:1;;9564:116::o;9685:125::-;;9753:1;9750;9747:8;9744:2;;;9758:18;;:::i;:::-;-1:-1:-1;9795:9:1;;9734:76::o;9815:258::-;9887:1;9897:113;9911:6;9908:1;9905:13;9897:113;;;9987:11;;;9981:18;9968:11;;;9961:39;9933:2;9926:10;9897:113;;;10028:6;10025:1;10022:13;10019:2;;;-1:-1:-1;;10063:1:1;10045:16;;10038:27;9868:205::o;10078:136::-;;10145:5;10135:2;;10154:18;;:::i;:::-;-1:-1:-1;;;10190:18:1;;10125:89::o;10219:380::-;10304:1;10294:12;;10351:1;10341:12;;;10362:2;;10416:4;10408:6;10404:17;10394:27;;10362:2;10469;10461:6;10458:14;10438:18;10435:38;10432:2;;;10515:10;10510:3;10506:20;10503:1;10496:31;10550:4;10547:1;10540:15;10578:4;10575:1;10568:15;10432:2;;10274:325;;;:::o;10604:127::-;10665:10;10660:3;10656:20;10653:1;10646:31;10696:4;10693:1;10686:15;10720:4;10717:1;10710:15

ipfs://cbdf4d24037437ded46f28fea2c5650c1b010d7150ff416b5454d2bebd2d16c0