Contract

Contract Source Code (Solidity)

IDE

• Blockscan IDE
• 🤖 Code ReaderBeta
• Remix IDE

Outline

•    - function _msgSender()
•    - function _msgData()
•    - function _contextSuffixLength()
•    - function owner()
•    - function _checkOwner()
•    - function renounceOwnership()
•    - function transferOwnership(address ne ...
•    - function _transferOwnership(address n ...
• interface IERC20Errors
• interface IERC721Errors
• interface IERC1155Errors
• interface IERC20
•    - function totalSupply()
•    - function balanceOf(address account)
•    - function transfer(address to, uint256 ...
•    - function allowance(address owner, add ...
•    - function approve(address spender, uin ...
•    - function transferFrom(address from, a ...
• interface IERC20Metadata is IERC20
•    - function name()
•    - function symbol()
•    - function decimals()
•    - function name()
•    - function symbol()
•    - function decimals()
•    - function totalSupply()
•    - function balanceOf(address account)
•    - function transfer(address to, uint256 ...
•    - function allowance(address owner, add ...
•    - function approve(address spender, uin ...
•    - function transferFrom(address from, a ...
•    - function _transfer(address from, addr ...
•    - function _update(address from, addres ...
•    - function _mint(address account, uint2 ...
•    - function _burn(address account, uint2 ...
•    - function _approve(address owner, addr ...
•    - function _approve(address owner, addr ...
•    - function _spendAllowance(address owne ...
•    - function decimals()
•    - function taxFeePerMille()
•    - function taxAddress()
•    - function isExcludedFromTaxFee(address ...
•    - function transfer(address to, uint256 ...
•    - function transferFrom(address from, a ...
•    - function _transferWithFee(address fro ...
•    - function _setTaxRate(uint256 taxFeePe ...
•    - function _setTaxAddress(address taxAd ...
•    - function _setExclusionFromTaxFee(addr ...
• interface IPayable
•    - function pay(string calldata serviceN ...
•  contract TaxableERC20 is ERC20Deta ... *
•    - function setTaxFeePerMille(uint256 ta ...
•    - function setTaxAddress(address taxAdd ...
•    - function setExclusionFromTaxFee(addre ...
•    - function transfer(address to, uint256 ...
•    - function transferFrom(
•    - function decimals()

More Options

• Similar
• Sol2Uml
• Submit Audit
• Compare

/**
 *Submitted for verification at Etherscan.io on 2024-01-09
*/

// SPDX-License-Identifier: MIT

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



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

// Original license: SPDX_License_Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.1) (utils/Context.sol)

pragma solidity ^0.8.20;

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

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

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


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

// Original license: SPDX_License_Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (access/Ownable.sol)

pragma solidity ^0.8.20;

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

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

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

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

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

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

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

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

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

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

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


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

// Original license: SPDX_License_Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (interfaces/draft-IERC6093.sol)
pragma solidity ^0.8.20;

/**
 * @dev Standard ERC20 Errors
 * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC20 tokens.
 */
interface IERC20Errors {
    /**
     * @dev Indicates an error related to the current `balance` of a `sender`. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     * @param balance Current balance for the interacting account.
     * @param needed Minimum amount required to perform a transfer.
     */
    error ERC20InsufficientBalance(address sender, uint256 balance, uint256 needed);

    /**
     * @dev Indicates a failure with the token `sender`. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     */
    error ERC20InvalidSender(address sender);

    /**
     * @dev Indicates a failure with the token `receiver`. Used in transfers.
     * @param receiver Address to which tokens are being transferred.
     */
    error ERC20InvalidReceiver(address receiver);

    /**
     * @dev Indicates a failure with the `spender`’s `allowance`. Used in transfers.
     * @param spender Address that may be allowed to operate on tokens without being their owner.
     * @param allowance Amount of tokens a `spender` is allowed to operate with.
     * @param needed Minimum amount required to perform a transfer.
     */
    error ERC20InsufficientAllowance(address spender, uint256 allowance, uint256 needed);

    /**
     * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals.
     * @param approver Address initiating an approval operation.
     */
    error ERC20InvalidApprover(address approver);

    /**
     * @dev Indicates a failure with the `spender` to be approved. Used in approvals.
     * @param spender Address that may be allowed to operate on tokens without being their owner.
     */
    error ERC20InvalidSpender(address spender);
}

/**
 * @dev Standard ERC721 Errors
 * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC721 tokens.
 */
interface IERC721Errors {
    /**
     * @dev Indicates that an address can't be an owner. For example, `address(0)` is a forbidden owner in EIP-20.
     * Used in balance queries.
     * @param owner Address of the current owner of a token.
     */
    error ERC721InvalidOwner(address owner);

    /**
     * @dev Indicates a `tokenId` whose `owner` is the zero address.
     * @param tokenId Identifier number of a token.
     */
    error ERC721NonexistentToken(uint256 tokenId);

    /**
     * @dev Indicates an error related to the ownership over a particular token. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     * @param tokenId Identifier number of a token.
     * @param owner Address of the current owner of a token.
     */
    error ERC721IncorrectOwner(address sender, uint256 tokenId, address owner);

    /**
     * @dev Indicates a failure with the token `sender`. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     */
    error ERC721InvalidSender(address sender);

    /**
     * @dev Indicates a failure with the token `receiver`. Used in transfers.
     * @param receiver Address to which tokens are being transferred.
     */
    error ERC721InvalidReceiver(address receiver);

    /**
     * @dev Indicates a failure with the `operator`’s approval. Used in transfers.
     * @param operator Address that may be allowed to operate on tokens without being their owner.
     * @param tokenId Identifier number of a token.
     */
    error ERC721InsufficientApproval(address operator, uint256 tokenId);

    /**
     * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals.
     * @param approver Address initiating an approval operation.
     */
    error ERC721InvalidApprover(address approver);

    /**
     * @dev Indicates a failure with the `operator` to be approved. Used in approvals.
     * @param operator Address that may be allowed to operate on tokens without being their owner.
     */
    error ERC721InvalidOperator(address operator);
}

/**
 * @dev Standard ERC1155 Errors
 * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC1155 tokens.
 */
interface IERC1155Errors {
    /**
     * @dev Indicates an error related to the current `balance` of a `sender`. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     * @param balance Current balance for the interacting account.
     * @param needed Minimum amount required to perform a transfer.
     * @param tokenId Identifier number of a token.
     */
    error ERC1155InsufficientBalance(address sender, uint256 balance, uint256 needed, uint256 tokenId);

    /**
     * @dev Indicates a failure with the token `sender`. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     */
    error ERC1155InvalidSender(address sender);

    /**
     * @dev Indicates a failure with the token `receiver`. Used in transfers.
     * @param receiver Address to which tokens are being transferred.
     */
    error ERC1155InvalidReceiver(address receiver);

    /**
     * @dev Indicates a failure with the `operator`’s approval. Used in transfers.
     * @param operator Address that may be allowed to operate on tokens without being their owner.
     * @param owner Address of the current owner of a token.
     */
    error ERC1155MissingApprovalForAll(address operator, address owner);

    /**
     * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals.
     * @param approver Address initiating an approval operation.
     */
    error ERC1155InvalidApprover(address approver);

    /**
     * @dev Indicates a failure with the `operator` to be approved. Used in approvals.
     * @param operator Address that may be allowed to operate on tokens without being their owner.
     */
    error ERC1155InvalidOperator(address operator);

    /**
     * @dev Indicates an array length mismatch between ids and values in a safeBatchTransferFrom operation.
     * Used in batch transfers.
     * @param idsLength Length of the array of token identifiers
     * @param valuesLength Length of the array of token amounts
     */
    error ERC1155InvalidArrayLength(uint256 idsLength, uint256 valuesLength);
}


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

// Original license: SPDX_License_Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/IERC20.sol)

pragma solidity ^0.8.20;

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

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

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

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

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

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

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

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


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

// Original license: SPDX_License_Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/extensions/IERC20Metadata.sol)

pragma solidity ^0.8.20;

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

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

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


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

// Original license: SPDX_License_Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/ERC20.sol)

pragma solidity ^0.8.20;




/**
 * @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}.
 *
 * 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].
 *
 * The default value of {decimals} is 18. To change this, you should override
 * this function so it returns a different value.
 *
 * 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.
 */
abstract contract ERC20 is Context, IERC20, IERC20Metadata, IERC20Errors {
    mapping(address account => uint256) private _balances;

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

    uint256 private _totalSupply;

    string private _name;
    string private _symbol;

    /**
     * @dev Sets the values for {name} and {symbol}.
     *
     * 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 returns (string memory) {
        return _name;
    }

    /**
     * @dev Returns the symbol of the token, usually a shorter version of the
     * name.
     */
    function symbol() public view virtual 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 default value returned by this function, unless
     * it's 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 returns (uint8) {
        return 18;
    }

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

    /**
     * @dev See {IERC20-balanceOf}.
     */
    function balanceOf(address account) public view virtual 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 `value`.
     */
    function transfer(address to, uint256 value) public virtual returns (bool) {
        address owner = _msgSender();
        _transfer(owner, to, value);
        return true;
    }

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

    /**
     * @dev See {IERC20-approve}.
     *
     * NOTE: If `value` 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 value) public virtual returns (bool) {
        address owner = _msgSender();
        _approve(owner, spender, value);
        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 `value`.
     * - the caller must have allowance for ``from``'s tokens of at least
     * `value`.
     */
    function transferFrom(address from, address to, uint256 value) public virtual returns (bool) {
        address spender = _msgSender();
        _spendAllowance(from, spender, value);
        _transfer(from, to, value);
        return true;
    }

    /**
     * @dev Moves a `value` 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.
     *
     * NOTE: This function is not virtual, {_update} should be overridden instead.
     */
    function _transfer(address from, address to, uint256 value) internal {
        if (from == address(0)) {
            revert ERC20InvalidSender(address(0));
        }
        if (to == address(0)) {
            revert ERC20InvalidReceiver(address(0));
        }
        _update(from, to, value);
    }

    /**
     * @dev Transfers a `value` amount of tokens from `from` to `to`, or alternatively mints (or burns) if `from`
     * (or `to`) is the zero address. All customizations to transfers, mints, and burns should be done by overriding
     * this function.
     *
     * Emits a {Transfer} event.
     */
    function _update(address from, address to, uint256 value) internal virtual {
        if (from == address(0)) {
            // Overflow check required: The rest of the code assumes that totalSupply never overflows
            _totalSupply += value;
        } else {
            uint256 fromBalance = _balances[from];
            if (fromBalance < value) {
                revert ERC20InsufficientBalance(from, fromBalance, value);
            }
            unchecked {
                // Overflow not possible: value <= fromBalance <= totalSupply.
                _balances[from] = fromBalance - value;
            }
        }

        if (to == address(0)) {
            unchecked {
                // Overflow not possible: value <= totalSupply or value <= fromBalance <= totalSupply.
                _totalSupply -= value;
            }
        } else {
            unchecked {
                // Overflow not possible: balance + value is at most totalSupply, which we know fits into a uint256.
                _balances[to] += value;
            }
        }

        emit Transfer(from, to, value);
    }

    /**
     * @dev Creates a `value` amount of tokens and assigns them to `account`, by transferring it from address(0).
     * Relies on the `_update` mechanism
     *
     * Emits a {Transfer} event with `from` set to the zero address.
     *
     * NOTE: This function is not virtual, {_update} should be overridden instead.
     */
    function _mint(address account, uint256 value) internal {
        if (account == address(0)) {
            revert ERC20InvalidReceiver(address(0));
        }
        _update(address(0), account, value);
    }

    /**
     * @dev Destroys a `value` amount of tokens from `account`, lowering the total supply.
     * Relies on the `_update` mechanism.
     *
     * Emits a {Transfer} event with `to` set to the zero address.
     *
     * NOTE: This function is not virtual, {_update} should be overridden instead
     */
    function _burn(address account, uint256 value) internal {
        if (account == address(0)) {
            revert ERC20InvalidSender(address(0));
        }
        _update(account, address(0), value);
    }

    /**
     * @dev Sets `value` 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.
     *
     * Overrides to this logic should be done to the variant with an additional `bool emitEvent` argument.
     */
    function _approve(address owner, address spender, uint256 value) internal {
        _approve(owner, spender, value, true);
    }

    /**
     * @dev Variant of {_approve} with an optional flag to enable or disable the {Approval} event.
     *
     * By default (when calling {_approve}) the flag is set to true. On the other hand, approval changes made by
     * `_spendAllowance` during the `transferFrom` operation set the flag to false. This saves gas by not emitting any
     * `Approval` event during `transferFrom` operations.
     *
     * Anyone who wishes to continue emitting `Approval` events on the`transferFrom` operation can force the flag to
     * true using the following override:
     * ```
     * function _approve(address owner, address spender, uint256 value, bool) internal virtual override {
     *     super._approve(owner, spender, value, true);
     * }
     * ```
     *
     * Requirements are the same as {_approve}.
     */
    function _approve(address owner, address spender, uint256 value, bool emitEvent) internal virtual {
        if (owner == address(0)) {
            revert ERC20InvalidApprover(address(0));
        }
        if (spender == address(0)) {
            revert ERC20InvalidSpender(address(0));
        }
        _allowances[owner][spender] = value;
        if (emitEvent) {
            emit Approval(owner, spender, value);
        }
    }

    /**
     * @dev Updates `owner` s allowance for `spender` based on spent `value`.
     *
     * Does not update the allowance value in case of infinite allowance.
     * Revert if not enough allowance is available.
     *
     * Does not emit an {Approval} event.
     */
    function _spendAllowance(address owner, address spender, uint256 value) internal virtual {
        uint256 currentAllowance = allowance(owner, spender);
        if (currentAllowance != type(uint256).max) {
            if (currentAllowance < value) {
                revert ERC20InsufficientAllowance(spender, currentAllowance, value);
            }
            unchecked {
                _approve(owner, spender, currentAllowance - value, false);
            }
        }
    }
}


// File contracts/access/TokenOwner.sol

// Original license: SPDX_License_Identifier: MIT

pragma solidity ^0.8.20;

/**
 * @title TokenOwner
 * @dev Ownable contract with deployer set as initial owner.
 */
abstract contract TokenOwner is Ownable {
    /**
     * @dev Initializes the contract setting the deployer as the initial owner.
     */
    constructor() Ownable(_msgSender()) {}
}


// File contracts/token/ERC20/extensions/ERC20Decimals.sol

// Original license: SPDX_License_Identifier: MIT

pragma solidity ^0.8.20;

/**
 * @title ERC20Decimals
 * @dev Extension of ERC20 that adds decimals storage slot.
 */
abstract contract ERC20Decimals is ERC20 {
    // indicates the decimals amount
    uint8 private immutable _decimals;

    /**
     * @dev Sets the value of the `_decimals`.
     * This value is immutable, it can only be set once during construction.
     */
    constructor(uint8 decimals_) {
        _decimals = decimals_;
    }

    /**
     * @inheritdoc IERC20Metadata
     */
    function decimals() public view virtual override returns (uint8) {
        return _decimals;
    }
}


// File contracts/token/ERC20/extensions/ERC20Detailed.sol

// Original license: SPDX_License_Identifier: MIT

pragma solidity ^0.8.20;

/**
 * @title ERC20Detailed
 * @dev Extension of ERC20 and ERC20Decimals.
 */
abstract contract ERC20Detailed is ERC20Decimals {
    constructor(
        string memory name_,
        string memory symbol_,
        uint8 decimals_
    ) ERC20(name_, symbol_) ERC20Decimals(decimals_) {}
}


// File contracts/token/ERC20/extensions/ERC20Taxable.sol

// Original license: SPDX_License_Identifier: MIT

pragma solidity ^0.8.20;

/**
 * @title ERC20Taxable
 * @dev Extension of ERC20 that adds a tax rate permille.
 */
abstract contract ERC20Taxable is ERC20 {
    // the permille rate for taxable mechanism
    uint256 private _taxRate;

    // the deposit address for tax
    address private _taxAddress;

    // mapping of exclusion status for each address
    mapping(address => bool) private _isExcludedFromTaxFee;

    /**
     * @dev Indicates an error setting the tax fee.
     * @param taxRate New tax fee that is wanted to set.
     */
    error ERC20TaxableInvalidTaxFee(uint256 taxRate);

    /**
     * @dev Indicates an error setting the tax address.
     * @param taxReceiver New tax address that is wanted to set.
     */
    error ERC20TaxableInvalidTaxReceiver(address taxReceiver);

    /**
     * @dev Sets the value of the `_taxRate` and the `_taxAddress`, excludes the deployer and the tax receiver.
     */
    constructor(uint256 taxFeePerMille_, address taxAddress_) {
        _setTaxRate(taxFeePerMille_);
        _setTaxAddress(taxAddress_);
        _setExclusionFromTaxFee(_msgSender(), true);
        _setExclusionFromTaxFee(taxAddress_, true);
    }

    /**
     * @dev Returns the permille rate for taxable mechanism.
     *
     * For each transfer the permille amount will be calculated and moved to deposit address.
     */
    function taxFeePerMille() external view returns (uint256) {
        return _taxRate;
    }

    /**
     * @dev Returns the deposit address for tax.
     */
    function taxAddress() external view returns (address) {
        return _taxAddress;
    }

    /**
     * @dev Returns the status of exclusion from tax fee mechanism for a given account.
     */
    function isExcludedFromTaxFee(address account) external view returns (bool) {
        return _isExcludedFromTaxFee[account];
    }

    /**
     * @dev Moves a `value` amount of tokens from the caller's account to `to`, minus the tax fee.
     * Moves the tax fee to a deposit address.
     *
     * Requirements:
     *
     * - `to` cannot be the zero address.
     * - the caller must have a balance of at least `value`.
     */
    function transfer(address to, uint256 value) public virtual override returns (bool) {
        address owner = _msgSender();
        _transferWithFee(owner, to, value);
        return true;
    }

    /**
     @dev Moves a `value` amount of tokens from `from` to `to`, minus the tax fee, using the
     * allowance mechanism. `value` is then deducted from the caller's allowance.
     * Moves the tax fee to a deposit address.
     *
     * Requirements:
     *
     * - `from` and `to` cannot be the zero address.
     * - `from` must have a balance of at least `value`.
     * - the caller must have allowance for `from`'s tokens of at least `value`.
     */
    function transferFrom(address from, address to, uint256 value) public virtual override returns (bool) {
        address spender = _msgSender();
        super._spendAllowance(from, spender, value);
        _transferWithFee(from, to, value);
        return true;
    }

    /**
     * @dev Moves the tax fee to a deposit address and then performs the transfer.
     * @param from The address which you want to send tokens from.
     * @param to The address which you want to transfer to.
     * @param value The amount of tokens to be transferred.
     */
    function _transferWithFee(address from, address to, uint256 value) internal {
        if (_taxRate > 0 && !(_isExcludedFromTaxFee[from] || _isExcludedFromTaxFee[to])) {
            uint256 fromBalance = balanceOf(from);
            if (fromBalance < value) {
                revert ERC20InsufficientBalance(from, fromBalance, value);
            }

            uint256 taxAmount = (value * _taxRate) / 1000;

            if (taxAmount > 0) {
                super._update(from, _taxAddress, taxAmount);
                unchecked {
                    // Overflow not possible: taxAmount < amount => _taxRate is required to be < 1000.
                    value -= taxAmount;
                }
            }
        }

        super._transfer(from, to, value);
    }

    /**
     * @dev Sets the amount of tax fee permille.
     *
     * WARNING: it allows everyone to set the fee. Access controls MUST be defined in derived contracts.
     *
     * @param taxFeePerMille_ The amount of tax fee permille.
     */
    function _setTaxRate(uint256 taxFeePerMille_) internal virtual {
        if (!(taxFeePerMille_ < 1000)) {
            revert ERC20TaxableInvalidTaxFee(taxFeePerMille_);
        }

        _taxRate = taxFeePerMille_;
    }

    /**
     * @dev Sets the deposit address for tax.
     *
     * WARNING: it allows everyone to set the address. Access controls MUST be defined in derived contracts.
     *
     * @param taxAddress_ The deposit address for tax.
     */
    function _setTaxAddress(address taxAddress_) internal virtual {
        if (taxAddress_ == address(0)) {
            revert ERC20TaxableInvalidTaxReceiver(taxAddress_);
        }

        _taxAddress = taxAddress_;
    }

    /**
     * @dev Sets the exclusion status from tax fee mechanism (both sending and receiving).
     *
     * WARNING: it allows everyone to set the status. Access controls MUST be defined in derived contracts.
     *
     * @param account_ The address that will be excluded or not.
     * @param status_ The status of exclusion.
     */
    function _setExclusionFromTaxFee(address account_, bool status_) internal virtual {
        _isExcludedFromTaxFee[account_] = status_;
    }
}


// File contracts/service/ServicePayer.sol

// Original license: SPDX_License_Identifier: MIT

pragma solidity ^0.8.20;

interface IPayable {
    function pay(string calldata serviceName, bytes calldata signature, address wallet) external payable;
}

/**
 * @title ServicePayer
 * @dev Implementation of the ServicePayer.
 */
abstract contract ServicePayer {
    constructor(address payable receiver, string memory serviceName, bytes memory signature, address wallet) payable {
        IPayable(receiver).pay{value: msg.value}(serviceName, signature, wallet);
    }
}


// File contracts/token/ERC20/TaxableERC20.sol

// Original license: SPDX_License_Identifier: MIT

pragma solidity ^0.8.20;

/**
 * @title TaxableERC20
 * @dev Implementation of the TaxableERC20.
 */
contract TaxableERC20 is ERC20Detailed, ERC20Taxable, TokenOwner, ServicePayer {
    constructor(
        string memory name_,
        string memory symbol_,
        uint8 decimals_,
        uint256 initialBalance_,
        uint256 taxFeePerMille_,
        address taxAddress_,
        bytes memory signature_,
        address payable feeReceiver_
    )
        payable
        ERC20Detailed(name_, symbol_, decimals_)
        ERC20Taxable(taxFeePerMille_, taxAddress_)
        ServicePayer(feeReceiver_, "TaxableERC20", signature_, _msgSender())
    {
        require(initialBalance_ > 0, "Initial supply cannot be zero");

        _mint(_msgSender(), initialBalance_);
    }

    /**
     * @dev Sets the amount of tax fee permille.
     *
     * NOTE: restricting access to owner only. See `ERC20Taxable::_setTaxRate`.
     *
     * @param taxFeePerMille The amount of tax fee permille.
     */
    function setTaxFeePerMille(uint256 taxFeePerMille) external onlyOwner {
        super._setTaxRate(taxFeePerMille);
    }

    /**
     * @dev Sets the address where to collect tax fee.
     *
     * NOTE: restricting access to owner only. See `ERC20Taxable::_setTaxAddress`.
     *
     * @param taxAddress The deposit address for tax.
     */
    function setTaxAddress(address taxAddress) external onlyOwner {
        super._setTaxAddress(taxAddress);
    }

    /**
     * @dev Sets the exclusion status from tax fee mechanism (both sending and receiving).
     *
     * NOTE: restricting access to owner only. See `ERC20Taxable::_setExclusionFromTaxFee`.
     *
     * @param account The address that will be excluded or not.
     * @param status The status of exclusion.
     */
    function setExclusionFromTaxFee(address account, bool status) external onlyOwner {
        super._setExclusionFromTaxFee(account, status);
    }

    /**
     * @inheritdoc ERC20Taxable
     */
    function transfer(address to, uint256 value) public virtual override(ERC20, ERC20Taxable) returns (bool) {
        return super.transfer(to, value);
    }

    /**
     * @inheritdoc ERC20Taxable
     */
    function transferFrom(
        address from,
        address to,
        uint256 value
    ) public virtual override(ERC20, ERC20Taxable) returns (bool) {
        return super.transferFrom(from, to, value);
    }

    /**
     * @inheritdoc ERC20Decimals
     */
    function decimals() public view override(ERC20, ERC20Decimals) returns (uint8) {
        return super.decimals();
    }
}

• No Contract Security Audit Submitted- Submit Audit Here

[{"inputs":[{"internalType":"string","name":"name_","type":"string"},{"internalType":"string","name":"symbol_","type":"string"},{"internalType":"uint8","name":"decimals_","type":"uint8"},{"internalType":"uint256","name":"initialBalance_","type":"uint256"},{"internalType":"uint256","name":"taxFeePerMille_","type":"uint256"},{"internalType":"address","name":"taxAddress_","type":"address"},{"internalType":"bytes","name":"signature_","type":"bytes"},{"internalType":"address payable","name":"feeReceiver_","type":"address"}],"stateMutability":"payable","type":"constructor"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"allowance","type":"uint256"},{"internalType":"uint256","name":"needed","type":"uint256"}],"name":"ERC20InsufficientAllowance","type":"error"},{"inputs":[{"internalType":"address","name":"sender","type":"address"},{"internalType":"uint256","name":"balance","type":"uint256"},{"internalType":"uint256","name":"needed","type":"uint256"}],"name":"ERC20InsufficientBalance","type":"error"},{"inputs":[{"internalType":"address","name":"approver","type":"address"}],"name":"ERC20InvalidApprover","type":"error"},{"inputs":[{"internalType":"address","name":"receiver","type":"address"}],"name":"ERC20InvalidReceiver","type":"error"},{"inputs":[{"internalType":"address","name":"sender","type":"address"}],"name":"ERC20InvalidSender","type":"error"},{"inputs":[{"internalType":"address","name":"spender","type":"address"}],"name":"ERC20InvalidSpender","type":"error"},{"inputs":[{"internalType":"uint256","name":"taxRate","type":"uint256"}],"name":"ERC20TaxableInvalidTaxFee","type":"error"},{"inputs":[{"internalType":"address","name":"taxReceiver","type":"address"}],"name":"ERC20TaxableInvalidTaxReceiver","type":"error"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"OwnableInvalidOwner","type":"error"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"OwnableUnauthorizedAccount","type":"error"},{"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":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","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":[{"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":"value","type":"uint256"}],"name":"approve","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"decimals","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"isExcludedFromTaxFee","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"bool","name":"status","type":"bool"}],"name":"setExclusionFromTaxFee","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"taxAddress","type":"address"}],"name":"setTaxAddress","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"taxFeePerMille","type":"uint256"}],"name":"setTaxFeePerMille","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"taxAddress","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"taxFeePerMille","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"value","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":"value","type":"uint256"}],"name":"transferFrom","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"}]

0x608060405234801561000f575f80fd5b5060043610610111575f3560e01c806395d89b411161009e578063b7bda68f1161006e578063b7bda68f14610257578063c283cd1214610268578063c6d205fa14610293578063dd62ed3e1461029b578063f2fde38b146102d3575f80fd5b806395d89b4114610216578063a1883d261461021e578063a9059cbb14610231578063b7600f7a14610244575f80fd5b806326789993116100e4578063267899931461017b578063313ce5671461019057806370a08231146101c1578063715018a6146101e95780638da5cb5b146101f1575f80fd5b806306fdde0314610115578063095ea7b31461013357806318160ddd1461015657806323b872dd14610168575b5f80fd5b61011d6102e6565b60405161012a9190610965565b60405180910390f35b6101466101413660046109cc565b610376565b604051901515815260200161012a565b6002545b60405190815260200161012a565b6101466101763660046109f4565b61038f565b61018e610189366004610a2d565b6103a3565b005b60405160ff7f000000000000000000000000000000000000000000000000000000000000001216815260200161012a565b61015a6101cf366004610a66565b6001600160a01b03165f9081526020819052604090205490565b61018e6103d2565b6008546001600160a01b03165b6040516001600160a01b03909116815260200161012a565b61011d6103e5565b61018e61022c366004610a66565b6103f4565b61014661023f3660046109cc565b610408565b61018e610252366004610a7f565b61041a565b6006546001600160a01b03166101fe565b610146610276366004610a66565b6001600160a01b03165f9081526007602052604090205460ff1690565b60055461015a565b61015a6102a9366004610a96565b6001600160a01b039182165f90815260016020908152604080832093909416825291909152205490565b61018e6102e1366004610a66565b61042b565b6060600380546102f590610ac7565b80601f016020809104026020016040519081016040528092919081815260200182805461032190610ac7565b801561036c5780601f106103435761010080835404028352916020019161036c565b820191905f5260205f20905b81548152906001019060200180831161034f57829003601f168201915b5050505050905090565b5f3361038381858561046a565b60019150505b92915050565b5f61039b84848461047c565b949350505050565b6103ab61049f565b6001600160a01b0382165f908152600760205260409020805460ff19168215151790555050565b6103da61049f565b6103e35f6104cc565b565b6060600480546102f590610ac7565b6103fc61049f565b6104058161051d565b50565b5f6104138383610571565b9392505050565b61042261049f565b6104058161057e565b61043361049f565b6001600160a01b03811661046157604051631e4fbdf760e01b81525f60048201526024015b60405180910390fd5b610405816104cc565b61047783838360016105a8565b505050565b5f3361048985828561067b565b6104948585856106f0565b506001949350505050565b6008546001600160a01b031633146103e35760405163118cdaa760e01b8152336004820152602401610458565b600880546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0905f90a35050565b6001600160a01b03811661054f576040516329aaeafd60e01b81526001600160a01b0382166004820152602401610458565b600680546001600160a01b0319166001600160a01b0392909216919091179055565b5f336103838185856106f0565b6103e881106105a35760405163a59708b960e01b815260048101829052602401610458565b600555565b6001600160a01b0384166105d15760405163e602df0560e01b81525f6004820152602401610458565b6001600160a01b0383166105fa57604051634a1406b160e11b81525f6004820152602401610458565b6001600160a01b038085165f908152600160209081526040808320938716835292905220829055801561067557826001600160a01b0316846001600160a01b03167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b9258460405161066c91815260200190565b60405180910390a35b50505050565b6001600160a01b038381165f908152600160209081526040808320938616835292905220545f19811461067557818110156106e257604051637dc7a0d960e11b81526001600160a01b03841660048201526024810182905260448101839052606401610458565b61067584848484035f6105a8565b5f60055411801561073b57506001600160a01b0383165f9081526007602052604090205460ff168061073957506001600160a01b0382165f9081526007602052604090205460ff165b155b156107d7576001600160a01b0383165f90815260208190526040902054818110156107925760405163391434e360e21b81526001600160a01b03851660048201526024810182905260448101839052606401610458565b5f6103e8600554846107a49190610b13565b6107ae9190610b2a565b905080156107d4576006546107ce9086906001600160a01b0316836107e2565b80830392505b50505b610477838383610908565b6001600160a01b03831661080c578060025f8282546108019190610b49565b9091555061087c9050565b6001600160a01b0383165f908152602081905260409020548181101561085e5760405163391434e360e21b81526001600160a01b03851660048201526024810182905260448101839052606401610458565b6001600160a01b0384165f9081526020819052604090209082900390555b6001600160a01b038216610898576002805482900390556108b6565b6001600160a01b0382165f9081526020819052604090208054820190555b816001600160a01b0316836001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef836040516108fb91815260200190565b60405180910390a3505050565b6001600160a01b03831661093157604051634b637e8f60e11b81525f6004820152602401610458565b6001600160a01b03821661095a5760405163ec442f0560e01b81525f6004820152602401610458565b6104778383836107e2565b5f602080835283518060208501525f5b8181101561099157858101830151858201604001528201610975565b505f604082860101526040601f19601f8301168501019250505092915050565b80356001600160a01b03811681146109c7575f80fd5b919050565b5f80604083850312156109dd575f80fd5b6109e6836109b1565b946020939093013593505050565b5f805f60608486031215610a06575f80fd5b610a0f846109b1565b9250610a1d602085016109b1565b9150604084013590509250925092565b5f8060408385031215610a3e575f80fd5b610a47836109b1565b915060208301358015158114610a5b575f80fd5b809150509250929050565b5f60208284031215610a76575f80fd5b610413826109b1565b5f60208284031215610a8f575f80fd5b5035919050565b5f8060408385031215610aa7575f80fd5b610ab0836109b1565b9150610abe602084016109b1565b90509250929050565b600181811c90821680610adb57607f821691505b602082108103610af957634e487b7160e01b5f52602260045260245ffd5b50919050565b634e487b7160e01b5f52601160045260245ffd5b808202811582820484141761038957610389610aff565b5f82610b4457634e487b7160e01b5f52601260045260245ffd5b500490565b8082018082111561038957610389610aff56fea2646970667358221220a3fd0b396f2163d18c48414bee14ccf24437c10b94633eedacbb16897eb6c79164736f6c63430008170033