POL Price: $0.531627 (-16.48%)
 

Overview

Max Total Supply

147,700,000 DUCKIES

Holders

100,753 ( -0.003%)

Market

Price

$0.0046 @ 0.008700 POL (-6.45%)

Onchain Market Cap

$683,137.61

Circulating Supply Market Cap

$229,960.00

Other Info

Token Contract (WITH 8 Decimals)

Filtered by Token Holder
Mapper: USDT Stablecoin
Balance
120 DUCKIES

Value
$0.56 ( ~1.0534 POL) [0.0001%]
0xc2132d05d31c914a87c6611c10748aeb04b58e8f
Loading...
Loading
Loading...
Loading
Loading...
Loading

OVERVIEW

The Duckies network serves as a canary testing ground for the Yellow Network. It's a smaller, sandboxed version designed to investigate the potential of Yellow's state channels-powered DeFi and help drive its progress.

Market

Volume (24H):$853.04
Market Capitalization:$229,960.00
Circulating Supply:49,572,749.00 DUCKIES
Market Data Source: Coinmarketcap

Contract Source Code Verified (Exact Match)

Contract Name:
YellowToken

Compiler Version
v0.8.18+commit.87f61d96

Optimization Enabled:
Yes with 200 runs

Other Settings:
default evmVersion, Audited
File 1 of 12 : YellowToken.sol
// SPDX-License-Identifier: GPL-3.0-or-later
pragma solidity 0.8.18;

import '@openzeppelin/contracts/token/ERC20/ERC20.sol';
import '@openzeppelin/contracts/access/AccessControl.sol';

import './interfaces/IBlacklist.sol';

/**
 * @notice Yellow and Canary utility token inheriting AccessControl and implementing Cap and Blacklist.
 * This smart contract is an ERC20 used by both YELLOW and DUCKIES tokens.
 * The YELLOW token is a collateral to open a state channel with another network entity.
 * Additionally, it is used to pay the settlement fees on the network.
 *
 * After deployment, DEFAULT_ADMIN_ROLE will be transferred to a DAO, which will govern the token.
 * This is done not to give too much token governance power to once account, which will definitely be a vector of attack.
 *
 * The similar applies to COMPLIANCE_ROLE. It is going to be granted to a multisig account, which will govern hackers and malicious users by blacklisting them.
 *
 * @dev Blacklist feature is using OpenZeppelin AccessControl.
 */
contract YellowToken is ERC20, AccessControl, IBlacklist {
	/// @dev Role for managing the blacklist process chosen by the DAO
	bytes32 public constant COMPLIANCE_ROLE = keccak256('COMPLIANCE_ROLE');

	/// @dev Role for user blacklisted
	bytes32 public constant BLACKLISTED_ROLE = keccak256('BLACKLISTED_ROLE');

	/// @dev Role given to the DAO snapshot
	bytes32 public constant MINTER_ROLE = keccak256('MINTER_ROLE');

	/// @dev Activation must be called at Token Listing Event.
	uint256 public activatedAt;

	/// @dev Token maximum supply
	uint256 public immutable TOKEN_SUPPLY_CAP;

	/**
	 * @notice Activated event. Emitted when `activate` function is invoked.
	 * @param premint Amount of tokes pre-minted during activation.
	 */
	event Activated(uint256 premint);

	/**
	 * @dev Simple constructor, passing arguments to ERC20 constructor.
	 * Grants `DEFAULT_ADMIN_ROLE` and `MINTER_ROLE` to deployer.
	 * @param name Name of the Token.
	 * @param symbol Symbol of the Token.
	 */
	constructor(string memory name, string memory symbol, uint256 supplyCap) ERC20(name, symbol) {
		_grantRole(DEFAULT_ADMIN_ROLE, msg.sender);
		_grantRole(MINTER_ROLE, msg.sender);
		TOKEN_SUPPLY_CAP = supplyCap;
	}

	/// Token functions

	/**
	 * @notice Return the cap on the token's total supply.
	 * @return uint256 Token supply cap.
	 */
	function cap() external view returns (uint256) {
		return TOKEN_SUPPLY_CAP;
	}

	/**
	 * @notice Return the number of decimals used to get its user representation.
	 * @dev Overrides ERC20 default value of 18;
	 * @return uint8 Number of decimals of Token.
	 */
	function decimals() public pure override returns (uint8) {
		return 8;
	}

	/**
	 * @notice Activate token, minting `premint` amount to `account` address.
	 * @dev Require `DEFAULT_ADMIN_ROLE` to invoke. Premint must satisfy these conditions: 0 < premint < token supply cap. Can be called only once.
	 * @param premint Amount of tokens to premint.
	 * @param account Address of account to premint to.
	 */
	function activate(uint256 premint, address account) external onlyRole(DEFAULT_ADMIN_ROLE) {
		require(premint > 0, 'Zero premint');
		require(premint <= TOKEN_SUPPLY_CAP, 'Premint exceeds cap');
		require(activatedAt == 0, 'Already activated');

		activatedAt = block.timestamp;
		_mint(account, premint);

		emit Activated(premint);
	}

	/**
	 * @notice Increase balance of address `to` by `amount`.
	 * @dev Require `MINTER_ROLE` to invoke. Emit `Transfer` event.
	 * Require Token to be activated.
	 * The following conditions must be satisfied: `totalSupply + amount <= supplyCap`.
	 * @param to Address to mint tokens to.
	 * @param amount Amount of tokens to mint.
	 */
	function mint(address to, uint256 amount) external onlyRole(MINTER_ROLE) {
		require(activatedAt > 0, 'Not activated');
		require(totalSupply() + amount <= TOKEN_SUPPLY_CAP, 'Mint exceeds cap');

		_mint(to, amount);
	}

	/**
	 * @notice Destroys `amount` tokens from caller's account. Emit `Transfer` event.
	 * @param amount Amount of tokens to burn.
	 */
	function burn(uint256 amount) external {
		_burn(msg.sender, amount);
	}

	/**
	 * @notice Destroys `amount` tokens from `account`, deducting from the caller's allowance. Emit `Transfer` event.
	 * @param account Address of account to burn tokens from.
	 * @param amount Amount of tokens to burn.
	 */
	function burnFrom(address account, uint256 amount) external {
		_spendAllowance(account, msg.sender, amount);
		_burn(account, amount);
	}

	/**
	 * @notice Transfer `amount` of tokens to `to` address from caller.
	 * @dev Require caller is not marked 'blacklisted'.
	 * @param to Address to transfer tokens to.
	 * @param amount Amount of tokens to transfer.
	 * @return bool true if transfer succeeded.
	 */
	function transfer(address to, uint256 amount) public override returns (bool) {
		_requireAccountNotBlacklisted(msg.sender);

		return ERC20.transfer(to, amount);
	}

	/**
	 * @notice Transfer `amount` of tokens from `from` to `to` address.
	 * @dev Require `from` is not marked 'blacklisted'.
	 * @param from Address to transfer tokens from.
	 * @param to Address to transfer tokens to.
	 * @param amount Amount of tokens to transfer.
	 * @return bool true if transfer succeeded.
	 */
	function transferFrom(address from, address to, uint256 amount) public override returns (bool) {
		_requireAccountNotBlacklisted(from);

		return ERC20.transferFrom(from, to, amount);
	}

	/// Blacklist Implementation

	/**
	 * @notice Mark `account` as 'blacklisted' and disallow `transfer` and `transferFrom` operations.
	 * @dev Require `COMPLIANCE_ROLE` to invoke. Emit `Blacklisted` event`.
	 * @param account Address of account to mark 'blacklisted'.
	 */
	function blacklist(address account) external onlyRole(COMPLIANCE_ROLE) {
		_grantRole(BLACKLISTED_ROLE, account);
		emit Blacklisted(account);
	}

	/**
	 * @notice Remove mark 'blacklisted' from `account`, reinstating abilities to invoke `transfer` and `transferFrom`.
	 * @dev Require `COMPLIANCE_ROLE` to invoke. Emit `BlacklistedRemoved` event`.
	 * @param account Address of account to remove 'blacklisted' mark from.
	 */
	function removeBlacklisted(address account) external onlyRole(COMPLIANCE_ROLE) {
		_revokeRole(BLACKLISTED_ROLE, account);
		emit BlacklistedRemoved(account);
	}

	/**
	 * @notice Burn all tokens from blacklisted `account` specified.
	 * @dev Require `DEFAULT_ADMIN_ROLE` to invoke. Emit `BlacklistedBurnt` event`.
	 * Account specified must be blacklisted.
	 * @param account Address of 'blacklisted' account to burn funds from.
	 */
	function burnBlacklisted(address account) external onlyRole(DEFAULT_ADMIN_ROLE) {
		require(hasRole(BLACKLISTED_ROLE, account), 'Account is not blacklisted');

		uint256 blackFundsAmount = balanceOf(account);
		_burn(account, blackFundsAmount);

		emit BlacklistedBurnt(account, blackFundsAmount);
	}

	/**
	 * @notice Internal Function
	 * @dev Require `account` is not marked 'blacklisted'.
	 * @param account Address of account to require not marked 'blacklisted'.
	 */
	function _requireAccountNotBlacklisted(address account) internal view {
		require(!hasRole(BLACKLISTED_ROLE, account), 'Account is blacklisted');
	}
}

File 2 of 12 : AccessControl.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (access/AccessControl.sol)

pragma solidity ^0.8.0;

import "./IAccessControl.sol";
import "../utils/Context.sol";
import "../utils/Strings.sol";
import "../utils/introspection/ERC165.sol";

/**
 * @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 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]{40}) is missing role (0x[0-9a-f]{64})$/
     *
     * _Available since v4.1._
     */
    modifier onlyRole(bytes32 role) {
        _checkRole(role);
        _;
    }

    /**
     * @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 virtual override returns (bool) {
        return _roles[role].members[account];
    }

    /**
     * @dev Revert with a standard message if `_msgSender()` is missing `role`.
     * Overriding this function changes the behavior of the {onlyRole} modifier.
     *
     * Format of the revert message is described in {_checkRole}.
     *
     * _Available since v4.6._
     */
    function _checkRole(bytes32 role) internal view virtual {
        _checkRole(role, _msgSender());
    }

    /**
     * @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]{40}) is missing role (0x[0-9a-f]{64})$/
     */
    function _checkRole(bytes32 role, address account) internal view virtual {
        if (!hasRole(role, account)) {
            revert(
                string(
                    abi.encodePacked(
                        "AccessControl: account ",
                        Strings.toHexString(account),
                        " 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 virtual 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.
     *
     * May emit a {RoleGranted} event.
     */
    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.
     *
     * May emit a {RoleRevoked} event.
     */
    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 revoked `role`, emits a {RoleRevoked}
     * event.
     *
     * Requirements:
     *
     * - the caller must be `account`.
     *
     * May emit a {RoleRevoked} event.
     */
    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.
     *
     * May emit a {RoleGranted} event.
     *
     * [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}.
     * ====
     *
     * NOTE: This function is deprecated in favor of {_grantRole}.
     */
    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 {
        bytes32 previousAdminRole = getRoleAdmin(role);
        _roles[role].adminRole = adminRole;
        emit RoleAdminChanged(role, previousAdminRole, adminRole);
    }

    /**
     * @dev Grants `role` to `account`.
     *
     * Internal function without access restriction.
     *
     * May emit a {RoleGranted} event.
     */
    function _grantRole(bytes32 role, address account) internal virtual {
        if (!hasRole(role, account)) {
            _roles[role].members[account] = true;
            emit RoleGranted(role, account, _msgSender());
        }
    }

    /**
     * @dev Revokes `role` from `account`.
     *
     * Internal function without access restriction.
     *
     * May emit a {RoleRevoked} event.
     */
    function _revokeRole(bytes32 role, address account) internal virtual {
        if (hasRole(role, account)) {
            _roles[role].members[account] = false;
            emit RoleRevoked(role, account, _msgSender());
        }
    }
}

File 3 of 12 : IAccessControl.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (access/IAccessControl.sol)

pragma solidity ^0.8.0;

/**
 * @dev External interface of AccessControl declared to support ERC165 detection.
 */
interface IAccessControl {
    /**
     * @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 {AccessControl-_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 Returns `true` if `account` has been granted `role`.
     */
    function hasRole(bytes32 role, address account) external view returns (bool);

    /**
     * @dev Returns the admin role that controls `role`. See {grantRole} and
     * {revokeRole}.
     *
     * To change a role's admin, use {AccessControl-_setRoleAdmin}.
     */
    function getRoleAdmin(bytes32 role) external view returns (bytes32);

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

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

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

File 4 of 12 : ERC20.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (token/ERC20/ERC20.sol)

pragma solidity ^0.8.0;

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

/**
 * @dev Implementation of the {IERC20} interface.
 *
 * This implementation is agnostic to the way tokens are created. This means
 * that a supply mechanism has to be added in a derived contract using {_mint}.
 * For a generic mechanism see {ERC20PresetMinterPauser}.
 *
 * TIP: For a detailed writeup see our guide
 * https://forum.openzeppelin.com/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:
     *
     * - `to` cannot be the zero address.
     * - the caller must have a balance of at least `amount`.
     */
    function transfer(address to, uint256 amount) public virtual override returns (bool) {
        address owner = _msgSender();
        _transfer(owner, to, amount);
        return true;
    }

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

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

    /**
     * @dev See {IERC20-transferFrom}.
     *
     * Emits an {Approval} event indicating the updated allowance. This is not
     * required by the EIP. See the note at the beginning of {ERC20}.
     *
     * NOTE: Does not update the allowance if the current allowance
     * is the maximum `uint256`.
     *
     * Requirements:
     *
     * - `from` and `to` cannot be the zero address.
     * - `from` must have a balance of at least `amount`.
     * - the caller must have allowance for ``from``'s tokens of at least
     * `amount`.
     */
    function transferFrom(
        address from,
        address to,
        uint256 amount
    ) public virtual override returns (bool) {
        address spender = _msgSender();
        _spendAllowance(from, spender, amount);
        _transfer(from, to, 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) {
        address owner = _msgSender();
        _approve(owner, spender, allowance(owner, 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) {
        address owner = _msgSender();
        uint256 currentAllowance = allowance(owner, spender);
        require(currentAllowance >= subtractedValue, "ERC20: decreased allowance below zero");
        unchecked {
            _approve(owner, spender, currentAllowance - subtractedValue);
        }

        return true;
    }

    /**
     * @dev Moves `amount` of tokens from `from` to `to`.
     *
     * 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:
     *
     * - `from` cannot be the zero address.
     * - `to` cannot be the zero address.
     * - `from` must have a balance of at least `amount`.
     */
    function _transfer(
        address from,
        address to,
        uint256 amount
    ) internal virtual {
        require(from != address(0), "ERC20: transfer from the zero address");
        require(to != address(0), "ERC20: transfer to the zero address");

        _beforeTokenTransfer(from, to, amount);

        uint256 fromBalance = _balances[from];
        require(fromBalance >= amount, "ERC20: transfer amount exceeds balance");
        unchecked {
            _balances[from] = fromBalance - amount;
            // Overflow not possible: the sum of all balances is capped by totalSupply, and the sum is preserved by
            // decrementing then incrementing.
            _balances[to] += amount;
        }

        emit Transfer(from, to, amount);

        _afterTokenTransfer(from, to, 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;
        unchecked {
            // Overflow not possible: balance + amount is at most totalSupply + amount, which is checked above.
            _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;
            // Overflow not possible: amount <= accountBalance <= totalSupply.
            _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 Updates `owner` s allowance for `spender` based on spent `amount`.
     *
     * Does not update the allowance amount in case of infinite allowance.
     * Revert if not enough allowance is available.
     *
     * Might emit an {Approval} event.
     */
    function _spendAllowance(
        address owner,
        address spender,
        uint256 amount
    ) internal virtual {
        uint256 currentAllowance = allowance(owner, spender);
        if (currentAllowance != type(uint256).max) {
            require(currentAllowance >= amount, "ERC20: insufficient allowance");
            unchecked {
                _approve(owner, spender, currentAllowance - 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 5 of 12 : IERC20Metadata.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/IERC20Metadata.sol)

pragma solidity ^0.8.0;

import "../IERC20.sol";

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

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

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

File 6 of 12 : IERC20.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.6.0) (token/ERC20/IERC20.sol)

pragma solidity ^0.8.0;

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

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

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

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

pragma solidity ^0.8.0;

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

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

File 8 of 12 : ERC165.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)

pragma solidity ^0.8.0;

import "./IERC165.sol";

/**
 * @dev Implementation of the {IERC165} interface.
 *
 * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check
 * for the additional interface id that will be supported. For example:
 *
 * ```solidity
 * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
 *     return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);
 * }
 * ```
 *
 * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.
 */
abstract contract ERC165 is IERC165 {
    /**
     * @dev See {IERC165-supportsInterface}.
     */
    function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
        return interfaceId == type(IERC165).interfaceId;
    }
}

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

pragma solidity ^0.8.0;

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

File 10 of 12 : Math.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (utils/math/Math.sol)

pragma solidity ^0.8.0;

/**
 * @dev Standard math utilities missing in the Solidity language.
 */
library Math {
    enum Rounding {
        Down, // Toward negative infinity
        Up, // Toward infinity
        Zero // Toward zero
    }

    /**
     * @dev Returns the largest of two numbers.
     */
    function max(uint256 a, uint256 b) internal pure returns (uint256) {
        return a > b ? a : b;
    }

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

    /**
     * @dev Returns the average of two numbers. The result is rounded towards
     * zero.
     */
    function average(uint256 a, uint256 b) internal pure returns (uint256) {
        // (a + b) / 2 can overflow.
        return (a & b) + (a ^ b) / 2;
    }

    /**
     * @dev Returns the ceiling of the division of two numbers.
     *
     * This differs from standard division with `/` in that it rounds up instead
     * of rounding down.
     */
    function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {
        // (a + b - 1) / b can overflow on addition, so we distribute.
        return a == 0 ? 0 : (a - 1) / b + 1;
    }

    /**
     * @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or denominator == 0
     * @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv)
     * with further edits by Uniswap Labs also under MIT license.
     */
    function mulDiv(
        uint256 x,
        uint256 y,
        uint256 denominator
    ) internal pure returns (uint256 result) {
        unchecked {
            // 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use
            // use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256
            // variables such that product = prod1 * 2^256 + prod0.
            uint256 prod0; // Least significant 256 bits of the product
            uint256 prod1; // Most significant 256 bits of the product
            assembly {
                let mm := mulmod(x, y, not(0))
                prod0 := mul(x, y)
                prod1 := sub(sub(mm, prod0), lt(mm, prod0))
            }

            // Handle non-overflow cases, 256 by 256 division.
            if (prod1 == 0) {
                return prod0 / denominator;
            }

            // Make sure the result is less than 2^256. Also prevents denominator == 0.
            require(denominator > prod1);

            ///////////////////////////////////////////////
            // 512 by 256 division.
            ///////////////////////////////////////////////

            // Make division exact by subtracting the remainder from [prod1 prod0].
            uint256 remainder;
            assembly {
                // Compute remainder using mulmod.
                remainder := mulmod(x, y, denominator)

                // Subtract 256 bit number from 512 bit number.
                prod1 := sub(prod1, gt(remainder, prod0))
                prod0 := sub(prod0, remainder)
            }

            // Factor powers of two out of denominator and compute largest power of two divisor of denominator. Always >= 1.
            // See https://cs.stackexchange.com/q/138556/92363.

            // Does not overflow because the denominator cannot be zero at this stage in the function.
            uint256 twos = denominator & (~denominator + 1);
            assembly {
                // Divide denominator by twos.
                denominator := div(denominator, twos)

                // Divide [prod1 prod0] by twos.
                prod0 := div(prod0, twos)

                // Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one.
                twos := add(div(sub(0, twos), twos), 1)
            }

            // Shift in bits from prod1 into prod0.
            prod0 |= prod1 * twos;

            // Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such
            // that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for
            // four bits. That is, denominator * inv = 1 mod 2^4.
            uint256 inverse = (3 * denominator) ^ 2;

            // Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also works
            // in modular arithmetic, doubling the correct bits in each step.
            inverse *= 2 - denominator * inverse; // inverse mod 2^8
            inverse *= 2 - denominator * inverse; // inverse mod 2^16
            inverse *= 2 - denominator * inverse; // inverse mod 2^32
            inverse *= 2 - denominator * inverse; // inverse mod 2^64
            inverse *= 2 - denominator * inverse; // inverse mod 2^128
            inverse *= 2 - denominator * inverse; // inverse mod 2^256

            // Because the division is now exact we can divide by multiplying with the modular inverse of denominator.
            // This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is
            // less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1
            // is no longer required.
            result = prod0 * inverse;
            return result;
        }
    }

    /**
     * @notice Calculates x * y / denominator with full precision, following the selected rounding direction.
     */
    function mulDiv(
        uint256 x,
        uint256 y,
        uint256 denominator,
        Rounding rounding
    ) internal pure returns (uint256) {
        uint256 result = mulDiv(x, y, denominator);
        if (rounding == Rounding.Up && mulmod(x, y, denominator) > 0) {
            result += 1;
        }
        return result;
    }

    /**
     * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded down.
     *
     * Inspired by Henry S. Warren, Jr.'s "Hacker's Delight" (Chapter 11).
     */
    function sqrt(uint256 a) internal pure returns (uint256) {
        if (a == 0) {
            return 0;
        }

        // For our first guess, we get the biggest power of 2 which is smaller than the square root of the target.
        //
        // We know that the "msb" (most significant bit) of our target number `a` is a power of 2 such that we have
        // `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`.
        //
        // This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)`
        // → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))`
        // → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)`
        //
        // Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit.
        uint256 result = 1 << (log2(a) >> 1);

        // At this point `result` is an estimation with one bit of precision. We know the true value is a uint128,
        // since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at
        // every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision
        // into the expected uint128 result.
        unchecked {
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            return min(result, a / result);
        }
    }

    /**
     * @notice Calculates sqrt(a), following the selected rounding direction.
     */
    function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) {
        unchecked {
            uint256 result = sqrt(a);
            return result + (rounding == Rounding.Up && result * result < a ? 1 : 0);
        }
    }

    /**
     * @dev Return the log in base 2, rounded down, of a positive value.
     * Returns 0 if given 0.
     */
    function log2(uint256 value) internal pure returns (uint256) {
        uint256 result = 0;
        unchecked {
            if (value >> 128 > 0) {
                value >>= 128;
                result += 128;
            }
            if (value >> 64 > 0) {
                value >>= 64;
                result += 64;
            }
            if (value >> 32 > 0) {
                value >>= 32;
                result += 32;
            }
            if (value >> 16 > 0) {
                value >>= 16;
                result += 16;
            }
            if (value >> 8 > 0) {
                value >>= 8;
                result += 8;
            }
            if (value >> 4 > 0) {
                value >>= 4;
                result += 4;
            }
            if (value >> 2 > 0) {
                value >>= 2;
                result += 2;
            }
            if (value >> 1 > 0) {
                result += 1;
            }
        }
        return result;
    }

    /**
     * @dev Return the log in base 2, following the selected rounding direction, of a positive value.
     * Returns 0 if given 0.
     */
    function log2(uint256 value, Rounding rounding) internal pure returns (uint256) {
        unchecked {
            uint256 result = log2(value);
            return result + (rounding == Rounding.Up && 1 << result < value ? 1 : 0);
        }
    }

    /**
     * @dev Return the log in base 10, rounded down, of a positive value.
     * Returns 0 if given 0.
     */
    function log10(uint256 value) internal pure returns (uint256) {
        uint256 result = 0;
        unchecked {
            if (value >= 10**64) {
                value /= 10**64;
                result += 64;
            }
            if (value >= 10**32) {
                value /= 10**32;
                result += 32;
            }
            if (value >= 10**16) {
                value /= 10**16;
                result += 16;
            }
            if (value >= 10**8) {
                value /= 10**8;
                result += 8;
            }
            if (value >= 10**4) {
                value /= 10**4;
                result += 4;
            }
            if (value >= 10**2) {
                value /= 10**2;
                result += 2;
            }
            if (value >= 10**1) {
                result += 1;
            }
        }
        return result;
    }

    /**
     * @dev Return the log in base 10, following the selected rounding direction, of a positive value.
     * Returns 0 if given 0.
     */
    function log10(uint256 value, Rounding rounding) internal pure returns (uint256) {
        unchecked {
            uint256 result = log10(value);
            return result + (rounding == Rounding.Up && 10**result < value ? 1 : 0);
        }
    }

    /**
     * @dev Return the log in base 256, rounded down, of a positive value.
     * Returns 0 if given 0.
     *
     * Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string.
     */
    function log256(uint256 value) internal pure returns (uint256) {
        uint256 result = 0;
        unchecked {
            if (value >> 128 > 0) {
                value >>= 128;
                result += 16;
            }
            if (value >> 64 > 0) {
                value >>= 64;
                result += 8;
            }
            if (value >> 32 > 0) {
                value >>= 32;
                result += 4;
            }
            if (value >> 16 > 0) {
                value >>= 16;
                result += 2;
            }
            if (value >> 8 > 0) {
                result += 1;
            }
        }
        return result;
    }

    /**
     * @dev Return the log in base 10, following the selected rounding direction, of a positive value.
     * Returns 0 if given 0.
     */
    function log256(uint256 value, Rounding rounding) internal pure returns (uint256) {
        unchecked {
            uint256 result = log256(value);
            return result + (rounding == Rounding.Up && 1 << (result * 8) < value ? 1 : 0);
        }
    }
}

File 11 of 12 : Strings.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (utils/Strings.sol)

pragma solidity ^0.8.0;

import "./math/Math.sol";

/**
 * @dev String operations.
 */
library Strings {
    bytes16 private constant _SYMBOLS = "0123456789abcdef";
    uint8 private constant _ADDRESS_LENGTH = 20;

    /**
     * @dev Converts a `uint256` to its ASCII `string` decimal representation.
     */
    function toString(uint256 value) internal pure returns (string memory) {
        unchecked {
            uint256 length = Math.log10(value) + 1;
            string memory buffer = new string(length);
            uint256 ptr;
            /// @solidity memory-safe-assembly
            assembly {
                ptr := add(buffer, add(32, length))
            }
            while (true) {
                ptr--;
                /// @solidity memory-safe-assembly
                assembly {
                    mstore8(ptr, byte(mod(value, 10), _SYMBOLS))
                }
                value /= 10;
                if (value == 0) break;
            }
            return buffer;
        }
    }

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

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

    /**
     * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.
     */
    function toHexString(address addr) internal pure returns (string memory) {
        return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);
    }
}

File 12 of 12 : IBlacklist.sol
// SPDX-License-Identifier: GPL-3.0-or-later
pragma solidity 0.8.18;

/**
 * @title The IBlacklist interface outlines the ability to prevent certain accounts from transferring tokens.
 *
 * @notice This feature is blocking transfers of reported stolen funds from exchanges or engaged in malicious activities.
 *
 * To safeguard user funds against any potential manipulation, specific roles are assigned to different accounts.
 * One account is authorized to blacklist other accounts while another account is authorized to burn funds.
 * By dividing these responsibilities between two different accounts, the risk of misuse of this functionality is reduced.
 *
 */
interface IBlacklist {
	/**
	 * @notice Mark `account` as 'blacklisted' and disallow `transfer` and `transferFrom` operations.
	 * @dev Require `COMPLIANCE_ROLE` to invoke. Emit `Blacklisted` event`.
	 * @param account Address of account to mark 'blacklisted'.
	 */
	function blacklist(address account) external;

	/**
	 * @notice Remove mark 'blacklisted' from `account`, reinstating abilities to invoke `transfer` and `transferFrom`.
	 * @dev Require `COMPLIANCE_ROLE` to invoke. Emit `BlacklistedRemoved` event`.
	 * @param account Address of account to remove 'blacklisted' mark from.
	 */
	function removeBlacklisted(address account) external;

	/**
	 * @notice Burn all tokens from blacklisted `account` specified.
	 * @dev Require `COMPLIANCE_ROLE` to invoke. Emit `BlacklistedBurnt` event`. Account specified must be blacklisted.
	 * @param account Address of 'blacklisted' account to burn funds from.
	 */
	function burnBlacklisted(address account) external;

	/// Events

	/**
	 * @notice `Account` was marked 'blacklisted'.
	 * @param account Address of account to have been marked 'blacklisted'.
	 */
	event Blacklisted(address indexed account);

	/**
	 * @notice Mark 'blacklisted' from `account` was removed.
	 * @param account Address of account 'blacklisted' mark was removed from.
	 */
	event BlacklistedRemoved(address indexed account);

	/**
	 * @notice All tokens from blacklisted `account` specified were burnt.
	 * @param account Address of 'blacklisted' account funds were burnt from.
	 */
	event BlacklistedBurnt(address indexed account, uint256 amount);
}

Settings
{
  "viaIR": true,
  "optimizer": {
    "enabled": true,
    "runs": 200,
    "details": {
      "yulDetails": {
        "optimizerSteps": "u"
      }
    }
  },
  "outputSelection": {
    "*": {
      "*": [
        "evm.bytecode",
        "evm.deployedBytecode",
        "devdoc",
        "userdoc",
        "metadata",
        "abi"
      ]
    }
  },
  "libraries": {}
}

Contract Security Audit

Contract ABI

[{"inputs":[{"internalType":"string","name":"name","type":"string"},{"internalType":"string","name":"symbol","type":"string"},{"internalType":"uint256","name":"supplyCap","type":"uint256"}],"stateMutability":"nonpayable","type":"constructor"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"premint","type":"uint256"}],"name":"Activated","type":"event"},{"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":"address","name":"account","type":"address"}],"name":"Blacklisted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"BlacklistedBurnt","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"account","type":"address"}],"name":"BlacklistedRemoved","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"},{"inputs":[],"name":"BLACKLISTED_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"COMPLIANCE_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":"TOKEN_SUPPLY_CAP","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"premint","type":"uint256"},{"internalType":"address","name":"account","type":"address"}],"name":"activate","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"activatedAt","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"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":[{"internalType":"address","name":"account","type":"address"}],"name":"blacklist","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"burn","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"burnBlacklisted","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"burnFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"cap","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"decimals","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"pure","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":"to","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":"account","type":"address"}],"name":"removeBlacklisted","outputs":[],"stateMutability":"nonpayable","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":"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":"to","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"transfer","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"transferFrom","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"}]

60a06040523462000048576200001f620000186200019a565b91620001de565b604051611ba46200058382396080518181816104ea0152818161131c01526115680152611ba490f35b600080fd5b634e487b7160e01b600052604160045260246000fd5b90601f01601f191681019081106001600160401b038211176200008557604052565b6200004d565b90620000a26200009a60405190565b928362000063565b565b6001600160401b0381116200008557602090601f01601f19160190565b60005b838110620000d55750506000910152565b8181015183820152602001620000c4565b90929192620000ff620000f982620000a4565b6200008b565b938185526020850190828401116200004857620000a292620000c1565b9080601f83011215620000485781516200013992602001620000e6565b90565b9091606082840312620000485781516001600160401b038111620000485783620001689184016200011c565b602083015190936001600160401b03821162000048576200019081620001399386016200011c565b9360400190505190565b620001bd6200212780380380620001b1816200008b565b9283398101906200013c565b909192565b6200013962000139620001399290565b620001396000620001c2565b90620001ea9162000231565b6200022c620001f8620001d2565b62000205338092620004c9565b7f9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a6620004c9565b608052565b620000a29182918291829182919062000436565b634e487b7160e01b600052602260045260246000fd5b90600160028304921680156200027e575b60208310146200027857565b62000245565b91607f16916200026c565b9160001960089290920291821b911b5b9181191691161790565b9190620002b862000139620002c193620001c2565b90835462000289565b9055565b620000a291600091620002a3565b818110620002df575050565b80620002ef6000600193620002c5565b01620002d3565b9190601f81116200030657505050565b6200031a620000a293600052602060002090565b906020601f8401819004830193106200033e575b6020601f909101040190620002d3565b90915081906200032e565b9062000353815190565b906001600160401b03821162000085576200037b826200037485546200025b565b85620002f6565b602090601f8311600114620003ba57620002c1929160009183620003ae575b5050600019600883021c1916906002021790565b0151905038806200039a565b601f19831691620003d085600052602060002090565b9260005b8181106200041157509160029391856001969410620003f7575b50505002019055565b01516000196008601f8516021c19169055388080620003ee565b91936020600181928787015181550195019201620003d4565b90620000a29162000349565b9062000448620000a29260036200042a565b60046200042a565b905b600052602052604060002090565b620001399062000476906001600160a01b031682565b6001600160a01b031690565b620001399062000460565b620001399062000482565b9062000452906200048d565b9060ff9062000299565b90620004c162000139620002c192151590565b8254620004a4565b90620004de620004da828462000559565b1590565b620004e7575050565b6200050e6001620005088360006200050187600562000450565b0162000498565b620004ae565b33906200054862000541620005417f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d9590565b926200048d565b926200055360405190565b600090a4565b62000139916000620005016200057b9362000572600090565b50600562000450565b5460ff169056fe6080604052600436101561001257600080fd5b60003560e01c806301ffc9a7146101fd578063062d3bd7146101f857806306fdde03146101f3578063095ea7b3146101ee57806318160ddd146101e957806323b872dd146101e4578063248a9ca3146101df5780632f2ff15d146101da578063313ce567146101d5578063355274ea1461018057806336568abe146101d057806339509351146101cb57806340c10f19146101c657806342966c68146101c1578063597be6d1146101bc57806362b199c5146101b7578063637c25a1146101b257806370a08231146101ad57806378d06fce146101a857806379cc6790146101a357806391d148541461019e57806395d89b4114610199578063a217fddf14610194578063a457c2d71461018f578063a9059cbb1461018a578063c6a276c214610185578063cea4c3aa14610180578063d53913931461017b578063d547741f14610176578063dd62ed3e146101715763f9f92be4036102155761079a565b61077e565b61074b565b610712565b6104d5565b6106fa565b6106de565b6106c2565b6106a7565b61066d565b610651565b610638565b610620565b610605565b6105d8565b6105b1565b610596565b61055c565b610543565b610527565b61050e565b6104a6565b610488565b61044a565b61041a565b6103cf565b6103b3565b61032e565b61027c565b610240565b6001600160e01b031981165b0361021557565b600080fd5b9050359061022782610202565b565b906020828203126102155761023d9161021a565b90565b346102155761026d61025b610256366004610229565b6107b2565b60405191829182901515815260200190565b0390f35b600091031261021557565b346102155761028c366004610271565b61026d7f442a94f1a1fac79af32856af2a64f63648cfa2ef3b98610a5bb7cbec4cee69855b6040515b9182918290815260200190565b60005b8381106102d55750506000910152565b81810151838201526020016102c5565b61030661030f602093610319936102fa815190565b80835293849260200190565b958691016102c2565b601f01601f191690565b0190565b602080825261023d929101906102e5565b346102155761033e366004610271565b61026d610349610cb4565b6040519182918261031d565b6001600160a01b031690565b6001600160a01b03811661020e565b9050359061022782610361565b8061020e565b905035906102278261037d565b91906040838203126102155761023d906103aa8185610370565b93602001610383565b346102155761026d61025b6103c9366004610390565b90610d0e565b34610215576103df366004610271565b61026d6102b1610cc8565b90916060828403126102155761023d6104038484610370565b936104118160208601610370565b93604001610383565b346102155761026d61025b6104303660046103ea565b916118ea565b906020828203126102155761023d91610383565b346102155761026d6102b1610460366004610436565b61087a565b91906040838203126102155761023d9061047f8185610383565b93602001610370565b34610215576104a161049b366004610465565b906108b1565b604051005b34610215576104b6366004610271565b61026d6104c161121d565b6040519182918260ff909116815260200190565b34610215576104e5366004610271565b61026d7f00000000000000000000000000000000000000000000000000000000000000006102b1565b34610215576104a1610521366004610465565b90610a9d565b346102155761026d61025b61053d366004610390565b90610d46565b34610215576104a1610556366004610390565b9061158e565b34610215576104a161056f366004610436565b611598565b61023d916008021c81565b9061023d9154610574565b61023d6000600661057f565b34610215576105a6366004610271565b61026d6102b161058a565b34610215576105c1366004610271565b61026d600080516020611b4f8339815191526102b1565b34610215576104a16105eb366004610465565b906113a2565b906020828203126102155761023d91610370565b346102155761026d6102b161061b3660046105f1565b610cd2565b34610215576104a16106333660046105f1565b611adc565b34610215576104a161064b366004610390565b906116b5565b346102155761026d61025b610667366004610465565b90610841565b346102155761067d366004610271565b61026d610349610cbe565b61023d61023d61023d9290565b61023d6000610688565b61023d610695565b34610215576106b7366004610271565b61026d6102b161069f565b346102155761026d61025b6106d8366004610390565b90610dbf565b346102155761026d61025b6106f4366004610390565b9061174e565b34610215576104a161070d3660046105f1565b611a03565b3461021557610722366004610271565b61026d7f9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a66102b1565b34610215576104a161075e366004610465565b90610a2f565b91906040838203126102155761023d9061047f8185610370565b346102155761026d6102b1610794366004610764565b90610cee565b34610215576104a16107ad3660046105f1565b61198b565b637965db0b60e01b6001600160e01b03198216149081156107d1575090565b61023d91506001600160e01b0319166301ffc9a760e01b1490565b905b600052602052604060002090565b61023d90610355906001600160a01b031682565b61023d906107fc565b61023d90610810565b906107ee90610819565b61023d905b60ff1690565b61023d905461082c565b61023d91600061085e61086493610856600090565b5060056107ec565b01610822565b610837565b61023d9081565b61023d9054610869565b600161088b61023d92610856600090565b01610870565b90610227916108a76108a28261087a565b6108bb565b9061022791610aed565b9061022791610891565b610227903390610988565b61023d90610688565b6103196108e7926020926108e1815190565b94859290565b938491016102c2565b61092e61023d9392610928610928937f416363657373436f6e74726f6c3a206163636f756e7420000000000000000000815260170190565b906108cf565b7001034b99036b4b9b9b4b733903937b6329607d1b815260110190565b634e487b7160e01b600052604160045260246000fd5b90601f01601f1916810190811067ffffffffffffffff82111761098357604052565b61094b565b9061099a6109968284610841565b1590565b6109a2575050565b610a109161023d6109be6109b86109f8946111f0565b926108c6565b6109d36020916109cd83610688565b906110a1565b926109ec6109e060405190565b948593840192836108f0565b90810382520382610961565b60405162461bcd60e51b81529182916004830161031d565b0390fd5b9061022791610a256108a28261087a565b9061022791610b64565b9061022791610a14565b15610a4057565b60405162461bcd60e51b815260206004820152602f60248201527f416363657373436f6e74726f6c3a2063616e206f6e6c792072656e6f756e636560448201526e103937b632b9903337b91039b2b63360891b6064820152608490fd5b6102279190610abe610aae33610355565b6001600160a01b03841614610a39565b610b64565b9060ff905b9181191691161790565b90610ae261023d610ae992151590565b8254610ac3565b9055565b90610afb6109968284610841565b610b03575050565b610b1e6001610b1983600061085e8760056107ec565b610ad2565b3390610b54610b4e610b4e7f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d9590565b92610819565b92610b5e60405190565b600090a4565b90610b6f8183610841565b610b77575050565b610b8c6000610b19838261085e8760056107ec565b3390610b54610b4e610b4e7ff6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b9590565b634e487b7160e01b600052602260045260246000fd5b9060016002830492168015610bf2575b6020831014610bed57565b610bbc565b91607f1691610be2565b80546000939291610c19610c0f83610bd2565b8085529360200190565b9160018116908115610c6b5750600114610c3257505050565b610c459192939450600052602060002090565b916000925b818410610c575750500190565b805484840152602090930192600101610c4a565b92949550505060ff1916825215156020020190565b9061023d91610bfc565b90610227610ca492610c9b60405190565b93848092610c80565b0383610961565b61023d90610c8a565b61023d6003610cab565b61023d6004610cab565b61023d6002610870565b610ce961023d91610ce1600090565b506000610822565b610870565b61023d91610d09610ce992610d01600090565b506001610822565b610822565b610d19919033610ec9565b600190565b634e487b7160e01b600052601160045260246000fd5b91908201809211610d4157565b610d1e565b610d199190610d5f3392610d5a8385610cee565b610d34565b91610ec9565b15610d6c57565b60405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604482015264207a65726f60d81b6064820152608490fd5b610d199190610d5f3392610dd38385610cee565b610ddf82821015610d65565b0390565b61035561023d61023d9290565b61023d90610de3565b15610e0057565b60405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b6064820152608490fd5b15610e5857565b60405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b6064820152608490fd5b9060001990610ac8565b90610ec261023d610ae992610688565b8254610ea8565b610f08610ef7610ed96000610df0565b6103556001600160a01b0382166001600160a01b0386161415610df9565b6001600160a01b0384161415610e51565b610f2083610f1b84610d09856001610822565b610eb2565b610f60610f56610f507f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92593610819565b93610819565b936102b560405190565b0390a3565b81810292918115918404141715610d4157565b90610227610f8560405190565b9283610961565b67ffffffffffffffff811161098357602090601f01601f19160190565b90610fbb610fb683610f8c565b610f78565b918252565b369037565b90610227610fdb610fd584610fa9565b93610f8c565b601f190160208401610fc0565b634e487b7160e01b600052603260045260246000fd5b90611007825190565b811015611015570160200190565b610fe8565b8015610d41576000190190565b61083161023d61023d9290565b61023d9061104c61104861023d9460ff1690565b9190565b901c90565b1561105857565b60405162461bcd60e51b815280610a10600482016020808252818101527f537472696e67733a20686578206c656e67746820696e73756666696369656e74604082015260600190565b91906002926110d26110cd6110be846110b988610688565b610f65565b6110c787610688565b90610d34565b610fc5565b9160009060306110ea6110e484610688565b86610ffe565b53611122611119600f60fb1b926110b96001998a95871a61111361110d88610688565b8b610ffe565b53610688565b6110c783610688565b905b611146575b5061023d9394509061114061104861023d93610688565b14611051565b9161115086610688565b8311156111be576f181899199a1a9b1b9c1cb0b131b232b360811b611175600f610688565b82169060108210156110155787926111956111b2926111b8941a60f81b90565b851a6111a18789610ffe565b536111ac6004611027565b90611034565b9361101a565b90611124565b91611129565b61023d9081906001600160a01b031681565b61023d6014611027565b61023d61023d61023d9260ff1690565b61120d61120861023d92611202606090565b50610810565b6111c4565b6109cd6112186111d6565b6111e0565b61023d6008611027565b90610227916112376108a2610695565b6112f9565b1561124357565b60405162461bcd60e51b815260206004820152600c60248201526b16995c9bc81c1c995b5a5b9d60a21b6044820152606490fd5b1561127e57565b60405162461bcd60e51b815260206004820152601360248201527205072656d696e7420657863656564732063617606c1b6044820152606490fd5b156112c057565b60405162461bcd60e51b8152602060048201526011602482015270105b1c9958591e481858dd1a5d985d1959607a1b6044820152606490fd5b908161136f9161135f600061131761131082610688565b851161123c565b6113437f0000000000000000000000000000000000000000000000000000000000000000851115611277565b6113596110486113536006610870565b92610688565b146112b9565b61136a426006610eb2565b6113f8565b61139d7f3ec796be1be7d03bff3a62b9fa594a60e947c1809bced06d929f145308ae57ce916102b560405190565b0390a1565b9061022791611227565b156113b357565b60405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f2061646472657373006044820152606490fd5b60006114546114418361140a84610df0565b936114296001600160a01b0386166001600160a01b03841614156113ac565b610d0961143a88610d5a6002610870565b6002610eb2565b61144e8561031983610870565b90610eb2565b610f60610f56610f507fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef93610819565b61022791906114b27f9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a66108bb565b611532565b156114be57565b60405162461bcd60e51b815260206004820152600d60248201526c139bdd081858dd1a5d985d1959609a1b6044820152606490fd5b156114fa57565b60405162461bcd60e51b815260206004820152601060248201526f04d696e742065786365656473206361760841b6044820152606490fd5b90610227916115576115446006610870565b6115516110486000610688565b116114b7565b61136a61156683610d5a610cc8565b7f000000000000000000000000000000000000000000000000000000000000000010156114f3565b9061022791611484565b610227903361164f565b156115a957565b60405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b6064820152608490fd5b156115ff57565b60405162461bcd60e51b815260206004820152602260248201527f45524332303a206275726e20616d6f756e7420657863656564732062616c616e604482015261636560f01b6064820152608490fd5b6000906116a461165e83610df0565b9261167d6001600160a01b0385166001600160a01b03851614156115a2565b610f1b8361169e87611692610ce98487610822565b610ddf828210156115f8565b92610822565b61145461143a84610ddf6002610870565b90610227916116c5823383611716565b61164f565b156116d157565b60405162461bcd60e51b815260206004820152601d60248201527f45524332303a20696e73756666696369656e7420616c6c6f77616e63650000006044820152606490fd5b906117218183610cee565b6000198103611731575b50505050565b61174593610d5f91610ddf828210156116ca565b3880808061172b565b61023d919061175c33611b2a565b610d19919033611879565b611879565b1561177357565b60405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604482015264647265737360d81b6064820152608490fd5b156117cd57565b60405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b6064820152608490fd5b1561182557565b60405162461bcd60e51b815260206004820152602660248201527f45524332303a207472616e7366657220616d6f756e7420657863656564732062604482015265616c616e636560d01b6064820152608490fd5b6114546114418360006118c06118af61189183610df0565b6103556001600160a01b0382166001600160a01b038a16141561176c565b6001600160a01b03841614156117c6565b610d096118e0886118d4610ce98986610822565b610ddf8282101561181e565b610f1b8784610822565b61023d9291906118f981611b2a565b610d19929190611767833383611716565b610227906119377f442a94f1a1fac79af32856af2a64f63648cfa2ef3b98610a5bb7cbec4cee69856108bb565b61194f81600080516020611b4f833981519152610aed565b6119797fffa4e6181777692565cf28528fc88fd1516ea86b56da075235fa575af6a4b85591610819565b9061198360405190565b80805b0390a2565b6102279061190a565b610227906119c17f442a94f1a1fac79af32856af2a64f63648cfa2ef3b98610a5bb7cbec4cee69856108bb565b6119d981600080516020611b4f833981519152610b64565b6119797ff38e60871ec534937251cd91cad807e15f55f1f6815128faecc256e71994b49791610819565b61022790611994565b61022790611a1b6108a2610695565b611a6c565b15611a2757565b60405162461bcd60e51b815260206004820152601a60248201527f4163636f756e74206973206e6f7420626c61636b6c69737465640000000000006044820152606490fd5b611a91611a8c82600080516020611b4f833981519152610841565b610841565b611a20565b611a9a81610cd2565b90611aa5828261164f565b611986611ad27f4743ca7a69ca9ba3afc645605fdc654fc3cfcf7791e24505160b617a5e5262e892610819565b926102b560405190565b61022790611a0c565b15611aec57565b60405162461bcd60e51b81526020600482015260166024820152751058d8dbdd5b9d081a5cc8189b1858dadb1a5cdd195960521b6044820152606490fd5b611b4961099661022792611a87600080516020611b4f83398151915290565b611ae556fe548c7f0307ab2a7ea894e5c7e8c5353cc750bb9385ee2e945f189a9a83daa8eda2646970667358221220a7077ebcec84a9398d41b818a6ec4f7c9aa66d1d43d28be24fdeb8d3608f3f6664736f6c63430008120033000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000016345785d8a0000000000000000000000000000000000000000000000000000000000000000000e59656c6c6f77204475636b69657300000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000074455434b49455300000000000000000000000000000000000000000000000000

Deployed Bytecode

0x6080604052600436101561001257600080fd5b60003560e01c806301ffc9a7146101fd578063062d3bd7146101f857806306fdde03146101f3578063095ea7b3146101ee57806318160ddd146101e957806323b872dd146101e4578063248a9ca3146101df5780632f2ff15d146101da578063313ce567146101d5578063355274ea1461018057806336568abe146101d057806339509351146101cb57806340c10f19146101c657806342966c68146101c1578063597be6d1146101bc57806362b199c5146101b7578063637c25a1146101b257806370a08231146101ad57806378d06fce146101a857806379cc6790146101a357806391d148541461019e57806395d89b4114610199578063a217fddf14610194578063a457c2d71461018f578063a9059cbb1461018a578063c6a276c214610185578063cea4c3aa14610180578063d53913931461017b578063d547741f14610176578063dd62ed3e146101715763f9f92be4036102155761079a565b61077e565b61074b565b610712565b6104d5565b6106fa565b6106de565b6106c2565b6106a7565b61066d565b610651565b610638565b610620565b610605565b6105d8565b6105b1565b610596565b61055c565b610543565b610527565b61050e565b6104a6565b610488565b61044a565b61041a565b6103cf565b6103b3565b61032e565b61027c565b610240565b6001600160e01b031981165b0361021557565b600080fd5b9050359061022782610202565b565b906020828203126102155761023d9161021a565b90565b346102155761026d61025b610256366004610229565b6107b2565b60405191829182901515815260200190565b0390f35b600091031261021557565b346102155761028c366004610271565b61026d7f442a94f1a1fac79af32856af2a64f63648cfa2ef3b98610a5bb7cbec4cee69855b6040515b9182918290815260200190565b60005b8381106102d55750506000910152565b81810151838201526020016102c5565b61030661030f602093610319936102fa815190565b80835293849260200190565b958691016102c2565b601f01601f191690565b0190565b602080825261023d929101906102e5565b346102155761033e366004610271565b61026d610349610cb4565b6040519182918261031d565b6001600160a01b031690565b6001600160a01b03811661020e565b9050359061022782610361565b8061020e565b905035906102278261037d565b91906040838203126102155761023d906103aa8185610370565b93602001610383565b346102155761026d61025b6103c9366004610390565b90610d0e565b34610215576103df366004610271565b61026d6102b1610cc8565b90916060828403126102155761023d6104038484610370565b936104118160208601610370565b93604001610383565b346102155761026d61025b6104303660046103ea565b916118ea565b906020828203126102155761023d91610383565b346102155761026d6102b1610460366004610436565b61087a565b91906040838203126102155761023d9061047f8185610383565b93602001610370565b34610215576104a161049b366004610465565b906108b1565b604051005b34610215576104b6366004610271565b61026d6104c161121d565b6040519182918260ff909116815260200190565b34610215576104e5366004610271565b61026d7f000000000000000000000000000000000000000000000000016345785d8a00006102b1565b34610215576104a1610521366004610465565b90610a9d565b346102155761026d61025b61053d366004610390565b90610d46565b34610215576104a1610556366004610390565b9061158e565b34610215576104a161056f366004610436565b611598565b61023d916008021c81565b9061023d9154610574565b61023d6000600661057f565b34610215576105a6366004610271565b61026d6102b161058a565b34610215576105c1366004610271565b61026d600080516020611b4f8339815191526102b1565b34610215576104a16105eb366004610465565b906113a2565b906020828203126102155761023d91610370565b346102155761026d6102b161061b3660046105f1565b610cd2565b34610215576104a16106333660046105f1565b611adc565b34610215576104a161064b366004610390565b906116b5565b346102155761026d61025b610667366004610465565b90610841565b346102155761067d366004610271565b61026d610349610cbe565b61023d61023d61023d9290565b61023d6000610688565b61023d610695565b34610215576106b7366004610271565b61026d6102b161069f565b346102155761026d61025b6106d8366004610390565b90610dbf565b346102155761026d61025b6106f4366004610390565b9061174e565b34610215576104a161070d3660046105f1565b611a03565b3461021557610722366004610271565b61026d7f9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a66102b1565b34610215576104a161075e366004610465565b90610a2f565b91906040838203126102155761023d9061047f8185610370565b346102155761026d6102b1610794366004610764565b90610cee565b34610215576104a16107ad3660046105f1565b61198b565b637965db0b60e01b6001600160e01b03198216149081156107d1575090565b61023d91506001600160e01b0319166301ffc9a760e01b1490565b905b600052602052604060002090565b61023d90610355906001600160a01b031682565b61023d906107fc565b61023d90610810565b906107ee90610819565b61023d905b60ff1690565b61023d905461082c565b61023d91600061085e61086493610856600090565b5060056107ec565b01610822565b610837565b61023d9081565b61023d9054610869565b600161088b61023d92610856600090565b01610870565b90610227916108a76108a28261087a565b6108bb565b9061022791610aed565b9061022791610891565b610227903390610988565b61023d90610688565b6103196108e7926020926108e1815190565b94859290565b938491016102c2565b61092e61023d9392610928610928937f416363657373436f6e74726f6c3a206163636f756e7420000000000000000000815260170190565b906108cf565b7001034b99036b4b9b9b4b733903937b6329607d1b815260110190565b634e487b7160e01b600052604160045260246000fd5b90601f01601f1916810190811067ffffffffffffffff82111761098357604052565b61094b565b9061099a6109968284610841565b1590565b6109a2575050565b610a109161023d6109be6109b86109f8946111f0565b926108c6565b6109d36020916109cd83610688565b906110a1565b926109ec6109e060405190565b948593840192836108f0565b90810382520382610961565b60405162461bcd60e51b81529182916004830161031d565b0390fd5b9061022791610a256108a28261087a565b9061022791610b64565b9061022791610a14565b15610a4057565b60405162461bcd60e51b815260206004820152602f60248201527f416363657373436f6e74726f6c3a2063616e206f6e6c792072656e6f756e636560448201526e103937b632b9903337b91039b2b63360891b6064820152608490fd5b6102279190610abe610aae33610355565b6001600160a01b03841614610a39565b610b64565b9060ff905b9181191691161790565b90610ae261023d610ae992151590565b8254610ac3565b9055565b90610afb6109968284610841565b610b03575050565b610b1e6001610b1983600061085e8760056107ec565b610ad2565b3390610b54610b4e610b4e7f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d9590565b92610819565b92610b5e60405190565b600090a4565b90610b6f8183610841565b610b77575050565b610b8c6000610b19838261085e8760056107ec565b3390610b54610b4e610b4e7ff6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b9590565b634e487b7160e01b600052602260045260246000fd5b9060016002830492168015610bf2575b6020831014610bed57565b610bbc565b91607f1691610be2565b80546000939291610c19610c0f83610bd2565b8085529360200190565b9160018116908115610c6b5750600114610c3257505050565b610c459192939450600052602060002090565b916000925b818410610c575750500190565b805484840152602090930192600101610c4a565b92949550505060ff1916825215156020020190565b9061023d91610bfc565b90610227610ca492610c9b60405190565b93848092610c80565b0383610961565b61023d90610c8a565b61023d6003610cab565b61023d6004610cab565b61023d6002610870565b610ce961023d91610ce1600090565b506000610822565b610870565b61023d91610d09610ce992610d01600090565b506001610822565b610822565b610d19919033610ec9565b600190565b634e487b7160e01b600052601160045260246000fd5b91908201809211610d4157565b610d1e565b610d199190610d5f3392610d5a8385610cee565b610d34565b91610ec9565b15610d6c57565b60405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604482015264207a65726f60d81b6064820152608490fd5b610d199190610d5f3392610dd38385610cee565b610ddf82821015610d65565b0390565b61035561023d61023d9290565b61023d90610de3565b15610e0057565b60405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b6064820152608490fd5b15610e5857565b60405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b6064820152608490fd5b9060001990610ac8565b90610ec261023d610ae992610688565b8254610ea8565b610f08610ef7610ed96000610df0565b6103556001600160a01b0382166001600160a01b0386161415610df9565b6001600160a01b0384161415610e51565b610f2083610f1b84610d09856001610822565b610eb2565b610f60610f56610f507f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92593610819565b93610819565b936102b560405190565b0390a3565b81810292918115918404141715610d4157565b90610227610f8560405190565b9283610961565b67ffffffffffffffff811161098357602090601f01601f19160190565b90610fbb610fb683610f8c565b610f78565b918252565b369037565b90610227610fdb610fd584610fa9565b93610f8c565b601f190160208401610fc0565b634e487b7160e01b600052603260045260246000fd5b90611007825190565b811015611015570160200190565b610fe8565b8015610d41576000190190565b61083161023d61023d9290565b61023d9061104c61104861023d9460ff1690565b9190565b901c90565b1561105857565b60405162461bcd60e51b815280610a10600482016020808252818101527f537472696e67733a20686578206c656e67746820696e73756666696369656e74604082015260600190565b91906002926110d26110cd6110be846110b988610688565b610f65565b6110c787610688565b90610d34565b610fc5565b9160009060306110ea6110e484610688565b86610ffe565b53611122611119600f60fb1b926110b96001998a95871a61111361110d88610688565b8b610ffe565b53610688565b6110c783610688565b905b611146575b5061023d9394509061114061104861023d93610688565b14611051565b9161115086610688565b8311156111be576f181899199a1a9b1b9c1cb0b131b232b360811b611175600f610688565b82169060108210156110155787926111956111b2926111b8941a60f81b90565b851a6111a18789610ffe565b536111ac6004611027565b90611034565b9361101a565b90611124565b91611129565b61023d9081906001600160a01b031681565b61023d6014611027565b61023d61023d61023d9260ff1690565b61120d61120861023d92611202606090565b50610810565b6111c4565b6109cd6112186111d6565b6111e0565b61023d6008611027565b90610227916112376108a2610695565b6112f9565b1561124357565b60405162461bcd60e51b815260206004820152600c60248201526b16995c9bc81c1c995b5a5b9d60a21b6044820152606490fd5b1561127e57565b60405162461bcd60e51b815260206004820152601360248201527205072656d696e7420657863656564732063617606c1b6044820152606490fd5b156112c057565b60405162461bcd60e51b8152602060048201526011602482015270105b1c9958591e481858dd1a5d985d1959607a1b6044820152606490fd5b908161136f9161135f600061131761131082610688565b851161123c565b6113437f000000000000000000000000000000000000000000000000016345785d8a0000851115611277565b6113596110486113536006610870565b92610688565b146112b9565b61136a426006610eb2565b6113f8565b61139d7f3ec796be1be7d03bff3a62b9fa594a60e947c1809bced06d929f145308ae57ce916102b560405190565b0390a1565b9061022791611227565b156113b357565b60405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f2061646472657373006044820152606490fd5b60006114546114418361140a84610df0565b936114296001600160a01b0386166001600160a01b03841614156113ac565b610d0961143a88610d5a6002610870565b6002610eb2565b61144e8561031983610870565b90610eb2565b610f60610f56610f507fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef93610819565b61022791906114b27f9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a66108bb565b611532565b156114be57565b60405162461bcd60e51b815260206004820152600d60248201526c139bdd081858dd1a5d985d1959609a1b6044820152606490fd5b156114fa57565b60405162461bcd60e51b815260206004820152601060248201526f04d696e742065786365656473206361760841b6044820152606490fd5b90610227916115576115446006610870565b6115516110486000610688565b116114b7565b61136a61156683610d5a610cc8565b7f000000000000000000000000000000000000000000000000016345785d8a000010156114f3565b9061022791611484565b610227903361164f565b156115a957565b60405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b6064820152608490fd5b156115ff57565b60405162461bcd60e51b815260206004820152602260248201527f45524332303a206275726e20616d6f756e7420657863656564732062616c616e604482015261636560f01b6064820152608490fd5b6000906116a461165e83610df0565b9261167d6001600160a01b0385166001600160a01b03851614156115a2565b610f1b8361169e87611692610ce98487610822565b610ddf828210156115f8565b92610822565b61145461143a84610ddf6002610870565b90610227916116c5823383611716565b61164f565b156116d157565b60405162461bcd60e51b815260206004820152601d60248201527f45524332303a20696e73756666696369656e7420616c6c6f77616e63650000006044820152606490fd5b906117218183610cee565b6000198103611731575b50505050565b61174593610d5f91610ddf828210156116ca565b3880808061172b565b61023d919061175c33611b2a565b610d19919033611879565b611879565b1561177357565b60405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604482015264647265737360d81b6064820152608490fd5b156117cd57565b60405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b6064820152608490fd5b1561182557565b60405162461bcd60e51b815260206004820152602660248201527f45524332303a207472616e7366657220616d6f756e7420657863656564732062604482015265616c616e636560d01b6064820152608490fd5b6114546114418360006118c06118af61189183610df0565b6103556001600160a01b0382166001600160a01b038a16141561176c565b6001600160a01b03841614156117c6565b610d096118e0886118d4610ce98986610822565b610ddf8282101561181e565b610f1b8784610822565b61023d9291906118f981611b2a565b610d19929190611767833383611716565b610227906119377f442a94f1a1fac79af32856af2a64f63648cfa2ef3b98610a5bb7cbec4cee69856108bb565b61194f81600080516020611b4f833981519152610aed565b6119797fffa4e6181777692565cf28528fc88fd1516ea86b56da075235fa575af6a4b85591610819565b9061198360405190565b80805b0390a2565b6102279061190a565b610227906119c17f442a94f1a1fac79af32856af2a64f63648cfa2ef3b98610a5bb7cbec4cee69856108bb565b6119d981600080516020611b4f833981519152610b64565b6119797ff38e60871ec534937251cd91cad807e15f55f1f6815128faecc256e71994b49791610819565b61022790611994565b61022790611a1b6108a2610695565b611a6c565b15611a2757565b60405162461bcd60e51b815260206004820152601a60248201527f4163636f756e74206973206e6f7420626c61636b6c69737465640000000000006044820152606490fd5b611a91611a8c82600080516020611b4f833981519152610841565b610841565b611a20565b611a9a81610cd2565b90611aa5828261164f565b611986611ad27f4743ca7a69ca9ba3afc645605fdc654fc3cfcf7791e24505160b617a5e5262e892610819565b926102b560405190565b61022790611a0c565b15611aec57565b60405162461bcd60e51b81526020600482015260166024820152751058d8dbdd5b9d081a5cc8189b1858dadb1a5cdd195960521b6044820152606490fd5b611b4961099661022792611a87600080516020611b4f83398151915290565b611ae556fe548c7f0307ab2a7ea894e5c7e8c5353cc750bb9385ee2e945f189a9a83daa8eda2646970667358221220a7077ebcec84a9398d41b818a6ec4f7c9aa66d1d43d28be24fdeb8d3608f3f6664736f6c63430008120033

Constructor Arguments (ABI-Encoded and is the last bytes of the Contract Creation Code above)

000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000016345785d8a0000000000000000000000000000000000000000000000000000000000000000000e59656c6c6f77204475636b69657300000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000074455434b49455300000000000000000000000000000000000000000000000000

-----Decoded View---------------
Arg [0] : name (string): Yellow Duckies
Arg [1] : symbol (string): DUCKIES
Arg [2] : supplyCap (uint256): 100000000000000000

-----Encoded View---------------
7 Constructor Arguments found :
Arg [0] : 0000000000000000000000000000000000000000000000000000000000000060
Arg [1] : 00000000000000000000000000000000000000000000000000000000000000a0
Arg [2] : 000000000000000000000000000000000000000000000000016345785d8a0000
Arg [3] : 000000000000000000000000000000000000000000000000000000000000000e
Arg [4] : 59656c6c6f77204475636b696573000000000000000000000000000000000000
Arg [5] : 0000000000000000000000000000000000000000000000000000000000000007
Arg [6] : 4455434b49455300000000000000000000000000000000000000000000000000


Loading...
Loading
[ Download: CSV Export  ]
[ Download: CSV Export  ]

A token is a representation of an on-chain or off-chain asset. The token page shows information such as price, total supply, holders, transfers and social links. Learn more about this page in our Knowledge Base.