ETH Price: $2,126.01 (+3.90%)

Transaction Decoder

Block:
16220101 at Dec-19-2022 05:01:23 PM +UTC
Transaction Fee:
0.002083882323335956 ETH $4.43
Gas Used:
130,468 Gas / 15.972363517 Gwei

Emitted Events:

357 ERC1967Proxy.0xc18e52b78ac9ae55fabb7d279130c597610b79d33c3e64d39152b275a48c5e33( 0xc18e52b78ac9ae55fabb7d279130c597610b79d33c3e64d39152b275a48c5e33, 0x000000000000000000000000bf861d09615543c419c749ea8cbeb720e3b3e3ad, 0x00000000000000000000000038a08d73153f32dbb2f867338d0bd6e3746e3391, 0000000000000000000000000000000000000000000000000000000000000000 )

Account State Difference:

  Address   Before After State Difference Code
0x2e779749...755CC017d
0x38a08d73...3746E3391
0.121121163157958303 Eth
Nonce: 108
0.119037280834622347 Eth
Nonce: 109
0.002083882323335956
(Flashbots: Builder)
1.21417123440789735 Eth1.214303390393487654 Eth0.000132155985590304

Execution Trace

ERC1967Proxy.8dfb2f0f( )
  • QuadPassport.setAttributesIssuer( )
    • Null: 0x000...001.f6ba153d( )
    • ERC1967Proxy.91d14854( )
      • QuadGovernance.hasRole( role=114E74F6EA3BD819998F78687BFCB11B140DA08E9B7D222FA9C1F1BA1F2AA122, account=0x38a08d73153F32DBB2f867338d0BD6E3746E3391 ) => ( True )
      • ERC1967Proxy.64146edc( )
        • QuadGovernance.getIssuerAttributePermission( _issuer=0x38a08d73153F32DBB2f867338d0BD6E3746E3391, _attribute=09DEAC0378109C72D82CCCD3C343A90F7020F0F1AF78DCD4FC949C6301AA9488 ) => ( True )
        • ERC1967Proxy.4a92e038( )
          • QuadGovernance.eligibleAttributes( _attribute=09DEAC0378109C72D82CCCD3C343A90F7020F0F1AF78DCD4FC949C6301AA9488 ) => ( True )
          • ERC1967Proxy.64146edc( )
            • QuadGovernance.getIssuerAttributePermission( _issuer=0x38a08d73153F32DBB2f867338d0BD6E3746E3391, _attribute=AF192D67680C4285E52CD2A94216CE249FB4E0227D267DCC01EA88F1B020A119 ) => ( True )
            • ERC1967Proxy.4a92e038( )
              • QuadGovernance.eligibleAttributes( _attribute=AF192D67680C4285E52CD2A94216CE249FB4E0227D267DCC01EA88F1B020A119 ) => ( False )
              • ERC1967Proxy.97e44996( )
                • QuadGovernance.eligibleAttributesByDID( _attribute=AF192D67680C4285E52CD2A94216CE249FB4E0227D267DCC01EA88F1B020A119 ) => ( True )
                  File 1 of 4: ERC1967Proxy
                  // SPDX-License-Identifier: MIT
                  pragma solidity ^0.8.0;
                  
                  /**
                   * @dev This abstract contract provides a fallback function that delegates all calls to another contract using the EVM
                   * instruction `delegatecall`. We refer to the second contract as the _implementation_ behind the proxy, and it has to
                   * be specified by overriding the virtual {_implementation} function.
                   *
                   * Additionally, delegation to the implementation can be triggered manually through the {_fallback} function, or to a
                   * different contract through the {_delegate} function.
                   *
                   * The success and return data of the delegated call will be returned back to the caller of the proxy.
                   */
                  abstract contract Proxy {
                      /**
                       * @dev Delegates the current call to `implementation`.
                       *
                       * This function does not return to its internall call site, it will return directly to the external caller.
                       */
                      function _delegate(address implementation) internal virtual {
                          // solhint-disable-next-line no-inline-assembly
                          assembly {
                          // Copy msg.data. We take full control of memory in this inline assembly
                          // block because it will not return to Solidity code. We overwrite the
                          // Solidity scratch pad at memory position 0.
                              calldatacopy(0, 0, calldatasize())
                  
                          // Call the implementation.
                          // out and outsize are 0 because we don't know the size yet.
                              let result := delegatecall(gas(), implementation, 0, calldatasize(), 0, 0)
                  
                          // Copy the returned data.
                              returndatacopy(0, 0, returndatasize())
                  
                              switch result
                              // delegatecall returns 0 on error.
                              case 0 { revert(0, returndatasize()) }
                              default { return(0, returndatasize()) }
                          }
                      }
                  
                      /**
                       * @dev This is a virtual function that should be overriden so it returns the address to which the fallback function
                       * and {_fallback} should delegate.
                       */
                      function _implementation() internal view virtual returns (address);
                  
                      /**
                       * @dev Delegates the current call to the address returned by `_implementation()`.
                       *
                       * This function does not return to its internall call site, it will return directly to the external caller.
                       */
                      function _fallback() internal virtual {
                          _beforeFallback();
                          _delegate(_implementation());
                      }
                  
                      /**
                       * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if no other
                       * function in the contract matches the call data.
                       */
                      fallback () external payable virtual {
                          _fallback();
                      }
                  
                      /**
                       * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if call data
                       * is empty.
                       */
                      receive () external payable virtual {
                          _fallback();
                      }
                  
                      /**
                       * @dev Hook that is called before falling back to the implementation. Can happen as part of a manual `_fallback`
                       * call, or as part of the Solidity `fallback` or `receive` functions.
                       *
                       * If overriden should call `super._beforeFallback()`.
                       */
                      function _beforeFallback() internal virtual {
                      }
                  }
                  
                  
                  /**
                   * @dev This abstract contract provides getters and event emitting update functions for
                   * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.
                   *
                   * _Available since v4.1._
                   *
                   */
                  abstract contract ERC1967Upgrade {
                      // This is the keccak-256 hash of "eip1967.proxy.rollback" subtracted by 1
                      bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143;
                  
                      /**
                       * @dev Storage slot with the address of the current implementation.
                       * This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1, and is
                       * validated in the constructor.
                       */
                      bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
                  
                      /**
                       * @dev Emitted when the implementation is upgraded.
                       */
                      event Upgraded(address indexed implementation);
                  
                      /**
                       * @dev Returns the current implementation address.
                       */
                      function _getImplementation() internal view returns (address) {
                          return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
                      }
                  
                      /**
                       * @dev Stores a new address in the EIP1967 implementation slot.
                       */
                      function _setImplementation(address newImplementation) private {
                          require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
                          StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
                      }
                  
                      /**
                       * @dev Perform implementation upgrade
                       *
                       * Emits an {Upgraded} event.
                       */
                      function _upgradeTo(address newImplementation) internal {
                          _setImplementation(newImplementation);
                          emit Upgraded(newImplementation);
                      }
                  
                      /**
                       * @dev Perform implementation upgrade with additional setup call.
                       *
                       * Emits an {Upgraded} event.
                       */
                      function _upgradeToAndCall(address newImplementation, bytes memory data, bool forceCall) internal {
                          _setImplementation(newImplementation);
                          emit Upgraded(newImplementation);
                          if (data.length > 0 || forceCall) {
                              Address.functionDelegateCall(newImplementation, data);
                          }
                      }
                  
                      /**
                       * @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call.
                       *
                       * Emits an {Upgraded} event.
                       */
                      function _upgradeToAndCallSecure(address newImplementation, bytes memory data, bool forceCall) internal {
                          address oldImplementation = _getImplementation();
                  
                          // Initial upgrade and setup call
                          _setImplementation(newImplementation);
                          if (data.length > 0 || forceCall) {
                              Address.functionDelegateCall(newImplementation, data);
                          }
                  
                          // Perform rollback test if not already in progress
                          StorageSlot.BooleanSlot storage rollbackTesting = StorageSlot.getBooleanSlot(_ROLLBACK_SLOT);
                          if (!rollbackTesting.value) {
                              // Trigger rollback using upgradeTo from the new implementation
                              rollbackTesting.value = true;
                              Address.functionDelegateCall(
                                  newImplementation,
                                  abi.encodeWithSignature(
                                      "upgradeTo(address)",
                                      oldImplementation
                                  )
                              );
                              rollbackTesting.value = false;
                              // Check rollback was effective
                              require(oldImplementation == _getImplementation(), "ERC1967Upgrade: upgrade breaks further upgrades");
                              // Finally reset to the new implementation and log the upgrade
                              _setImplementation(newImplementation);
                              emit Upgraded(newImplementation);
                          }
                      }
                  
                      /**
                       * @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does
                       * not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that).
                       *
                       * Emits a {BeaconUpgraded} event.
                       */
                      function _upgradeBeaconToAndCall(address newBeacon, bytes memory data, bool forceCall) internal {
                          _setBeacon(newBeacon);
                          emit BeaconUpgraded(newBeacon);
                          if (data.length > 0 || forceCall) {
                              Address.functionDelegateCall(IBeacon(newBeacon).implementation(), data);
                          }
                      }
                  
                      /**
                       * @dev Storage slot with the admin of the contract.
                       * This is the keccak-256 hash of "eip1967.proxy.admin" subtracted by 1, and is
                       * validated in the constructor.
                       */
                      bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;
                  
                      /**
                       * @dev Emitted when the admin account has changed.
                       */
                      event AdminChanged(address previousAdmin, address newAdmin);
                  
                      /**
                       * @dev Returns the current admin.
                       */
                      function _getAdmin() internal view returns (address) {
                          return StorageSlot.getAddressSlot(_ADMIN_SLOT).value;
                      }
                  
                      /**
                       * @dev Stores a new address in the EIP1967 admin slot.
                       */
                      function _setAdmin(address newAdmin) private {
                          require(newAdmin != address(0), "ERC1967: new admin is the zero address");
                          StorageSlot.getAddressSlot(_ADMIN_SLOT).value = newAdmin;
                      }
                  
                      /**
                       * @dev Changes the admin of the proxy.
                       *
                       * Emits an {AdminChanged} event.
                       */
                      function _changeAdmin(address newAdmin) internal {
                          emit AdminChanged(_getAdmin(), newAdmin);
                          _setAdmin(newAdmin);
                      }
                  
                      /**
                       * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.
                       * This is bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor.
                       */
                      bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;
                  
                      /**
                       * @dev Emitted when the beacon is upgraded.
                       */
                      event BeaconUpgraded(address indexed beacon);
                  
                      /**
                       * @dev Returns the current beacon.
                       */
                      function _getBeacon() internal view returns (address) {
                          return StorageSlot.getAddressSlot(_BEACON_SLOT).value;
                      }
                  
                      /**
                       * @dev Stores a new beacon in the EIP1967 beacon slot.
                       */
                      function _setBeacon(address newBeacon) private {
                          require(
                              Address.isContract(newBeacon),
                              "ERC1967: new beacon is not a contract"
                          );
                          require(
                              Address.isContract(IBeacon(newBeacon).implementation()),
                              "ERC1967: beacon implementation is not a contract"
                          );
                          StorageSlot.getAddressSlot(_BEACON_SLOT).value = newBeacon;
                      }
                  }
                  
                  /**
                   * @dev This is the interface that {BeaconProxy} expects of its beacon.
                   */
                  interface IBeacon {
                      /**
                       * @dev Must return an address that can be used as a delegate call target.
                       *
                       * {BeaconProxy} will check that this address is a contract.
                       */
                      function implementation() external view returns (address);
                  }
                  
                  /**
                   * @dev Collection of functions related to the address type
                   */
                  library Address {
                      /**
                       * @dev Returns true if `account` is a contract.
                       *
                       * [IMPORTANT]
                       * ====
                       * It is unsafe to assume that an address for which this function returns
                       * false is an externally-owned account (EOA) and not a contract.
                       *
                       * Among others, `isContract` will return false for the following
                       * types of addresses:
                       *
                       *  - an externally-owned account
                       *  - a contract in construction
                       *  - an address where a contract will be created
                       *  - an address where a contract lived, but was destroyed
                       * ====
                       */
                      function isContract(address account) internal view returns (bool) {
                          // This method relies on extcodesize, which returns 0 for contracts in
                          // construction, since the code is only stored at the end of the
                          // constructor execution.
                  
                          uint256 size;
                          // solhint-disable-next-line no-inline-assembly
                          assembly { size := extcodesize(account) }
                          return size > 0;
                      }
                  
                      /**
                       * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
                       * `recipient`, forwarding all available gas and reverting on errors.
                       *
                       * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
                       * of certain opcodes, possibly making contracts go over the 2300 gas limit
                       * imposed by `transfer`, making them unable to receive funds via
                       * `transfer`. {sendValue} removes this limitation.
                       *
                       * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
                       *
                       * IMPORTANT: because control is transferred to `recipient`, care must be
                       * taken to not create reentrancy vulnerabilities. Consider using
                       * {ReentrancyGuard} or the
                       * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
                       */
                      function sendValue(address payable recipient, uint256 amount) internal {
                          require(address(this).balance >= amount, "Address: insufficient balance");
                  
                          // solhint-disable-next-line avoid-low-level-calls, avoid-call-value
                          (bool success, ) = recipient.call{ value: amount }("");
                          require(success, "Address: unable to send value, recipient may have reverted");
                      }
                  
                      /**
                       * @dev Performs a Solidity function call using a low level `call`. A
                       * plain`call` is an unsafe replacement for a function call: use this
                       * function instead.
                       *
                       * If `target` reverts with a revert reason, it is bubbled up by this
                       * function (like regular Solidity function calls).
                       *
                       * Returns the raw returned data. To convert to the expected return value,
                       * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
                       *
                       * Requirements:
                       *
                       * - `target` must be a contract.
                       * - calling `target` with `data` must not revert.
                       *
                       * _Available since v3.1._
                       */
                      function functionCall(address target, bytes memory data) internal returns (bytes memory) {
                          return functionCall(target, data, "Address: low-level call failed");
                      }
                  
                      /**
                       * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
                       * `errorMessage` as a fallback revert reason when `target` reverts.
                       *
                       * _Available since v3.1._
                       */
                      function functionCall(address target, bytes memory data, string memory errorMessage) internal returns (bytes memory) {
                          return functionCallWithValue(target, data, 0, errorMessage);
                      }
                  
                      /**
                       * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                       * but also transferring `value` wei to `target`.
                       *
                       * Requirements:
                       *
                       * - the calling contract must have an ETH balance of at least `value`.
                       * - the called Solidity function must be `payable`.
                       *
                       * _Available since v3.1._
                       */
                      function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
                          return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
                      }
                  
                      /**
                       * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
                       * with `errorMessage` as a fallback revert reason when `target` reverts.
                       *
                       * _Available since v3.1._
                       */
                      function functionCallWithValue(address target, bytes memory data, uint256 value, string memory errorMessage) internal returns (bytes memory) {
                          require(address(this).balance >= value, "Address: insufficient balance for call");
                          require(isContract(target), "Address: call to non-contract");
                  
                          // solhint-disable-next-line avoid-low-level-calls
                          (bool success, bytes memory returndata) = target.call{ value: value }(data);
                          return _verifyCallResult(success, returndata, errorMessage);
                      }
                  
                      /**
                       * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                       * but performing a static call.
                       *
                       * _Available since v3.3._
                       */
                      function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
                          return functionStaticCall(target, data, "Address: low-level static call failed");
                      }
                  
                      /**
                       * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
                       * but performing a static call.
                       *
                       * _Available since v3.3._
                       */
                      function functionStaticCall(address target, bytes memory data, string memory errorMessage) internal view returns (bytes memory) {
                          require(isContract(target), "Address: static call to non-contract");
                  
                          // solhint-disable-next-line avoid-low-level-calls
                          (bool success, bytes memory returndata) = target.staticcall(data);
                          return _verifyCallResult(success, returndata, errorMessage);
                      }
                  
                      /**
                       * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                       * but performing a delegate call.
                       *
                       * _Available since v3.4._
                       */
                      function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
                          return functionDelegateCall(target, data, "Address: low-level delegate call failed");
                      }
                  
                      /**
                       * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
                       * but performing a delegate call.
                       *
                       * _Available since v3.4._
                       */
                      function functionDelegateCall(address target, bytes memory data, string memory errorMessage) internal returns (bytes memory) {
                          require(isContract(target), "Address: delegate call to non-contract");
                  
                          // solhint-disable-next-line avoid-low-level-calls
                          (bool success, bytes memory returndata) = target.delegatecall(data);
                          return _verifyCallResult(success, returndata, errorMessage);
                      }
                  
                      function _verifyCallResult(bool success, bytes memory returndata, string memory errorMessage) private pure returns(bytes memory) {
                          if (success) {
                              return returndata;
                          } else {
                              // Look for revert reason and bubble it up if present
                              if (returndata.length > 0) {
                                  // The easiest way to bubble the revert reason is using memory via assembly
                  
                                  // solhint-disable-next-line no-inline-assembly
                                  assembly {
                                      let returndata_size := mload(returndata)
                                      revert(add(32, returndata), returndata_size)
                                  }
                              } else {
                                  revert(errorMessage);
                              }
                          }
                      }
                  }
                  
                  /**
                   * @dev Library for reading and writing primitive types to specific storage slots.
                   *
                   * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.
                   * This library helps with reading and writing to such slots without the need for inline assembly.
                   *
                   * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.
                   *
                   * Example usage to set ERC1967 implementation slot:
                   * ```
                   * contract ERC1967 {
                   *     bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
                   *
                   *     function _getImplementation() internal view returns (address) {
                   *         return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
                   *     }
                   *
                   *     function _setImplementation(address newImplementation) internal {
                   *         require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
                   *         StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
                   *     }
                   * }
                   * ```
                   *
                   * _Available since v4.1 for `address`, `bool`, `bytes32`, and `uint256`._
                   */
                  library StorageSlot {
                      struct AddressSlot {
                          address value;
                      }
                  
                      struct BooleanSlot {
                          bool value;
                      }
                  
                      struct Bytes32Slot {
                          bytes32 value;
                      }
                  
                      struct Uint256Slot {
                          uint256 value;
                      }
                  
                      /**
                       * @dev Returns an `AddressSlot` with member `value` located at `slot`.
                       */
                      function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {
                          assembly {
                              r.slot := slot
                          }
                      }
                  
                      /**
                       * @dev Returns an `BooleanSlot` with member `value` located at `slot`.
                       */
                      function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {
                          assembly {
                              r.slot := slot
                          }
                      }
                  
                      /**
                       * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.
                       */
                      function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {
                          assembly {
                              r.slot := slot
                          }
                      }
                  
                      /**
                       * @dev Returns an `Uint256Slot` with member `value` located at `slot`.
                       */
                      function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {
                          assembly {
                              r.slot := slot
                          }
                      }
                  }
                  
                  /*
                   * @dev Provides information about the current execution context, including the
                   * sender of the transaction and its data. While these are generally available
                   * via msg.sender and msg.data, they should not be accessed in such a direct
                   * manner, since when dealing with meta-transactions the account sending and
                   * paying for execution may not be the actual sender (as far as an application
                   * is concerned).
                   *
                   * This contract is only required for intermediate, library-like contracts.
                   */
                  abstract contract Context {
                      function _msgSender() internal view virtual returns (address) {
                          return msg.sender;
                      }
                  
                      function _msgData() internal view virtual returns (bytes calldata) {
                          this; // silence state mutability warning without generating bytecode - see https://github.com/ethereum/solidity/issues/2691
                          return msg.data;
                      }
                  }
                  
                  /**
                   * @dev Contract module which provides a basic access control mechanism, where
                   * there is an account (an owner) that can be granted exclusive access to
                   * specific functions.
                   *
                   * By default, the owner account will be the one that deploys the contract. This
                   * can later be changed with {transferOwnership}.
                   *
                   * This module is used through inheritance. It will make available the modifier
                   * `onlyOwner`, which can be applied to your functions to restrict their use to
                   * the owner.
                   */
                  abstract contract Ownable is Context {
                      address private _owner;
                  
                      event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
                  
                      /**
                       * @dev Initializes the contract setting the deployer as the initial owner.
                       */
                      constructor () {
                          address msgSender = _msgSender();
                          _owner = msgSender;
                          emit OwnershipTransferred(address(0), msgSender);
                      }
                  
                      /**
                       * @dev Returns the address of the current owner.
                       */
                      function owner() public view virtual returns (address) {
                          return _owner;
                      }
                  
                      /**
                       * @dev Throws if called by any account other than the owner.
                       */
                      modifier onlyOwner() {
                          require(owner() == _msgSender(), "Ownable: caller is not the owner");
                          _;
                      }
                  
                      /**
                       * @dev Leaves the contract without owner. It will not be possible to call
                       * `onlyOwner` functions anymore. Can only be called by the current owner.
                       *
                       * NOTE: Renouncing ownership will leave the contract without an owner,
                       * thereby removing any functionality that is only available to the owner.
                       */
                      function renounceOwnership() public virtual onlyOwner {
                          emit OwnershipTransferred(_owner, address(0));
                          _owner = address(0);
                      }
                  
                      /**
                       * @dev Transfers ownership of the contract to a new account (`newOwner`).
                       * Can only be called by the current owner.
                       */
                      function transferOwnership(address newOwner) public virtual onlyOwner {
                          require(newOwner != address(0), "Ownable: new owner is the zero address");
                          emit OwnershipTransferred(_owner, newOwner);
                          _owner = newOwner;
                      }
                  }
                  
                  /**
                   * @dev This is an auxiliary contract meant to be assigned as the admin of a {TransparentUpgradeableProxy}. For an
                   * explanation of why you would want to use this see the documentation for {TransparentUpgradeableProxy}.
                   */
                  contract ProxyAdmin is Ownable {
                  
                      /**
                       * @dev Returns the current implementation of `proxy`.
                       *
                       * Requirements:
                       *
                       * - This contract must be the admin of `proxy`.
                       */
                      function getProxyImplementation(TransparentUpgradeableProxy proxy) public view virtual returns (address) {
                          // We need to manually run the static call since the getter cannot be flagged as view
                          // bytes4(keccak256("implementation()")) == 0x5c60da1b
                          (bool success, bytes memory returndata) = address(proxy).staticcall(hex"5c60da1b");
                          require(success);
                          return abi.decode(returndata, (address));
                      }
                  
                      /**
                       * @dev Returns the current admin of `proxy`.
                       *
                       * Requirements:
                       *
                       * - This contract must be the admin of `proxy`.
                       */
                      function getProxyAdmin(TransparentUpgradeableProxy proxy) public view virtual returns (address) {
                          // We need to manually run the static call since the getter cannot be flagged as view
                          // bytes4(keccak256("admin()")) == 0xf851a440
                          (bool success, bytes memory returndata) = address(proxy).staticcall(hex"f851a440");
                          require(success);
                          return abi.decode(returndata, (address));
                      }
                  
                      /**
                       * @dev Changes the admin of `proxy` to `newAdmin`.
                       *
                       * Requirements:
                       *
                       * - This contract must be the current admin of `proxy`.
                       */
                      function changeProxyAdmin(TransparentUpgradeableProxy proxy, address newAdmin) public virtual onlyOwner {
                          proxy.changeAdmin(newAdmin);
                      }
                  
                      /**
                       * @dev Upgrades `proxy` to `implementation`. See {TransparentUpgradeableProxy-upgradeTo}.
                       *
                       * Requirements:
                       *
                       * - This contract must be the admin of `proxy`.
                       */
                      function upgrade(TransparentUpgradeableProxy proxy, address implementation) public virtual onlyOwner {
                          proxy.upgradeTo(implementation);
                      }
                  
                      /**
                       * @dev Upgrades `proxy` to `implementation` and calls a function on the new implementation. See
                       * {TransparentUpgradeableProxy-upgradeToAndCall}.
                       *
                       * Requirements:
                       *
                       * - This contract must be the admin of `proxy`.
                       */
                      function upgradeAndCall(TransparentUpgradeableProxy proxy, address implementation, bytes memory data) public payable virtual onlyOwner {
                          proxy.upgradeToAndCall{value: msg.value}(implementation, data);
                      }
                  }
                  
                  
                  /**
                   * @dev Base contract for building openzeppelin-upgrades compatible implementations for the {ERC1967Proxy}. It includes
                   * publicly available upgrade functions that are called by the plugin and by the secure upgrade mechanism to verify
                   * continuation of the upgradability.
                   *
                   * The {_authorizeUpgrade} function MUST be overridden to include access restriction to the upgrade mechanism.
                   *
                   * _Available since v4.1._
                   */
                  abstract contract UUPSUpgradeable is ERC1967Upgrade {
                      function upgradeTo(address newImplementation) external virtual {
                          _authorizeUpgrade(newImplementation);
                          _upgradeToAndCallSecure(newImplementation, bytes(""), false);
                      }
                  
                      function upgradeToAndCall(address newImplementation, bytes memory data) external payable virtual {
                          _authorizeUpgrade(newImplementation);
                          _upgradeToAndCallSecure(newImplementation, data, true);
                      }
                  
                      function _authorizeUpgrade(address newImplementation) internal virtual;
                  }
                  
                  
                  abstract contract Proxiable is UUPSUpgradeable {
                      function _authorizeUpgrade(address newImplementation) internal override {
                          _beforeUpgrade(newImplementation);
                      }
                  
                      function _beforeUpgrade(address newImplementation) internal virtual;
                  }
                  
                  contract ChildOfProxiable is Proxiable {
                      function _beforeUpgrade(address newImplementation) internal virtual override {}
                  }
                  
                  
                  /**
                   * @dev This contract implements an upgradeable proxy. It is upgradeable because calls are delegated to an
                   * implementation address that can be changed. This address is stored in storage in the location specified by
                   * https://eips.ethereum.org/EIPS/eip-1967[EIP1967], so that it doesn't conflict with the storage layout of the
                   * implementation behind the proxy.
                   */
                  contract ERC1967Proxy is Proxy, ERC1967Upgrade {
                      /**
                       * @dev Initializes the upgradeable proxy with an initial implementation specified by `_logic`.
                       *
                       * If `_data` is nonempty, it's used as data in a delegate call to `_logic`. This will typically be an encoded
                       * function call, and allows initializating the storage of the proxy like a Solidity constructor.
                       */
                      constructor(address _logic, bytes memory _data) payable {
                          assert(_IMPLEMENTATION_SLOT == bytes32(uint256(keccak256("eip1967.proxy.implementation")) - 1));
                          _upgradeToAndCall(_logic, _data, false);
                      }
                  
                      /**
                       * @dev Returns the current implementation address.
                       */
                      function _implementation() internal view virtual override returns (address impl) {
                          return ERC1967Upgrade._getImplementation();
                      }
                  }
                  
                  /**
                   * @dev This contract implements a proxy that is upgradeable by an admin.
                   *
                   * To avoid https://medium.com/nomic-labs-blog/malicious-backdoors-in-ethereum-proxies-62629adf3357[proxy selector
                   * clashing], which can potentially be used in an attack, this contract uses the
                   * https://blog.openzeppelin.com/the-transparent-proxy-pattern/[transparent proxy pattern]. This pattern implies two
                   * things that go hand in hand:
                   *
                   * 1. If any account other than the admin calls the proxy, the call will be forwarded to the implementation, even if
                   * that call matches one of the admin functions exposed by the proxy itself.
                   * 2. If the admin calls the proxy, it can access the admin functions, but its calls will never be forwarded to the
                   * implementation. If the admin tries to call a function on the implementation it will fail with an error that says
                   * "admin cannot fallback to proxy target".
                   *
                   * These properties mean that the admin account can only be used for admin actions like upgrading the proxy or changing
                   * the admin, so it's best if it's a dedicated account that is not used for anything else. This will avoid headaches due
                   * to sudden errors when trying to call a function from the proxy implementation.
                   *
                   * Our recommendation is for the dedicated account to be an instance of the {ProxyAdmin} contract. If set up this way,
                   * you should think of the `ProxyAdmin` instance as the real administrative interface of your proxy.
                   */
                  contract TransparentUpgradeableProxy is ERC1967Proxy {
                      /**
                       * @dev Initializes an upgradeable proxy managed by `_admin`, backed by the implementation at `_logic`, and
                       * optionally initialized with `_data` as explained in {ERC1967Proxy-constructor}.
                       */
                      constructor(address _logic, address admin_, bytes memory _data) payable ERC1967Proxy(_logic, _data) {
                          assert(_ADMIN_SLOT == bytes32(uint256(keccak256("eip1967.proxy.admin")) - 1));
                          _changeAdmin(admin_);
                      }
                  
                      /**
                       * @dev Modifier used internally that will delegate the call to the implementation unless the sender is the admin.
                       */
                      modifier ifAdmin() {
                          if (msg.sender == _getAdmin()) {
                              _;
                          } else {
                              _fallback();
                          }
                      }
                  
                      /**
                       * @dev Returns the current admin.
                       *
                       * NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyAdmin}.
                       *
                       * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the
                       * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.
                       * `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`
                       */
                      function admin() external ifAdmin returns (address admin_) {
                          admin_ = _getAdmin();
                      }
                  
                      /**
                       * @dev Returns the current implementation.
                       *
                       * NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyImplementation}.
                       *
                       * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the
                       * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.
                       * `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`
                       */
                      function implementation() external ifAdmin returns (address implementation_) {
                          implementation_ = _implementation();
                      }
                  
                      /**
                       * @dev Changes the admin of the proxy.
                       *
                       * Emits an {AdminChanged} event.
                       *
                       * NOTE: Only the admin can call this function. See {ProxyAdmin-changeProxyAdmin}.
                       */
                      function changeAdmin(address newAdmin) external virtual ifAdmin {
                          _changeAdmin(newAdmin);
                      }
                  
                      /**
                       * @dev Upgrade the implementation of the proxy.
                       *
                       * NOTE: Only the admin can call this function. See {ProxyAdmin-upgrade}.
                       */
                      function upgradeTo(address newImplementation) external ifAdmin {
                          _upgradeToAndCall(newImplementation, bytes(""), false);
                      }
                  
                      /**
                       * @dev Upgrade the implementation of the proxy, and then call a function from the new implementation as specified
                       * by `data`, which should be an encoded function call. This is useful to initialize new storage variables in the
                       * proxied contract.
                       *
                       * NOTE: Only the admin can call this function. See {ProxyAdmin-upgradeAndCall}.
                       */
                      function upgradeToAndCall(address newImplementation, bytes calldata data) external payable ifAdmin {
                          _upgradeToAndCall(newImplementation, data, true);
                      }
                  
                      /**
                       * @dev Returns the current admin.
                       */
                      function _admin() internal view virtual returns (address) {
                          return _getAdmin();
                      }
                  
                      /**
                       * @dev Makes sure the admin cannot access the fallback function. See {Proxy-_beforeFallback}.
                       */
                      function _beforeFallback() internal virtual override {
                          require(msg.sender != _getAdmin(), "TransparentUpgradeableProxy: admin cannot fallback to proxy target");
                          super._beforeFallback();
                      }
                  }
                  
                  
                  // Kept for backwards compatibility with older versions of Hardhat and Truffle plugins.
                  contract AdminUpgradeabilityProxy is TransparentUpgradeableProxy {
                      constructor(address logic, address admin, bytes memory data) payable TransparentUpgradeableProxy(logic, admin, data) {}
                  }

                  File 2 of 4: QuadPassport
                  //SPDX-License-Identifier: BUSL-1.1
                  pragma solidity 0.8.16;
                  import "@openzeppelin/contracts-upgradeable/access/IAccessControlUpgradeable.sol";
                  import "@openzeppelin/contracts-upgradeable/proxy/utils/UUPSUpgradeable.sol";
                  import "@openzeppelin/contracts-upgradeable/utils/cryptography/ECDSAUpgradeable.sol";
                  import "@openzeppelin/contracts-upgradeable/security/PausableUpgradeable.sol";
                  import "./interfaces/IQuadPassport.sol";
                  import "./interfaces/IQuadGovernance.sol";
                  import "./storage/QuadPassportStore.sol";
                  import "./QuadSoulbound.sol";
                  /// @title Quadrata Web3 Identity Passport
                  /// @author Fabrice Cheng, Theodore Clapp
                  /// @notice This represents a Quadrata NFT Passport
                  contract QuadPassport is IQuadPassport, UUPSUpgradeable, PausableUpgradeable, QuadSoulbound, QuadPassportStore {
                      // used to prevent logic contract self destruct take over
                      constructor() initializer {}
                      /// @dev initializer (constructor)
                      /// @param _governanceContract address of the IQuadGovernance contract
                      function initialize(
                          address _governanceContract
                      ) public initializer {
                          require(_governanceContract != address(0), "GOVERNANCE_ADDRESS_ZERO");
                          governance = IQuadGovernance(_governanceContract);
                          name = "Quadrata Passport";
                          symbol = "QP";
                      }
                      /// @notice Set attributes for a Quadrata Passport (Only Individuals)
                      /// @dev Only when authorized by an eligible issuer
                      /// @param _config Input paramters required to authorize attributes to be set
                      /// @param _sigIssuer ECDSA signature computed by an eligible issuer to authorize the mint
                      /// @param _sigAccount ECDSA signature computed by an eligible EOA to prove ownership
                      function setAttributes(
                          AttributeSetterConfig memory _config,
                          bytes calldata _sigIssuer,
                          bytes calldata _sigAccount
                      ) external payable override whenNotPaused {
                          require(msg.value == _config.fee,  "INVALID_SET_ATTRIBUTE_FEE");
                          bytes32 signedMsg = ECDSAUpgradeable.toEthSignedMessageHash("Welcome to Quadrata! By signing, you agree to the Terms of Service.");
                          address account = ECDSAUpgradeable.recover(signedMsg, _sigAccount);
                          address issuer = _setAttributesVerify(account, _config, _sigIssuer);
                          _setAttributesInternal(account, _config, issuer);
                      }
                      /// @notice Set attributes from multiple issuers for a Quadrata Passport (Only Individuals)
                      /// @dev Only when authorized by an eligible issuer
                      /// @param _configs List of input paramters required to authorize attributes to be set
                      /// @param _sigIssuers List of ECDSA signature computed by an eligible issuer to authorize the mint
                      /// @param _sigAccounts List of ECDSA signature computed by an eligible EOA to prove ownership
                      function setAttributesBulk(
                          AttributeSetterConfig[] memory _configs,
                          bytes[] calldata _sigIssuers,
                          bytes[] calldata _sigAccounts
                      ) external payable override whenNotPaused {
                          require(_configs.length == _sigIssuers.length, "INVALID_BULK_ATTRIBUTES_LENGTH");
                          require(_configs.length == _sigAccounts.length, "INVALID_BULK_ATTRIBUTES_LENGTH");
                          bytes32 signedMsg = ECDSAUpgradeable.toEthSignedMessageHash("Welcome to Quadrata! By signing, you agree to the Terms of Service.");
                          uint256 totalFee;
                          for(uint256 i = 0; i < _configs.length; i++){
                              address account = ECDSAUpgradeable.recover(signedMsg, _sigAccounts[i]);
                              address issuer = _setAttributesVerify(account, _configs[i], _sigIssuers[i]);
                              totalFee += _configs[i].fee;
                              _setAttributesInternal(account, _configs[i], issuer);
                          }
                          require(msg.value == totalFee,  "INVALID_SET_ATTRIBUTE_BULK_FEE");
                      }
                      /// @notice Set attributes for a Quadrata Passport (only by Issuers)
                      /// @param _account Address of the Quadrata Passport holder
                      /// @param _config Input paramters required to set attributes
                      /// @param _sigIssuer ECDSA signature computed by an eligible issuer to authorize the action
                      function setAttributesIssuer(
                          address _account,
                          AttributeSetterConfig memory _config,
                          bytes calldata _sigIssuer
                      ) external payable override whenNotPaused {
                          require(_account != address(0), "ACCOUNT_CANNOT_BE_ZERO");
                          require(msg.value == _config.fee,  "INVALID_SET_ATTRIBUTE_FEE");
                          address issuer = _setAttributesVerify(_account, _config, _sigIssuer);
                          _setAttributesInternal(_account, _config, issuer);
                      }
                      /// @notice Internal function for `setAttributes` and `setAttributesIssuer`
                      /// @param _account Address of the Quadrata Passport holder
                      /// @param _config Input paramters required to set attributes
                      /// @param _issuer Extracted address of ECDSA signature computed by an eligible issuer to authorize the action
                      function _setAttributesInternal(
                          address _account,
                          AttributeSetterConfig memory _config,
                          address _issuer
                      ) internal {
                          // Handle DID
                          if(_config.did != bytes32(0)){
                              require(governance.getIssuerAttributePermission(_issuer, ATTRIBUTE_DID), "ISSUER_ATTR_PERMISSION_INVALID");
                              _validateDid(_account, _config.did);
                              _writeAttrToStorage(
                                  _computeAttrKey(_account, ATTRIBUTE_DID, _config.did),
                                  _config.did,
                                  _issuer,
                                  _config.verifiedAt);
                          }
                          for (uint256 i = 0; i < _config.attrKeys.length; i++) {
                              require(governance.getIssuerAttributePermission(_issuer, _config.attrTypes[i]), "ISSUER_ATTR_PERMISSION_INVALID");
                              require(_config.attrTypes[i] != ATTRIBUTE_DID, "ISSUER_UPDATED_DID");
                              // Verify attrKeys computation
                              _verifyAttrKey(_account, _config.attrTypes[i], _config.attrKeys[i], _config.did);
                              _writeAttrToStorage(
                                  _config.attrKeys[i],
                                  _config.attrValues[i],
                                  _issuer,
                                  _config.verifiedAt);
                          }
                          if (_config.tokenId != 0 && balanceOf(_account, _config.tokenId) == 0) {
                              _mint(_account, _config.tokenId, 1);
                          }
                          emit SetAttributeReceipt(_account, _issuer, _config.fee);
                      }
                      /// @notice Internal function that validates supplied DID on updates do not change
                      /// @param _account address of entity being attested to
                      /// @param _did new DID value
                      function _validateDid(address _account, bytes32 _did) internal view {
                          Attribute[] memory dIDAttrs = _attributes[keccak256(abi.encode(_account, ATTRIBUTE_DID))];
                          if(dIDAttrs.length > 0){
                              require(dIDAttrs[0].value == _did, "INVALID_DID");
                          }
                      }
                      /// @notice Internal function that writes the attribute value and issuer position to storage
                      /// @param _attrKey attribute key (i.e. keccak256(address, keccak256("AML")))
                      /// @param _attrValue attribute value
                      /// @param _issuer address of issuer who verified attribute
                      /// @param _verifiedAt timestamp of when attribute was verified at
                      function _writeAttrToStorage(
                          bytes32 _attrKey,
                          bytes32 _attrValue,
                          address _issuer,
                          uint256 _verifiedAt
                      ) internal {
                          uint256 issuerPosition = _position[keccak256(abi.encode(_attrKey, _issuer))];
                          Attribute memory attr = Attribute({
                              value:  _attrValue,
                              epoch: _verifiedAt,
                              issuer: _issuer
                          });
                          if (issuerPosition == 0) {
                          // Means the issuer hasn't yet attested to that attribute type
                              _attributes[_attrKey].push(attr);
                              _position[keccak256(abi.encode(_attrKey, _issuer))] = _attributes[_attrKey].length;
                          } else {
                              // Issuer already attested to that attribute - override
                              _attributes[_attrKey][issuerPosition-1] = attr;
                          }
                      }
                      /// @notice Verify that the attrKey has been correctly computed based on account and attrType
                      /// @param _account Address of the Quadrata Passport holder
                      /// @param _attrType bytes32 of the attribute type
                      /// @param _attrKey bytes32 of the attrKey to compare against/verify
                      function _verifyAttrKey(address _account, bytes32 _attrType, bytes32 _attrKey, bytes32 _did) internal view {
                          bytes32 expectedAttrKey = _computeAttrKey(_account, _attrType, _did);
                          require(_attrKey == expectedAttrKey, "MISMATCH_ATTR_KEY");
                      }
                      /// @notice Internal helper to check setAttributes process
                      /// @param _account Address of the Quadrata Passport holder
                      /// @param _config Input paramters required to set attributes
                      /// @param _sigIssuer ECDSA signature computed by an eligible issuer to authorize the action
                      /// @return address of the issuer
                      function _setAttributesVerify(
                          address _account,
                          AttributeSetterConfig memory _config,
                          bytes calldata _sigIssuer
                      ) internal returns(address) {
                          require(_config.tokenId == 0 || governance.eligibleTokenId(_config.tokenId), "PASSPORT_TOKENID_INVALID");
                          require(_config.verifiedAt != 0, "VERIFIED_AT_CANNOT_BE_ZERO");
                          require(_config.issuedAt != 0, "ISSUED_AT_CANNOT_BE_ZERO");
                          require(_config.issuedAt <= block.timestamp, "INVALID_ISSUED_AT");
                          require(_config.verifiedAt <= block.timestamp, "INVALID_VERIFIED_AT");
                          require(block.timestamp <= _config.issuedAt + 1 days, "EXPIRED_ISSUED_AT");
                          require(_config.attrKeys.length == _config.attrTypes.length, "MISMATCH_LENGTH");
                          require(_config.attrKeys.length == _config.attrValues.length, "MISMATCH_LENGTH");
                          // Verify signature
                          bytes32 extractionHash = keccak256(
                              abi.encode(
                                  _account,
                                  _config.attrKeys,
                                  _config.attrValues,
                                  _config.did,
                                  _config.verifiedAt,
                                  _config.issuedAt,
                                  _config.fee,
                                  block.chainid,
                                  address(this)
                              )
                          );
                          bytes32 signedMsg = ECDSAUpgradeable.toEthSignedMessageHash(extractionHash);
                          address issuer = ECDSAUpgradeable.recover(signedMsg, _sigIssuer);
                          bytes32 issuerMintHash = keccak256(abi.encode(extractionHash, issuer));
                          require(IAccessControlUpgradeable(address(governance)).hasRole(ISSUER_ROLE, issuer), "INVALID_ISSUER");
                          require(!_usedSigHashes[issuerMintHash], "SIGNATURE_ALREADY_USED");
                          _usedSigHashes[issuerMintHash] = true;
                          return issuer;
                      }
                      /// @notice Compute the attrKey for the mapping `_attributes`
                      /// @param _account address of the wallet owner
                      /// @param _attribute attribute type (ex: keccak256("COUNTRY"))
                      /// @param _did DID of the passport (optional - could be pass as bytes32(0))
                      function _computeAttrKey(address _account, bytes32 _attribute, bytes32 _did) internal view returns(bytes32) {
                          if (governance.eligibleAttributes(_attribute)) {
                              return keccak256(abi.encode(_account, _attribute));
                          }
                          if (governance.eligibleAttributesByDID(_attribute)){
                              if(_did == bytes32(0)){
                                  Attribute[] memory dIDAttrs = _attributes[keccak256(abi.encode(_account, ATTRIBUTE_DID))];
                                  require(dIDAttrs.length > 0 && dIDAttrs[0].value != bytes32(0), "MISSING_DID");
                                  _did = dIDAttrs[0].value;
                              }
                              return keccak256(abi.encode(_did, _attribute));
                          }
                          revert("ATTRIBUTE_NOT_ELIGIBLE");
                      }
                      /// @notice Burn your Quadrata passport
                      /// @dev Only owner of the passport
                      function burnPassports() external override whenNotPaused {
                          for (uint256 i = 0; i < governance.getEligibleAttributesLength(); i++) {
                              bytes32 attributeType = governance.eligibleAttributesArray(i);
                              bytes32 attrKey = keccak256(abi.encode(_msgSender(), attributeType));
                              IQuadPassportStore.Attribute[] storage attrs = _attributes[attrKey];
                              for(uint256 j = attrs.length; j > 0; j--){
                                  _position[keccak256(abi.encode(attrKey, attrs[j-1].issuer))] = 0;
                                  attrs.pop();
                              }
                          }
                          _burnPassports(_msgSender());
                      }
                      /// @notice Issuer can burn an account's Quadrata passport when requested
                      /// @dev Only issuer role
                      /// @param _account address of the wallet to burn
                      function burnPassportsIssuer(
                          address _account
                      ) external override whenNotPaused {
                          require(IAccessControlUpgradeable(address(governance)).hasRole(ISSUER_ROLE, _msgSender()), "INVALID_ISSUER");
                          bool isEmpty = true;
                          // only delete attributes from issuer
                          for (uint256 i = 0; i < governance.getEligibleAttributesLength(); i++) {
                              bytes32 attributeType = governance.eligibleAttributesArray(i);
                              bytes32 attrKey = keccak256(abi.encode(_account, attributeType));
                              uint256 position = _position[keccak256(abi.encode(attrKey, _msgSender()))];
                              Attribute[] storage attrs = _attributes[attrKey];
                              if (position > 0) {
                                  // Swap last attribute position with position of attribute to delete before calling pop()
                                  Attribute memory attrToDelete = attrs[position-1];
                                  Attribute memory attrToSwap = attrs[attrs.length-1];
                                  _position[keccak256(abi.encode(attrKey, attrToSwap.issuer))] = position;
                                  _position[keccak256(abi.encode(attrKey, attrToDelete.issuer))] = 0;
                                  attrs[position-1] = attrToSwap;
                                  attrs.pop();
                              }
                              if (attrs.length > 0) {
                                  isEmpty = false;
                              }
                          }
                          if (isEmpty){
                              _burnPassports(_account);
                          }
                          emit BurnPassportsIssuer(_msgSender(), _account);
                      }
                      /// @dev Loop through all eligible token ids and burn passports if they exist
                      /// @param _account address of user
                      function _burnPassports(address _account) internal {
                          for (uint256 currTokenId = 1; currTokenId <= governance.getMaxEligibleTokenId(); currTokenId++){
                              uint256 number = balanceOf(_account, currTokenId);
                              if (number > 0){
                                  _burn(_account, currTokenId, number);
                              }
                          }
                      }
                      /// @dev Allow an authorized readers to get attribute information about a passport holder for a specific issuer
                      /// @param _account address of user
                      /// @param _attribute attribute to get respective value from
                      /// @return value of attribute from issuer
                      function attributes(
                          address _account,
                          bytes32 _attribute
                      ) public view override returns (Attribute[] memory) {
                          require(IAccessControlUpgradeable(address(governance)).hasRole(READER_ROLE, _msgSender()), "INVALID_READER");
                          require(governance.eligibleAttributes(_attribute)
                              || governance.eligibleAttributesByDID(_attribute),
                              "ATTRIBUTE_NOT_ELIGIBLE"
                          );
                          bytes32 attrKey;
                          if (governance.eligibleAttributes(_attribute)) {
                              attrKey = keccak256(abi.encode(_account, _attribute));
                          } else {
                              Attribute[] memory dIDAttrs = _attributes[keccak256(abi.encode(_account, ATTRIBUTE_DID))];
                              if (dIDAttrs.length == 0 || dIDAttrs[0].value == bytes32(0))
                                  return new Attribute[](0);
                              attrKey = keccak256(abi.encode(dIDAttrs[0].value, _attribute));
                          }
                          return _attributes[attrKey];
                      }
                      /// @dev Admin function to set the new pending Governance address
                      /// @notice Restricted behind a TimelockController
                      /// @param _governanceContract contract address of IQuadGovernance
                      function setGovernance(address _governanceContract) external override {
                          require(_msgSender() == address(governance), "ONLY_GOVERNANCE_CONTRACT");
                          require(_governanceContract != address(0), "GOVERNANCE_ADDRESS_ZERO");
                          pendingGovernance = _governanceContract;
                          emit SetPendingGovernance(pendingGovernance);
                      }
                      /// @dev Withdraw to an issuer's treasury
                      /// @notice Restricted behind a TimelockController
                      /// @param _to address an issuer's treasury
                      /// @param _amount amount to withdraw
                      function withdraw(address payable _to, uint256 _amount) external override whenNotPaused {
                          require(
                              IAccessControlUpgradeable(address(governance)).hasRole(GOVERNANCE_ROLE, _msgSender()),
                              "INVALID_ADMIN"
                          );
                          bool isValid = false;
                          address issuer;
                          address[] memory issuers = governance.getIssuers();
                          for (uint256 i = 0; i < issuers.length; i++) {
                              if (_to == governance.issuersTreasury(issuers[i])) {
                                  isValid = true;
                                  issuer = issuers[i];
                                  break;
                              }
                          }
                          require(_to != address(0), "WITHDRAW_ADDRESS_ZERO");
                          require(isValid, "WITHDRAWAL_ADDRESS_INVALID");
                          require(_amount <= address(this).balance, "INSUFFICIENT_BALANCE");
                          (bool sent,) = _to.call{value: _amount}("");
                          require(sent, "FAILED_TO_TRANSFER_NATIVE_ETH");
                          emit WithdrawEvent(issuer, _to, _amount);
                      }
                      /// @dev Admin function to accept and set the governance contract address
                      /// @notice Restricted behind a TimelockController
                      function acceptGovernance() external override {
                          require(_msgSender() == pendingGovernance, "ONLY_PENDING_GOVERNANCE_CONTRACT");
                          address oldGov = address(governance);
                          governance = IQuadGovernance(pendingGovernance);
                          pendingGovernance = address(0);
                          emit GovernanceUpdated(oldGov, address(governance));
                      }
                      /// @dev Admin function to set Metadata URI to associate with a tokenId
                      /// @param _tokenId Token Id
                      /// @param _uri URI pointing to IPFS
                      function setTokenURI(uint256 _tokenId, string memory _uri) external override {
                          require(_msgSender() == address(governance), "ONLY_GOVERNANCE_CONTRACT");
                          _setURI(_uri, _tokenId);
                      }
                      /// @dev Admin function to pause critical operations (emergency)
                      function pause() external {
                          require(
                              IAccessControlUpgradeable(address(governance)).hasRole(PAUSER_ROLE, _msgSender()),
                              "INVALID_PAUSER"
                          );
                          _pause();
                      }
                      /// @dev Admin function to unpause critical operations (emergency)
                      function unpause() external {
                          require(
                              IAccessControlUpgradeable(address(governance)).hasRole(PAUSER_ROLE, _msgSender()),
                              "INVALID_PAUSER"
                          );
                          _unpause();
                      }
                      /// @dev Retrieve the pause status of the contract
                      function passportPaused() external view override returns(bool) {
                          return paused();
                      }
                      function _authorizeUpgrade(address) internal view override {
                          require(
                              IAccessControlUpgradeable(address(governance)).hasRole(GOVERNANCE_ROLE, _msgSender()),
                              "INVALID_ADMIN"
                          );
                      }
                  }
                  // 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 IAccessControlUpgradeable {
                      /**
                       * @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 (last updated v4.5.0) (proxy/utils/UUPSUpgradeable.sol)
                  pragma solidity ^0.8.0;
                  import "../../interfaces/draft-IERC1822Upgradeable.sol";
                  import "../ERC1967/ERC1967UpgradeUpgradeable.sol";
                  import "./Initializable.sol";
                  /**
                   * @dev An upgradeability mechanism designed for UUPS proxies. The functions included here can perform an upgrade of an
                   * {ERC1967Proxy}, when this contract is set as the implementation behind such a proxy.
                   *
                   * A security mechanism ensures that an upgrade does not turn off upgradeability accidentally, although this risk is
                   * reinstated if the upgrade retains upgradeability but removes the security mechanism, e.g. by replacing
                   * `UUPSUpgradeable` with a custom implementation of upgrades.
                   *
                   * The {_authorizeUpgrade} function must be overridden to include access restriction to the upgrade mechanism.
                   *
                   * _Available since v4.1._
                   */
                  abstract contract UUPSUpgradeable is Initializable, IERC1822ProxiableUpgradeable, ERC1967UpgradeUpgradeable {
                      function __UUPSUpgradeable_init() internal onlyInitializing {
                      }
                      function __UUPSUpgradeable_init_unchained() internal onlyInitializing {
                      }
                      /// @custom:oz-upgrades-unsafe-allow state-variable-immutable state-variable-assignment
                      address private immutable __self = address(this);
                      /**
                       * @dev Check that the execution is being performed through a delegatecall call and that the execution context is
                       * a proxy contract with an implementation (as defined in ERC1967) pointing to self. This should only be the case
                       * for UUPS and transparent proxies that are using the current contract as their implementation. Execution of a
                       * function through ERC1167 minimal proxies (clones) would not normally pass this test, but is not guaranteed to
                       * fail.
                       */
                      modifier onlyProxy() {
                          require(address(this) != __self, "Function must be called through delegatecall");
                          require(_getImplementation() == __self, "Function must be called through active proxy");
                          _;
                      }
                      /**
                       * @dev Check that the execution is not being performed through a delegate call. This allows a function to be
                       * callable on the implementing contract but not through proxies.
                       */
                      modifier notDelegated() {
                          require(address(this) == __self, "UUPSUpgradeable: must not be called through delegatecall");
                          _;
                      }
                      /**
                       * @dev Implementation of the ERC1822 {proxiableUUID} function. This returns the storage slot used by the
                       * implementation. It is used to validate that the this implementation remains valid after an upgrade.
                       *
                       * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks
                       * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this
                       * function revert if invoked through a proxy. This is guaranteed by the `notDelegated` modifier.
                       */
                      function proxiableUUID() external view virtual override notDelegated returns (bytes32) {
                          return _IMPLEMENTATION_SLOT;
                      }
                      /**
                       * @dev Upgrade the implementation of the proxy to `newImplementation`.
                       *
                       * Calls {_authorizeUpgrade}.
                       *
                       * Emits an {Upgraded} event.
                       */
                      function upgradeTo(address newImplementation) external virtual onlyProxy {
                          _authorizeUpgrade(newImplementation);
                          _upgradeToAndCallUUPS(newImplementation, new bytes(0), false);
                      }
                      /**
                       * @dev Upgrade the implementation of the proxy to `newImplementation`, and subsequently execute the function call
                       * encoded in `data`.
                       *
                       * Calls {_authorizeUpgrade}.
                       *
                       * Emits an {Upgraded} event.
                       */
                      function upgradeToAndCall(address newImplementation, bytes memory data) external payable virtual onlyProxy {
                          _authorizeUpgrade(newImplementation);
                          _upgradeToAndCallUUPS(newImplementation, data, true);
                      }
                      /**
                       * @dev Function that should revert when `msg.sender` is not authorized to upgrade the contract. Called by
                       * {upgradeTo} and {upgradeToAndCall}.
                       *
                       * Normally, this function will use an xref:access.adoc[access control] modifier such as {Ownable-onlyOwner}.
                       *
                       * ```solidity
                       * function _authorizeUpgrade(address) internal override onlyOwner {}
                       * ```
                       */
                      function _authorizeUpgrade(address newImplementation) internal virtual;
                      /**
                       * @dev This empty reserved space is put in place to allow future versions to add new
                       * variables without shifting down storage in the inheritance chain.
                       * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
                       */
                      uint256[50] private __gap;
                  }
                  // SPDX-License-Identifier: MIT
                  // OpenZeppelin Contracts (last updated v4.7.0) (utils/cryptography/ECDSA.sol)
                  pragma solidity ^0.8.0;
                  import "../StringsUpgradeable.sol";
                  /**
                   * @dev Elliptic Curve Digital Signature Algorithm (ECDSA) operations.
                   *
                   * These functions can be used to verify that a message was signed by the holder
                   * of the private keys of a given address.
                   */
                  library ECDSAUpgradeable {
                      enum RecoverError {
                          NoError,
                          InvalidSignature,
                          InvalidSignatureLength,
                          InvalidSignatureS,
                          InvalidSignatureV
                      }
                      function _throwError(RecoverError error) private pure {
                          if (error == RecoverError.NoError) {
                              return; // no error: do nothing
                          } else if (error == RecoverError.InvalidSignature) {
                              revert("ECDSA: invalid signature");
                          } else if (error == RecoverError.InvalidSignatureLength) {
                              revert("ECDSA: invalid signature length");
                          } else if (error == RecoverError.InvalidSignatureS) {
                              revert("ECDSA: invalid signature 's' value");
                          } else if (error == RecoverError.InvalidSignatureV) {
                              revert("ECDSA: invalid signature 'v' value");
                          }
                      }
                      /**
                       * @dev Returns the address that signed a hashed message (`hash`) with
                       * `signature` or error string. This address can then be used for verification purposes.
                       *
                       * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:
                       * this function rejects them by requiring the `s` value to be in the lower
                       * half order, and the `v` value to be either 27 or 28.
                       *
                       * IMPORTANT: `hash` _must_ be the result of a hash operation for the
                       * verification to be secure: it is possible to craft signatures that
                       * recover to arbitrary addresses for non-hashed data. A safe way to ensure
                       * this is by receiving a hash of the original message (which may otherwise
                       * be too long), and then calling {toEthSignedMessageHash} on it.
                       *
                       * Documentation for signature generation:
                       * - with https://web3js.readthedocs.io/en/v1.3.4/web3-eth-accounts.html#sign[Web3.js]
                       * - with https://docs.ethers.io/v5/api/signer/#Signer-signMessage[ethers]
                       *
                       * _Available since v4.3._
                       */
                      function tryRecover(bytes32 hash, bytes memory signature) internal pure returns (address, RecoverError) {
                          // Check the signature length
                          // - case 65: r,s,v signature (standard)
                          // - case 64: r,vs signature (cf https://eips.ethereum.org/EIPS/eip-2098) _Available since v4.1._
                          if (signature.length == 65) {
                              bytes32 r;
                              bytes32 s;
                              uint8 v;
                              // ecrecover takes the signature parameters, and the only way to get them
                              // currently is to use assembly.
                              /// @solidity memory-safe-assembly
                              assembly {
                                  r := mload(add(signature, 0x20))
                                  s := mload(add(signature, 0x40))
                                  v := byte(0, mload(add(signature, 0x60)))
                              }
                              return tryRecover(hash, v, r, s);
                          } else if (signature.length == 64) {
                              bytes32 r;
                              bytes32 vs;
                              // ecrecover takes the signature parameters, and the only way to get them
                              // currently is to use assembly.
                              /// @solidity memory-safe-assembly
                              assembly {
                                  r := mload(add(signature, 0x20))
                                  vs := mload(add(signature, 0x40))
                              }
                              return tryRecover(hash, r, vs);
                          } else {
                              return (address(0), RecoverError.InvalidSignatureLength);
                          }
                      }
                      /**
                       * @dev Returns the address that signed a hashed message (`hash`) with
                       * `signature`. This address can then be used for verification purposes.
                       *
                       * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:
                       * this function rejects them by requiring the `s` value to be in the lower
                       * half order, and the `v` value to be either 27 or 28.
                       *
                       * IMPORTANT: `hash` _must_ be the result of a hash operation for the
                       * verification to be secure: it is possible to craft signatures that
                       * recover to arbitrary addresses for non-hashed data. A safe way to ensure
                       * this is by receiving a hash of the original message (which may otherwise
                       * be too long), and then calling {toEthSignedMessageHash} on it.
                       */
                      function recover(bytes32 hash, bytes memory signature) internal pure returns (address) {
                          (address recovered, RecoverError error) = tryRecover(hash, signature);
                          _throwError(error);
                          return recovered;
                      }
                      /**
                       * @dev Overload of {ECDSA-tryRecover} that receives the `r` and `vs` short-signature fields separately.
                       *
                       * See https://eips.ethereum.org/EIPS/eip-2098[EIP-2098 short signatures]
                       *
                       * _Available since v4.3._
                       */
                      function tryRecover(
                          bytes32 hash,
                          bytes32 r,
                          bytes32 vs
                      ) internal pure returns (address, RecoverError) {
                          bytes32 s = vs & bytes32(0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff);
                          uint8 v = uint8((uint256(vs) >> 255) + 27);
                          return tryRecover(hash, v, r, s);
                      }
                      /**
                       * @dev Overload of {ECDSA-recover} that receives the `r and `vs` short-signature fields separately.
                       *
                       * _Available since v4.2._
                       */
                      function recover(
                          bytes32 hash,
                          bytes32 r,
                          bytes32 vs
                      ) internal pure returns (address) {
                          (address recovered, RecoverError error) = tryRecover(hash, r, vs);
                          _throwError(error);
                          return recovered;
                      }
                      /**
                       * @dev Overload of {ECDSA-tryRecover} that receives the `v`,
                       * `r` and `s` signature fields separately.
                       *
                       * _Available since v4.3._
                       */
                      function tryRecover(
                          bytes32 hash,
                          uint8 v,
                          bytes32 r,
                          bytes32 s
                      ) internal pure returns (address, RecoverError) {
                          // EIP-2 still allows signature malleability for ecrecover(). Remove this possibility and make the signature
                          // unique. Appendix F in the Ethereum Yellow paper (https://ethereum.github.io/yellowpaper/paper.pdf), defines
                          // the valid range for s in (301): 0 < s < secp256k1n ÷ 2 + 1, and for v in (302): v ∈ {27, 28}. Most
                          // signatures from current libraries generate a unique signature with an s-value in the lower half order.
                          //
                          // If your library generates malleable signatures, such as s-values in the upper range, calculate a new s-value
                          // with 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141 - s1 and flip v from 27 to 28 or
                          // vice versa. If your library also generates signatures with 0/1 for v instead 27/28, add 27 to v to accept
                          // these malleable signatures as well.
                          if (uint256(s) > 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0) {
                              return (address(0), RecoverError.InvalidSignatureS);
                          }
                          if (v != 27 && v != 28) {
                              return (address(0), RecoverError.InvalidSignatureV);
                          }
                          // If the signature is valid (and not malleable), return the signer address
                          address signer = ecrecover(hash, v, r, s);
                          if (signer == address(0)) {
                              return (address(0), RecoverError.InvalidSignature);
                          }
                          return (signer, RecoverError.NoError);
                      }
                      /**
                       * @dev Overload of {ECDSA-recover} that receives the `v`,
                       * `r` and `s` signature fields separately.
                       */
                      function recover(
                          bytes32 hash,
                          uint8 v,
                          bytes32 r,
                          bytes32 s
                      ) internal pure returns (address) {
                          (address recovered, RecoverError error) = tryRecover(hash, v, r, s);
                          _throwError(error);
                          return recovered;
                      }
                      /**
                       * @dev Returns an Ethereum Signed Message, created from a `hash`. This
                       * produces hash corresponding to the one signed with the
                       * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]
                       * JSON-RPC method as part of EIP-191.
                       *
                       * See {recover}.
                       */
                      function toEthSignedMessageHash(bytes32 hash) internal pure returns (bytes32) {
                          // 32 is the length in bytes of hash,
                          // enforced by the type signature above
                          return keccak256(abi.encodePacked("\\x19Ethereum Signed Message:\
                  32", hash));
                      }
                      /**
                       * @dev Returns an Ethereum Signed Message, created from `s`. This
                       * produces hash corresponding to the one signed with the
                       * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]
                       * JSON-RPC method as part of EIP-191.
                       *
                       * See {recover}.
                       */
                      function toEthSignedMessageHash(bytes memory s) internal pure returns (bytes32) {
                          return keccak256(abi.encodePacked("\\x19Ethereum Signed Message:\
                  ", StringsUpgradeable.toString(s.length), s));
                      }
                      /**
                       * @dev Returns an Ethereum Signed Typed Data, created from a
                       * `domainSeparator` and a `structHash`. This produces hash corresponding
                       * to the one signed with the
                       * https://eips.ethereum.org/EIPS/eip-712[`eth_signTypedData`]
                       * JSON-RPC method as part of EIP-712.
                       *
                       * See {recover}.
                       */
                      function toTypedDataHash(bytes32 domainSeparator, bytes32 structHash) internal pure returns (bytes32) {
                          return keccak256(abi.encodePacked("\\x19\\x01", domainSeparator, structHash));
                      }
                  }
                  // SPDX-License-Identifier: MIT
                  // OpenZeppelin Contracts (last updated v4.7.0) (security/Pausable.sol)
                  pragma solidity ^0.8.0;
                  import "../utils/ContextUpgradeable.sol";
                  import "../proxy/utils/Initializable.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 PausableUpgradeable is Initializable, ContextUpgradeable {
                      /**
                       * @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.
                       */
                      function __Pausable_init() internal onlyInitializing {
                          __Pausable_init_unchained();
                      }
                      function __Pausable_init_unchained() internal onlyInitializing {
                          _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());
                      }
                      /**
                       * @dev This empty reserved space is put in place to allow future versions to add new
                       * variables without shifting down storage in the inheritance chain.
                       * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
                       */
                      uint256[49] private __gap;
                  }
                  //SPDX-License-Identifier: BUSL-1.1
                  pragma solidity 0.8.16;
                  import "./IQuadPassportStore.sol";
                  import "./IQuadSoulbound.sol";
                  interface IQuadPassport is IQuadSoulbound {
                      event GovernanceUpdated(address indexed _oldGovernance, address indexed _governance);
                      event SetPendingGovernance(address indexed _pendingGovernance);
                      event SetAttributeReceipt(address indexed _account, address indexed _issuer, uint256 _fee);
                      event BurnPassportsIssuer(address indexed _issuer, address indexed _account);
                      event WithdrawEvent(address indexed _issuer, address indexed _treasury, uint256 _fee);
                      function setAttributes(
                          IQuadPassportStore.AttributeSetterConfig memory _config,
                          bytes calldata _sigIssuer,
                          bytes calldata _sigAccount
                      ) external payable;
                      function setAttributesBulk(
                          IQuadPassportStore.AttributeSetterConfig[] memory _configs,
                          bytes[] calldata _sigIssuers,
                          bytes[] calldata _sigAccounts
                      ) external payable;
                      function setAttributesIssuer(
                          address _account,
                          IQuadPassportStore.AttributeSetterConfig memory _config,
                          bytes calldata _sigIssuer
                      ) external payable;
                      function burnPassports() external;
                      function burnPassportsIssuer(address _account) external;
                      function setGovernance(address _governanceContract) external;
                      function acceptGovernance() external;
                      function attributes(address _account, bytes32 _attribute) external view returns (IQuadPassportStore.Attribute[] memory);
                      function withdraw(address payable _to, uint256 _amount) external;
                      function passportPaused() external view returns(bool);
                      function setTokenURI(uint256 _tokenId, string memory _uri) external;
                  }
                  //SPDX-License-Identifier: BUSL-1.1
                  pragma solidity 0.8.16;
                  import "../storage/QuadGovernanceStore.sol";
                  interface IQuadGovernance {
                      event AttributePriceUpdatedFixed(bytes32 _attribute, uint256 _oldPrice, uint256 _price);
                      event BusinessAttributePriceUpdatedFixed(bytes32 _attribute, uint256 _oldPrice, uint256 _price);
                      event EligibleTokenUpdated(uint256 _tokenId, bool _eligibleStatus);
                      event EligibleAttributeUpdated(bytes32 _attribute, bool _eligibleStatus);
                      event EligibleAttributeByDIDUpdated(bytes32 _attribute, bool _eligibleStatus);
                      event IssuerAdded(address indexed _issuer, address indexed _newTreasury);
                      event IssuerDeleted(address indexed _issuer);
                      event IssuerStatusChanged(address indexed issuer, bool newStatus);
                      event IssuerAttributePermission(address indexed issuer, bytes32 _attribute,  bool _permission);
                      event PassportAddressUpdated(address indexed _oldAddress, address indexed _address);
                      event RevenueSplitIssuerUpdated(uint256 _oldSplit, uint256 _split);
                      event TreasuryUpdated(address indexed _oldAddress, address indexed _address);
                      function setTreasury(address _treasury) external;
                      function setPassportContractAddress(address _passportAddr) external;
                      function updateGovernanceInPassport(address _newGovernance) external;
                      function setEligibleTokenId(uint256 _tokenId, bool _eligibleStatus, string memory _uri) external;
                      function setEligibleAttribute(bytes32 _attribute, bool _eligibleStatus) external;
                      function setEligibleAttributeByDID(bytes32 _attribute, bool _eligibleStatus) external;
                      function setAttributePriceFixed(bytes32 _attribute, uint256 _price) external;
                      function setBusinessAttributePriceFixed(bytes32 _attribute, uint256 _price) external;
                      function setRevSplitIssuer(uint256 _split) external;
                      function addIssuer(address _issuer, address _treasury) external;
                      function deleteIssuer(address _issuer) external;
                      function setIssuerStatus(address _issuer, bool _status) external;
                      function setIssuerAttributePermission(address _issuer, bytes32 _attribute, bool _permission) external;
                      function getEligibleAttributesLength() external view returns(uint256);
                      function getMaxEligibleTokenId() external view returns(uint256);
                      function eligibleTokenId(uint256) external view returns(bool);
                      function issuersTreasury(address) external view returns (address);
                      function eligibleAttributes(bytes32) external view returns(bool);
                      function eligibleAttributesByDID(bytes32) external view returns(bool);
                      function eligibleAttributesArray(uint256) external view returns(bytes32);
                      function pricePerAttributeFixed(bytes32) external view returns(uint256);
                      function pricePerBusinessAttributeFixed(bytes32) external view returns(uint256);
                      function revSplitIssuer() external view returns (uint256);
                      function treasury() external view returns (address);
                      function getIssuersLength() external view returns (uint256);
                      function getIssuers() external view returns (address[] memory);
                      function issuers(uint256) external view returns(address);
                      function getIssuerStatus(address _issuer) external view returns(bool);
                      function getIssuerAttributePermission(address _issuer, bytes32 _attribute) external view returns(bool);
                  }
                  //SPDX-License-Identifier: BUSL-1.1
                  pragma solidity 0.8.16;
                  import "../interfaces/IQuadPassportStore.sol";
                  import "../interfaces/IQuadGovernance.sol";
                  import "./QuadConstant.sol";
                  contract QuadPassportStore is IQuadPassportStore, QuadConstant {
                      IQuadGovernance public governance;
                      address public pendingGovernance;
                      // SignatureHash => bool
                      mapping(bytes32 => bool) internal _usedSigHashes;
                      string public symbol;
                      string public name;
                      // Key could be:
                      // 1) keccak256(userAddress, keccak256(attrType))
                      // 2) keccak256(DID, keccak256(attrType))
                      mapping(bytes32 => Attribute[]) internal _attributes;
                      // Key could be:
                      // 1) keccak256(keccak256(userAddress, keccak256(attrType)), issuer)
                      // 1) keccak256(keccak256(DID, keccak256(attrType)), issuer)
                      mapping(bytes32 => uint256) internal _position;
                  }
                  //SPDX-License-Identifier: BUSL-1.1
                  pragma solidity 0.8.16;
                  import "@openzeppelin/contracts-upgradeable/utils/ContextUpgradeable.sol";
                  import "@openzeppelin/contracts-upgradeable/token/ERC1155/IERC1155Upgradeable.sol";
                  import "@openzeppelin/contracts-upgradeable/token/ERC1155/extensions/IERC1155MetadataURIUpgradeable.sol";
                  import "./interfaces/IQuadSoulbound.sol";
                  /// @title Quadrata Soulbound NFT
                  /// @author Fabrice Cheng, Theodore Clapp
                  /// @notice This represents Quadrata Soulbound NFT
                  contract QuadSoulbound is IQuadSoulbound, ContextUpgradeable {
                      // Mapping from token ID to account balances
                      mapping(uint256 => mapping(address => uint256)) private _balances;
                      // Mapping from tokenId to uris
                      mapping(uint256 => string) private _uris;
                      function uri(uint256 _tokenId) public view virtual override returns (string memory) {
                          if (bytes(_uris[_tokenId]).length == 0) {
                              return _uris[1];
                          }
                          return _uris[_tokenId];
                      }
                      /**
                       * @dev ERC1155 balanceOf implementation
                       *
                       * Requirements:
                       *
                       * - `account` cannot be the zero address.
                       */
                      function balanceOf(address account, uint256 id) public view virtual override returns (uint256) {
                          require(account != address(0), "ERC1155: address zero is not a valid owner");
                          return _balances[id][account];
                      }
                      /**
                       * @dev See {IERC1155-balanceOfBatch}.
                       *
                       * Requirements:
                       *
                       * - `accounts` and `ids` must have the same length.
                       */
                      function balanceOfBatch(address[] memory accounts, uint256[] memory ids)
                          public
                          view
                          virtual
                          override
                          returns (uint256[] memory)
                      {
                          require(accounts.length == ids.length, "ERC1155: accounts and ids length mismatch");
                          uint256[] memory batchBalances = new uint256[](accounts.length);
                          for (uint256 i = 0; i < accounts.length; ++i) {
                              batchBalances[i] = balanceOf(accounts[i], ids[i]);
                          }
                          return batchBalances;
                      }
                      /**
                       * @dev See {IERC165-supportsInterface}.
                       */
                      function supportsInterface(bytes4 interfaceId) public view virtual returns (bool) {
                          return
                              interfaceId == type(IERC1155Upgradeable).interfaceId ||
                              interfaceId == type(IERC1155MetadataURIUpgradeable).interfaceId;
                      }
                      /**
                       * @dev Sets a new URI for all token types, by relying on the token type ID
                       * substitution mechanism
                       * https://eips.ethereum.org/EIPS/eip-1155#metadata[defined in the EIP].
                       *
                       * By this mechanism, any occurrence of the `\\{id\\}` substring in either the
                       * URI or any of the amounts in the JSON file at said URI will be replaced by
                       * clients with the token type ID.
                       *
                       * For example, the `https://token-cdn-domain/\\{id\\}.json` URI would be
                       * interpreted by clients as
                       * `https://token-cdn-domain/000000000000000000000000000000000000000000000000000000000004cce0.json`
                       * for token type ID 0x4cce0.
                       *
                       * See {uri}.
                       *
                       * Because these URIs cannot be meaningfully represented by the {URI} event,
                       * this function emits no events.
                       */
                      function _setURI(string memory newuri, uint256 tokenId) internal virtual {
                          _uris[tokenId] = newuri;
                          emit URI(newuri, tokenId);
                      }
                      /**
                       * @dev Creates `amount` tokens of token type `id`, and assigns them to `to`.
                       *
                       * Emits a {TransferSingle} event.
                       *
                       * Requirements:
                       *
                       * - `to` cannot be the zero address.
                       * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155Received} and return the
                       * acceptance magic value.
                       */
                      function _mint(
                          address to,
                          uint256 id,
                          uint256 amount
                      ) internal virtual {
                          require(to != address(0), "ERC1155: mint to the zero address");
                          _balances[id][to] += amount;
                          emit TransferSingle(_msgSender(), address(0), to, id, amount);
                      }
                      /**
                       * @dev Destroys `amount` tokens of token type `id` from `from`
                       *
                       * Emits a {TransferSingle} event.
                       *
                       * Requirements:
                       *
                       * - `from` cannot be the zero address.
                       * - `from` must have at least `amount` tokens of token type `id`.
                       */
                      function _burn(
                          address from,
                          uint256 id,
                          uint256 amount
                      ) internal virtual {
                          require(from != address(0), "ERC1155: burn from the zero address");
                          uint256 fromBalance = _balances[id][from];
                          require(fromBalance >= amount, "ERC1155: burn amount exceeds balance");
                          unchecked {
                              _balances[id][from] = fromBalance - amount;
                          }
                          emit TransferSingle(_msgSender(), from, address(0), id, amount);
                      }
                      uint256[47] private __gap;
                  }
                  // SPDX-License-Identifier: MIT
                  // OpenZeppelin Contracts (last updated v4.5.0) (interfaces/draft-IERC1822.sol)
                  pragma solidity ^0.8.0;
                  /**
                   * @dev ERC1822: Universal Upgradeable Proxy Standard (UUPS) documents a method for upgradeability through a simplified
                   * proxy whose upgrades are fully controlled by the current implementation.
                   */
                  interface IERC1822ProxiableUpgradeable {
                      /**
                       * @dev Returns the storage slot that the proxiable contract assumes is being used to store the implementation
                       * address.
                       *
                       * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks
                       * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this
                       * function revert if invoked through a proxy.
                       */
                      function proxiableUUID() external view returns (bytes32);
                  }
                  // SPDX-License-Identifier: MIT
                  // OpenZeppelin Contracts (last updated v4.5.0) (proxy/ERC1967/ERC1967Upgrade.sol)
                  pragma solidity ^0.8.2;
                  import "../beacon/IBeaconUpgradeable.sol";
                  import "../../interfaces/draft-IERC1822Upgradeable.sol";
                  import "../../utils/AddressUpgradeable.sol";
                  import "../../utils/StorageSlotUpgradeable.sol";
                  import "../utils/Initializable.sol";
                  /**
                   * @dev This abstract contract provides getters and event emitting update functions for
                   * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.
                   *
                   * _Available since v4.1._
                   *
                   * @custom:oz-upgrades-unsafe-allow delegatecall
                   */
                  abstract contract ERC1967UpgradeUpgradeable is Initializable {
                      function __ERC1967Upgrade_init() internal onlyInitializing {
                      }
                      function __ERC1967Upgrade_init_unchained() internal onlyInitializing {
                      }
                      // This is the keccak-256 hash of "eip1967.proxy.rollback" subtracted by 1
                      bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143;
                      /**
                       * @dev Storage slot with the address of the current implementation.
                       * This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1, and is
                       * validated in the constructor.
                       */
                      bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
                      /**
                       * @dev Emitted when the implementation is upgraded.
                       */
                      event Upgraded(address indexed implementation);
                      /**
                       * @dev Returns the current implementation address.
                       */
                      function _getImplementation() internal view returns (address) {
                          return StorageSlotUpgradeable.getAddressSlot(_IMPLEMENTATION_SLOT).value;
                      }
                      /**
                       * @dev Stores a new address in the EIP1967 implementation slot.
                       */
                      function _setImplementation(address newImplementation) private {
                          require(AddressUpgradeable.isContract(newImplementation), "ERC1967: new implementation is not a contract");
                          StorageSlotUpgradeable.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
                      }
                      /**
                       * @dev Perform implementation upgrade
                       *
                       * Emits an {Upgraded} event.
                       */
                      function _upgradeTo(address newImplementation) internal {
                          _setImplementation(newImplementation);
                          emit Upgraded(newImplementation);
                      }
                      /**
                       * @dev Perform implementation upgrade with additional setup call.
                       *
                       * Emits an {Upgraded} event.
                       */
                      function _upgradeToAndCall(
                          address newImplementation,
                          bytes memory data,
                          bool forceCall
                      ) internal {
                          _upgradeTo(newImplementation);
                          if (data.length > 0 || forceCall) {
                              _functionDelegateCall(newImplementation, data);
                          }
                      }
                      /**
                       * @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call.
                       *
                       * Emits an {Upgraded} event.
                       */
                      function _upgradeToAndCallUUPS(
                          address newImplementation,
                          bytes memory data,
                          bool forceCall
                      ) internal {
                          // Upgrades from old implementations will perform a rollback test. This test requires the new
                          // implementation to upgrade back to the old, non-ERC1822 compliant, implementation. Removing
                          // this special case will break upgrade paths from old UUPS implementation to new ones.
                          if (StorageSlotUpgradeable.getBooleanSlot(_ROLLBACK_SLOT).value) {
                              _setImplementation(newImplementation);
                          } else {
                              try IERC1822ProxiableUpgradeable(newImplementation).proxiableUUID() returns (bytes32 slot) {
                                  require(slot == _IMPLEMENTATION_SLOT, "ERC1967Upgrade: unsupported proxiableUUID");
                              } catch {
                                  revert("ERC1967Upgrade: new implementation is not UUPS");
                              }
                              _upgradeToAndCall(newImplementation, data, forceCall);
                          }
                      }
                      /**
                       * @dev Storage slot with the admin of the contract.
                       * This is the keccak-256 hash of "eip1967.proxy.admin" subtracted by 1, and is
                       * validated in the constructor.
                       */
                      bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;
                      /**
                       * @dev Emitted when the admin account has changed.
                       */
                      event AdminChanged(address previousAdmin, address newAdmin);
                      /**
                       * @dev Returns the current admin.
                       */
                      function _getAdmin() internal view returns (address) {
                          return StorageSlotUpgradeable.getAddressSlot(_ADMIN_SLOT).value;
                      }
                      /**
                       * @dev Stores a new address in the EIP1967 admin slot.
                       */
                      function _setAdmin(address newAdmin) private {
                          require(newAdmin != address(0), "ERC1967: new admin is the zero address");
                          StorageSlotUpgradeable.getAddressSlot(_ADMIN_SLOT).value = newAdmin;
                      }
                      /**
                       * @dev Changes the admin of the proxy.
                       *
                       * Emits an {AdminChanged} event.
                       */
                      function _changeAdmin(address newAdmin) internal {
                          emit AdminChanged(_getAdmin(), newAdmin);
                          _setAdmin(newAdmin);
                      }
                      /**
                       * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.
                       * This is bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor.
                       */
                      bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;
                      /**
                       * @dev Emitted when the beacon is upgraded.
                       */
                      event BeaconUpgraded(address indexed beacon);
                      /**
                       * @dev Returns the current beacon.
                       */
                      function _getBeacon() internal view returns (address) {
                          return StorageSlotUpgradeable.getAddressSlot(_BEACON_SLOT).value;
                      }
                      /**
                       * @dev Stores a new beacon in the EIP1967 beacon slot.
                       */
                      function _setBeacon(address newBeacon) private {
                          require(AddressUpgradeable.isContract(newBeacon), "ERC1967: new beacon is not a contract");
                          require(
                              AddressUpgradeable.isContract(IBeaconUpgradeable(newBeacon).implementation()),
                              "ERC1967: beacon implementation is not a contract"
                          );
                          StorageSlotUpgradeable.getAddressSlot(_BEACON_SLOT).value = newBeacon;
                      }
                      /**
                       * @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does
                       * not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that).
                       *
                       * Emits a {BeaconUpgraded} event.
                       */
                      function _upgradeBeaconToAndCall(
                          address newBeacon,
                          bytes memory data,
                          bool forceCall
                      ) internal {
                          _setBeacon(newBeacon);
                          emit BeaconUpgraded(newBeacon);
                          if (data.length > 0 || forceCall) {
                              _functionDelegateCall(IBeaconUpgradeable(newBeacon).implementation(), data);
                          }
                      }
                      /**
                       * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
                       * but performing a delegate call.
                       *
                       * _Available since v3.4._
                       */
                      function _functionDelegateCall(address target, bytes memory data) private returns (bytes memory) {
                          require(AddressUpgradeable.isContract(target), "Address: delegate call to non-contract");
                          // solhint-disable-next-line avoid-low-level-calls
                          (bool success, bytes memory returndata) = target.delegatecall(data);
                          return AddressUpgradeable.verifyCallResult(success, returndata, "Address: low-level delegate call failed");
                      }
                      /**
                       * @dev This empty reserved space is put in place to allow future versions to add new
                       * variables without shifting down storage in the inheritance chain.
                       * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
                       */
                      uint256[50] private __gap;
                  }
                  // SPDX-License-Identifier: MIT
                  // OpenZeppelin Contracts (last updated v4.7.0) (proxy/utils/Initializable.sol)
                  pragma solidity ^0.8.2;
                  import "../../utils/AddressUpgradeable.sol";
                  /**
                   * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed
                   * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an
                   * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer
                   * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.
                   *
                   * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be
                   * reused. This mechanism prevents re-execution of each "step" but allows the creation of new initialization steps in
                   * case an upgrade adds a module that needs to be initialized.
                   *
                   * For example:
                   *
                   * [.hljs-theme-light.nopadding]
                   * ```
                   * contract MyToken is ERC20Upgradeable {
                   *     function initialize() initializer public {
                   *         __ERC20_init("MyToken", "MTK");
                   *     }
                   * }
                   * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {
                   *     function initializeV2() reinitializer(2) public {
                   *         __ERC20Permit_init("MyToken");
                   *     }
                   * }
                   * ```
                   *
                   * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as
                   * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.
                   *
                   * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure
                   * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.
                   *
                   * [CAUTION]
                   * ====
                   * Avoid leaving a contract uninitialized.
                   *
                   * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation
                   * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke
                   * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:
                   *
                   * [.hljs-theme-light.nopadding]
                   * ```
                   * /// @custom:oz-upgrades-unsafe-allow constructor
                   * constructor() {
                   *     _disableInitializers();
                   * }
                   * ```
                   * ====
                   */
                  abstract contract Initializable {
                      /**
                       * @dev Indicates that the contract has been initialized.
                       * @custom:oz-retyped-from bool
                       */
                      uint8 private _initialized;
                      /**
                       * @dev Indicates that the contract is in the process of being initialized.
                       */
                      bool private _initializing;
                      /**
                       * @dev Triggered when the contract has been initialized or reinitialized.
                       */
                      event Initialized(uint8 version);
                      /**
                       * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,
                       * `onlyInitializing` functions can be used to initialize parent contracts. Equivalent to `reinitializer(1)`.
                       */
                      modifier initializer() {
                          bool isTopLevelCall = !_initializing;
                          require(
                              (isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1),
                              "Initializable: contract is already initialized"
                          );
                          _initialized = 1;
                          if (isTopLevelCall) {
                              _initializing = true;
                          }
                          _;
                          if (isTopLevelCall) {
                              _initializing = false;
                              emit Initialized(1);
                          }
                      }
                      /**
                       * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the
                       * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be
                       * used to initialize parent contracts.
                       *
                       * `initializer` is equivalent to `reinitializer(1)`, so a reinitializer may be used after the original
                       * initialization step. This is essential to configure modules that are added through upgrades and that require
                       * initialization.
                       *
                       * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in
                       * a contract, executing them in the right order is up to the developer or operator.
                       */
                      modifier reinitializer(uint8 version) {
                          require(!_initializing && _initialized < version, "Initializable: contract is already initialized");
                          _initialized = version;
                          _initializing = true;
                          _;
                          _initializing = false;
                          emit Initialized(version);
                      }
                      /**
                       * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the
                       * {initializer} and {reinitializer} modifiers, directly or indirectly.
                       */
                      modifier onlyInitializing() {
                          require(_initializing, "Initializable: contract is not initializing");
                          _;
                      }
                      /**
                       * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.
                       * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized
                       * to any version. It is recommended to use this to lock implementation contracts that are designed to be called
                       * through proxies.
                       */
                      function _disableInitializers() internal virtual {
                          require(!_initializing, "Initializable: contract is initializing");
                          if (_initialized < type(uint8).max) {
                              _initialized = type(uint8).max;
                              emit Initialized(type(uint8).max);
                          }
                      }
                  }
                  // SPDX-License-Identifier: MIT
                  // OpenZeppelin Contracts v4.4.1 (proxy/beacon/IBeacon.sol)
                  pragma solidity ^0.8.0;
                  /**
                   * @dev This is the interface that {BeaconProxy} expects of its beacon.
                   */
                  interface IBeaconUpgradeable {
                      /**
                       * @dev Must return an address that can be used as a delegate call target.
                       *
                       * {BeaconProxy} will check that this address is a contract.
                       */
                      function implementation() external view returns (address);
                  }
                  // SPDX-License-Identifier: MIT
                  // OpenZeppelin Contracts (last updated v4.7.0) (utils/Address.sol)
                  pragma solidity ^0.8.1;
                  /**
                   * @dev Collection of functions related to the address type
                   */
                  library AddressUpgradeable {
                      /**
                       * @dev Returns true if `account` is a contract.
                       *
                       * [IMPORTANT]
                       * ====
                       * It is unsafe to assume that an address for which this function returns
                       * false is an externally-owned account (EOA) and not a contract.
                       *
                       * Among others, `isContract` will return false for the following
                       * types of addresses:
                       *
                       *  - an externally-owned account
                       *  - a contract in construction
                       *  - an address where a contract will be created
                       *  - an address where a contract lived, but was destroyed
                       * ====
                       *
                       * [IMPORTANT]
                       * ====
                       * You shouldn't rely on `isContract` to protect against flash loan attacks!
                       *
                       * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
                       * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
                       * constructor.
                       * ====
                       */
                      function isContract(address account) internal view returns (bool) {
                          // This method relies on extcodesize/address.code.length, which returns 0
                          // for contracts in construction, since the code is only stored at the end
                          // of the constructor execution.
                          return account.code.length > 0;
                      }
                      /**
                       * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
                       * `recipient`, forwarding all available gas and reverting on errors.
                       *
                       * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
                       * of certain opcodes, possibly making contracts go over the 2300 gas limit
                       * imposed by `transfer`, making them unable to receive funds via
                       * `transfer`. {sendValue} removes this limitation.
                       *
                       * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
                       *
                       * IMPORTANT: because control is transferred to `recipient`, care must be
                       * taken to not create reentrancy vulnerabilities. Consider using
                       * {ReentrancyGuard} or the
                       * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
                       */
                      function sendValue(address payable recipient, uint256 amount) internal {
                          require(address(this).balance >= amount, "Address: insufficient balance");
                          (bool success, ) = recipient.call{value: amount}("");
                          require(success, "Address: unable to send value, recipient may have reverted");
                      }
                      /**
                       * @dev Performs a Solidity function call using a low level `call`. A
                       * plain `call` is an unsafe replacement for a function call: use this
                       * function instead.
                       *
                       * If `target` reverts with a revert reason, it is bubbled up by this
                       * function (like regular Solidity function calls).
                       *
                       * Returns the raw returned data. To convert to the expected return value,
                       * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
                       *
                       * Requirements:
                       *
                       * - `target` must be a contract.
                       * - calling `target` with `data` must not revert.
                       *
                       * _Available since v3.1._
                       */
                      function functionCall(address target, bytes memory data) internal returns (bytes memory) {
                          return functionCall(target, data, "Address: low-level call failed");
                      }
                      /**
                       * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
                       * `errorMessage` as a fallback revert reason when `target` reverts.
                       *
                       * _Available since v3.1._
                       */
                      function functionCall(
                          address target,
                          bytes memory data,
                          string memory errorMessage
                      ) internal returns (bytes memory) {
                          return functionCallWithValue(target, data, 0, errorMessage);
                      }
                      /**
                       * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                       * but also transferring `value` wei to `target`.
                       *
                       * Requirements:
                       *
                       * - the calling contract must have an ETH balance of at least `value`.
                       * - the called Solidity function must be `payable`.
                       *
                       * _Available since v3.1._
                       */
                      function functionCallWithValue(
                          address target,
                          bytes memory data,
                          uint256 value
                      ) internal returns (bytes memory) {
                          return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
                      }
                      /**
                       * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
                       * with `errorMessage` as a fallback revert reason when `target` reverts.
                       *
                       * _Available since v3.1._
                       */
                      function functionCallWithValue(
                          address target,
                          bytes memory data,
                          uint256 value,
                          string memory errorMessage
                      ) internal returns (bytes memory) {
                          require(address(this).balance >= value, "Address: insufficient balance for call");
                          require(isContract(target), "Address: call to non-contract");
                          (bool success, bytes memory returndata) = target.call{value: value}(data);
                          return verifyCallResult(success, returndata, errorMessage);
                      }
                      /**
                       * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                       * but performing a static call.
                       *
                       * _Available since v3.3._
                       */
                      function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
                          return functionStaticCall(target, data, "Address: low-level static call failed");
                      }
                      /**
                       * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
                       * but performing a static call.
                       *
                       * _Available since v3.3._
                       */
                      function functionStaticCall(
                          address target,
                          bytes memory data,
                          string memory errorMessage
                      ) internal view returns (bytes memory) {
                          require(isContract(target), "Address: static call to non-contract");
                          (bool success, bytes memory returndata) = target.staticcall(data);
                          return verifyCallResult(success, returndata, errorMessage);
                      }
                      /**
                       * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the
                       * revert reason using the provided one.
                       *
                       * _Available since v4.3._
                       */
                      function verifyCallResult(
                          bool success,
                          bytes memory returndata,
                          string memory errorMessage
                      ) internal pure returns (bytes memory) {
                          if (success) {
                              return returndata;
                          } else {
                              // Look for revert reason and bubble it up if present
                              if (returndata.length > 0) {
                                  // The easiest way to bubble the revert reason is using memory via assembly
                                  /// @solidity memory-safe-assembly
                                  assembly {
                                      let returndata_size := mload(returndata)
                                      revert(add(32, returndata), returndata_size)
                                  }
                              } else {
                                  revert(errorMessage);
                              }
                          }
                      }
                  }
                  // SPDX-License-Identifier: MIT
                  // OpenZeppelin Contracts (last updated v4.7.0) (utils/StorageSlot.sol)
                  pragma solidity ^0.8.0;
                  /**
                   * @dev Library for reading and writing primitive types to specific storage slots.
                   *
                   * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.
                   * This library helps with reading and writing to such slots without the need for inline assembly.
                   *
                   * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.
                   *
                   * Example usage to set ERC1967 implementation slot:
                   * ```
                   * contract ERC1967 {
                   *     bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
                   *
                   *     function _getImplementation() internal view returns (address) {
                   *         return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
                   *     }
                   *
                   *     function _setImplementation(address newImplementation) internal {
                   *         require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
                   *         StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
                   *     }
                   * }
                   * ```
                   *
                   * _Available since v4.1 for `address`, `bool`, `bytes32`, and `uint256`._
                   */
                  library StorageSlotUpgradeable {
                      struct AddressSlot {
                          address value;
                      }
                      struct BooleanSlot {
                          bool value;
                      }
                      struct Bytes32Slot {
                          bytes32 value;
                      }
                      struct Uint256Slot {
                          uint256 value;
                      }
                      /**
                       * @dev Returns an `AddressSlot` with member `value` located at `slot`.
                       */
                      function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {
                          /// @solidity memory-safe-assembly
                          assembly {
                              r.slot := slot
                          }
                      }
                      /**
                       * @dev Returns an `BooleanSlot` with member `value` located at `slot`.
                       */
                      function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {
                          /// @solidity memory-safe-assembly
                          assembly {
                              r.slot := slot
                          }
                      }
                      /**
                       * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.
                       */
                      function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {
                          /// @solidity memory-safe-assembly
                          assembly {
                              r.slot := slot
                          }
                      }
                      /**
                       * @dev Returns an `Uint256Slot` with member `value` located at `slot`.
                       */
                      function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {
                          /// @solidity memory-safe-assembly
                          assembly {
                              r.slot := slot
                          }
                      }
                  }
                  // SPDX-License-Identifier: MIT
                  // OpenZeppelin Contracts (last updated v4.7.0) (utils/Strings.sol)
                  pragma solidity ^0.8.0;
                  /**
                   * @dev String operations.
                   */
                  library StringsUpgradeable {
                      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;
                  import "../proxy/utils/Initializable.sol";
                  /**
                   * @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 ContextUpgradeable is Initializable {
                      function __Context_init() internal onlyInitializing {
                      }
                      function __Context_init_unchained() internal onlyInitializing {
                      }
                      function _msgSender() internal view virtual returns (address) {
                          return msg.sender;
                      }
                      function _msgData() internal view virtual returns (bytes calldata) {
                          return msg.data;
                      }
                      /**
                       * @dev This empty reserved space is put in place to allow future versions to add new
                       * variables without shifting down storage in the inheritance chain.
                       * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
                       */
                      uint256[50] private __gap;
                  }
                  //SPDX-License-Identifier: BUSL-1.1
                  pragma solidity 0.8.16;
                  interface IQuadPassportStore {
                      /// @dev Attribute store infomation as it relates to a single attribute
                      /// `attrKeys` Array of keys defined by (wallet address/DID + data Type)
                      /// `value` Attribute value
                      /// `epoch` timestamp when the attribute has been verified by an Issuer
                      /// `issuer` address of the issuer issuing the attribute
                      struct Attribute {
                          bytes32 value;
                          uint256 epoch;
                          address issuer;
                      }
                      /// @dev AttributeSetterConfig contains configuration for setting attributes for a Passport holder
                      /// @notice This struct is used to abstract setAttributes function parameters
                      /// `attrKeys` Array of keys defined by (wallet address/DID + data Type)
                      /// `attrValues` Array of attributes values
                      /// `attrTypes` Array of attributes types (ex: [keccak256("DID")]) used for validation
                      /// `did` did of entity
                      /// `tokenId` tokenId of the Passport
                      /// `issuedAt` epoch when the passport has been issued by the Issuer
                      /// `verifiedAt` epoch when the attribute has been attested by the Issuer
                      /// `fee` Fee (in Native token) to pay the Issuer
                      struct AttributeSetterConfig {
                          bytes32[] attrKeys;
                          bytes32[] attrValues;
                          bytes32[] attrTypes;
                          bytes32 did;
                          uint256 tokenId;
                          uint256 verifiedAt;
                          uint256 issuedAt;
                          uint256 fee;
                      }
                  }
                  //SPDX-License-Identifier: BUSL-1.1
                  pragma solidity 0.8.16;
                  interface IQuadSoulbound  {
                      /**
                       * @dev Emitted when `value` tokens of token type `id` are transferred from `from` to `to` by `operator`.
                       */
                      event TransferSingle(address indexed operator, address indexed from, address indexed to, uint256 id, uint256 value);
                      /**
                       * @dev Emitted when the URI for token type `id` changes to `value`, if it is a non-programmatic URI.
                       *
                       * If an {URI} event was emitted for `id`, the standard
                       * https://eips.ethereum.org/EIPS/eip-1155#metadata-extensions[guarantees] that `value` will equal the value
                       * returned by {IERC1155MetadataURI-uri}.
                       */
                      event URI(string value, uint256 indexed id);
                      function uri(uint256 _tokenId) external view returns (string memory);
                      /**
                       * @dev ERC1155 balanceOf implementation
                       *
                       * Requirements:
                       *
                       * - `account` cannot be the zero address.
                       */
                      function balanceOf(address account, uint256 id) external view returns (uint256);
                      /**
                       * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {balanceOf}.
                       *
                       * Requirements:
                       *
                       * - `accounts` and `ids` must have the same length.
                       */
                      function balanceOfBatch(address[] calldata accounts, uint256[] calldata ids)
                          external
                          view
                          returns (uint256[] memory);
                  }
                  //SPDX-License-Identifier: BUSL-1.1
                  pragma solidity 0.8.16;
                  import "../interfaces/IQuadPassport.sol";
                  import "./QuadConstant.sol";
                  contract QuadGovernanceStore is QuadConstant {
                      // Attributes
                      bytes32[] internal _eligibleAttributesArray;
                      mapping(bytes32 => bool) internal _eligibleAttributes;
                      mapping(bytes32 => bool) internal _eligibleAttributesByDID;
                      // TokenId
                      mapping(uint256 => bool) internal _eligibleTokenId;
                      // Pricing
                      mapping(bytes32 => uint256) internal _pricePerBusinessAttributeFixed;
                      mapping(bytes32 => uint256) internal _pricePerAttributeFixed;
                      // Issuers
                      mapping(address => address) internal _issuerTreasury;
                      mapping(address => bool) internal _issuerStatus;
                      mapping(bytes32 => bool) internal _issuerAttributePermission;
                      address[] internal _issuers;
                      // Others
                      uint256 internal _revSplitIssuer; // 50 means 50%;
                      uint256 internal _maxEligibleTokenId;
                      IQuadPassport internal _passport;
                      address internal _treasury;
                  }
                  //SPDX-License-Identifier: BUSL-1.1
                  pragma solidity 0.8.16;
                  contract QuadConstant {
                      bytes32 public constant ISSUER_ROLE = keccak256("ISSUER_ROLE");
                      bytes32 public constant GOVERNANCE_ROLE = keccak256("GOVERNANCE_ROLE");
                      bytes32 public constant READER_ROLE = keccak256("READER_ROLE");
                      bytes32 public constant PAUSER_ROLE = keccak256("PAUSER_ROLE");
                      bytes32 public constant DIGEST_TO_SIGN = 0x37937bf5ff1ecbf00bbd389ab7ca9a190d7e8c0a084b2893ece7923be1d2ec85;
                      bytes32 internal constant ATTRIBUTE_DID = 0x09deac0378109c72d82cccd3c343a90f7020f0f1af78dcd4fc949c6301aa9488;
                      bytes32 internal constant ATTRIBUTE_IS_BUSINESS = 0xaf369ce728c816785c72f1ff0222ca9553b2cb93729d6a803be6af0d2369239b;
                      bytes32 internal constant ATTRIBUTE_COUNTRY = 0xc4713d2897c0d675d85b414a1974570a575e5032b6f7be9545631a1f922b26ef;
                      bytes32 internal constant ATTRIBUTE_AML = 0xaf192d67680c4285e52cd2a94216ce249fb4e0227d267dcc01ea88f1b020a119;
                      uint256[47] private __gap;
                  }
                  // SPDX-License-Identifier: MIT
                  // OpenZeppelin Contracts (last updated v4.7.0) (token/ERC1155/IERC1155.sol)
                  pragma solidity ^0.8.0;
                  import "../../utils/introspection/IERC165Upgradeable.sol";
                  /**
                   * @dev Required interface of an ERC1155 compliant contract, as defined in the
                   * https://eips.ethereum.org/EIPS/eip-1155[EIP].
                   *
                   * _Available since v3.1._
                   */
                  interface IERC1155Upgradeable is IERC165Upgradeable {
                      /**
                       * @dev Emitted when `value` tokens of token type `id` are transferred from `from` to `to` by `operator`.
                       */
                      event TransferSingle(address indexed operator, address indexed from, address indexed to, uint256 id, uint256 value);
                      /**
                       * @dev Equivalent to multiple {TransferSingle} events, where `operator`, `from` and `to` are the same for all
                       * transfers.
                       */
                      event TransferBatch(
                          address indexed operator,
                          address indexed from,
                          address indexed to,
                          uint256[] ids,
                          uint256[] values
                      );
                      /**
                       * @dev Emitted when `account` grants or revokes permission to `operator` to transfer their tokens, according to
                       * `approved`.
                       */
                      event ApprovalForAll(address indexed account, address indexed operator, bool approved);
                      /**
                       * @dev Emitted when the URI for token type `id` changes to `value`, if it is a non-programmatic URI.
                       *
                       * If an {URI} event was emitted for `id`, the standard
                       * https://eips.ethereum.org/EIPS/eip-1155#metadata-extensions[guarantees] that `value` will equal the value
                       * returned by {IERC1155MetadataURI-uri}.
                       */
                      event URI(string value, uint256 indexed id);
                      /**
                       * @dev Returns the amount of tokens of token type `id` owned by `account`.
                       *
                       * Requirements:
                       *
                       * - `account` cannot be the zero address.
                       */
                      function balanceOf(address account, uint256 id) external view returns (uint256);
                      /**
                       * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {balanceOf}.
                       *
                       * Requirements:
                       *
                       * - `accounts` and `ids` must have the same length.
                       */
                      function balanceOfBatch(address[] calldata accounts, uint256[] calldata ids)
                          external
                          view
                          returns (uint256[] memory);
                      /**
                       * @dev Grants or revokes permission to `operator` to transfer the caller's tokens, according to `approved`,
                       *
                       * Emits an {ApprovalForAll} event.
                       *
                       * Requirements:
                       *
                       * - `operator` cannot be the caller.
                       */
                      function setApprovalForAll(address operator, bool approved) external;
                      /**
                       * @dev Returns true if `operator` is approved to transfer ``account``'s tokens.
                       *
                       * See {setApprovalForAll}.
                       */
                      function isApprovedForAll(address account, address operator) external view returns (bool);
                      /**
                       * @dev Transfers `amount` tokens of token type `id` from `from` to `to`.
                       *
                       * Emits a {TransferSingle} event.
                       *
                       * Requirements:
                       *
                       * - `to` cannot be the zero address.
                       * - If the caller is not `from`, it must have been approved to spend ``from``'s tokens via {setApprovalForAll}.
                       * - `from` must have a balance of tokens of type `id` of at least `amount`.
                       * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155Received} and return the
                       * acceptance magic value.
                       */
                      function safeTransferFrom(
                          address from,
                          address to,
                          uint256 id,
                          uint256 amount,
                          bytes calldata data
                      ) external;
                      /**
                       * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {safeTransferFrom}.
                       *
                       * Emits a {TransferBatch} event.
                       *
                       * Requirements:
                       *
                       * - `ids` and `amounts` must have the same length.
                       * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155BatchReceived} and return the
                       * acceptance magic value.
                       */
                      function safeBatchTransferFrom(
                          address from,
                          address to,
                          uint256[] calldata ids,
                          uint256[] calldata amounts,
                          bytes calldata data
                      ) external;
                  }
                  // SPDX-License-Identifier: MIT
                  // OpenZeppelin Contracts v4.4.1 (token/ERC1155/extensions/IERC1155MetadataURI.sol)
                  pragma solidity ^0.8.0;
                  import "../IERC1155Upgradeable.sol";
                  /**
                   * @dev Interface of the optional ERC1155MetadataExtension interface, as defined
                   * in the https://eips.ethereum.org/EIPS/eip-1155#metadata-extensions[EIP].
                   *
                   * _Available since v3.1._
                   */
                  interface IERC1155MetadataURIUpgradeable is IERC1155Upgradeable {
                      /**
                       * @dev Returns the URI for token type `id`.
                       *
                       * If the `\\{id\\}` substring is present in the URI, it must be replaced by
                       * clients with the actual token type ID.
                       */
                      function uri(uint256 id) external view returns (string memory);
                  }
                  // 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 IERC165Upgradeable {
                      /**
                       * @dev Returns true if this contract implements the interface defined by
                       * `interfaceId`. See the corresponding
                       * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
                       * to learn more about how these ids are created.
                       *
                       * This function call must use less than 30 000 gas.
                       */
                      function supportsInterface(bytes4 interfaceId) external view returns (bool);
                  }
                  

                  File 3 of 4: ERC1967Proxy
                  // SPDX-License-Identifier: MIT
                  pragma solidity ^0.8.0;
                  
                  /**
                   * @dev This abstract contract provides a fallback function that delegates all calls to another contract using the EVM
                   * instruction `delegatecall`. We refer to the second contract as the _implementation_ behind the proxy, and it has to
                   * be specified by overriding the virtual {_implementation} function.
                   *
                   * Additionally, delegation to the implementation can be triggered manually through the {_fallback} function, or to a
                   * different contract through the {_delegate} function.
                   *
                   * The success and return data of the delegated call will be returned back to the caller of the proxy.
                   */
                  abstract contract Proxy {
                      /**
                       * @dev Delegates the current call to `implementation`.
                       *
                       * This function does not return to its internall call site, it will return directly to the external caller.
                       */
                      function _delegate(address implementation) internal virtual {
                          // solhint-disable-next-line no-inline-assembly
                          assembly {
                          // Copy msg.data. We take full control of memory in this inline assembly
                          // block because it will not return to Solidity code. We overwrite the
                          // Solidity scratch pad at memory position 0.
                              calldatacopy(0, 0, calldatasize())
                  
                          // Call the implementation.
                          // out and outsize are 0 because we don't know the size yet.
                              let result := delegatecall(gas(), implementation, 0, calldatasize(), 0, 0)
                  
                          // Copy the returned data.
                              returndatacopy(0, 0, returndatasize())
                  
                              switch result
                              // delegatecall returns 0 on error.
                              case 0 { revert(0, returndatasize()) }
                              default { return(0, returndatasize()) }
                          }
                      }
                  
                      /**
                       * @dev This is a virtual function that should be overriden so it returns the address to which the fallback function
                       * and {_fallback} should delegate.
                       */
                      function _implementation() internal view virtual returns (address);
                  
                      /**
                       * @dev Delegates the current call to the address returned by `_implementation()`.
                       *
                       * This function does not return to its internall call site, it will return directly to the external caller.
                       */
                      function _fallback() internal virtual {
                          _beforeFallback();
                          _delegate(_implementation());
                      }
                  
                      /**
                       * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if no other
                       * function in the contract matches the call data.
                       */
                      fallback () external payable virtual {
                          _fallback();
                      }
                  
                      /**
                       * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if call data
                       * is empty.
                       */
                      receive () external payable virtual {
                          _fallback();
                      }
                  
                      /**
                       * @dev Hook that is called before falling back to the implementation. Can happen as part of a manual `_fallback`
                       * call, or as part of the Solidity `fallback` or `receive` functions.
                       *
                       * If overriden should call `super._beforeFallback()`.
                       */
                      function _beforeFallback() internal virtual {
                      }
                  }
                  
                  
                  /**
                   * @dev This abstract contract provides getters and event emitting update functions for
                   * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.
                   *
                   * _Available since v4.1._
                   *
                   */
                  abstract contract ERC1967Upgrade {
                      // This is the keccak-256 hash of "eip1967.proxy.rollback" subtracted by 1
                      bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143;
                  
                      /**
                       * @dev Storage slot with the address of the current implementation.
                       * This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1, and is
                       * validated in the constructor.
                       */
                      bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
                  
                      /**
                       * @dev Emitted when the implementation is upgraded.
                       */
                      event Upgraded(address indexed implementation);
                  
                      /**
                       * @dev Returns the current implementation address.
                       */
                      function _getImplementation() internal view returns (address) {
                          return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
                      }
                  
                      /**
                       * @dev Stores a new address in the EIP1967 implementation slot.
                       */
                      function _setImplementation(address newImplementation) private {
                          require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
                          StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
                      }
                  
                      /**
                       * @dev Perform implementation upgrade
                       *
                       * Emits an {Upgraded} event.
                       */
                      function _upgradeTo(address newImplementation) internal {
                          _setImplementation(newImplementation);
                          emit Upgraded(newImplementation);
                      }
                  
                      /**
                       * @dev Perform implementation upgrade with additional setup call.
                       *
                       * Emits an {Upgraded} event.
                       */
                      function _upgradeToAndCall(address newImplementation, bytes memory data, bool forceCall) internal {
                          _setImplementation(newImplementation);
                          emit Upgraded(newImplementation);
                          if (data.length > 0 || forceCall) {
                              Address.functionDelegateCall(newImplementation, data);
                          }
                      }
                  
                      /**
                       * @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call.
                       *
                       * Emits an {Upgraded} event.
                       */
                      function _upgradeToAndCallSecure(address newImplementation, bytes memory data, bool forceCall) internal {
                          address oldImplementation = _getImplementation();
                  
                          // Initial upgrade and setup call
                          _setImplementation(newImplementation);
                          if (data.length > 0 || forceCall) {
                              Address.functionDelegateCall(newImplementation, data);
                          }
                  
                          // Perform rollback test if not already in progress
                          StorageSlot.BooleanSlot storage rollbackTesting = StorageSlot.getBooleanSlot(_ROLLBACK_SLOT);
                          if (!rollbackTesting.value) {
                              // Trigger rollback using upgradeTo from the new implementation
                              rollbackTesting.value = true;
                              Address.functionDelegateCall(
                                  newImplementation,
                                  abi.encodeWithSignature(
                                      "upgradeTo(address)",
                                      oldImplementation
                                  )
                              );
                              rollbackTesting.value = false;
                              // Check rollback was effective
                              require(oldImplementation == _getImplementation(), "ERC1967Upgrade: upgrade breaks further upgrades");
                              // Finally reset to the new implementation and log the upgrade
                              _setImplementation(newImplementation);
                              emit Upgraded(newImplementation);
                          }
                      }
                  
                      /**
                       * @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does
                       * not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that).
                       *
                       * Emits a {BeaconUpgraded} event.
                       */
                      function _upgradeBeaconToAndCall(address newBeacon, bytes memory data, bool forceCall) internal {
                          _setBeacon(newBeacon);
                          emit BeaconUpgraded(newBeacon);
                          if (data.length > 0 || forceCall) {
                              Address.functionDelegateCall(IBeacon(newBeacon).implementation(), data);
                          }
                      }
                  
                      /**
                       * @dev Storage slot with the admin of the contract.
                       * This is the keccak-256 hash of "eip1967.proxy.admin" subtracted by 1, and is
                       * validated in the constructor.
                       */
                      bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;
                  
                      /**
                       * @dev Emitted when the admin account has changed.
                       */
                      event AdminChanged(address previousAdmin, address newAdmin);
                  
                      /**
                       * @dev Returns the current admin.
                       */
                      function _getAdmin() internal view returns (address) {
                          return StorageSlot.getAddressSlot(_ADMIN_SLOT).value;
                      }
                  
                      /**
                       * @dev Stores a new address in the EIP1967 admin slot.
                       */
                      function _setAdmin(address newAdmin) private {
                          require(newAdmin != address(0), "ERC1967: new admin is the zero address");
                          StorageSlot.getAddressSlot(_ADMIN_SLOT).value = newAdmin;
                      }
                  
                      /**
                       * @dev Changes the admin of the proxy.
                       *
                       * Emits an {AdminChanged} event.
                       */
                      function _changeAdmin(address newAdmin) internal {
                          emit AdminChanged(_getAdmin(), newAdmin);
                          _setAdmin(newAdmin);
                      }
                  
                      /**
                       * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.
                       * This is bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor.
                       */
                      bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;
                  
                      /**
                       * @dev Emitted when the beacon is upgraded.
                       */
                      event BeaconUpgraded(address indexed beacon);
                  
                      /**
                       * @dev Returns the current beacon.
                       */
                      function _getBeacon() internal view returns (address) {
                          return StorageSlot.getAddressSlot(_BEACON_SLOT).value;
                      }
                  
                      /**
                       * @dev Stores a new beacon in the EIP1967 beacon slot.
                       */
                      function _setBeacon(address newBeacon) private {
                          require(
                              Address.isContract(newBeacon),
                              "ERC1967: new beacon is not a contract"
                          );
                          require(
                              Address.isContract(IBeacon(newBeacon).implementation()),
                              "ERC1967: beacon implementation is not a contract"
                          );
                          StorageSlot.getAddressSlot(_BEACON_SLOT).value = newBeacon;
                      }
                  }
                  
                  /**
                   * @dev This is the interface that {BeaconProxy} expects of its beacon.
                   */
                  interface IBeacon {
                      /**
                       * @dev Must return an address that can be used as a delegate call target.
                       *
                       * {BeaconProxy} will check that this address is a contract.
                       */
                      function implementation() external view returns (address);
                  }
                  
                  /**
                   * @dev Collection of functions related to the address type
                   */
                  library Address {
                      /**
                       * @dev Returns true if `account` is a contract.
                       *
                       * [IMPORTANT]
                       * ====
                       * It is unsafe to assume that an address for which this function returns
                       * false is an externally-owned account (EOA) and not a contract.
                       *
                       * Among others, `isContract` will return false for the following
                       * types of addresses:
                       *
                       *  - an externally-owned account
                       *  - a contract in construction
                       *  - an address where a contract will be created
                       *  - an address where a contract lived, but was destroyed
                       * ====
                       */
                      function isContract(address account) internal view returns (bool) {
                          // This method relies on extcodesize, which returns 0 for contracts in
                          // construction, since the code is only stored at the end of the
                          // constructor execution.
                  
                          uint256 size;
                          // solhint-disable-next-line no-inline-assembly
                          assembly { size := extcodesize(account) }
                          return size > 0;
                      }
                  
                      /**
                       * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
                       * `recipient`, forwarding all available gas and reverting on errors.
                       *
                       * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
                       * of certain opcodes, possibly making contracts go over the 2300 gas limit
                       * imposed by `transfer`, making them unable to receive funds via
                       * `transfer`. {sendValue} removes this limitation.
                       *
                       * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
                       *
                       * IMPORTANT: because control is transferred to `recipient`, care must be
                       * taken to not create reentrancy vulnerabilities. Consider using
                       * {ReentrancyGuard} or the
                       * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
                       */
                      function sendValue(address payable recipient, uint256 amount) internal {
                          require(address(this).balance >= amount, "Address: insufficient balance");
                  
                          // solhint-disable-next-line avoid-low-level-calls, avoid-call-value
                          (bool success, ) = recipient.call{ value: amount }("");
                          require(success, "Address: unable to send value, recipient may have reverted");
                      }
                  
                      /**
                       * @dev Performs a Solidity function call using a low level `call`. A
                       * plain`call` is an unsafe replacement for a function call: use this
                       * function instead.
                       *
                       * If `target` reverts with a revert reason, it is bubbled up by this
                       * function (like regular Solidity function calls).
                       *
                       * Returns the raw returned data. To convert to the expected return value,
                       * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
                       *
                       * Requirements:
                       *
                       * - `target` must be a contract.
                       * - calling `target` with `data` must not revert.
                       *
                       * _Available since v3.1._
                       */
                      function functionCall(address target, bytes memory data) internal returns (bytes memory) {
                          return functionCall(target, data, "Address: low-level call failed");
                      }
                  
                      /**
                       * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
                       * `errorMessage` as a fallback revert reason when `target` reverts.
                       *
                       * _Available since v3.1._
                       */
                      function functionCall(address target, bytes memory data, string memory errorMessage) internal returns (bytes memory) {
                          return functionCallWithValue(target, data, 0, errorMessage);
                      }
                  
                      /**
                       * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                       * but also transferring `value` wei to `target`.
                       *
                       * Requirements:
                       *
                       * - the calling contract must have an ETH balance of at least `value`.
                       * - the called Solidity function must be `payable`.
                       *
                       * _Available since v3.1._
                       */
                      function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
                          return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
                      }
                  
                      /**
                       * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
                       * with `errorMessage` as a fallback revert reason when `target` reverts.
                       *
                       * _Available since v3.1._
                       */
                      function functionCallWithValue(address target, bytes memory data, uint256 value, string memory errorMessage) internal returns (bytes memory) {
                          require(address(this).balance >= value, "Address: insufficient balance for call");
                          require(isContract(target), "Address: call to non-contract");
                  
                          // solhint-disable-next-line avoid-low-level-calls
                          (bool success, bytes memory returndata) = target.call{ value: value }(data);
                          return _verifyCallResult(success, returndata, errorMessage);
                      }
                  
                      /**
                       * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                       * but performing a static call.
                       *
                       * _Available since v3.3._
                       */
                      function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
                          return functionStaticCall(target, data, "Address: low-level static call failed");
                      }
                  
                      /**
                       * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
                       * but performing a static call.
                       *
                       * _Available since v3.3._
                       */
                      function functionStaticCall(address target, bytes memory data, string memory errorMessage) internal view returns (bytes memory) {
                          require(isContract(target), "Address: static call to non-contract");
                  
                          // solhint-disable-next-line avoid-low-level-calls
                          (bool success, bytes memory returndata) = target.staticcall(data);
                          return _verifyCallResult(success, returndata, errorMessage);
                      }
                  
                      /**
                       * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                       * but performing a delegate call.
                       *
                       * _Available since v3.4._
                       */
                      function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
                          return functionDelegateCall(target, data, "Address: low-level delegate call failed");
                      }
                  
                      /**
                       * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
                       * but performing a delegate call.
                       *
                       * _Available since v3.4._
                       */
                      function functionDelegateCall(address target, bytes memory data, string memory errorMessage) internal returns (bytes memory) {
                          require(isContract(target), "Address: delegate call to non-contract");
                  
                          // solhint-disable-next-line avoid-low-level-calls
                          (bool success, bytes memory returndata) = target.delegatecall(data);
                          return _verifyCallResult(success, returndata, errorMessage);
                      }
                  
                      function _verifyCallResult(bool success, bytes memory returndata, string memory errorMessage) private pure returns(bytes memory) {
                          if (success) {
                              return returndata;
                          } else {
                              // Look for revert reason and bubble it up if present
                              if (returndata.length > 0) {
                                  // The easiest way to bubble the revert reason is using memory via assembly
                  
                                  // solhint-disable-next-line no-inline-assembly
                                  assembly {
                                      let returndata_size := mload(returndata)
                                      revert(add(32, returndata), returndata_size)
                                  }
                              } else {
                                  revert(errorMessage);
                              }
                          }
                      }
                  }
                  
                  /**
                   * @dev Library for reading and writing primitive types to specific storage slots.
                   *
                   * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.
                   * This library helps with reading and writing to such slots without the need for inline assembly.
                   *
                   * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.
                   *
                   * Example usage to set ERC1967 implementation slot:
                   * ```
                   * contract ERC1967 {
                   *     bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
                   *
                   *     function _getImplementation() internal view returns (address) {
                   *         return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
                   *     }
                   *
                   *     function _setImplementation(address newImplementation) internal {
                   *         require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
                   *         StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
                   *     }
                   * }
                   * ```
                   *
                   * _Available since v4.1 for `address`, `bool`, `bytes32`, and `uint256`._
                   */
                  library StorageSlot {
                      struct AddressSlot {
                          address value;
                      }
                  
                      struct BooleanSlot {
                          bool value;
                      }
                  
                      struct Bytes32Slot {
                          bytes32 value;
                      }
                  
                      struct Uint256Slot {
                          uint256 value;
                      }
                  
                      /**
                       * @dev Returns an `AddressSlot` with member `value` located at `slot`.
                       */
                      function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {
                          assembly {
                              r.slot := slot
                          }
                      }
                  
                      /**
                       * @dev Returns an `BooleanSlot` with member `value` located at `slot`.
                       */
                      function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {
                          assembly {
                              r.slot := slot
                          }
                      }
                  
                      /**
                       * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.
                       */
                      function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {
                          assembly {
                              r.slot := slot
                          }
                      }
                  
                      /**
                       * @dev Returns an `Uint256Slot` with member `value` located at `slot`.
                       */
                      function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {
                          assembly {
                              r.slot := slot
                          }
                      }
                  }
                  
                  /*
                   * @dev Provides information about the current execution context, including the
                   * sender of the transaction and its data. While these are generally available
                   * via msg.sender and msg.data, they should not be accessed in such a direct
                   * manner, since when dealing with meta-transactions the account sending and
                   * paying for execution may not be the actual sender (as far as an application
                   * is concerned).
                   *
                   * This contract is only required for intermediate, library-like contracts.
                   */
                  abstract contract Context {
                      function _msgSender() internal view virtual returns (address) {
                          return msg.sender;
                      }
                  
                      function _msgData() internal view virtual returns (bytes calldata) {
                          this; // silence state mutability warning without generating bytecode - see https://github.com/ethereum/solidity/issues/2691
                          return msg.data;
                      }
                  }
                  
                  /**
                   * @dev Contract module which provides a basic access control mechanism, where
                   * there is an account (an owner) that can be granted exclusive access to
                   * specific functions.
                   *
                   * By default, the owner account will be the one that deploys the contract. This
                   * can later be changed with {transferOwnership}.
                   *
                   * This module is used through inheritance. It will make available the modifier
                   * `onlyOwner`, which can be applied to your functions to restrict their use to
                   * the owner.
                   */
                  abstract contract Ownable is Context {
                      address private _owner;
                  
                      event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
                  
                      /**
                       * @dev Initializes the contract setting the deployer as the initial owner.
                       */
                      constructor () {
                          address msgSender = _msgSender();
                          _owner = msgSender;
                          emit OwnershipTransferred(address(0), msgSender);
                      }
                  
                      /**
                       * @dev Returns the address of the current owner.
                       */
                      function owner() public view virtual returns (address) {
                          return _owner;
                      }
                  
                      /**
                       * @dev Throws if called by any account other than the owner.
                       */
                      modifier onlyOwner() {
                          require(owner() == _msgSender(), "Ownable: caller is not the owner");
                          _;
                      }
                  
                      /**
                       * @dev Leaves the contract without owner. It will not be possible to call
                       * `onlyOwner` functions anymore. Can only be called by the current owner.
                       *
                       * NOTE: Renouncing ownership will leave the contract without an owner,
                       * thereby removing any functionality that is only available to the owner.
                       */
                      function renounceOwnership() public virtual onlyOwner {
                          emit OwnershipTransferred(_owner, address(0));
                          _owner = address(0);
                      }
                  
                      /**
                       * @dev Transfers ownership of the contract to a new account (`newOwner`).
                       * Can only be called by the current owner.
                       */
                      function transferOwnership(address newOwner) public virtual onlyOwner {
                          require(newOwner != address(0), "Ownable: new owner is the zero address");
                          emit OwnershipTransferred(_owner, newOwner);
                          _owner = newOwner;
                      }
                  }
                  
                  /**
                   * @dev This is an auxiliary contract meant to be assigned as the admin of a {TransparentUpgradeableProxy}. For an
                   * explanation of why you would want to use this see the documentation for {TransparentUpgradeableProxy}.
                   */
                  contract ProxyAdmin is Ownable {
                  
                      /**
                       * @dev Returns the current implementation of `proxy`.
                       *
                       * Requirements:
                       *
                       * - This contract must be the admin of `proxy`.
                       */
                      function getProxyImplementation(TransparentUpgradeableProxy proxy) public view virtual returns (address) {
                          // We need to manually run the static call since the getter cannot be flagged as view
                          // bytes4(keccak256("implementation()")) == 0x5c60da1b
                          (bool success, bytes memory returndata) = address(proxy).staticcall(hex"5c60da1b");
                          require(success);
                          return abi.decode(returndata, (address));
                      }
                  
                      /**
                       * @dev Returns the current admin of `proxy`.
                       *
                       * Requirements:
                       *
                       * - This contract must be the admin of `proxy`.
                       */
                      function getProxyAdmin(TransparentUpgradeableProxy proxy) public view virtual returns (address) {
                          // We need to manually run the static call since the getter cannot be flagged as view
                          // bytes4(keccak256("admin()")) == 0xf851a440
                          (bool success, bytes memory returndata) = address(proxy).staticcall(hex"f851a440");
                          require(success);
                          return abi.decode(returndata, (address));
                      }
                  
                      /**
                       * @dev Changes the admin of `proxy` to `newAdmin`.
                       *
                       * Requirements:
                       *
                       * - This contract must be the current admin of `proxy`.
                       */
                      function changeProxyAdmin(TransparentUpgradeableProxy proxy, address newAdmin) public virtual onlyOwner {
                          proxy.changeAdmin(newAdmin);
                      }
                  
                      /**
                       * @dev Upgrades `proxy` to `implementation`. See {TransparentUpgradeableProxy-upgradeTo}.
                       *
                       * Requirements:
                       *
                       * - This contract must be the admin of `proxy`.
                       */
                      function upgrade(TransparentUpgradeableProxy proxy, address implementation) public virtual onlyOwner {
                          proxy.upgradeTo(implementation);
                      }
                  
                      /**
                       * @dev Upgrades `proxy` to `implementation` and calls a function on the new implementation. See
                       * {TransparentUpgradeableProxy-upgradeToAndCall}.
                       *
                       * Requirements:
                       *
                       * - This contract must be the admin of `proxy`.
                       */
                      function upgradeAndCall(TransparentUpgradeableProxy proxy, address implementation, bytes memory data) public payable virtual onlyOwner {
                          proxy.upgradeToAndCall{value: msg.value}(implementation, data);
                      }
                  }
                  
                  
                  /**
                   * @dev Base contract for building openzeppelin-upgrades compatible implementations for the {ERC1967Proxy}. It includes
                   * publicly available upgrade functions that are called by the plugin and by the secure upgrade mechanism to verify
                   * continuation of the upgradability.
                   *
                   * The {_authorizeUpgrade} function MUST be overridden to include access restriction to the upgrade mechanism.
                   *
                   * _Available since v4.1._
                   */
                  abstract contract UUPSUpgradeable is ERC1967Upgrade {
                      function upgradeTo(address newImplementation) external virtual {
                          _authorizeUpgrade(newImplementation);
                          _upgradeToAndCallSecure(newImplementation, bytes(""), false);
                      }
                  
                      function upgradeToAndCall(address newImplementation, bytes memory data) external payable virtual {
                          _authorizeUpgrade(newImplementation);
                          _upgradeToAndCallSecure(newImplementation, data, true);
                      }
                  
                      function _authorizeUpgrade(address newImplementation) internal virtual;
                  }
                  
                  
                  abstract contract Proxiable is UUPSUpgradeable {
                      function _authorizeUpgrade(address newImplementation) internal override {
                          _beforeUpgrade(newImplementation);
                      }
                  
                      function _beforeUpgrade(address newImplementation) internal virtual;
                  }
                  
                  contract ChildOfProxiable is Proxiable {
                      function _beforeUpgrade(address newImplementation) internal virtual override {}
                  }
                  
                  
                  /**
                   * @dev This contract implements an upgradeable proxy. It is upgradeable because calls are delegated to an
                   * implementation address that can be changed. This address is stored in storage in the location specified by
                   * https://eips.ethereum.org/EIPS/eip-1967[EIP1967], so that it doesn't conflict with the storage layout of the
                   * implementation behind the proxy.
                   */
                  contract ERC1967Proxy is Proxy, ERC1967Upgrade {
                      /**
                       * @dev Initializes the upgradeable proxy with an initial implementation specified by `_logic`.
                       *
                       * If `_data` is nonempty, it's used as data in a delegate call to `_logic`. This will typically be an encoded
                       * function call, and allows initializating the storage of the proxy like a Solidity constructor.
                       */
                      constructor(address _logic, bytes memory _data) payable {
                          assert(_IMPLEMENTATION_SLOT == bytes32(uint256(keccak256("eip1967.proxy.implementation")) - 1));
                          _upgradeToAndCall(_logic, _data, false);
                      }
                  
                      /**
                       * @dev Returns the current implementation address.
                       */
                      function _implementation() internal view virtual override returns (address impl) {
                          return ERC1967Upgrade._getImplementation();
                      }
                  }
                  
                  /**
                   * @dev This contract implements a proxy that is upgradeable by an admin.
                   *
                   * To avoid https://medium.com/nomic-labs-blog/malicious-backdoors-in-ethereum-proxies-62629adf3357[proxy selector
                   * clashing], which can potentially be used in an attack, this contract uses the
                   * https://blog.openzeppelin.com/the-transparent-proxy-pattern/[transparent proxy pattern]. This pattern implies two
                   * things that go hand in hand:
                   *
                   * 1. If any account other than the admin calls the proxy, the call will be forwarded to the implementation, even if
                   * that call matches one of the admin functions exposed by the proxy itself.
                   * 2. If the admin calls the proxy, it can access the admin functions, but its calls will never be forwarded to the
                   * implementation. If the admin tries to call a function on the implementation it will fail with an error that says
                   * "admin cannot fallback to proxy target".
                   *
                   * These properties mean that the admin account can only be used for admin actions like upgrading the proxy or changing
                   * the admin, so it's best if it's a dedicated account that is not used for anything else. This will avoid headaches due
                   * to sudden errors when trying to call a function from the proxy implementation.
                   *
                   * Our recommendation is for the dedicated account to be an instance of the {ProxyAdmin} contract. If set up this way,
                   * you should think of the `ProxyAdmin` instance as the real administrative interface of your proxy.
                   */
                  contract TransparentUpgradeableProxy is ERC1967Proxy {
                      /**
                       * @dev Initializes an upgradeable proxy managed by `_admin`, backed by the implementation at `_logic`, and
                       * optionally initialized with `_data` as explained in {ERC1967Proxy-constructor}.
                       */
                      constructor(address _logic, address admin_, bytes memory _data) payable ERC1967Proxy(_logic, _data) {
                          assert(_ADMIN_SLOT == bytes32(uint256(keccak256("eip1967.proxy.admin")) - 1));
                          _changeAdmin(admin_);
                      }
                  
                      /**
                       * @dev Modifier used internally that will delegate the call to the implementation unless the sender is the admin.
                       */
                      modifier ifAdmin() {
                          if (msg.sender == _getAdmin()) {
                              _;
                          } else {
                              _fallback();
                          }
                      }
                  
                      /**
                       * @dev Returns the current admin.
                       *
                       * NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyAdmin}.
                       *
                       * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the
                       * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.
                       * `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`
                       */
                      function admin() external ifAdmin returns (address admin_) {
                          admin_ = _getAdmin();
                      }
                  
                      /**
                       * @dev Returns the current implementation.
                       *
                       * NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyImplementation}.
                       *
                       * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the
                       * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.
                       * `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`
                       */
                      function implementation() external ifAdmin returns (address implementation_) {
                          implementation_ = _implementation();
                      }
                  
                      /**
                       * @dev Changes the admin of the proxy.
                       *
                       * Emits an {AdminChanged} event.
                       *
                       * NOTE: Only the admin can call this function. See {ProxyAdmin-changeProxyAdmin}.
                       */
                      function changeAdmin(address newAdmin) external virtual ifAdmin {
                          _changeAdmin(newAdmin);
                      }
                  
                      /**
                       * @dev Upgrade the implementation of the proxy.
                       *
                       * NOTE: Only the admin can call this function. See {ProxyAdmin-upgrade}.
                       */
                      function upgradeTo(address newImplementation) external ifAdmin {
                          _upgradeToAndCall(newImplementation, bytes(""), false);
                      }
                  
                      /**
                       * @dev Upgrade the implementation of the proxy, and then call a function from the new implementation as specified
                       * by `data`, which should be an encoded function call. This is useful to initialize new storage variables in the
                       * proxied contract.
                       *
                       * NOTE: Only the admin can call this function. See {ProxyAdmin-upgradeAndCall}.
                       */
                      function upgradeToAndCall(address newImplementation, bytes calldata data) external payable ifAdmin {
                          _upgradeToAndCall(newImplementation, data, true);
                      }
                  
                      /**
                       * @dev Returns the current admin.
                       */
                      function _admin() internal view virtual returns (address) {
                          return _getAdmin();
                      }
                  
                      /**
                       * @dev Makes sure the admin cannot access the fallback function. See {Proxy-_beforeFallback}.
                       */
                      function _beforeFallback() internal virtual override {
                          require(msg.sender != _getAdmin(), "TransparentUpgradeableProxy: admin cannot fallback to proxy target");
                          super._beforeFallback();
                      }
                  }
                  
                  
                  // Kept for backwards compatibility with older versions of Hardhat and Truffle plugins.
                  contract AdminUpgradeabilityProxy is TransparentUpgradeableProxy {
                      constructor(address logic, address admin, bytes memory data) payable TransparentUpgradeableProxy(logic, admin, data) {}
                  }

                  File 4 of 4: QuadGovernance
                  //SPDX-License-Identifier: BUSL-1.1
                  pragma solidity 0.8.16;
                  import "@openzeppelin/contracts-upgradeable/access/AccessControlUpgradeable.sol";
                  import "@openzeppelin/contracts-upgradeable/proxy/utils/UUPSUpgradeable.sol";
                  import "./interfaces/IQuadPassport.sol";
                  import "./interfaces/IQuadGovernance.sol";
                  import "./storage/QuadGovernanceStore.sol";
                  /// @title Governance Contract for Quadrata Passport
                  /// @author Fabrice Cheng, Theodore Clapp
                  /// @notice All admin functions to govern the QuadPassport contract
                  contract QuadGovernance is IQuadGovernance, AccessControlUpgradeable, UUPSUpgradeable, QuadGovernanceStore {
                      // used to prevent logic contract self destruct take over
                      constructor() initializer {}
                      /// @dev Initializer (constructor)
                      function initialize() public initializer {
                          __AccessControl_init_unchained();
                          // Set Roles
                          _setRoleAdmin(PAUSER_ROLE, GOVERNANCE_ROLE);
                          _setRoleAdmin(ISSUER_ROLE, GOVERNANCE_ROLE);
                          _setRoleAdmin(READER_ROLE, GOVERNANCE_ROLE);
                          _setupRole(GOVERNANCE_ROLE, _msgSender());
                          _setupRole(DEFAULT_ADMIN_ROLE, _msgSender());
                      }
                      /// @dev Set QuadPassport treasury wallet to withdraw the protocol fees
                      /// @notice Restricted behind a TimelockController
                      /// @param _newTreasury address of the treasury
                      function setTreasury(address _newTreasury) external override {
                          require(hasRole(GOVERNANCE_ROLE, _msgSender()), "INVALID_ADMIN");
                          require(_newTreasury != _treasury, "TREASURY_ADDRESS_ALREADY_SET");
                          require(_newTreasury != address(0), "TREASURY_ADDRESS_ZERO");
                          address oldTreasury = _treasury;
                          _treasury = _newTreasury;
                          emit TreasuryUpdated(oldTreasury, _newTreasury);
                      }
                      /// @dev Set QuadPassport contract address
                      /// @notice Restricted behind a TimelockController
                      /// @param _passportAddr address of the QuadPassport contract
                      function setPassportContractAddress(address _passportAddr)  external override {
                          require(hasRole(GOVERNANCE_ROLE, _msgSender()), "INVALID_ADMIN");
                          require(_passportAddr != address(0), "PASSPORT_ADDRESS_ZERO");
                          require(address(_passport) != _passportAddr, "PASSPORT_ADDRESS_ALREADY_SET");
                          address _oldPassport = address(_passport);
                          _passport = IQuadPassport(_passportAddr);
                          emit PassportAddressUpdated(_oldPassport, address(_passport));
                      }
                      /// @dev Set the pending QuadGovernance address in the QuadPassport contract
                      /// @notice Restricted behind a TimelockController
                      /// @param _newGovernance address of the QuadGovernance contract
                      function updateGovernanceInPassport(address _newGovernance)  external override {
                          require(hasRole(GOVERNANCE_ROLE, _msgSender()), "INVALID_ADMIN");
                          require(_newGovernance != address(0), "GOVERNANCE_ADDRESS_ZERO");
                          require(address(_passport) != address(0), "PASSPORT_NOT_SET");
                          _passport.setGovernance(_newGovernance);
                      }
                      /// @dev Confirms the pending QuadGovernance address in the QuadPassport contract
                      function acceptGovernanceInPassport() external {
                          require(hasRole(GOVERNANCE_ROLE, _msgSender()), "INVALID_ADMIN");
                          _passport.acceptGovernance();
                      }
                      /// @dev Set the eligibility status for a tokenId passport
                      /// @notice Restricted behind a TimelockController
                      /// @param _tokenId tokenId of the passport
                      /// @param _eligibleStatus eligiblity boolean for the tokenId
                      /// @param _uri URI of the IPFS link
                      function setEligibleTokenId(uint256 _tokenId, bool _eligibleStatus, string memory _uri) external override {
                          require(hasRole(GOVERNANCE_ROLE, _msgSender()), "INVALID_ADMIN");
                          if(_tokenId > _maxEligibleTokenId){
                              require(_maxEligibleTokenId + 1 == _tokenId, "INCREMENT_TOKENID_BY_1");
                              _maxEligibleTokenId = _tokenId;
                          }
                          _eligibleTokenId[_tokenId] = _eligibleStatus;
                          _passport.setTokenURI(_tokenId, _uri);
                          emit EligibleTokenUpdated(_tokenId, _eligibleStatus);
                      }
                      /// @dev Set the eligibility status for an attribute type
                      /// @notice Restricted behind a TimelockController
                      /// @param _attribute keccak256 of the attribute name (ex: keccak256("COUNTRY"))
                      /// @param _eligibleStatus eligiblity boolean for the attribute
                      function setEligibleAttribute(bytes32 _attribute, bool _eligibleStatus) override external {
                          require(hasRole(GOVERNANCE_ROLE, _msgSender()), "INVALID_ADMIN");
                          require(_eligibleAttributes[_attribute] != _eligibleStatus, "ATTRIBUTE_ELIGIBILITY_SET");
                          _eligibleAttributes[_attribute] = _eligibleStatus;
                          if (_eligibleStatus) {
                              _eligibleAttributesArray.push(_attribute);
                          } else {
                              for (uint256 i = 0; i < _eligibleAttributesArray.length; i++) {
                                  if (_eligibleAttributesArray[i] == _attribute) {
                                      _eligibleAttributesArray[i] = _eligibleAttributesArray[_eligibleAttributesArray.length - 1];
                                      _eligibleAttributesArray.pop();
                                      break;
                                  }
                              }
                          }
                          emit EligibleAttributeUpdated(_attribute, _eligibleStatus);
                      }
                      /// @dev Set the eligibility status for an attribute type grouped by DID (Applicable to AML only for now)
                      /// @notice Restricted behind a TimelockController
                      /// @param _attribute keccak256 of the attribute name (ex: keccak256("AML"))
                      /// @param _eligibleStatus eligiblity boolean for the attribute
                      function setEligibleAttributeByDID(bytes32 _attribute, bool _eligibleStatus) override external {
                          require(hasRole(GOVERNANCE_ROLE, _msgSender()), "INVALID_ADMIN");
                          require(_eligibleAttributesByDID[_attribute] != _eligibleStatus, "ATTRIBUTE_ELIGIBILITY_SET");
                          _eligibleAttributesByDID[_attribute] = _eligibleStatus;
                          emit EligibleAttributeByDIDUpdated(_attribute, _eligibleStatus);
                      }
                      /// @dev Set the price for querying a single attribute after owning a passport
                      /// @notice Restricted behind a TimelockController
                      /// @param _attribute keccak256 of the attribute name (ex: keccak256("COUNTRY"))
                      /// @param _price price (Native Token Eth/Matic/etc...)
                      function setAttributePriceFixed(bytes32 _attribute, uint256 _price) override external {
                          require(hasRole(GOVERNANCE_ROLE, _msgSender()), "INVALID_ADMIN");
                          require(_pricePerAttributeFixed[_attribute] != _price, "ATTRIBUTE_PRICE_ALREADY_SET");
                          uint256 oldPrice = _pricePerAttributeFixed[_attribute];
                          _pricePerAttributeFixed[_attribute] = _price;
                          emit AttributePriceUpdatedFixed(_attribute, oldPrice, _price);
                      }
                      /// @dev Set the business attribute price for querying a single attribute after owning a passport
                      /// @notice Restricted behind a TimelockController
                      /// @param _attribute keccak256 of the attribute name (ex: keccak256("COUNTRY"))
                      /// @param _price price (Native Token Eth/Matic/etc...)
                      function setBusinessAttributePriceFixed(bytes32 _attribute, uint256 _price) override external {
                          require(hasRole(GOVERNANCE_ROLE, _msgSender()), "INVALID_ADMIN");
                          require(_pricePerBusinessAttributeFixed[_attribute] != _price, "KYB_ATTRIBUTE_PRICE_ALREADY_SET");
                          uint256 oldPrice = _pricePerBusinessAttributeFixed[_attribute];
                          _pricePerBusinessAttributeFixed[_attribute] = _price;
                          emit BusinessAttributePriceUpdatedFixed(_attribute, oldPrice, _price);
                      }
                      /// @dev Set the revenue split percentage between Issuers and Quadrata Protocol
                      /// @notice Restricted behind a TimelockController
                      /// @param _split percentage split (`50` equals 50%)
                      function setRevSplitIssuer(uint256 _split) override external {
                          require(hasRole(GOVERNANCE_ROLE, _msgSender()), "INVALID_ADMIN");
                          require(_revSplitIssuer != _split, "REV_SPLIT_ALREADY_SET");
                          require(_split <= 100, "SPLIT_TOO_HIGH");
                          uint256 oldSplit = _revSplitIssuer;
                          _revSplitIssuer = _split;
                          emit RevenueSplitIssuerUpdated(oldSplit, _split);
                      }
                      /// @dev Add a new issuer or update treasury
                      /// @notice Restricted behind a TimelockController
                      /// @param _issuer address generating the signature authorizing minting/setting attributes
                      /// @param _treasury address of the issuer treasury to withdraw the fees
                      function addIssuer(address _issuer, address _treasury) override external {
                          require(hasRole(GOVERNANCE_ROLE, _msgSender()), "INVALID_ADMIN");
                          require(_treasury != address(0), "TREASURY_ISSUER_ADDRESS_ZERO");
                          require(_issuer != address(0), "ISSUER_ADDRESS_ZERO");
                          _issuerTreasury[_issuer] = _treasury;
                          bool issuerExist = false;
                          for (uint256 i = 0; i < _issuers.length; i++) {
                              if (_issuers[i] == _issuer) {
                                  issuerExist = true;
                                  break;
                              }
                          }
                          if (!issuerExist) {
                              grantRole(ISSUER_ROLE, _issuer);
                              _issuers.push(_issuer);
                              _issuerStatus[_issuer] = true;
                          }
                          emit IssuerAdded(_issuer, _treasury);
                      }
                      /// @dev Delete issuer
                      /// @notice Restricted behind a TimelockController
                      /// @param _issuer address to remove
                      function deleteIssuer(address _issuer) override external {
                          require(hasRole(GOVERNANCE_ROLE, _msgSender()), "INVALID_ADMIN");
                          require(_issuer != address(0), "ISSUER_ADDRESS_ZERO");
                          for (uint256 i = 0; i < _issuers.length; i++) {
                              if (_issuers[i] == _issuer) {
                                  _issuers[i] = _issuers[_issuers.length-1];
                                  _issuers.pop();
                                  _issuerStatus[_issuer] = false;
                                  revokeRole(ISSUER_ROLE, _issuer);
                                  emit IssuerDeleted(_issuer);
                                  return;
                              }
                          }
                      }
                      /// @dev Sets the status for specified issuer
                      /// @notice Restricted behind a TimelockController
                      /// @param _issuer address to change status
                      /// @param _status new status for issuer
                      function setIssuerStatus(address _issuer, bool _status) external {
                          require(hasRole(GOVERNANCE_ROLE, _msgSender()), "INVALID_ADMIN");
                          require(_issuer != address(0), "ISSUER_ADDRESS_ZERO");
                          _issuerStatus[_issuer] = _status;
                          if(_status) {
                              grantRole(ISSUER_ROLE, _issuer);
                          } else {
                              revokeRole(ISSUER_ROLE, _issuer);
                          }
                          emit IssuerStatusChanged(_issuer, _status);
                      }
                      /// @dev Set which attributes an issuer can attest to
                      /// @notice Restricted behind a TimelockController
                      /// @param _issuer address to change status
                      /// @param _attribute attribute to authorize (ex: keccak256("AML"))
                      /// @param _permission bool for authorizing an issuer to attest
                      function setIssuerAttributePermission(address _issuer, bytes32 _attribute, bool _permission) external {
                          require(hasRole(GOVERNANCE_ROLE, _msgSender()), "INVALID_ADMIN");
                          require(_issuer != address(0), "ISSUER_ADDRESS_ZERO");
                          require(hasRole(ISSUER_ROLE, _issuer), "INVALID_ISSUER");
                          require(eligibleAttributes(_attribute) || eligibleAttributesByDID(_attribute), "ATTRIBUTE_NOT_ELIGIBLE");
                          _issuerAttributePermission[keccak256(abi.encode(_issuer, _attribute))] = _permission;
                          emit IssuerAttributePermission(_issuer, _attribute, _permission);
                      }
                      function _authorizeUpgrade(address) override internal view {
                          require(hasRole(GOVERNANCE_ROLE, _msgSender()), "INVALID_ADMIN");
                      }
                      /// @dev Get the address of protocol treasury
                      /// @return treasury address
                      function treasury() override public view returns(address) {
                          return _treasury;
                      }
                      /// @dev Get the address of passport
                      /// @return passport address
                      function passport() public view returns(IQuadPassport) {
                          return _passport;
                      }
                      /// @dev Get the attribute eligibility
                      /// @param _attribute Attribute Type
                      /// @return attribute eligibility
                      function eligibleAttributes(bytes32 _attribute) override public view returns(bool) {
                          return _eligibleAttributes[_attribute];
                      }
                      /// @dev Get the attribute eligibility by DID
                      /// @param _attribute Attribute Type
                      /// @return attribute eligibility
                      function eligibleAttributesByDID(bytes32 _attribute) override public view returns(bool) {
                          return _eligibleAttributesByDID[_attribute];
                      }
                      /// @dev Get a maintained attribute from eligibility
                      /// @param _attribute Attribute Type
                      /// @return eligible attribute element
                      function eligibleAttributesArray(uint256 _attribute) override public view returns(bytes32) {
                          return _eligibleAttributesArray[_attribute];
                      }
                      /// @dev Get number of eligible attributes currently supported
                      /// @return length of eligible attributes
                      function getEligibleAttributesLength() override external view returns(uint256) {
                          return _eligibleAttributesArray.length;
                      }
                      /// @dev Get list of eligible tokenIds currently supported
                      /// @return length of eligible attributes
                      function getMaxEligibleTokenId() override external view returns(uint256) {
                          return _maxEligibleTokenId;
                      }
                      /// @dev Get active tokenId
                      /// @param _tokenId TokenId
                      /// @return tokenId eligibility
                      function eligibleTokenId(uint256 _tokenId) override public view returns(bool) {
                          return _eligibleTokenId[_tokenId];
                      }
                      /// @dev Get query price for an attribute in eth
                      /// @param _attribute Attribute Type
                      /// @return attribute price for using getter in eth
                      function pricePerAttributeFixed(bytes32 _attribute) override public view returns(uint256) {
                          return _pricePerAttributeFixed[_attribute];
                      }
                      /// @dev Get query price for an attribute given a business is asking (in eth)
                      /// @param _attribute Attribute Type
                      /// @return attribute price for using getter given a business is asking (in eth)
                      function pricePerBusinessAttributeFixed(bytes32 _attribute) override public view returns(uint256) {
                          return _pricePerBusinessAttributeFixed[_attribute];
                      }
                      /// @dev Get the length of _issuers array
                      /// @return total number of _issuers
                      function getIssuersLength() override public view returns (uint256) {
                          return _issuers.length;
                      }
                      /// @dev Get the _issuers array
                      /// @return list of issuers
                      function getIssuers() override public view returns (address[] memory) {
                          return _issuers;
                      }
                      /// @dev Get the status of an issuer
                      /// @param _issuer address of issuer
                      /// @return issuer status
                      function getIssuerStatus(address _issuer) override public view returns(bool) {
                          return _issuerStatus[_issuer];
                      }
                      /// @dev Get the authorization status for an issuer to attest to a specific attribute
                      /// @param _issuer address of issuer
                      /// @param _attribute attribute type
                      /// @return authorization status
                      function getIssuerAttributePermission(address _issuer, bytes32 _attribute) override public view returns(bool) {
                          return _issuerAttributePermission[keccak256(abi.encode(_issuer, _attribute))];
                      }
                      /// @dev Get the revenue split between protocol and _issuers
                      /// @return ratio of revenue distribution
                      function revSplitIssuer() override public view returns(uint256) {
                          return _revSplitIssuer;
                      }
                      /// @dev Get an issuer at a certain index
                      /// @param _index Array index
                      /// @return issuer element
                      function issuers(uint256 _index) override public view returns(address) {
                          return _issuers[_index];
                      }
                      /// @dev Get an issuer's treasury
                      /// @param _issuer address of the issuer
                      /// @return issuer treasury
                      function issuersTreasury(address _issuer) override public view returns (address) {
                          return _issuerTreasury[_issuer];
                      }
                  }
                  // SPDX-License-Identifier: MIT
                  // OpenZeppelin Contracts (last updated v4.7.0) (access/AccessControl.sol)
                  pragma solidity ^0.8.0;
                  import "./IAccessControlUpgradeable.sol";
                  import "../utils/ContextUpgradeable.sol";
                  import "../utils/StringsUpgradeable.sol";
                  import "../utils/introspection/ERC165Upgradeable.sol";
                  import "../proxy/utils/Initializable.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 AccessControlUpgradeable is Initializable, ContextUpgradeable, IAccessControlUpgradeable, ERC165Upgradeable {
                      function __AccessControl_init() internal onlyInitializing {
                      }
                      function __AccessControl_init_unchained() internal onlyInitializing {
                      }
                      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(IAccessControlUpgradeable).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 ",
                                          StringsUpgradeable.toHexString(uint160(account), 20),
                                          " is missing role ",
                                          StringsUpgradeable.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());
                          }
                      }
                      /**
                       * @dev This empty reserved space is put in place to allow future versions to add new
                       * variables without shifting down storage in the inheritance chain.
                       * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
                       */
                      uint256[49] private __gap;
                  }
                  // SPDX-License-Identifier: MIT
                  // OpenZeppelin Contracts (last updated v4.5.0) (proxy/utils/UUPSUpgradeable.sol)
                  pragma solidity ^0.8.0;
                  import "../../interfaces/draft-IERC1822Upgradeable.sol";
                  import "../ERC1967/ERC1967UpgradeUpgradeable.sol";
                  import "./Initializable.sol";
                  /**
                   * @dev An upgradeability mechanism designed for UUPS proxies. The functions included here can perform an upgrade of an
                   * {ERC1967Proxy}, when this contract is set as the implementation behind such a proxy.
                   *
                   * A security mechanism ensures that an upgrade does not turn off upgradeability accidentally, although this risk is
                   * reinstated if the upgrade retains upgradeability but removes the security mechanism, e.g. by replacing
                   * `UUPSUpgradeable` with a custom implementation of upgrades.
                   *
                   * The {_authorizeUpgrade} function must be overridden to include access restriction to the upgrade mechanism.
                   *
                   * _Available since v4.1._
                   */
                  abstract contract UUPSUpgradeable is Initializable, IERC1822ProxiableUpgradeable, ERC1967UpgradeUpgradeable {
                      function __UUPSUpgradeable_init() internal onlyInitializing {
                      }
                      function __UUPSUpgradeable_init_unchained() internal onlyInitializing {
                      }
                      /// @custom:oz-upgrades-unsafe-allow state-variable-immutable state-variable-assignment
                      address private immutable __self = address(this);
                      /**
                       * @dev Check that the execution is being performed through a delegatecall call and that the execution context is
                       * a proxy contract with an implementation (as defined in ERC1967) pointing to self. This should only be the case
                       * for UUPS and transparent proxies that are using the current contract as their implementation. Execution of a
                       * function through ERC1167 minimal proxies (clones) would not normally pass this test, but is not guaranteed to
                       * fail.
                       */
                      modifier onlyProxy() {
                          require(address(this) != __self, "Function must be called through delegatecall");
                          require(_getImplementation() == __self, "Function must be called through active proxy");
                          _;
                      }
                      /**
                       * @dev Check that the execution is not being performed through a delegate call. This allows a function to be
                       * callable on the implementing contract but not through proxies.
                       */
                      modifier notDelegated() {
                          require(address(this) == __self, "UUPSUpgradeable: must not be called through delegatecall");
                          _;
                      }
                      /**
                       * @dev Implementation of the ERC1822 {proxiableUUID} function. This returns the storage slot used by the
                       * implementation. It is used to validate that the this implementation remains valid after an upgrade.
                       *
                       * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks
                       * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this
                       * function revert if invoked through a proxy. This is guaranteed by the `notDelegated` modifier.
                       */
                      function proxiableUUID() external view virtual override notDelegated returns (bytes32) {
                          return _IMPLEMENTATION_SLOT;
                      }
                      /**
                       * @dev Upgrade the implementation of the proxy to `newImplementation`.
                       *
                       * Calls {_authorizeUpgrade}.
                       *
                       * Emits an {Upgraded} event.
                       */
                      function upgradeTo(address newImplementation) external virtual onlyProxy {
                          _authorizeUpgrade(newImplementation);
                          _upgradeToAndCallUUPS(newImplementation, new bytes(0), false);
                      }
                      /**
                       * @dev Upgrade the implementation of the proxy to `newImplementation`, and subsequently execute the function call
                       * encoded in `data`.
                       *
                       * Calls {_authorizeUpgrade}.
                       *
                       * Emits an {Upgraded} event.
                       */
                      function upgradeToAndCall(address newImplementation, bytes memory data) external payable virtual onlyProxy {
                          _authorizeUpgrade(newImplementation);
                          _upgradeToAndCallUUPS(newImplementation, data, true);
                      }
                      /**
                       * @dev Function that should revert when `msg.sender` is not authorized to upgrade the contract. Called by
                       * {upgradeTo} and {upgradeToAndCall}.
                       *
                       * Normally, this function will use an xref:access.adoc[access control] modifier such as {Ownable-onlyOwner}.
                       *
                       * ```solidity
                       * function _authorizeUpgrade(address) internal override onlyOwner {}
                       * ```
                       */
                      function _authorizeUpgrade(address newImplementation) internal virtual;
                      /**
                       * @dev This empty reserved space is put in place to allow future versions to add new
                       * variables without shifting down storage in the inheritance chain.
                       * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
                       */
                      uint256[50] private __gap;
                  }
                  //SPDX-License-Identifier: BUSL-1.1
                  pragma solidity 0.8.16;
                  import "./IQuadPassportStore.sol";
                  import "./IQuadSoulbound.sol";
                  interface IQuadPassport is IQuadSoulbound {
                      event GovernanceUpdated(address indexed _oldGovernance, address indexed _governance);
                      event SetPendingGovernance(address indexed _pendingGovernance);
                      event SetAttributeReceipt(address indexed _account, address indexed _issuer, uint256 _fee);
                      event BurnPassportsIssuer(address indexed _issuer, address indexed _account);
                      event WithdrawEvent(address indexed _issuer, address indexed _treasury, uint256 _fee);
                      function setAttributes(
                          IQuadPassportStore.AttributeSetterConfig memory _config,
                          bytes calldata _sigIssuer,
                          bytes calldata _sigAccount
                      ) external payable;
                      function setAttributesIssuer(
                          address _account,
                          IQuadPassportStore.AttributeSetterConfig memory _config,
                          bytes calldata _sigIssuer
                      ) external payable;
                      function burnPassports() external;
                      function burnPassportsIssuer(address _account) external;
                      function setGovernance(address _governanceContract) external;
                      function acceptGovernance() external;
                      function attributes(address _account, bytes32 _attribute) external view returns (IQuadPassportStore.Attribute[] memory);
                      function withdraw(address payable _to, uint256 _amount) external;
                      function passportPaused() external view returns(bool);
                      function setTokenURI(uint256 _tokenId, string memory _uri) external;
                  }
                  //SPDX-License-Identifier: BUSL-1.1
                  pragma solidity 0.8.16;
                  import "../storage/QuadGovernanceStore.sol";
                  interface IQuadGovernance {
                      event AttributePriceUpdatedFixed(bytes32 _attribute, uint256 _oldPrice, uint256 _price);
                      event BusinessAttributePriceUpdatedFixed(bytes32 _attribute, uint256 _oldPrice, uint256 _price);
                      event EligibleTokenUpdated(uint256 _tokenId, bool _eligibleStatus);
                      event EligibleAttributeUpdated(bytes32 _attribute, bool _eligibleStatus);
                      event EligibleAttributeByDIDUpdated(bytes32 _attribute, bool _eligibleStatus);
                      event IssuerAdded(address indexed _issuer, address indexed _newTreasury);
                      event IssuerDeleted(address indexed _issuer);
                      event IssuerStatusChanged(address indexed issuer, bool newStatus);
                      event IssuerAttributePermission(address indexed issuer, bytes32 _attribute,  bool _permission);
                      event PassportAddressUpdated(address indexed _oldAddress, address indexed _address);
                      event RevenueSplitIssuerUpdated(uint256 _oldSplit, uint256 _split);
                      event TreasuryUpdated(address indexed _oldAddress, address indexed _address);
                      function setTreasury(address _treasury) external;
                      function setPassportContractAddress(address _passportAddr) external;
                      function updateGovernanceInPassport(address _newGovernance) external;
                      function setEligibleTokenId(uint256 _tokenId, bool _eligibleStatus, string memory _uri) external;
                      function setEligibleAttribute(bytes32 _attribute, bool _eligibleStatus) external;
                      function setEligibleAttributeByDID(bytes32 _attribute, bool _eligibleStatus) external;
                      function setAttributePriceFixed(bytes32 _attribute, uint256 _price) external;
                      function setBusinessAttributePriceFixed(bytes32 _attribute, uint256 _price) external;
                      function setRevSplitIssuer(uint256 _split) external;
                      function addIssuer(address _issuer, address _treasury) external;
                      function deleteIssuer(address _issuer) external;
                      function setIssuerStatus(address _issuer, bool _status) external;
                      function setIssuerAttributePermission(address _issuer, bytes32 _attribute, bool _permission) external;
                      function getEligibleAttributesLength() external view returns(uint256);
                      function getMaxEligibleTokenId() external view returns(uint256);
                      function eligibleTokenId(uint256) external view returns(bool);
                      function issuersTreasury(address) external view returns (address);
                      function eligibleAttributes(bytes32) external view returns(bool);
                      function eligibleAttributesByDID(bytes32) external view returns(bool);
                      function eligibleAttributesArray(uint256) external view returns(bytes32);
                      function pricePerAttributeFixed(bytes32) external view returns(uint256);
                      function pricePerBusinessAttributeFixed(bytes32) external view returns(uint256);
                      function revSplitIssuer() external view returns (uint256);
                      function treasury() external view returns (address);
                      function getIssuersLength() external view returns (uint256);
                      function getIssuers() external view returns (address[] memory);
                      function issuers(uint256) external view returns(address);
                      function getIssuerStatus(address _issuer) external view returns(bool);
                      function getIssuerAttributePermission(address _issuer, bytes32 _attribute) external view returns(bool);
                  }
                  //SPDX-License-Identifier: BUSL-1.1
                  pragma solidity 0.8.16;
                  import "../interfaces/IQuadPassport.sol";
                  import "./QuadConstant.sol";
                  contract QuadGovernanceStore is QuadConstant {
                      // Attributes
                      bytes32[] internal _eligibleAttributesArray;
                      mapping(bytes32 => bool) internal _eligibleAttributes;
                      mapping(bytes32 => bool) internal _eligibleAttributesByDID;
                      // TokenId
                      mapping(uint256 => bool) internal _eligibleTokenId;
                      // Pricing
                      mapping(bytes32 => uint256) internal _pricePerBusinessAttributeFixed;
                      mapping(bytes32 => uint256) internal _pricePerAttributeFixed;
                      // Issuers
                      mapping(address => address) internal _issuerTreasury;
                      mapping(address => bool) internal _issuerStatus;
                      mapping(bytes32 => bool) internal _issuerAttributePermission;
                      address[] internal _issuers;
                      // Others
                      uint256 internal _revSplitIssuer; // 50 means 50%;
                      uint256 internal _maxEligibleTokenId;
                      IQuadPassport internal _passport;
                      address internal _treasury;
                  }
                  // 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 IAccessControlUpgradeable {
                      /**
                       * @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/Context.sol)
                  pragma solidity ^0.8.0;
                  import "../proxy/utils/Initializable.sol";
                  /**
                   * @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 ContextUpgradeable is Initializable {
                      function __Context_init() internal onlyInitializing {
                      }
                      function __Context_init_unchained() internal onlyInitializing {
                      }
                      function _msgSender() internal view virtual returns (address) {
                          return msg.sender;
                      }
                      function _msgData() internal view virtual returns (bytes calldata) {
                          return msg.data;
                      }
                      /**
                       * @dev This empty reserved space is put in place to allow future versions to add new
                       * variables without shifting down storage in the inheritance chain.
                       * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
                       */
                      uint256[50] private __gap;
                  }
                  // SPDX-License-Identifier: MIT
                  // OpenZeppelin Contracts (last updated v4.7.0) (utils/Strings.sol)
                  pragma solidity ^0.8.0;
                  /**
                   * @dev String operations.
                   */
                  library StringsUpgradeable {
                      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/introspection/ERC165.sol)
                  pragma solidity ^0.8.0;
                  import "./IERC165Upgradeable.sol";
                  import "../../proxy/utils/Initializable.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 ERC165Upgradeable is Initializable, IERC165Upgradeable {
                      function __ERC165_init() internal onlyInitializing {
                      }
                      function __ERC165_init_unchained() internal onlyInitializing {
                      }
                      /**
                       * @dev See {IERC165-supportsInterface}.
                       */
                      function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
                          return interfaceId == type(IERC165Upgradeable).interfaceId;
                      }
                      /**
                       * @dev This empty reserved space is put in place to allow future versions to add new
                       * variables without shifting down storage in the inheritance chain.
                       * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
                       */
                      uint256[50] private __gap;
                  }
                  // SPDX-License-Identifier: MIT
                  // OpenZeppelin Contracts (last updated v4.7.0) (proxy/utils/Initializable.sol)
                  pragma solidity ^0.8.2;
                  import "../../utils/AddressUpgradeable.sol";
                  /**
                   * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed
                   * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an
                   * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer
                   * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.
                   *
                   * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be
                   * reused. This mechanism prevents re-execution of each "step" but allows the creation of new initialization steps in
                   * case an upgrade adds a module that needs to be initialized.
                   *
                   * For example:
                   *
                   * [.hljs-theme-light.nopadding]
                   * ```
                   * contract MyToken is ERC20Upgradeable {
                   *     function initialize() initializer public {
                   *         __ERC20_init("MyToken", "MTK");
                   *     }
                   * }
                   * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {
                   *     function initializeV2() reinitializer(2) public {
                   *         __ERC20Permit_init("MyToken");
                   *     }
                   * }
                   * ```
                   *
                   * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as
                   * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.
                   *
                   * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure
                   * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.
                   *
                   * [CAUTION]
                   * ====
                   * Avoid leaving a contract uninitialized.
                   *
                   * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation
                   * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke
                   * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:
                   *
                   * [.hljs-theme-light.nopadding]
                   * ```
                   * /// @custom:oz-upgrades-unsafe-allow constructor
                   * constructor() {
                   *     _disableInitializers();
                   * }
                   * ```
                   * ====
                   */
                  abstract contract Initializable {
                      /**
                       * @dev Indicates that the contract has been initialized.
                       * @custom:oz-retyped-from bool
                       */
                      uint8 private _initialized;
                      /**
                       * @dev Indicates that the contract is in the process of being initialized.
                       */
                      bool private _initializing;
                      /**
                       * @dev Triggered when the contract has been initialized or reinitialized.
                       */
                      event Initialized(uint8 version);
                      /**
                       * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,
                       * `onlyInitializing` functions can be used to initialize parent contracts. Equivalent to `reinitializer(1)`.
                       */
                      modifier initializer() {
                          bool isTopLevelCall = !_initializing;
                          require(
                              (isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1),
                              "Initializable: contract is already initialized"
                          );
                          _initialized = 1;
                          if (isTopLevelCall) {
                              _initializing = true;
                          }
                          _;
                          if (isTopLevelCall) {
                              _initializing = false;
                              emit Initialized(1);
                          }
                      }
                      /**
                       * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the
                       * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be
                       * used to initialize parent contracts.
                       *
                       * `initializer` is equivalent to `reinitializer(1)`, so a reinitializer may be used after the original
                       * initialization step. This is essential to configure modules that are added through upgrades and that require
                       * initialization.
                       *
                       * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in
                       * a contract, executing them in the right order is up to the developer or operator.
                       */
                      modifier reinitializer(uint8 version) {
                          require(!_initializing && _initialized < version, "Initializable: contract is already initialized");
                          _initialized = version;
                          _initializing = true;
                          _;
                          _initializing = false;
                          emit Initialized(version);
                      }
                      /**
                       * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the
                       * {initializer} and {reinitializer} modifiers, directly or indirectly.
                       */
                      modifier onlyInitializing() {
                          require(_initializing, "Initializable: contract is not initializing");
                          _;
                      }
                      /**
                       * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.
                       * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized
                       * to any version. It is recommended to use this to lock implementation contracts that are designed to be called
                       * through proxies.
                       */
                      function _disableInitializers() internal virtual {
                          require(!_initializing, "Initializable: contract is initializing");
                          if (_initialized < type(uint8).max) {
                              _initialized = type(uint8).max;
                              emit Initialized(type(uint8).max);
                          }
                      }
                  }
                  // SPDX-License-Identifier: MIT
                  // OpenZeppelin Contracts (last updated v4.7.0) (utils/Address.sol)
                  pragma solidity ^0.8.1;
                  /**
                   * @dev Collection of functions related to the address type
                   */
                  library AddressUpgradeable {
                      /**
                       * @dev Returns true if `account` is a contract.
                       *
                       * [IMPORTANT]
                       * ====
                       * It is unsafe to assume that an address for which this function returns
                       * false is an externally-owned account (EOA) and not a contract.
                       *
                       * Among others, `isContract` will return false for the following
                       * types of addresses:
                       *
                       *  - an externally-owned account
                       *  - a contract in construction
                       *  - an address where a contract will be created
                       *  - an address where a contract lived, but was destroyed
                       * ====
                       *
                       * [IMPORTANT]
                       * ====
                       * You shouldn't rely on `isContract` to protect against flash loan attacks!
                       *
                       * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
                       * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
                       * constructor.
                       * ====
                       */
                      function isContract(address account) internal view returns (bool) {
                          // This method relies on extcodesize/address.code.length, which returns 0
                          // for contracts in construction, since the code is only stored at the end
                          // of the constructor execution.
                          return account.code.length > 0;
                      }
                      /**
                       * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
                       * `recipient`, forwarding all available gas and reverting on errors.
                       *
                       * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
                       * of certain opcodes, possibly making contracts go over the 2300 gas limit
                       * imposed by `transfer`, making them unable to receive funds via
                       * `transfer`. {sendValue} removes this limitation.
                       *
                       * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
                       *
                       * IMPORTANT: because control is transferred to `recipient`, care must be
                       * taken to not create reentrancy vulnerabilities. Consider using
                       * {ReentrancyGuard} or the
                       * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
                       */
                      function sendValue(address payable recipient, uint256 amount) internal {
                          require(address(this).balance >= amount, "Address: insufficient balance");
                          (bool success, ) = recipient.call{value: amount}("");
                          require(success, "Address: unable to send value, recipient may have reverted");
                      }
                      /**
                       * @dev Performs a Solidity function call using a low level `call`. A
                       * plain `call` is an unsafe replacement for a function call: use this
                       * function instead.
                       *
                       * If `target` reverts with a revert reason, it is bubbled up by this
                       * function (like regular Solidity function calls).
                       *
                       * Returns the raw returned data. To convert to the expected return value,
                       * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
                       *
                       * Requirements:
                       *
                       * - `target` must be a contract.
                       * - calling `target` with `data` must not revert.
                       *
                       * _Available since v3.1._
                       */
                      function functionCall(address target, bytes memory data) internal returns (bytes memory) {
                          return functionCall(target, data, "Address: low-level call failed");
                      }
                      /**
                       * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
                       * `errorMessage` as a fallback revert reason when `target` reverts.
                       *
                       * _Available since v3.1._
                       */
                      function functionCall(
                          address target,
                          bytes memory data,
                          string memory errorMessage
                      ) internal returns (bytes memory) {
                          return functionCallWithValue(target, data, 0, errorMessage);
                      }
                      /**
                       * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                       * but also transferring `value` wei to `target`.
                       *
                       * Requirements:
                       *
                       * - the calling contract must have an ETH balance of at least `value`.
                       * - the called Solidity function must be `payable`.
                       *
                       * _Available since v3.1._
                       */
                      function functionCallWithValue(
                          address target,
                          bytes memory data,
                          uint256 value
                      ) internal returns (bytes memory) {
                          return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
                      }
                      /**
                       * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
                       * with `errorMessage` as a fallback revert reason when `target` reverts.
                       *
                       * _Available since v3.1._
                       */
                      function functionCallWithValue(
                          address target,
                          bytes memory data,
                          uint256 value,
                          string memory errorMessage
                      ) internal returns (bytes memory) {
                          require(address(this).balance >= value, "Address: insufficient balance for call");
                          require(isContract(target), "Address: call to non-contract");
                          (bool success, bytes memory returndata) = target.call{value: value}(data);
                          return verifyCallResult(success, returndata, errorMessage);
                      }
                      /**
                       * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                       * but performing a static call.
                       *
                       * _Available since v3.3._
                       */
                      function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
                          return functionStaticCall(target, data, "Address: low-level static call failed");
                      }
                      /**
                       * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
                       * but performing a static call.
                       *
                       * _Available since v3.3._
                       */
                      function functionStaticCall(
                          address target,
                          bytes memory data,
                          string memory errorMessage
                      ) internal view returns (bytes memory) {
                          require(isContract(target), "Address: static call to non-contract");
                          (bool success, bytes memory returndata) = target.staticcall(data);
                          return verifyCallResult(success, returndata, errorMessage);
                      }
                      /**
                       * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the
                       * revert reason using the provided one.
                       *
                       * _Available since v4.3._
                       */
                      function verifyCallResult(
                          bool success,
                          bytes memory returndata,
                          string memory errorMessage
                      ) internal pure returns (bytes memory) {
                          if (success) {
                              return returndata;
                          } else {
                              // Look for revert reason and bubble it up if present
                              if (returndata.length > 0) {
                                  // The easiest way to bubble the revert reason is using memory via assembly
                                  /// @solidity memory-safe-assembly
                                  assembly {
                                      let returndata_size := mload(returndata)
                                      revert(add(32, returndata), returndata_size)
                                  }
                              } else {
                                  revert(errorMessage);
                              }
                          }
                      }
                  }
                  // 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 IERC165Upgradeable {
                      /**
                       * @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);
                  }
                  // SPDX-License-Identifier: MIT
                  // OpenZeppelin Contracts (last updated v4.5.0) (interfaces/draft-IERC1822.sol)
                  pragma solidity ^0.8.0;
                  /**
                   * @dev ERC1822: Universal Upgradeable Proxy Standard (UUPS) documents a method for upgradeability through a simplified
                   * proxy whose upgrades are fully controlled by the current implementation.
                   */
                  interface IERC1822ProxiableUpgradeable {
                      /**
                       * @dev Returns the storage slot that the proxiable contract assumes is being used to store the implementation
                       * address.
                       *
                       * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks
                       * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this
                       * function revert if invoked through a proxy.
                       */
                      function proxiableUUID() external view returns (bytes32);
                  }
                  // SPDX-License-Identifier: MIT
                  // OpenZeppelin Contracts (last updated v4.5.0) (proxy/ERC1967/ERC1967Upgrade.sol)
                  pragma solidity ^0.8.2;
                  import "../beacon/IBeaconUpgradeable.sol";
                  import "../../interfaces/draft-IERC1822Upgradeable.sol";
                  import "../../utils/AddressUpgradeable.sol";
                  import "../../utils/StorageSlotUpgradeable.sol";
                  import "../utils/Initializable.sol";
                  /**
                   * @dev This abstract contract provides getters and event emitting update functions for
                   * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.
                   *
                   * _Available since v4.1._
                   *
                   * @custom:oz-upgrades-unsafe-allow delegatecall
                   */
                  abstract contract ERC1967UpgradeUpgradeable is Initializable {
                      function __ERC1967Upgrade_init() internal onlyInitializing {
                      }
                      function __ERC1967Upgrade_init_unchained() internal onlyInitializing {
                      }
                      // This is the keccak-256 hash of "eip1967.proxy.rollback" subtracted by 1
                      bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143;
                      /**
                       * @dev Storage slot with the address of the current implementation.
                       * This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1, and is
                       * validated in the constructor.
                       */
                      bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
                      /**
                       * @dev Emitted when the implementation is upgraded.
                       */
                      event Upgraded(address indexed implementation);
                      /**
                       * @dev Returns the current implementation address.
                       */
                      function _getImplementation() internal view returns (address) {
                          return StorageSlotUpgradeable.getAddressSlot(_IMPLEMENTATION_SLOT).value;
                      }
                      /**
                       * @dev Stores a new address in the EIP1967 implementation slot.
                       */
                      function _setImplementation(address newImplementation) private {
                          require(AddressUpgradeable.isContract(newImplementation), "ERC1967: new implementation is not a contract");
                          StorageSlotUpgradeable.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
                      }
                      /**
                       * @dev Perform implementation upgrade
                       *
                       * Emits an {Upgraded} event.
                       */
                      function _upgradeTo(address newImplementation) internal {
                          _setImplementation(newImplementation);
                          emit Upgraded(newImplementation);
                      }
                      /**
                       * @dev Perform implementation upgrade with additional setup call.
                       *
                       * Emits an {Upgraded} event.
                       */
                      function _upgradeToAndCall(
                          address newImplementation,
                          bytes memory data,
                          bool forceCall
                      ) internal {
                          _upgradeTo(newImplementation);
                          if (data.length > 0 || forceCall) {
                              _functionDelegateCall(newImplementation, data);
                          }
                      }
                      /**
                       * @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call.
                       *
                       * Emits an {Upgraded} event.
                       */
                      function _upgradeToAndCallUUPS(
                          address newImplementation,
                          bytes memory data,
                          bool forceCall
                      ) internal {
                          // Upgrades from old implementations will perform a rollback test. This test requires the new
                          // implementation to upgrade back to the old, non-ERC1822 compliant, implementation. Removing
                          // this special case will break upgrade paths from old UUPS implementation to new ones.
                          if (StorageSlotUpgradeable.getBooleanSlot(_ROLLBACK_SLOT).value) {
                              _setImplementation(newImplementation);
                          } else {
                              try IERC1822ProxiableUpgradeable(newImplementation).proxiableUUID() returns (bytes32 slot) {
                                  require(slot == _IMPLEMENTATION_SLOT, "ERC1967Upgrade: unsupported proxiableUUID");
                              } catch {
                                  revert("ERC1967Upgrade: new implementation is not UUPS");
                              }
                              _upgradeToAndCall(newImplementation, data, forceCall);
                          }
                      }
                      /**
                       * @dev Storage slot with the admin of the contract.
                       * This is the keccak-256 hash of "eip1967.proxy.admin" subtracted by 1, and is
                       * validated in the constructor.
                       */
                      bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;
                      /**
                       * @dev Emitted when the admin account has changed.
                       */
                      event AdminChanged(address previousAdmin, address newAdmin);
                      /**
                       * @dev Returns the current admin.
                       */
                      function _getAdmin() internal view returns (address) {
                          return StorageSlotUpgradeable.getAddressSlot(_ADMIN_SLOT).value;
                      }
                      /**
                       * @dev Stores a new address in the EIP1967 admin slot.
                       */
                      function _setAdmin(address newAdmin) private {
                          require(newAdmin != address(0), "ERC1967: new admin is the zero address");
                          StorageSlotUpgradeable.getAddressSlot(_ADMIN_SLOT).value = newAdmin;
                      }
                      /**
                       * @dev Changes the admin of the proxy.
                       *
                       * Emits an {AdminChanged} event.
                       */
                      function _changeAdmin(address newAdmin) internal {
                          emit AdminChanged(_getAdmin(), newAdmin);
                          _setAdmin(newAdmin);
                      }
                      /**
                       * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.
                       * This is bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor.
                       */
                      bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;
                      /**
                       * @dev Emitted when the beacon is upgraded.
                       */
                      event BeaconUpgraded(address indexed beacon);
                      /**
                       * @dev Returns the current beacon.
                       */
                      function _getBeacon() internal view returns (address) {
                          return StorageSlotUpgradeable.getAddressSlot(_BEACON_SLOT).value;
                      }
                      /**
                       * @dev Stores a new beacon in the EIP1967 beacon slot.
                       */
                      function _setBeacon(address newBeacon) private {
                          require(AddressUpgradeable.isContract(newBeacon), "ERC1967: new beacon is not a contract");
                          require(
                              AddressUpgradeable.isContract(IBeaconUpgradeable(newBeacon).implementation()),
                              "ERC1967: beacon implementation is not a contract"
                          );
                          StorageSlotUpgradeable.getAddressSlot(_BEACON_SLOT).value = newBeacon;
                      }
                      /**
                       * @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does
                       * not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that).
                       *
                       * Emits a {BeaconUpgraded} event.
                       */
                      function _upgradeBeaconToAndCall(
                          address newBeacon,
                          bytes memory data,
                          bool forceCall
                      ) internal {
                          _setBeacon(newBeacon);
                          emit BeaconUpgraded(newBeacon);
                          if (data.length > 0 || forceCall) {
                              _functionDelegateCall(IBeaconUpgradeable(newBeacon).implementation(), data);
                          }
                      }
                      /**
                       * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
                       * but performing a delegate call.
                       *
                       * _Available since v3.4._
                       */
                      function _functionDelegateCall(address target, bytes memory data) private returns (bytes memory) {
                          require(AddressUpgradeable.isContract(target), "Address: delegate call to non-contract");
                          // solhint-disable-next-line avoid-low-level-calls
                          (bool success, bytes memory returndata) = target.delegatecall(data);
                          return AddressUpgradeable.verifyCallResult(success, returndata, "Address: low-level delegate call failed");
                      }
                      /**
                       * @dev This empty reserved space is put in place to allow future versions to add new
                       * variables without shifting down storage in the inheritance chain.
                       * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
                       */
                      uint256[50] private __gap;
                  }
                  // SPDX-License-Identifier: MIT
                  // OpenZeppelin Contracts v4.4.1 (proxy/beacon/IBeacon.sol)
                  pragma solidity ^0.8.0;
                  /**
                   * @dev This is the interface that {BeaconProxy} expects of its beacon.
                   */
                  interface IBeaconUpgradeable {
                      /**
                       * @dev Must return an address that can be used as a delegate call target.
                       *
                       * {BeaconProxy} will check that this address is a contract.
                       */
                      function implementation() external view returns (address);
                  }
                  // SPDX-License-Identifier: MIT
                  // OpenZeppelin Contracts (last updated v4.7.0) (utils/StorageSlot.sol)
                  pragma solidity ^0.8.0;
                  /**
                   * @dev Library for reading and writing primitive types to specific storage slots.
                   *
                   * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.
                   * This library helps with reading and writing to such slots without the need for inline assembly.
                   *
                   * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.
                   *
                   * Example usage to set ERC1967 implementation slot:
                   * ```
                   * contract ERC1967 {
                   *     bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
                   *
                   *     function _getImplementation() internal view returns (address) {
                   *         return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
                   *     }
                   *
                   *     function _setImplementation(address newImplementation) internal {
                   *         require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
                   *         StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
                   *     }
                   * }
                   * ```
                   *
                   * _Available since v4.1 for `address`, `bool`, `bytes32`, and `uint256`._
                   */
                  library StorageSlotUpgradeable {
                      struct AddressSlot {
                          address value;
                      }
                      struct BooleanSlot {
                          bool value;
                      }
                      struct Bytes32Slot {
                          bytes32 value;
                      }
                      struct Uint256Slot {
                          uint256 value;
                      }
                      /**
                       * @dev Returns an `AddressSlot` with member `value` located at `slot`.
                       */
                      function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {
                          /// @solidity memory-safe-assembly
                          assembly {
                              r.slot := slot
                          }
                      }
                      /**
                       * @dev Returns an `BooleanSlot` with member `value` located at `slot`.
                       */
                      function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {
                          /// @solidity memory-safe-assembly
                          assembly {
                              r.slot := slot
                          }
                      }
                      /**
                       * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.
                       */
                      function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {
                          /// @solidity memory-safe-assembly
                          assembly {
                              r.slot := slot
                          }
                      }
                      /**
                       * @dev Returns an `Uint256Slot` with member `value` located at `slot`.
                       */
                      function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {
                          /// @solidity memory-safe-assembly
                          assembly {
                              r.slot := slot
                          }
                      }
                  }
                  //SPDX-License-Identifier: BUSL-1.1
                  pragma solidity 0.8.16;
                  interface IQuadPassportStore {
                      /// @dev Attribute store infomation as it relates to a single attribute
                      /// `attrKeys` Array of keys defined by (wallet address/DID + data Type)
                      /// `value` Attribute value
                      /// `epoch` timestamp when the attribute has been verified by an Issuer
                      /// `issuer` address of the issuer issuing the attribute
                      struct Attribute {
                          bytes32 value;
                          uint256 epoch;
                          address issuer;
                      }
                      /// @dev AttributeSetterConfig contains configuration for setting attributes for a Passport holder
                      /// @notice This struct is used to abstract setAttributes function parameters
                      /// `attrKeys` Array of keys defined by (wallet address/DID + data Type)
                      /// `attrValues` Array of attributes values
                      /// `attrTypes` Array of attributes types (ex: [keccak256("DID")]) used for validation
                      /// `did` did of entity
                      /// `tokenId` tokenId of the Passport
                      /// `issuedAt` epoch when the passport has been issued by the Issuer
                      /// `verifiedAt` epoch when the attribute has been attested by the Issuer
                      /// `fee` Fee (in Native token) to pay the Issuer
                      struct AttributeSetterConfig {
                          bytes32[] attrKeys;
                          bytes32[] attrValues;
                          bytes32[] attrTypes;
                          bytes32 did;
                          uint256 tokenId;
                          uint256 verifiedAt;
                          uint256 issuedAt;
                          uint256 fee;
                      }
                  }
                  //SPDX-License-Identifier: BUSL-1.1
                  pragma solidity 0.8.16;
                  interface IQuadSoulbound  {
                      /**
                       * @dev Emitted when `value` tokens of token type `id` are transferred from `from` to `to` by `operator`.
                       */
                      event TransferSingle(address indexed operator, address indexed from, address indexed to, uint256 id, uint256 value);
                      /**
                       * @dev Emitted when the URI for token type `id` changes to `value`, if it is a non-programmatic URI.
                       *
                       * If an {URI} event was emitted for `id`, the standard
                       * https://eips.ethereum.org/EIPS/eip-1155#metadata-extensions[guarantees] that `value` will equal the value
                       * returned by {IERC1155MetadataURI-uri}.
                       */
                      event URI(string value, uint256 indexed id);
                      function uri(uint256 _tokenId) external view returns (string memory);
                      /**
                       * @dev ERC1155 balanceOf implementation
                       *
                       * Requirements:
                       *
                       * - `account` cannot be the zero address.
                       */
                      function balanceOf(address account, uint256 id) external view returns (uint256);
                      /**
                       * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {balanceOf}.
                       *
                       * Requirements:
                       *
                       * - `accounts` and `ids` must have the same length.
                       */
                      function balanceOfBatch(address[] calldata accounts, uint256[] calldata ids)
                          external
                          view
                          returns (uint256[] memory);
                  }
                  //SPDX-License-Identifier: BUSL-1.1
                  pragma solidity 0.8.16;
                  contract QuadConstant {
                      bytes32 public constant ISSUER_ROLE = keccak256("ISSUER_ROLE");
                      bytes32 public constant GOVERNANCE_ROLE = keccak256("GOVERNANCE_ROLE");
                      bytes32 public constant READER_ROLE = keccak256("READER_ROLE");
                      bytes32 public constant PAUSER_ROLE = keccak256("PAUSER_ROLE");
                      bytes32 public constant DIGEST_TO_SIGN = 0x37937bf5ff1ecbf00bbd389ab7ca9a190d7e8c0a084b2893ece7923be1d2ec85;
                      bytes32 internal constant ATTRIBUTE_DID = 0x09deac0378109c72d82cccd3c343a90f7020f0f1af78dcd4fc949c6301aa9488;
                      bytes32 internal constant ATTRIBUTE_IS_BUSINESS = 0xaf369ce728c816785c72f1ff0222ca9553b2cb93729d6a803be6af0d2369239b;
                      bytes32 internal constant ATTRIBUTE_COUNTRY = 0xc4713d2897c0d675d85b414a1974570a575e5032b6f7be9545631a1f922b26ef;
                      bytes32 internal constant ATTRIBUTE_AML = 0xaf192d67680c4285e52cd2a94216ce249fb4e0227d267dcc01ea88f1b020a119;
                      uint256[47] private __gap;
                  }