ETH Price: $2,029.76 (+2.73%)

Transaction Decoder

Block:
16839925 at Mar-16-2023 10:50:23 AM +UTC
Transaction Fee:
0.008559740822559799 ETH $17.37
Gas Used:
247,237 Gas / 34.621601227 Gwei

Emitted Events:

397 0xa177fe58304598e5695105bb3b5c43e697a9e3c7.0xf9fda95d7e1555b30593092241d171240b167c8031641b1b015ffd68d06aae63( 0xf9fda95d7e1555b30593092241d171240b167c8031641b1b015ffd68d06aae63, 0x000000000000000000000000aecd4fea00199603d2cfdfb24133f060c229bc94, 0000000000000000000000000000000000000000000000000000000000000040, 0000000000000000000000000000000000000000000000000000000000000180, 0000000000000000000000000000000000000000000000000000000000000020, 0000000000000000000000000000000000000000000000000000000000000001, 0000000000000000000000000000000000000000000000000000000000000020, 000000000000000000000000ea65976cac7bbd785b134ccee1479f97aab60566, 0000000000000000000000000000000000000000000000000000000000000060, 0000000000000000000000000000000000000000000000000000000000000000, 0000000000000000000000000000000000000000000000000000000000000044, a9059cbb0000000000000000000000004174499cce4ac8e35d557bb8d3673c7b, 25c96db20000000000000000000000000000000000000000000001ccd25b0f92, b410796000000000000000000000000000000000000000000000000000000000, 0000000000000000000000000000000000000000000000000000000000000000 )
398 MESS.Transfer( from=0xa177fe58304598e5695105bb3b5c43e697a9e3c7, to=0x4174499CCe4AC8e35d557bB8D3673c7B25c96dB2, value=8500659999999999900000 )
399 0xaecd4fea00199603d2cfdfb24133f060c229bc94.0x4071f64eaf4d348c83f2d213e607d3e91ea291d1b573eb67788813d21c1e5b6d( 0x4071f64eaf4d348c83f2d213e607d3e91ea291d1b573eb67788813d21c1e5b6d, 0x0000000000000000000000003a1d10170230b74110b225f6a1bef89d0b56cbcf, 0x0000000000000000000000000000000000000000000000000000000000000149, 0x8be6fc300c1c24d2b325e2227db5d3bef48776d5480f65084fefc9be8813ead7, 00000000000000000000000000000000000000000000000000000000000000a0, 0000000000000000000000000000000000000000000000000000000000000001, 0000000000000000000000000000000000000000000000000000000000000340, 0000000000000000000000000000000000000000000000000000000000000360, 0000000000000000000000000000000000000000000000000000000000000001, 0000000000000000000000000000000000000000000000000000000000000020, 0000000000000000000000000000000000000000000000000000000000000001, 0000000000000000000000000000000000000000000000000000000000000020, 000000000000000000000000a177fe58304598e5695105bb3b5c43e697a9e3c7, 0000000000000000000000000000000000000000000000000000000000000060, 0000000000000000000000000000000000000000000000000000000000000000, 00000000000000000000000000000000000000000000000000000000000001a4, a623a8ef00000000000000000000000000000000000000000000000000000000, 0000004000000000000000000000000000000000000000000000000000000000, 0000018000000000000000000000000000000000000000000000000000000000, 0000002000000000000000000000000000000000000000000000000000000000, 0000000100000000000000000000000000000000000000000000000000000000, 00000020000000000000000000000000ea65976cac7bbd785b134ccee1479f97, aab6056600000000000000000000000000000000000000000000000000000000, 0000006000000000000000000000000000000000000000000000000000000000, 0000000000000000000000000000000000000000000000000000000000000000, 00000044a9059cbb0000000000000000000000004174499cce4ac8e35d557bb8, d3673c7b25c96db20000000000000000000000000000000000000000000001cc, d25b0f92b4107960000000000000000000000000000000000000000000000000, 0000000000000000000000000000000000000000000000000000000000000000, 0000000000000000000000000000000000000000000000000000000000000000, 0000000000000000000000000000000000000000000000000000000000000000, 0000000000000000000000000000000000000000000000000000000000000000 )

Account State Difference:

  Address   Before After State Difference Code
0x3A1D1017...d0b56cbcF
0.415934604869652372 Eth
Nonce: 177
0.407374864047092573 Eth
Nonce: 178
0.008559740822559799
(Manta-builder)
125.92602972057165036 Eth125.926051514240992423 Eth0.000021793669342063
0xAeCd4feA...0c229bc94
0xEa65976C...7Aab60566

Execution Trace

0xaecd4fea00199603d2cfdfb24133f060c229bc94.680754db( )
  • GlobalConfig.hasRole( role=0B7322EBC56F27A124C063802688BBC3635A2CE3F24ABDA3E4ADAEC5FCE31196, account=0x3A1D10170230B74110B225f6a1BEf89d0b56cbcF ) => ( has=True )
  • Null: 0x000...001.8be6fc30( )
  • GlobalConfig.hasRole( role=46A52CF33029DE9F84853745A87AF28464C80BF0346DF1B32E205FC73319F622, account=0x29a4b03Dfa539AF9e3E81a5E12a338EA60DC5dB4 ) => ( has=True )
  • Null: 0x000...001.8be6fc30( )
  • GlobalConfig.hasRole( role=AC02C3C644549AC65116CF5A9937AEA85546E641364A9AF91A36EDA41A13B7E6, account=0x520a829052ED08fA5109AF502bE84cce638D9F7c ) => ( has=True )
  • 0xaecd4fea00199603d2cfdfb24133f060c229bc94.5e060d79( )
    • 0xa177fe58304598e5695105bb3b5c43e697a9e3c7.a623a8ef( )
      • GlobalConfig.hasRole( role=C8D0EB786D8EDE55E6A1B6CEF6634EA7DD4625CDB7A2AD54AB5FE5C54B43D013, account=0xAeCd4feA00199603d2cFdfb24133F060c229bc94 ) => ( has=True )
      • MESS.transfer( to=0x4174499CCe4AC8e35d557bB8D3673c7B25c96dB2, amount=8500659999999999900000 ) => ( True )
        • GlobalConfig.hasRole( role=0000000000000000000000000000000000000000000000000000000000000000, account=0xA177Fe58304598E5695105Bb3b5c43e697A9e3c7 ) => ( has=False )
        • GlobalConfig.hasRole( role=A49807205CE4D355092EF5A8A18F56E8913CF4A201FBE287825B095693C21775, account=0xA177Fe58304598E5695105Bb3b5c43e697A9e3c7 ) => ( has=False )
        • GlobalConfig.hasRole( role=ECEEF7797AF2E02F3081F740231D7A12B7F97400383D3FFDFA8953C62ACB4708, account=0xA177Fe58304598E5695105Bb3b5c43e697A9e3c7 ) => ( has=False )
        • GlobalConfig.hasRole( role=0000000000000000000000000000000000000000000000000000000000000000, account=0x4174499CCe4AC8e35d557bB8D3673c7B25c96dB2 ) => ( has=False )
        • GlobalConfig.hasRole( role=A49807205CE4D355092EF5A8A18F56E8913CF4A201FBE287825B095693C21775, account=0x4174499CCe4AC8e35d557bB8D3673c7B25c96dB2 ) => ( has=False )
        • GlobalConfig.hasRole( role=ECEEF7797AF2E02F3081F740231D7A12B7F97400383D3FFDFA8953C62ACB4708, account=0x4174499CCe4AC8e35d557bB8D3673c7B25c96dB2 ) => ( has=False )
          File 1 of 2: MESS
          // SPDX-License-Identifier: MIT
          pragma solidity >=0.8.0 <0.9.0;
          import "./ContextMess.sol"; 
          import "@openzeppelin/contracts/token/ERC20/ERC20.sol";
          import "@openzeppelin/contracts/security/Pausable.sol";
          contract MESS is ContextMess, ERC20 ,Pausable{
              struct TransferParam {
                  address to;
                  uint256 amount;
              }
              constructor(address config_) ERC20("MESS", "MESS") {
                  _checkConfig(IConfig(config_));
              } 
              // =============================================================
              // about mint burn and transfer
              // relate with "@openzeppelin/contracts/security/Pausable.sol";
              // =============================================================
              // mint token to treasury wallet,only minter can do this.
              function mint(uint256 amount) public isMinter {
                  address to = _TreasuryWalletContract();
                  super._mint(to, amount);
              }
              //burn token , only burner can do this.
              function burn(uint256 amount) public isBurner {
                  _burn(_msgSender(), amount);
              }
              //batch transfer token to other address
              function batchTransfer(TransferParam[] memory transfers) public isTransferer {
                  for (uint256 i = 0; i < transfers.length; i++) {
                      super._transfer(_TreasuryWalletContract(), transfers[i].to, transfers[i].amount);
                  }
              }
              //deny transfer when paused or address in the blacklist
              function _beforeTokenTransfer(
                  address from,
                  address to,
                  uint256 amount
              ) internal override whenNotPaused isNotInTheBlacklist(from) isNotInTheBlacklist(to) {
                  super._beforeTokenTransfer(from, to, amount);
              }
              // =============================================================
              // about pause and unpause
              // relate with "@openzeppelin/contracts/security/Pausable.sol";
              // =============================================================
              //pause transfer function,only pauser can do this.
              function pause() public isPauser {
                  _pause();
              }
              //unpause transfer function
              function unpause() public isPauser {
                  _unpause();
              }
          }// SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.7.0) (security/Pausable.sol)
          pragma solidity ^0.8.0;
          import "../utils/Context.sol";
          /**
           * @dev Contract module which allows children to implement an emergency stop
           * mechanism that can be triggered by an authorized account.
           *
           * This module is used through inheritance. It will make available the
           * modifiers `whenNotPaused` and `whenPaused`, which can be applied to
           * the functions of your contract. Note that they will not be pausable by
           * simply including this module, only once the modifiers are put in place.
           */
          abstract contract Pausable is Context {
              /**
               * @dev Emitted when the pause is triggered by `account`.
               */
              event Paused(address account);
              /**
               * @dev Emitted when the pause is lifted by `account`.
               */
              event Unpaused(address account);
              bool private _paused;
              /**
               * @dev Initializes the contract in unpaused state.
               */
              constructor() {
                  _paused = false;
              }
              /**
               * @dev Modifier to make a function callable only when the contract is not paused.
               *
               * Requirements:
               *
               * - The contract must not be paused.
               */
              modifier whenNotPaused() {
                  _requireNotPaused();
                  _;
              }
              /**
               * @dev Modifier to make a function callable only when the contract is paused.
               *
               * Requirements:
               *
               * - The contract must be paused.
               */
              modifier whenPaused() {
                  _requirePaused();
                  _;
              }
              /**
               * @dev Returns true if the contract is paused, and false otherwise.
               */
              function paused() public view virtual returns (bool) {
                  return _paused;
              }
              /**
               * @dev Throws if the contract is paused.
               */
              function _requireNotPaused() internal view virtual {
                  require(!paused(), "Pausable: paused");
              }
              /**
               * @dev Throws if the contract is not paused.
               */
              function _requirePaused() internal view virtual {
                  require(paused(), "Pausable: not paused");
              }
              /**
               * @dev Triggers stopped state.
               *
               * Requirements:
               *
               * - The contract must not be paused.
               */
              function _pause() internal virtual whenNotPaused {
                  _paused = true;
                  emit Paused(_msgSender());
              }
              /**
               * @dev Returns to normal state.
               *
               * Requirements:
               *
               * - The contract must be paused.
               */
              function _unpause() internal virtual whenPaused {
                  _paused = false;
                  emit Unpaused(_msgSender());
              }
          }
          // 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 {}
          }
          //SPDX-License-Identifier: MIT
          pragma solidity >=0.8.0 <0.9.0;
          import "../IConfig.sol";
          import "../Registry.sol";
          contract ContextMess  {
              
              IConfig public config;
              function _checkConfig(IConfig config_) internal {
                  require(config_.version() > 0 || config_.supportsInterface(type(IConfig).interfaceId), "ERC20: not a valid config contract");
                  config = config_;
              }
              function _TreasuryWalletContract() internal view returns (address) {
                  bytes32 _key = Registry.TREASURYWALLET_KEY;
                  address to = _getContractAddress(_key);
                  require(to != address(0), "ERC20: treasurywallet contract not found");
                  return to;
              }
              function _getContractAddress(bytes32 key) internal view returns (address) {
                  (bytes32 typeID, bytes memory data) = config.getRawValue(key);
                  return bytesToAddress(typeID, data);
              }
              function bytesToAddress(bytes32 typeID, bytes memory data) internal pure returns (address addr) {
                  require(typeID == Registry.ADDRESS_HASH, "ERC20: wrong typeID");
                  addr = abi.decode(data, (address));
              }
              modifier onlyAdmin() {
                  require(config.hasRole(Registry.ADMIN_ROLE, msg.sender), "ERC20: caller is not the admin role");
                  _;
              }
              modifier isMinter() {
                  require(config.hasRole(Registry.MINTER_ROLE, msg.sender), "ERC20: caller is not the minter role");
                  _;
              }
              modifier isBurner() {
                  require(config.hasRole(Registry.BURNER_ROLE, msg.sender), "ERC20: caller is not the burner role");
                  _;
              }
              modifier isTransferer() {
                  require(config.hasRole(Registry.TRANSFER_ROLE, msg.sender), "ERC20: caller is not the transferer role");
                  _;
              }
              modifier isNotInTheBlacklist(address account) {
                  require(config.hasRole(Registry.SUPER_ADMIN_ROLE, account) || config.hasRole(Registry.ADMIN_ROLE, account)  || !config.hasRole(Registry.BLACKLIST_ROLE, account), "SN119:  address is restricted at the moment");
                  _;
              }
              modifier isPauser() {
                  require(config.hasRole(Registry.PAUSER_ROLE, msg.sender), "ERC20: caller is not the pauser role");
                  _;
              }
          }
          // SPDX-License-Identifier: MIT
          pragma solidity >=0.8.0 <0.9.0;
          library Registry {
              
              // =============================================================
              // about role
              // =============================================================
              // SUPER_ADMIN_ROLE
              bytes32 internal constant SUPER_ADMIN_ROLE = 0x0000000000000000000000000000000000000000000000000000000000000000;
              // keccak256("ADMIN_ROLE");
              bytes32 internal constant ADMIN_ROLE = 0xa49807205ce4d355092ef5a8a18f56e8913cf4a201fbe287825b095693c21775;
              // keccak256("minter.role")
              bytes32 internal constant MINTER_ROLE = 0xb7400b17e52d343f741138df9e91f7b1f847b285f261edc36ddf5d104892f80d;
              // keccak256("burner.role")
              bytes32 internal constant BURNER_ROLE = 0x67ddb8e48ce0d66032a44701598dde318e9e357db26bb3a846b15f87ffdb8369;
              // keccak256("transfer.role")
              bytes32 internal constant TRANSFER_ROLE = 0xd9075b04fc9576b33d6513403323ecc334609c7afb3004ab47244ebef1d5ccd1;
              // keccak256("blacklist.role")
              bytes32 internal constant BLACKLIST_ROLE = 0xeceef7797af2e02f3081f740231d7a12b7f97400383d3ffdfa8953c62acb4708;
              // keccak256("pauser.role")
              bytes32 internal constant PAUSER_ROLE = 0xa67d36adcd6e3e45eaf6d65fa285a008bff25153247f18ac567589f1f32c3460;
              // =============================================================
              // about KV
              // =============================================================
              // keccak256("treasurywallet.key");
              bytes32 internal constant TREASURYWALLET_KEY = 0xe3bb4fe41787a18688c48ea64caf92a2bae2555227aaef6d464b886efb453118;
              // keccak256("operationwallet.key")
              bytes32 internal constant OPERATIONWALLET_KEY = 0x265545640c0c4e566d10fc3f1073314df9d9f30336f39c054903d28124930538;
              // keccak256("hotwallet.key")
              bytes32 internal constant HOTWALLET_KEY = 0x5a9627b84796698a4e50d2d61a91ce59358fe3945a467b2b94968cb135c41531;
              // keccak256("uint256");
              bytes32 internal constant UINT256_HASH = 0xec13d6d12b88433319b64e1065a96ea19cd330ef6603f5f6fb685dde3959a320;
              // keccak256("address");
              bytes32 internal constant ADDRESS_HASH = 0x421683f821a0574472445355be6d2b769119e8515f8376a1d7878523dfdecf7b;
          }// SPDX-License-Identifier: MIT
          pragma solidity >=0.8.0 <0.9.0;
          interface IConfig {
            function version() external pure returns (uint256 v);
            function getRawValue(bytes32 key) external view returns(bytes32 typeID, bytes memory data);
            function hasRole(bytes32 role, address account) external view returns(bool has);
            function supportsInterface(bytes4 interfaceId) external view returns (bool);
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts v4.4.1 (utils/Context.sol)
          pragma solidity ^0.8.0;
          /**
           * @dev Provides information about the current execution context, including the
           * sender of the transaction and its data. While these are generally available
           * via msg.sender and msg.data, they should not be accessed in such a direct
           * manner, since when dealing with meta-transactions the account sending and
           * paying for execution may not be the actual sender (as far as an application
           * is concerned).
           *
           * This contract is only required for intermediate, library-like contracts.
           */
          abstract contract Context {
              function _msgSender() internal view virtual returns (address) {
                  return msg.sender;
              }
              function _msgData() internal view virtual returns (bytes calldata) {
                  return msg.data;
              }
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/IERC20Metadata.sol)
          pragma solidity ^0.8.0;
          import "../IERC20.sol";
          /**
           * @dev Interface for the optional metadata functions from the ERC20 standard.
           *
           * _Available since v4.1._
           */
          interface IERC20Metadata is IERC20 {
              /**
               * @dev Returns the name of the token.
               */
              function name() external view returns (string memory);
              /**
               * @dev Returns the symbol of the token.
               */
              function symbol() external view returns (string memory);
              /**
               * @dev Returns the decimals places of the token.
               */
              function decimals() external view returns (uint8);
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts (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 2 of 2: GlobalConfig
          // SPDX-License-Identifier: MIT
          pragma solidity >=0.8.0 <0.9.0;
          import "./IGlobalConfig.sol";
          import "../library/Registry.sol";
          import "../library/LEnumerableMetadata.sol";
          import "@openzeppelin/contracts/access/AccessControlEnumerable.sol";
          contract GlobalConfig is IGlobalConfig, AccessControlEnumerable {
              using LEnumerableMetadata for LEnumerableMetadata.MetadataSet;
              LEnumerableMetadata.MetadataSet private _configSet;
              // roleID -> fatherRoleID.
              // one addr in fatherRole, the addr also in children role.
              mapping(bytes32=>bytes32) public fatherRoleMap;
              constructor(address superAdmin) {
                  if (superAdmin == address(0)) revert("GlobalConfig cannot be created");
                  _setupRole(Registry.SUPER_ADMIN_ROLE, superAdmin);
                  _configSet._init();
              }
              function supportsInterface(bytes4 interfaceId) public view virtual override(IConfig, AccessControlEnumerable) returns (bool) {
                return interfaceId == type(IGlobalConfig).interfaceId || interfaceId == type(IConfig).interfaceId || super.supportsInterface(interfaceId);
              }
              function version() external pure returns (uint256 v) {
                  return 1;
              }
              function revokeRole(bytes32 role, address account) external override isRoleAdmin(role){
                  require (role != Registry.SUPER_ADMIN_ROLE || getRoleMemberCount(role) > 1, "SC101: one super admin exists at a minimum");
                  _revokeRole(role, account);
              }
              function renounceRole(bytes32 role, address account) external override {
                  require (role != Registry.SUPER_ADMIN_ROLE || getRoleMemberCount(role) > 1, "SC101: one super admin exists at a minimum");
                  super.renounceRole(role, account);
              }
              function hasRole(bytes32 role, address account) external view override(IAccessControl, IConfig) returns (bool has) {
                if(super.hasRole(role, account)){
                  return true;
                }
                // the father role map default value is super admin role.
                if(super.hasRole(fatherRoleMap[role], account)){
                  return true;
                }
                // if addr is role admin, so the addr has the role.
                if(super.hasRole(getRoleAdmin(role), account)){
                  return true;
                }
                
                if (super.hasRole(Registry.SUPER_ADMIN_ROLE, account)) {
                  return true;
                }
                return false;
              }
              function checkAdmin(address account) public view returns(bool) {
                // hasRole always check superadmin.
                return hasRole(Registry.ADMIN_ROLE, account);
              }
              modifier isAdmin() {
                  require(checkAdmin(msg.sender), "SC102: invoke restricted to admin role");
                  _;
              }
              modifier isSuperAdmin(){
                  _checkRole(Registry.SUPER_ADMIN_ROLE, msg.sender);
                  _;
              }
              modifier checkNotAdminRole(bytes32 role){
                require(role != Registry.SUPER_ADMIN_ROLE && role != Registry.ADMIN_ROLE, "SC103: ask for neither super admin nor admin role");
                _;
              }
              modifier isRoleAdmin(bytes32 role){
                require(super.hasRole(getRoleAdmin(role), msg.sender) || super.hasRole(Registry.SUPER_ADMIN_ROLE, msg.sender), "SC104: not role admin");
                _;
              }
              function setFatherRole(bytes32 role, bytes32 fatherRole) external isSuperAdmin checkNotAdminRole(role){
                require(getRoleAdmin(fatherRole) != role, "SC105: fatherRole admin can't equal role");
                require(role != fatherRole, "SC106: role == fatherRole");
                fatherRoleMap[role] = fatherRole;
              }
              function setRoleAdmin(bytes32 role, bytes32 adminRole) public isSuperAdmin checkNotAdminRole(role){
                require(fatherRoleMap[adminRole] != role, "SC105: adminRole's admin can't equal role");
                require(role != adminRole, "SC106: role == adminRole");
                _setRoleAdmin(role, adminRole);
              }
              function grantRole(bytes32 role, address account) public override isRoleAdmin(role){
                super._grantRole(role, account);
              }
              function getRawValue(bytes32 key) public view override returns(bytes32 typeID, bytes memory data){
                  return _configSet._get(key);
              }
              function getKey(string memory keyStr) public pure override returns(bytes32 key){
                  return LEnumerableMetadata._getKeyID(keyStr);
              }
              function getAllkeys(string memory startKey, uint256 pageSize) public view returns (string[] memory keys) {
                  return _configSet._getAllKeys(startKey, pageSize);
              }
              function setKVs(bytes[] memory mds) public isAdmin {
                  _configSet._setBytesSlice(mds);
                  for (uint256 i = 0; i < mds.length; i++) {
                      (string memory keyStr, bytes32 typeID, bytes memory data) = abi.decode(mds[i], (string, bytes32, bytes));
                      emit SetKVEvent(getKey(keyStr), keyStr, typeID, data);
                  }
              }
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.5.0) (access/AccessControlEnumerable.sol)
          pragma solidity ^0.8.0;
          import "./IAccessControlEnumerable.sol";
          import "./AccessControl.sol";
          import "../utils/structs/EnumerableSet.sol";
          /**
           * @dev Extension of {AccessControl} that allows enumerating the members of each role.
           */
          abstract contract AccessControlEnumerable is IAccessControlEnumerable, AccessControl {
              using EnumerableSet for EnumerableSet.AddressSet;
              mapping(bytes32 => EnumerableSet.AddressSet) private _roleMembers;
              /**
               * @dev See {IERC165-supportsInterface}.
               */
              function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
                  return interfaceId == type(IAccessControlEnumerable).interfaceId || super.supportsInterface(interfaceId);
              }
              /**
               * @dev Returns one of the accounts that have `role`. `index` must be a
               * value between 0 and {getRoleMemberCount}, non-inclusive.
               *
               * Role bearers are not sorted in any particular way, and their ordering may
               * change at any point.
               *
               * WARNING: When using {getRoleMember} and {getRoleMemberCount}, make sure
               * you perform all queries on the same block. See the following
               * https://forum.openzeppelin.com/t/iterating-over-elements-on-enumerableset-in-openzeppelin-contracts/2296[forum post]
               * for more information.
               */
              function getRoleMember(bytes32 role, uint256 index) public view virtual override returns (address) {
                  return _roleMembers[role].at(index);
              }
              /**
               * @dev Returns the number of accounts that have `role`. Can be used
               * together with {getRoleMember} to enumerate all bearers of a role.
               */
              function getRoleMemberCount(bytes32 role) public view virtual override returns (uint256) {
                  return _roleMembers[role].length();
              }
              /**
               * @dev Overload {_grantRole} to track enumerable memberships
               */
              function _grantRole(bytes32 role, address account) internal virtual override {
                  super._grantRole(role, account);
                  _roleMembers[role].add(account);
              }
              /**
               * @dev Overload {_revokeRole} to track enumerable memberships
               */
              function _revokeRole(bytes32 role, address account) internal virtual override {
                  super._revokeRole(role, account);
                  _roleMembers[role].remove(account);
              }
          }
          //SPDX-License-Identifier: MIT
          pragma solidity ^0.8.0;
          import "./LChainLink.sol";
          library LEnumerableMetadata {
              using LChainLink for LChainLink.Link;
              // chain.
              // "map key" is keccak256("key")
              struct Metadata {
                  string key;
                  bytes32 typeID;
                  bytes data;
                  LChainLink.Link link;
              }
              struct MetadataSet {
                  mapping(bytes32 => Metadata) kvData;
                  uint256 size;
              }
              function _getKeyID(string memory key) internal pure returns (bytes32) {
                  require(bytes(key).length != 0, "key is empty");
                  bytes32 id = keccak256(abi.encodePacked(key));
                  require(!LChainLink._isEmpty(id), "id error");
                  return id;
              }
              function _init(MetadataSet storage m) internal {
                  m.kvData[LChainLink.SENTINEL_ID].link._init();
              }
              function _checkKvDatas(bytes[] memory kvDatas) internal pure {
                  for (uint256 i = 0; i < kvDatas.length; i++) {
                      _parseKvData(kvDatas[i]);
                  }
              }
              function _parseKvData(bytes memory data)
                  internal
                  pure
                  returns (
                      string memory,
                      bytes32,
                      bytes memory
                  )
              {
                  return abi.decode(data, (string, bytes32, bytes));
              }
              function _encodeKvData(
                  string memory key,
                  bytes32 typeID,
                  bytes memory data,
                  string memory desc
              ) internal pure returns (bytes memory) {
                  return abi.encode(key, typeID, data, desc);
              }
              function _setBytesSlice(MetadataSet storage m, bytes[] memory mds)
                  internal
              {
                  for (uint256 i = 0; i < mds.length; i++) {
                      (
                          string memory key,
                          bytes32 typeID,
                          bytes memory data
                      ) = _parseKvData(mds[i]);
                      if (data.length == 0) {
                          _del(m, key);
                      } else {
                          _addOrChange(m, key, typeID, data);
                      }
                  }
              }
              function _addOrChange(
                  MetadataSet storage m,
                  string memory key,
                  bytes32 typeID,
                  bytes memory data
              ) internal {
                  bytes32 keyID = _getKeyID(key);
                  Metadata storage md = m.kvData[keyID];
                  if (!md.link._isEmpty()) {
                      // change data
                      if (md.typeID != typeID) {
                          md.typeID = typeID;
                      }
                      md.data = data;
                      return;
                  }
                  // add data
                  md.key = key;
                  md.typeID = typeID;
                  md.data = data;
                  Metadata storage sentinel = m.kvData[LChainLink.SENTINEL_ID];
                  md.link._addItemLink(
                      sentinel.link,
                      m.kvData[sentinel.link.next].link,
                      keyID
                  );
                  m.size++;
              }
              function _del(MetadataSet storage m, string memory key) internal {
                  bytes32 keyID = _getKeyID(key);
                  Metadata storage md = m.kvData[keyID];
                  if (md.link._isEmpty()) {
                      return;
                  }
                  md.link._delItemLink(
                      m.kvData[md.link.pre].link,
                      m.kvData[md.link.next].link
                  );
                  delete m.kvData[keyID];
                  m.size--;
              }
              function _getByKey(MetadataSet storage m, string memory key)
                  internal
                  view
                  returns (bytes32 typeID, bytes memory data)
              {
                  return _get(m, _getKeyID(key));
              }
              function _get(MetadataSet storage m, bytes32 keyID)
                  internal
                  view
                  returns (bytes32 typeID, bytes memory data)
              {
                  Metadata storage md = m.kvData[keyID];
                  return (md.typeID, md.data);
              }
              function _getAllKeys(
                  MetadataSet storage m,
                  string memory startKey,
                  uint256 pageSize
              ) internal view returns (string[] memory keys) {
                  keys = new string[](pageSize);
                  uint256 idx = 0;
                  bytes32 nowKeyID;
                  if (bytes(startKey).length == 0) {
                      nowKeyID = LChainLink.SENTINEL_ID;
                  } else {
                      nowKeyID = _getKeyID(startKey);
                  }
                  nowKeyID = m.kvData[nowKeyID].link._getNextID();
                  while (idx < pageSize && !LChainLink._isEmpty(nowKeyID)) {
                      Metadata storage md = m.kvData[nowKeyID];
                      keys[idx] = md.key;
                      nowKeyID = md.link._getNextID();
                      idx++;
                  }
                  assembly {
                      mstore(keys, idx)
                  }
                  return keys;
              }
              // return encode(string key, bytes32 typeID, bytes value)[]
              function _getAll(
                  MetadataSet storage m,
                  string memory startKey,
                  uint256 pageSize
              ) internal view returns (bytes[] memory datas) {
                  datas = new bytes[](pageSize);
                  uint256 idx = 0;
                  bytes32 nowKeyID;
                  if (bytes(startKey).length == 0) {
                      nowKeyID = LChainLink.SENTINEL_ID;
                  } else {
                      nowKeyID = _getKeyID(startKey);
                  }
                  nowKeyID = m.kvData[nowKeyID].link._getNextID();
                  while (idx < pageSize && !LChainLink._isEmpty(nowKeyID)) {
                      Metadata storage md = m.kvData[nowKeyID];
                      datas[idx] = abi.encode(md.key, md.typeID, md.data);
                      nowKeyID = md.link._getNextID();
                      idx++;
                  }
                  assembly {
                      mstore(datas, idx)
                  }
                  return datas;
              }
          }// SPDX-License-Identifier: MIT
          pragma solidity >=0.8.0 <0.9.0;
          library Registry {
            /***************************** ROLE NAME CONSTANT VARIABLES  ***********************************/
            // SUPER_ADMIN_ROLE
            bytes32 internal constant SUPER_ADMIN_ROLE = 0x0000000000000000000000000000000000000000000000000000000000000000;
            // keccak256("ADMIN_ROLE");
            bytes32 internal constant ADMIN_ROLE = 0xa49807205ce4d355092ef5a8a18f56e8913cf4a201fbe287825b095693c21775;
            // keccak256("only.on.chain");
            bytes32 internal constant ONLY_ON_CHAIN = 0x0b7322ebc56f27a124c063802688bbc3635a2ce3f24abda3e4adaec5fce31196;
          }
          // SPDX-License-Identifier: MIT
          pragma solidity >=0.8.0 <0.9.0;
          import "./IConfig.sol";
          interface IGlobalConfig is IConfig {
            event SetKVEvent(bytes32 indexed key, string keyStr, bytes32 typeID, bytes data);
            function getKey(string memory keyStr) external pure returns(bytes32 key);
            
            function setKVs(bytes[] memory mds) external;
          }
          //SPDX-License-Identifier: MIT
          pragma solidity ^0.8.0;
          library LChainLink {
              struct Link {
                  bytes32 id;
                  bytes32 next;
                  bytes32 pre;
              }
              bytes32 internal constant SENTINEL_ID =
                  bytes32(
                      0x0000000000000000000000000000000000000000000000000000000000000001
                  );
              address internal constant SENTINEL_ADDR = address(0x1);
              //////////////////// for bytes32
              function _isEmpty(bytes32 id) internal pure returns (bool) {
                  if (id == bytes32(0x0) || id == SENTINEL_ID) {
                      return true;
                  }
                  return false;
              }
              function _isEmpty(Link storage link) internal view returns (bool) {
                  if (
                      link.id == bytes32(0x0) ||
                      (link.next == link.pre && link.next == bytes32(0x0))
                  ) {
                      return true;
                  }
                  return false;
              }
              function _init(Link storage link) internal {
                  if (!_isEmpty(link)) {
                      return;
                  }
                  link.id = SENTINEL_ID;
                  link.next = SENTINEL_ID;
                  link.pre = SENTINEL_ID;
              }
              function _addItemLink(
                  Link storage item,
                  Link storage sentinel,
                  Link storage next,
                  bytes32 itemID
              ) internal {
                  require(
                      sentinel.next == next.id && next.pre == SENTINEL_ID,
                      "add link error"
                  );
                  item.id = itemID;
                  item.next = sentinel.next;
                  item.pre = SENTINEL_ID;
                  next.pre = itemID;
                  sentinel.next = itemID;
              }
              function _delItemLink(
                  Link storage item,
                  Link storage pre,
                  Link storage next
              ) internal {
                  require(pre.next == item.id && next.pre == item.id, "del link error");
                  item.id = bytes32(0x0);
                  item.next = bytes32(0x0);
                  item.pre = bytes32(0x0);
                  pre.next = next.id;
                  next.pre = pre.id;
              }
              function _getNextID(Link storage item) internal view returns (bytes32) {
                  // require(item.next != bytes32(0x0), "get link next error");
                  return item.next;
              }
              function _getPreID(Link storage item) internal view returns (bytes32) {
                  // require(item.pre != bytes32(0x0), "get link pre error");
                  return item.pre;
              }
              //////////////////// for address
              function _isEmpty(address addr) internal pure returns (bool) {
                  return _isEmpty(bytes32(uint256(uint160(addr))));
              }
              function _addItemLink(
                  Link storage item,
                  Link storage sentinel,
                  Link storage next,
                  address itemAddr
              ) internal {
                  _addItemLink(item, sentinel, next, bytes32(uint256(uint160(itemAddr))));
              }
              function _getNextAddr(Link storage item) internal view returns (address) {
                  return address(uint160(uint256(_getNextID(item))));
              }
              function _getPreAddr(Link storage item) internal view returns (address) {
                  return address(uint160(uint256(_getPreID(item))));
              }
          }// SPDX-License-Identifier: MIT
          pragma solidity >=0.8.0 <0.9.0;
          interface IConfig {
            function version() external pure returns (uint256 v);
            function getRawValue(bytes32 key) external view returns(bytes32 typeID, bytes memory data);
            function hasRole(bytes32 role, address account) external view returns(bool has);
            function supportsInterface(bytes4 interfaceId) external view returns (bool);
            
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.7.0) (utils/structs/EnumerableSet.sol)
          pragma solidity ^0.8.0;
          /**
           * @dev Library for managing
           * https://en.wikipedia.org/wiki/Set_(abstract_data_type)[sets] of primitive
           * types.
           *
           * Sets have the following properties:
           *
           * - Elements are added, removed, and checked for existence in constant time
           * (O(1)).
           * - Elements are enumerated in O(n). No guarantees are made on the ordering.
           *
           * ```
           * contract Example {
           *     // Add the library methods
           *     using EnumerableSet for EnumerableSet.AddressSet;
           *
           *     // Declare a set state variable
           *     EnumerableSet.AddressSet private mySet;
           * }
           * ```
           *
           * As of v3.3.0, sets of type `bytes32` (`Bytes32Set`), `address` (`AddressSet`)
           * and `uint256` (`UintSet`) are supported.
           *
           * [WARNING]
           * ====
           *  Trying to delete such a structure from storage will likely result in data corruption, rendering the structure unusable.
           *  See https://github.com/ethereum/solidity/pull/11843[ethereum/solidity#11843] for more info.
           *
           *  In order to clean an EnumerableSet, you can either remove all elements one by one or create a fresh instance using an array of EnumerableSet.
           * ====
           */
          library EnumerableSet {
              // To implement this library for multiple types with as little code
              // repetition as possible, we write it in terms of a generic Set type with
              // bytes32 values.
              // The Set implementation uses private functions, and user-facing
              // implementations (such as AddressSet) are just wrappers around the
              // underlying Set.
              // This means that we can only create new EnumerableSets for types that fit
              // in bytes32.
              struct Set {
                  // Storage of set values
                  bytes32[] _values;
                  // Position of the value in the `values` array, plus 1 because index 0
                  // means a value is not in the set.
                  mapping(bytes32 => uint256) _indexes;
              }
              /**
               * @dev Add a value to a set. O(1).
               *
               * Returns true if the value was added to the set, that is if it was not
               * already present.
               */
              function _add(Set storage set, bytes32 value) private returns (bool) {
                  if (!_contains(set, value)) {
                      set._values.push(value);
                      // The value is stored at length-1, but we add 1 to all indexes
                      // and use 0 as a sentinel value
                      set._indexes[value] = set._values.length;
                      return true;
                  } else {
                      return false;
                  }
              }
              /**
               * @dev Removes a value from a set. O(1).
               *
               * Returns true if the value was removed from the set, that is if it was
               * present.
               */
              function _remove(Set storage set, bytes32 value) private returns (bool) {
                  // We read and store the value's index to prevent multiple reads from the same storage slot
                  uint256 valueIndex = set._indexes[value];
                  if (valueIndex != 0) {
                      // Equivalent to contains(set, value)
                      // To delete an element from the _values array in O(1), we swap the element to delete with the last one in
                      // the array, and then remove the last element (sometimes called as 'swap and pop').
                      // This modifies the order of the array, as noted in {at}.
                      uint256 toDeleteIndex = valueIndex - 1;
                      uint256 lastIndex = set._values.length - 1;
                      if (lastIndex != toDeleteIndex) {
                          bytes32 lastValue = set._values[lastIndex];
                          // Move the last value to the index where the value to delete is
                          set._values[toDeleteIndex] = lastValue;
                          // Update the index for the moved value
                          set._indexes[lastValue] = valueIndex; // Replace lastValue's index to valueIndex
                      }
                      // Delete the slot where the moved value was stored
                      set._values.pop();
                      // Delete the index for the deleted slot
                      delete set._indexes[value];
                      return true;
                  } else {
                      return false;
                  }
              }
              /**
               * @dev Returns true if the value is in the set. O(1).
               */
              function _contains(Set storage set, bytes32 value) private view returns (bool) {
                  return set._indexes[value] != 0;
              }
              /**
               * @dev Returns the number of values on the set. O(1).
               */
              function _length(Set storage set) private view returns (uint256) {
                  return set._values.length;
              }
              /**
               * @dev Returns the value stored at position `index` in the set. O(1).
               *
               * Note that there are no guarantees on the ordering of values inside the
               * array, and it may change when more values are added or removed.
               *
               * Requirements:
               *
               * - `index` must be strictly less than {length}.
               */
              function _at(Set storage set, uint256 index) private view returns (bytes32) {
                  return set._values[index];
              }
              /**
               * @dev Return the entire set in an array
               *
               * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
               * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
               * this function has an unbounded cost, and using it as part of a state-changing function may render the function
               * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
               */
              function _values(Set storage set) private view returns (bytes32[] memory) {
                  return set._values;
              }
              // Bytes32Set
              struct Bytes32Set {
                  Set _inner;
              }
              /**
               * @dev Add a value to a set. O(1).
               *
               * Returns true if the value was added to the set, that is if it was not
               * already present.
               */
              function add(Bytes32Set storage set, bytes32 value) internal returns (bool) {
                  return _add(set._inner, value);
              }
              /**
               * @dev Removes a value from a set. O(1).
               *
               * Returns true if the value was removed from the set, that is if it was
               * present.
               */
              function remove(Bytes32Set storage set, bytes32 value) internal returns (bool) {
                  return _remove(set._inner, value);
              }
              /**
               * @dev Returns true if the value is in the set. O(1).
               */
              function contains(Bytes32Set storage set, bytes32 value) internal view returns (bool) {
                  return _contains(set._inner, value);
              }
              /**
               * @dev Returns the number of values in the set. O(1).
               */
              function length(Bytes32Set storage set) internal view returns (uint256) {
                  return _length(set._inner);
              }
              /**
               * @dev Returns the value stored at position `index` in the set. O(1).
               *
               * Note that there are no guarantees on the ordering of values inside the
               * array, and it may change when more values are added or removed.
               *
               * Requirements:
               *
               * - `index` must be strictly less than {length}.
               */
              function at(Bytes32Set storage set, uint256 index) internal view returns (bytes32) {
                  return _at(set._inner, index);
              }
              /**
               * @dev Return the entire set in an array
               *
               * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
               * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
               * this function has an unbounded cost, and using it as part of a state-changing function may render the function
               * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
               */
              function values(Bytes32Set storage set) internal view returns (bytes32[] memory) {
                  return _values(set._inner);
              }
              // AddressSet
              struct AddressSet {
                  Set _inner;
              }
              /**
               * @dev Add a value to a set. O(1).
               *
               * Returns true if the value was added to the set, that is if it was not
               * already present.
               */
              function add(AddressSet storage set, address value) internal returns (bool) {
                  return _add(set._inner, bytes32(uint256(uint160(value))));
              }
              /**
               * @dev Removes a value from a set. O(1).
               *
               * Returns true if the value was removed from the set, that is if it was
               * present.
               */
              function remove(AddressSet storage set, address value) internal returns (bool) {
                  return _remove(set._inner, bytes32(uint256(uint160(value))));
              }
              /**
               * @dev Returns true if the value is in the set. O(1).
               */
              function contains(AddressSet storage set, address value) internal view returns (bool) {
                  return _contains(set._inner, bytes32(uint256(uint160(value))));
              }
              /**
               * @dev Returns the number of values in the set. O(1).
               */
              function length(AddressSet storage set) internal view returns (uint256) {
                  return _length(set._inner);
              }
              /**
               * @dev Returns the value stored at position `index` in the set. O(1).
               *
               * Note that there are no guarantees on the ordering of values inside the
               * array, and it may change when more values are added or removed.
               *
               * Requirements:
               *
               * - `index` must be strictly less than {length}.
               */
              function at(AddressSet storage set, uint256 index) internal view returns (address) {
                  return address(uint160(uint256(_at(set._inner, index))));
              }
              /**
               * @dev Return the entire set in an array
               *
               * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
               * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
               * this function has an unbounded cost, and using it as part of a state-changing function may render the function
               * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
               */
              function values(AddressSet storage set) internal view returns (address[] memory) {
                  bytes32[] memory store = _values(set._inner);
                  address[] memory result;
                  /// @solidity memory-safe-assembly
                  assembly {
                      result := store
                  }
                  return result;
              }
              // UintSet
              struct UintSet {
                  Set _inner;
              }
              /**
               * @dev Add a value to a set. O(1).
               *
               * Returns true if the value was added to the set, that is if it was not
               * already present.
               */
              function add(UintSet storage set, uint256 value) internal returns (bool) {
                  return _add(set._inner, bytes32(value));
              }
              /**
               * @dev Removes a value from a set. O(1).
               *
               * Returns true if the value was removed from the set, that is if it was
               * present.
               */
              function remove(UintSet storage set, uint256 value) internal returns (bool) {
                  return _remove(set._inner, bytes32(value));
              }
              /**
               * @dev Returns true if the value is in the set. O(1).
               */
              function contains(UintSet storage set, uint256 value) internal view returns (bool) {
                  return _contains(set._inner, bytes32(value));
              }
              /**
               * @dev Returns the number of values on the set. O(1).
               */
              function length(UintSet storage set) internal view returns (uint256) {
                  return _length(set._inner);
              }
              /**
               * @dev Returns the value stored at position `index` in the set. O(1).
               *
               * Note that there are no guarantees on the ordering of values inside the
               * array, and it may change when more values are added or removed.
               *
               * Requirements:
               *
               * - `index` must be strictly less than {length}.
               */
              function at(UintSet storage set, uint256 index) internal view returns (uint256) {
                  return uint256(_at(set._inner, index));
              }
              /**
               * @dev Return the entire set in an array
               *
               * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
               * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
               * this function has an unbounded cost, and using it as part of a state-changing function may render the function
               * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
               */
              function values(UintSet storage set) internal view returns (uint256[] memory) {
                  bytes32[] memory store = _values(set._inner);
                  uint256[] memory result;
                  /// @solidity memory-safe-assembly
                  assembly {
                      result := store
                  }
                  return result;
              }
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.7.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(uint160(account), 20),
                                  " is missing role ",
                                  Strings.toHexString(uint256(role), 32)
                              )
                          )
                      );
                  }
              }
              /**
               * @dev Returns the admin role that controls `role`. See {grantRole} and
               * {revokeRole}.
               *
               * To change a role's admin, use {_setRoleAdmin}.
               */
              function getRoleAdmin(bytes32 role) public view 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());
                  }
              }
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts v4.4.1 (access/IAccessControlEnumerable.sol)
          pragma solidity ^0.8.0;
          import "./IAccessControl.sol";
          /**
           * @dev External interface of AccessControlEnumerable declared to support ERC165 detection.
           */
          interface IAccessControlEnumerable is IAccessControl {
              /**
               * @dev Returns one of the accounts that have `role`. `index` must be a
               * value between 0 and {getRoleMemberCount}, non-inclusive.
               *
               * Role bearers are not sorted in any particular way, and their ordering may
               * change at any point.
               *
               * WARNING: When using {getRoleMember} and {getRoleMemberCount}, make sure
               * you perform all queries on the same block. See the following
               * https://forum.openzeppelin.com/t/iterating-over-elements-on-enumerableset-in-openzeppelin-contracts/2296[forum post]
               * for more information.
               */
              function getRoleMember(bytes32 role, uint256 index) external view returns (address);
              /**
               * @dev Returns the number of accounts that have `role`. Can be used
               * together with {getRoleMember} to enumerate all bearers of a role.
               */
              function getRoleMemberCount(bytes32 role) external view returns (uint256);
          }
          // 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;
          }
          // 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;
              }
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts (last updated v4.7.0) (utils/Strings.sol)
          pragma solidity ^0.8.0;
          /**
           * @dev String operations.
           */
          library Strings {
              bytes16 private constant _HEX_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) {
                  // Inspired by OraclizeAPI's implementation - MIT licence
                  // https://github.com/oraclize/ethereum-api/blob/b42146b063c7d6ee1358846c198246239e9360e8/oraclizeAPI_0.4.25.sol
                  if (value == 0) {
                      return "0";
                  }
                  uint256 temp = value;
                  uint256 digits;
                  while (temp != 0) {
                      digits++;
                      temp /= 10;
                  }
                  bytes memory buffer = new bytes(digits);
                  while (value != 0) {
                      digits -= 1;
                      buffer[digits] = bytes1(uint8(48 + uint256(value % 10)));
                      value /= 10;
                  }
                  return string(buffer);
              }
              /**
               * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
               */
              function toHexString(uint256 value) internal pure returns (string memory) {
                  if (value == 0) {
                      return "0x00";
                  }
                  uint256 temp = value;
                  uint256 length = 0;
                  while (temp != 0) {
                      length++;
                      temp >>= 8;
                  }
                  return toHexString(value, length);
              }
              /**
               * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.
               */
              function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {
                  bytes memory buffer = new bytes(2 * length + 2);
                  buffer[0] = "0";
                  buffer[1] = "x";
                  for (uint256 i = 2 * length + 1; i > 1; --i) {
                      buffer[i] = _HEX_SYMBOLS[value & 0xf];
                      value >>= 4;
                  }
                  require(value == 0, "Strings: hex length insufficient");
                  return string(buffer);
              }
              /**
               * @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);
              }
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts v4.4.1 (utils/Context.sol)
          pragma solidity ^0.8.0;
          /**
           * @dev Provides information about the current execution context, including the
           * sender of the transaction and its data. While these are generally available
           * via msg.sender and msg.data, they should not be accessed in such a direct
           * manner, since when dealing with meta-transactions the account sending and
           * paying for execution may not be the actual sender (as far as an application
           * is concerned).
           *
           * This contract is only required for intermediate, library-like contracts.
           */
          abstract contract Context {
              function _msgSender() internal view virtual returns (address) {
                  return msg.sender;
              }
              function _msgData() internal view virtual returns (bytes calldata) {
                  return msg.data;
              }
          }
          // SPDX-License-Identifier: MIT
          // OpenZeppelin Contracts v4.4.1 (utils/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);
          }