creation_sourcecode: // File: @openzeppelin/contracts/token/ERC20/IERC20.sol
  
  
  // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/IERC20.sol)
  
  pragma solidity ^0.8.20;
  
  /**
   * @dev Interface of the ERC20 standard as defined in the EIP.
   */
  interface IERC20 {
      /**
       * @dev Emitted when `value` tokens are moved from one account (`from`) to
       * another (`to`).
       *
       * Note that `value` may be zero.
       */
      event Transfer(address indexed from, address indexed to, uint256 value);
  
      /**
       * @dev Emitted when the allowance of a `spender` for an `owner` is set by
       * a call to {approve}. `value` is the new allowance.
       */
      event Approval(address indexed owner, address indexed spender, uint256 value);
  
      /**
       * @dev Returns the value of tokens in existence.
       */
      function totalSupply() external view returns (uint256);
  
      /**
       * @dev Returns the value of tokens owned by `account`.
       */
      function balanceOf(address account) external view returns (uint256);
  
      /**
       * @dev Moves a `value` amount of tokens from the caller's account to `to`.
       *
       * Returns a boolean value indicating whether the operation succeeded.
       *
       * Emits a {Transfer} event.
       */
      function transfer(address to, uint256 value) external returns (bool);
  
      /**
       * @dev Returns the remaining number of tokens that `spender` will be
       * allowed to spend on behalf of `owner` through {transferFrom}. This is
       * zero by default.
       *
       * This value changes when {approve} or {transferFrom} are called.
       */
      function allowance(address owner, address spender) external view returns (uint256);
  
      /**
       * @dev Sets a `value` amount of tokens as the allowance of `spender` over the
       * caller's tokens.
       *
       * Returns a boolean value indicating whether the operation succeeded.
       *
       * IMPORTANT: Beware that changing an allowance with this method brings the risk
       * that someone may use both the old and the new allowance by unfortunate
       * transaction ordering. One possible solution to mitigate this race
       * condition is to first reduce the spender's allowance to 0 and set the
       * desired value afterwards:
       * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
       *
       * Emits an {Approval} event.
       */
      function approve(address spender, uint256 value) external returns (bool);
  
      /**
       * @dev Moves a `value` amount of tokens from `from` to `to` using the
       * allowance mechanism. `value` is then deducted from the caller's
       * allowance.
       *
       * Returns a boolean value indicating whether the operation succeeded.
       *
       * Emits a {Transfer} event.
       */
      function transferFrom(address from, address to, uint256 value) external returns (bool);
  }
  
  // File: @openzeppelin/contracts/utils/math/SignedMath.sol
  
  
  // OpenZeppelin Contracts (last updated v5.0.0) (utils/math/SignedMath.sol)
  
  pragma solidity ^0.8.20;
  
  /**
   * @dev Standard signed math utilities missing in the Solidity language.
   */
  library SignedMath {
      /**
       * @dev Returns the largest of two signed numbers.
       */
      function max(int256 a, int256 b) internal pure returns (int256) {
          return a > b ? a : b;
      }
  
      /**
       * @dev Returns the smallest of two signed numbers.
       */
      function min(int256 a, int256 b) internal pure returns (int256) {
          return a < b ? a : b;
      }
  
      /**
       * @dev Returns the average of two signed numbers without overflow.
       * The result is rounded towards zero.
       */
      function average(int256 a, int256 b) internal pure returns (int256) {
          // Formula from the book "Hacker's Delight"
          int256 x = (a & b) + ((a ^ b) >> 1);
          return x + (int256(uint256(x) >> 255) & (a ^ b));
      }
  
      /**
       * @dev Returns the absolute unsigned value of a signed value.
       */
      function abs(int256 n) internal pure returns (uint256) {
          unchecked {
              // must be unchecked in order to support `n = type(int256).min`
              return uint256(n >= 0 ? n : -n);
          }
      }
  }
  
  // File: @openzeppelin/contracts/security/ReentrancyGuard.sol
  
  
  // OpenZeppelin Contracts (last updated v4.9.0) (security/ReentrancyGuard.sol)
  
  pragma solidity ^0.8.0;
  
  /**
   * @dev Contract module that helps prevent reentrant calls to a function.
   *
   * Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier
   * available, which can be applied to functions to make sure there are no nested
   * (reentrant) calls to them.
   *
   * Note that because there is a single `nonReentrant` guard, functions marked as
   * `nonReentrant` may not call one another. This can be worked around by making
   * those functions `private`, and then adding `external` `nonReentrant` entry
   * points to them.
   *
   * TIP: If you would like to learn more about reentrancy and alternative ways
   * to protect against it, check out our blog post
   * https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul].
   */
  abstract contract ReentrancyGuard {
      // Booleans are more expensive than uint256 or any type that takes up a full
      // word because each write operation emits an extra SLOAD to first read the
      // slot's contents, replace the bits taken up by the boolean, and then write
      // back. This is the compiler's defense against contract upgrades and
      // pointer aliasing, and it cannot be disabled.
  
      // The values being non-zero value makes deployment a bit more expensive,
      // but in exchange the refund on every call to nonReentrant will be lower in
      // amount. Since refunds are capped to a percentage of the total
      // transaction's gas, it is best to keep them low in cases like this one, to
      // increase the likelihood of the full refund coming into effect.
      uint256 private constant _NOT_ENTERED = 1;
      uint256 private constant _ENTERED = 2;
  
      uint256 private _status;
  
      constructor() {
          _status = _NOT_ENTERED;
      }
  
      /**
       * @dev Prevents a contract from calling itself, directly or indirectly.
       * Calling a `nonReentrant` function from another `nonReentrant`
       * function is not supported. It is possible to prevent this from happening
       * by making the `nonReentrant` function external, and making it call a
       * `private` function that does the actual work.
       */
      modifier nonReentrant() {
          _nonReentrantBefore();
          _;
          _nonReentrantAfter();
      }
  
      function _nonReentrantBefore() private {
          // On the first call to nonReentrant, _status will be _NOT_ENTERED
          require(_status != _ENTERED, "ReentrancyGuard: reentrant call");
  
          // Any calls to nonReentrant after this point will fail
          _status = _ENTERED;
      }
  
      function _nonReentrantAfter() private {
          // By storing the original value once again, a refund is triggered (see
          // https://eips.ethereum.org/EIPS/eip-2200)
          _status = _NOT_ENTERED;
      }
  
      /**
       * @dev Returns true if the reentrancy guard is currently set to "entered", which indicates there is a
       * `nonReentrant` function in the call stack.
       */
      function _reentrancyGuardEntered() internal view returns (bool) {
          return _status == _ENTERED;
      }
  }
  
  // File: @openzeppelin/contracts/interfaces/draft-IERC6093.sol
  
  
  // OpenZeppelin Contracts (last updated v5.0.0) (interfaces/draft-IERC6093.sol)
  pragma solidity ^0.8.20;
  
  /**
   * @dev Standard ERC20 Errors
   * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC20 tokens.
   */
  interface IERC20Errors {
      /**
       * @dev Indicates an error related to the current `balance` of a `sender`. Used in transfers.
       * @param sender Address whose tokens are being transferred.
       * @param balance Current balance for the interacting account.
       * @param needed Minimum amount required to perform a transfer.
       */
      error ERC20InsufficientBalance(address sender, uint256 balance, uint256 needed);
  
      /**
       * @dev Indicates a failure with the token `sender`. Used in transfers.
       * @param sender Address whose tokens are being transferred.
       */
      error ERC20InvalidSender(address sender);
  
      /**
       * @dev Indicates a failure with the token `receiver`. Used in transfers.
       * @param receiver Address to which tokens are being transferred.
       */
      error ERC20InvalidReceiver(address receiver);
  
      /**
       * @dev Indicates a failure with the `spender`’s `allowance`. Used in transfers.
       * @param spender Address that may be allowed to operate on tokens without being their owner.
       * @param allowance Amount of tokens a `spender` is allowed to operate with.
       * @param needed Minimum amount required to perform a transfer.
       */
      error ERC20InsufficientAllowance(address spender, uint256 allowance, uint256 needed);
  
      /**
       * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals.
       * @param approver Address initiating an approval operation.
       */
      error ERC20InvalidApprover(address approver);
  
      /**
       * @dev Indicates a failure with the `spender` to be approved. Used in approvals.
       * @param spender Address that may be allowed to operate on tokens without being their owner.
       */
      error ERC20InvalidSpender(address spender);
  }
  
  /**
   * @dev Standard ERC721 Errors
   * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC721 tokens.
   */
  interface IERC721Errors {
      /**
       * @dev Indicates that an address can't be an owner. For example, `address(0)` is a forbidden owner in EIP-20.
       * Used in balance queries.
       * @param owner Address of the current owner of a token.
       */
      error ERC721InvalidOwner(address owner);
  
      /**
       * @dev Indicates a `tokenId` whose `owner` is the zero address.
       * @param tokenId Identifier number of a token.
       */
      error ERC721NonexistentToken(uint256 tokenId);
  
      /**
       * @dev Indicates an error related to the ownership over a particular token. Used in transfers.
       * @param sender Address whose tokens are being transferred.
       * @param tokenId Identifier number of a token.
       * @param owner Address of the current owner of a token.
       */
      error ERC721IncorrectOwner(address sender, uint256 tokenId, address owner);
  
      /**
       * @dev Indicates a failure with the token `sender`. Used in transfers.
       * @param sender Address whose tokens are being transferred.
       */
      error ERC721InvalidSender(address sender);
  
      /**
       * @dev Indicates a failure with the token `receiver`. Used in transfers.
       * @param receiver Address to which tokens are being transferred.
       */
      error ERC721InvalidReceiver(address receiver);
  
      /**
       * @dev Indicates a failure with the `operator`’s approval. Used in transfers.
       * @param operator Address that may be allowed to operate on tokens without being their owner.
       * @param tokenId Identifier number of a token.
       */
      error ERC721InsufficientApproval(address operator, uint256 tokenId);
  
      /**
       * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals.
       * @param approver Address initiating an approval operation.
       */
      error ERC721InvalidApprover(address approver);
  
      /**
       * @dev Indicates a failure with the `operator` to be approved. Used in approvals.
       * @param operator Address that may be allowed to operate on tokens without being their owner.
       */
      error ERC721InvalidOperator(address operator);
  }
  
  /**
   * @dev Standard ERC1155 Errors
   * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC1155 tokens.
   */
  interface IERC1155Errors {
      /**
       * @dev Indicates an error related to the current `balance` of a `sender`. Used in transfers.
       * @param sender Address whose tokens are being transferred.
       * @param balance Current balance for the interacting account.
       * @param needed Minimum amount required to perform a transfer.
       * @param tokenId Identifier number of a token.
       */
      error ERC1155InsufficientBalance(address sender, uint256 balance, uint256 needed, uint256 tokenId);
  
      /**
       * @dev Indicates a failure with the token `sender`. Used in transfers.
       * @param sender Address whose tokens are being transferred.
       */
      error ERC1155InvalidSender(address sender);
  
      /**
       * @dev Indicates a failure with the token `receiver`. Used in transfers.
       * @param receiver Address to which tokens are being transferred.
       */
      error ERC1155InvalidReceiver(address receiver);
  
      /**
       * @dev Indicates a failure with the `operator`’s approval. Used in transfers.
       * @param operator Address that may be allowed to operate on tokens without being their owner.
       * @param owner Address of the current owner of a token.
       */
      error ERC1155MissingApprovalForAll(address operator, address owner);
  
      /**
       * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals.
       * @param approver Address initiating an approval operation.
       */
      error ERC1155InvalidApprover(address approver);
  
      /**
       * @dev Indicates a failure with the `operator` to be approved. Used in approvals.
       * @param operator Address that may be allowed to operate on tokens without being their owner.
       */
      error ERC1155InvalidOperator(address operator);
  
      /**
       * @dev Indicates an array length mismatch between ids and values in a safeBatchTransferFrom operation.
       * Used in batch transfers.
       * @param idsLength Length of the array of token identifiers
       * @param valuesLength Length of the array of token amounts
       */
      error ERC1155InvalidArrayLength(uint256 idsLength, uint256 valuesLength);
  }
  
  // File: @openzeppelin/contracts/utils/math/Math.sol
  
  
  // OpenZeppelin Contracts (last updated v5.0.0) (utils/math/Math.sol)
  
  pragma solidity ^0.8.20;
  
  /**
   * @dev Standard math utilities missing in the Solidity language.
   */
  library Math {
      /**
       * @dev Muldiv operation overflow.
       */
      error MathOverflowedMulDiv();
  
      enum Rounding {
          Floor, // Toward negative infinity
          Ceil, // Toward positive infinity
          Trunc, // Toward zero
          Expand // Away from zero
      }
  
      /**
       * @dev Returns the addition of two unsigned integers, with an overflow flag.
       */
      function tryAdd(uint256 a, uint256 b) internal pure returns (bool, uint256) {
          unchecked {
              uint256 c = a + b;
              if (c < a) return (false, 0);
              return (true, c);
          }
      }
  
      /**
       * @dev Returns the subtraction of two unsigned integers, with an overflow flag.
       */
      function trySub(uint256 a, uint256 b) internal pure returns (bool, uint256) {
          unchecked {
              if (b > a) return (false, 0);
              return (true, a - b);
          }
      }
  
      /**
       * @dev Returns the multiplication of two unsigned integers, with an overflow flag.
       */
      function tryMul(uint256 a, uint256 b) internal pure returns (bool, uint256) {
          unchecked {
              // Gas optimization: this is cheaper than requiring 'a' not being zero, but the
              // benefit is lost if 'b' is also tested.
              // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522
              if (a == 0) return (true, 0);
              uint256 c = a * b;
              if (c / a != b) return (false, 0);
              return (true, c);
          }
      }
  
      /**
       * @dev Returns the division of two unsigned integers, with a division by zero flag.
       */
      function tryDiv(uint256 a, uint256 b) internal pure returns (bool, uint256) {
          unchecked {
              if (b == 0) return (false, 0);
              return (true, a / b);
          }
      }
  
      /**
       * @dev Returns the remainder of dividing two unsigned integers, with a division by zero flag.
       */
      function tryMod(uint256 a, uint256 b) internal pure returns (bool, uint256) {
          unchecked {
              if (b == 0) return (false, 0);
              return (true, a % b);
          }
      }
  
      /**
       * @dev Returns the largest of two numbers.
       */
      function max(uint256 a, uint256 b) internal pure returns (uint256) {
          return a > b ? a : b;
      }
  
      /**
       * @dev Returns the smallest of two numbers.
       */
      function min(uint256 a, uint256 b) internal pure returns (uint256) {
          return a < b ? a : b;
      }
  
      /**
       * @dev Returns the average of two numbers. The result is rounded towards
       * zero.
       */
      function average(uint256 a, uint256 b) internal pure returns (uint256) {
          // (a + b) / 2 can overflow.
          return (a & b) + (a ^ b) / 2;
      }
  
      /**
       * @dev Returns the ceiling of the division of two numbers.
       *
       * This differs from standard division with `/` in that it rounds towards infinity instead
       * of rounding towards zero.
       */
      function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {
          if (b == 0) {
              // Guarantee the same behavior as in a regular Solidity division.
              return a / b;
          }
  
          // (a + b - 1) / b can overflow on addition, so we distribute.
          return a == 0 ? 0 : (a - 1) / b + 1;
      }
  
      /**
       * @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or
       * denominator == 0.
       * @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv) with further edits by
       * Uniswap Labs also under MIT license.
       */
      function mulDiv(uint256 x, uint256 y, uint256 denominator) internal pure returns (uint256 result) {
          unchecked {
              // 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use
              // use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256
              // variables such that product = prod1 * 2^256 + prod0.
              uint256 prod0 = x * y; // Least significant 256 bits of the product
              uint256 prod1; // Most significant 256 bits of the product
              assembly {
                  let mm := mulmod(x, y, not(0))
                  prod1 := sub(sub(mm, prod0), lt(mm, prod0))
              }
  
              // Handle non-overflow cases, 256 by 256 division.
              if (prod1 == 0) {
                  // Solidity will revert if denominator == 0, unlike the div opcode on its own.
                  // The surrounding unchecked block does not change this fact.
                  // See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic.
                  return prod0 / denominator;
              }
  
              // Make sure the result is less than 2^256. Also prevents denominator == 0.
              if (denominator <= prod1) {
                  revert MathOverflowedMulDiv();
              }
  
              ///////////////////////////////////////////////
              // 512 by 256 division.
              ///////////////////////////////////////////////
  
              // Make division exact by subtracting the remainder from [prod1 prod0].
              uint256 remainder;
              assembly {
                  // Compute remainder using mulmod.
                  remainder := mulmod(x, y, denominator)
  
                  // Subtract 256 bit number from 512 bit number.
                  prod1 := sub(prod1, gt(remainder, prod0))
                  prod0 := sub(prod0, remainder)
              }
  
              // Factor powers of two out of denominator and compute largest power of two divisor of denominator.
              // Always >= 1. See https://cs.stackexchange.com/q/138556/92363.
  
              uint256 twos = denominator & (0 - denominator);
              assembly {
                  // Divide denominator by twos.
                  denominator := div(denominator, twos)
  
                  // Divide [prod1 prod0] by twos.
                  prod0 := div(prod0, twos)
  
                  // Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one.
                  twos := add(div(sub(0, twos), twos), 1)
              }
  
              // Shift in bits from prod1 into prod0.
              prod0 |= prod1 * twos;
  
              // Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such
              // that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for
              // four bits. That is, denominator * inv = 1 mod 2^4.
              uint256 inverse = (3 * denominator) ^ 2;
  
              // Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also
              // works in modular arithmetic, doubling the correct bits in each step.
              inverse *= 2 - denominator * inverse; // inverse mod 2^8
              inverse *= 2 - denominator * inverse; // inverse mod 2^16
              inverse *= 2 - denominator * inverse; // inverse mod 2^32
              inverse *= 2 - denominator * inverse; // inverse mod 2^64
              inverse *= 2 - denominator * inverse; // inverse mod 2^128
              inverse *= 2 - denominator * inverse; // inverse mod 2^256
  
              // Because the division is now exact we can divide by multiplying with the modular inverse of denominator.
              // This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is
              // less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1
              // is no longer required.
              result = prod0 * inverse;
              return result;
          }
      }
  
      /**
       * @notice Calculates x * y / denominator with full precision, following the selected rounding direction.
       */
      function mulDiv(uint256 x, uint256 y, uint256 denominator, Rounding rounding) internal pure returns (uint256) {
          uint256 result = mulDiv(x, y, denominator);
          if (unsignedRoundsUp(rounding) && mulmod(x, y, denominator) > 0) {
              result += 1;
          }
          return result;
      }
  
      /**
       * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded
       * towards zero.
       *
       * Inspired by Henry S. Warren, Jr.'s "Hacker's Delight" (Chapter 11).
       */
      function sqrt(uint256 a) internal pure returns (uint256) {
          if (a == 0) {
              return 0;
          }
  
          // For our first guess, we get the biggest power of 2 which is smaller than the square root of the target.
          //
          // We know that the "msb" (most significant bit) of our target number `a` is a power of 2 such that we have
          // `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`.
          //
          // This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)`
          // → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))`
          // → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)`
          //
          // Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit.
          uint256 result = 1 << (log2(a) >> 1);
  
          // At this point `result` is an estimation with one bit of precision. We know the true value is a uint128,
          // since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at
          // every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision
          // into the expected uint128 result.
          unchecked {
              result = (result + a / result) >> 1;
              result = (result + a / result) >> 1;
              result = (result + a / result) >> 1;
              result = (result + a / result) >> 1;
              result = (result + a / result) >> 1;
              result = (result + a / result) >> 1;
              result = (result + a / result) >> 1;
              return min(result, a / result);
          }
      }
  
      /**
       * @notice Calculates sqrt(a), following the selected rounding direction.
       */
      function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) {
          unchecked {
              uint256 result = sqrt(a);
              return result + (unsignedRoundsUp(rounding) && result * result < a ? 1 : 0);
          }
      }
  
      /**
       * @dev Return the log in base 2 of a positive value rounded towards zero.
       * Returns 0 if given 0.
       */
      function log2(uint256 value) internal pure returns (uint256) {
          uint256 result = 0;
          unchecked {
              if (value >> 128 > 0) {
                  value >>= 128;
                  result += 128;
              }
              if (value >> 64 > 0) {
                  value >>= 64;
                  result += 64;
              }
              if (value >> 32 > 0) {
                  value >>= 32;
                  result += 32;
              }
              if (value >> 16 > 0) {
                  value >>= 16;
                  result += 16;
              }
              if (value >> 8 > 0) {
                  value >>= 8;
                  result += 8;
              }
              if (value >> 4 > 0) {
                  value >>= 4;
                  result += 4;
              }
              if (value >> 2 > 0) {
                  value >>= 2;
                  result += 2;
              }
              if (value >> 1 > 0) {
                  result += 1;
              }
          }
          return result;
      }
  
      /**
       * @dev Return the log in base 2, following the selected rounding direction, of a positive value.
       * Returns 0 if given 0.
       */
      function log2(uint256 value, Rounding rounding) internal pure returns (uint256) {
          unchecked {
              uint256 result = log2(value);
              return result + (unsignedRoundsUp(rounding) && 1 << result < value ? 1 : 0);
          }
      }
  
      /**
       * @dev Return the log in base 10 of a positive value rounded towards zero.
       * Returns 0 if given 0.
       */
      function log10(uint256 value) internal pure returns (uint256) {
          uint256 result = 0;
          unchecked {
              if (value >= 10 ** 64) {
                  value /= 10 ** 64;
                  result += 64;
              }
              if (value >= 10 ** 32) {
                  value /= 10 ** 32;
                  result += 32;
              }
              if (value >= 10 ** 16) {
                  value /= 10 ** 16;
                  result += 16;
              }
              if (value >= 10 ** 8) {
                  value /= 10 ** 8;
                  result += 8;
              }
              if (value >= 10 ** 4) {
                  value /= 10 ** 4;
                  result += 4;
              }
              if (value >= 10 ** 2) {
                  value /= 10 ** 2;
                  result += 2;
              }
              if (value >= 10 ** 1) {
                  result += 1;
              }
          }
          return result;
      }
  
      /**
       * @dev Return the log in base 10, following the selected rounding direction, of a positive value.
       * Returns 0 if given 0.
       */
      function log10(uint256 value, Rounding rounding) internal pure returns (uint256) {
          unchecked {
              uint256 result = log10(value);
              return result + (unsignedRoundsUp(rounding) && 10 ** result < value ? 1 : 0);
          }
      }
  
      /**
       * @dev Return the log in base 256 of a positive value rounded towards zero.
       * Returns 0 if given 0.
       *
       * Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string.
       */
      function log256(uint256 value) internal pure returns (uint256) {
          uint256 result = 0;
          unchecked {
              if (value >> 128 > 0) {
                  value >>= 128;
                  result += 16;
              }
              if (value >> 64 > 0) {
                  value >>= 64;
                  result += 8;
              }
              if (value >> 32 > 0) {
                  value >>= 32;
                  result += 4;
              }
              if (value >> 16 > 0) {
                  value >>= 16;
                  result += 2;
              }
              if (value >> 8 > 0) {
                  result += 1;
              }
          }
          return result;
      }
  
      /**
       * @dev Return the log in base 256, following the selected rounding direction, of a positive value.
       * Returns 0 if given 0.
       */
      function log256(uint256 value, Rounding rounding) internal pure returns (uint256) {
          unchecked {
              uint256 result = log256(value);
              return result + (unsignedRoundsUp(rounding) && 1 << (result << 3) < value ? 1 : 0);
          }
      }
  
      /**
       * @dev Returns whether a provided rounding mode is considered rounding up for unsigned integers.
       */
      function unsignedRoundsUp(Rounding rounding) internal pure returns (bool) {
          return uint8(rounding) % 2 == 1;
      }
  }
  
  // File: @openzeppelin/contracts/utils/Strings.sol
  
  
  // OpenZeppelin Contracts (last updated v5.0.0) (utils/Strings.sol)
  
  pragma solidity ^0.8.20;
  
  
  
  /**
   * @dev String operations.
   */
  library Strings {
      bytes16 private constant HEX_DIGITS = "0123456789abcdef";
      uint8 private constant ADDRESS_LENGTH = 20;
  
      /**
       * @dev The `value` string doesn't fit in the specified `length`.
       */
      error StringsInsufficientHexLength(uint256 value, uint256 length);
  
      /**
       * @dev Converts a `uint256` to its ASCII `string` decimal representation.
       */
      function toString(uint256 value) internal pure returns (string memory) {
          unchecked {
              uint256 length = Math.log10(value) + 1;
              string memory buffer = new string(length);
              uint256 ptr;
              /// @solidity memory-safe-assembly
              assembly {
                  ptr := add(buffer, add(32, length))
              }
              while (true) {
                  ptr--;
                  /// @solidity memory-safe-assembly
                  assembly {
                      mstore8(ptr, byte(mod(value, 10), HEX_DIGITS))
                  }
                  value /= 10;
                  if (value == 0) break;
              }
              return buffer;
          }
      }
  
      /**
       * @dev Converts a `int256` to its ASCII `string` decimal representation.
       */
      function toStringSigned(int256 value) internal pure returns (string memory) {
          return string.concat(value < 0 ? "-" : "", toString(SignedMath.abs(value)));
      }
  
      /**
       * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
       */
      function toHexString(uint256 value) internal pure returns (string memory) {
          unchecked {
              return toHexString(value, Math.log256(value) + 1);
          }
      }
  
      /**
       * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.
       */
      function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {
          uint256 localValue = value;
          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_DIGITS[localValue & 0xf];
              localValue >>= 4;
          }
          if (localValue != 0) {
              revert StringsInsufficientHexLength(value, length);
          }
          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);
      }
  
      /**
       * @dev Returns true if the two strings are equal.
       */
      function equal(string memory a, string memory b) internal pure returns (bool) {
          return bytes(a).length == bytes(b).length && keccak256(bytes(a)) == keccak256(bytes(b));
      }
  }
  
  // File: @openzeppelin/contracts/utils/StorageSlot.sol
  
  
  // OpenZeppelin Contracts (last updated v5.0.0) (utils/StorageSlot.sol)
  // This file was procedurally generated from scripts/generate/templates/StorageSlot.js.
  
  pragma solidity ^0.8.20;
  
  /**
   * @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:
   * ```solidity
   * 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(newImplementation.code.length > 0);
   *         StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
   *     }
   * }
   * ```
   */
  library StorageSlot {
      struct AddressSlot {
          address value;
      }
  
      struct BooleanSlot {
          bool value;
      }
  
      struct Bytes32Slot {
          bytes32 value;
      }
  
      struct Uint256Slot {
          uint256 value;
      }
  
      struct StringSlot {
          string value;
      }
  
      struct BytesSlot {
          bytes 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
          }
      }
  
      /**
       * @dev Returns an `StringSlot` with member `value` located at `slot`.
       */
      function getStringSlot(bytes32 slot) internal pure returns (StringSlot storage r) {
          /// @solidity memory-safe-assembly
          assembly {
              r.slot := slot
          }
      }
  
      /**
       * @dev Returns an `StringSlot` representation of the string storage pointer `store`.
       */
      function getStringSlot(string storage store) internal pure returns (StringSlot storage r) {
          /// @solidity memory-safe-assembly
          assembly {
              r.slot := store.slot
          }
      }
  
      /**
       * @dev Returns an `BytesSlot` with member `value` located at `slot`.
       */
      function getBytesSlot(bytes32 slot) internal pure returns (BytesSlot storage r) {
          /// @solidity memory-safe-assembly
          assembly {
              r.slot := slot
          }
      }
  
      /**
       * @dev Returns an `BytesSlot` representation of the bytes storage pointer `store`.
       */
      function getBytesSlot(bytes storage store) internal pure returns (BytesSlot storage r) {
          /// @solidity memory-safe-assembly
          assembly {
              r.slot := store.slot
          }
      }
  }
  
  // File: @openzeppelin/contracts/utils/Arrays.sol
  
  
  // OpenZeppelin Contracts (last updated v5.0.0) (utils/Arrays.sol)
  
  pragma solidity ^0.8.20;
  
  
  
  /**
   * @dev Collection of functions related to array types.
   */
  library Arrays {
      using StorageSlot for bytes32;
  
      /**
       * @dev Searches a sorted `array` and returns the first index that contains
       * a value greater or equal to `element`. If no such index exists (i.e. all
       * values in the array are strictly less than `element`), the array length is
       * returned. Time complexity O(log n).
       *
       * `array` is expected to be sorted in ascending order, and to contain no
       * repeated elements.
       */
      function findUpperBound(uint256[] storage array, uint256 element) internal view returns (uint256) {
          uint256 low = 0;
          uint256 high = array.length;
  
          if (high == 0) {
              return 0;
          }
  
          while (low < high) {
              uint256 mid = Math.average(low, high);
  
              // Note that mid will always be strictly less than high (i.e. it will be a valid array index)
              // because Math.average rounds towards zero (it does integer division with truncation).
              if (unsafeAccess(array, mid).value > element) {
                  high = mid;
              } else {
                  low = mid + 1;
              }
          }
  
          // At this point `low` is the exclusive upper bound. We will return the inclusive upper bound.
          if (low > 0 && unsafeAccess(array, low - 1).value == element) {
              return low - 1;
          } else {
              return low;
          }
      }
  
      /**
       * @dev Access an array in an "unsafe" way. Skips solidity "index-out-of-range" check.
       *
       * WARNING: Only use if you are certain `pos` is lower than the array length.
       */
      function unsafeAccess(address[] storage arr, uint256 pos) internal pure returns (StorageSlot.AddressSlot storage) {
          bytes32 slot;
          // We use assembly to calculate the storage slot of the element at index `pos` of the dynamic array `arr`
          // following https://docs.soliditylang.org/en/v0.8.20/internals/layout_in_storage.html#mappings-and-dynamic-arrays.
  
          /// @solidity memory-safe-assembly
          assembly {
              mstore(0, arr.slot)
              slot := add(keccak256(0, 0x20), pos)
          }
          return slot.getAddressSlot();
      }
  
      /**
       * @dev Access an array in an "unsafe" way. Skips solidity "index-out-of-range" check.
       *
       * WARNING: Only use if you are certain `pos` is lower than the array length.
       */
      function unsafeAccess(bytes32[] storage arr, uint256 pos) internal pure returns (StorageSlot.Bytes32Slot storage) {
          bytes32 slot;
          // We use assembly to calculate the storage slot of the element at index `pos` of the dynamic array `arr`
          // following https://docs.soliditylang.org/en/v0.8.20/internals/layout_in_storage.html#mappings-and-dynamic-arrays.
  
          /// @solidity memory-safe-assembly
          assembly {
              mstore(0, arr.slot)
              slot := add(keccak256(0, 0x20), pos)
          }
          return slot.getBytes32Slot();
      }
  
      /**
       * @dev Access an array in an "unsafe" way. Skips solidity "index-out-of-range" check.
       *
       * WARNING: Only use if you are certain `pos` is lower than the array length.
       */
      function unsafeAccess(uint256[] storage arr, uint256 pos) internal pure returns (StorageSlot.Uint256Slot storage) {
          bytes32 slot;
          // We use assembly to calculate the storage slot of the element at index `pos` of the dynamic array `arr`
          // following https://docs.soliditylang.org/en/v0.8.20/internals/layout_in_storage.html#mappings-and-dynamic-arrays.
  
          /// @solidity memory-safe-assembly
          assembly {
              mstore(0, arr.slot)
              slot := add(keccak256(0, 0x20), pos)
          }
          return slot.getUint256Slot();
      }
  
      /**
       * @dev Access an array in an "unsafe" way. Skips solidity "index-out-of-range" check.
       *
       * WARNING: Only use if you are certain `pos` is lower than the array length.
       */
      function unsafeMemoryAccess(uint256[] memory arr, uint256 pos) internal pure returns (uint256 res) {
          assembly {
              res := mload(add(add(arr, 0x20), mul(pos, 0x20)))
          }
      }
  
      /**
       * @dev Access an array in an "unsafe" way. Skips solidity "index-out-of-range" check.
       *
       * WARNING: Only use if you are certain `pos` is lower than the array length.
       */
      function unsafeMemoryAccess(address[] memory arr, uint256 pos) internal pure returns (address res) {
          assembly {
              res := mload(add(add(arr, 0x20), mul(pos, 0x20)))
          }
      }
  }
  
  // File: @openzeppelin/contracts/utils/Context.sol
  
  
  // OpenZeppelin Contracts (last updated v5.0.1) (utils/Context.sol)
  
  pragma solidity ^0.8.20;
  
  /**
   * @dev Provides information about the current execution context, including the
   * sender of the transaction and its data. While these are generally available
   * via msg.sender and msg.data, they should not be accessed in such a direct
   * manner, since when dealing with meta-transactions the account sending and
   * paying for execution may not be the actual sender (as far as an application
   * is concerned).
   *
   * This contract is only required for intermediate, library-like contracts.
   */
  abstract contract Context {
      function _msgSender() internal view virtual returns (address) {
          return msg.sender;
      }
  
      function _msgData() internal view virtual returns (bytes calldata) {
          return msg.data;
      }
  
      function _contextSuffixLength() internal view virtual returns (uint256) {
          return 0;
      }
  }
  
  // File: @openzeppelin/contracts/access/Ownable.sol
  
  
  // OpenZeppelin Contracts (last updated v5.0.0) (access/Ownable.sol)
  
  pragma solidity ^0.8.20;
  
  
  /**
   * @dev Contract module which provides a basic access control mechanism, where
   * there is an account (an owner) that can be granted exclusive access to
   * specific functions.
   *
   * The initial owner is set to the address provided by the deployer. This can
   * later be changed with {transferOwnership}.
   *
   * This module is used through inheritance. It will make available the modifier
   * `onlyOwner`, which can be applied to your functions to restrict their use to
   * the owner.
   */
  abstract contract Ownable is Context {
      address private _owner;
  
      /**
       * @dev The caller account is not authorized to perform an operation.
       */
      error OwnableUnauthorizedAccount(address account);
  
      /**
       * @dev The owner is not a valid owner account. (eg. `address(0)`)
       */
      error OwnableInvalidOwner(address owner);
  
      event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
  
      /**
       * @dev Initializes the contract setting the address provided by the deployer as the initial owner.
       */
      constructor(address initialOwner) {
          if (initialOwner == address(0)) {
              revert OwnableInvalidOwner(address(0));
          }
          _transferOwnership(initialOwner);
      }
  
      /**
       * @dev Throws if called by any account other than the owner.
       */
      modifier onlyOwner() {
          _checkOwner();
          _;
      }
  
      /**
       * @dev Returns the address of the current owner.
       */
      function owner() public view virtual returns (address) {
          return _owner;
      }
  
      /**
       * @dev Throws if the sender is not the owner.
       */
      function _checkOwner() internal view virtual {
          if (owner() != _msgSender()) {
              revert OwnableUnauthorizedAccount(_msgSender());
          }
      }
  
      /**
       * @dev Leaves the contract without owner. It will not be possible to call
       * `onlyOwner` functions. Can only be called by the current owner.
       *
       * NOTE: Renouncing ownership will leave the contract without an owner,
       * thereby disabling any functionality that is only available to the owner.
       */
      function renounceOwnership() public virtual onlyOwner {
          _transferOwnership(address(0));
      }
  
      /**
       * @dev Transfers ownership of the contract to a new account (`newOwner`).
       * Can only be called by the current owner.
       */
      function transferOwnership(address newOwner) public virtual onlyOwner {
          if (newOwner == address(0)) {
              revert OwnableInvalidOwner(address(0));
          }
          _transferOwnership(newOwner);
      }
  
      /**
       * @dev Transfers ownership of the contract to a new account (`newOwner`).
       * Internal function without access restriction.
       */
      function _transferOwnership(address newOwner) internal virtual {
          address oldOwner = _owner;
          _owner = newOwner;
          emit OwnershipTransferred(oldOwner, newOwner);
      }
  }
  
  // File: @openzeppelin/contracts/utils/introspection/IERC165.sol
  
  
  // OpenZeppelin Contracts (last updated v5.0.0) (utils/introspection/IERC165.sol)
  
  pragma solidity ^0.8.20;
  
  /**
   * @dev Interface of the ERC165 standard, as defined in the
   * https://eips.ethereum.org/EIPS/eip-165[EIP].
   *
   * Implementers can declare support of contract interfaces, which can then be
   * queried by others ({ERC165Checker}).
   *
   * For an implementation, see {ERC165}.
   */
  interface IERC165 {
      /**
       * @dev Returns true if this contract implements the interface defined by
       * `interfaceId`. See the corresponding
       * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
       * to learn more about how these ids are created.
       *
       * This function call must use less than 30 000 gas.
       */
      function supportsInterface(bytes4 interfaceId) external view returns (bool);
  }
  
  // File: @openzeppelin/contracts/utils/introspection/ERC165.sol
  
  
  // OpenZeppelin Contracts (last updated v5.0.0) (utils/introspection/ERC165.sol)
  
  pragma solidity ^0.8.20;
  
  
  /**
   * @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);
   * }
   * ```
   */
  abstract contract ERC165 is IERC165 {
      /**
       * @dev See {IERC165-supportsInterface}.
       */
      function supportsInterface(bytes4 interfaceId) public view virtual returns (bool) {
          return interfaceId == type(IERC165).interfaceId;
      }
  }
  
  // File: @openzeppelin/contracts/token/ERC1155/IERC1155Receiver.sol
  
  
  // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC1155/IERC1155Receiver.sol)
  
  pragma solidity ^0.8.20;
  
  
  /**
   * @dev Interface that must be implemented by smart contracts in order to receive
   * ERC-1155 token transfers.
   */
  interface IERC1155Receiver is IERC165 {
      /**
       * @dev Handles the receipt of a single ERC1155 token type. This function is
       * called at the end of a `safeTransferFrom` after the balance has been updated.
       *
       * NOTE: To accept the transfer, this must return
       * `bytes4(keccak256("onERC1155Received(address,address,uint256,uint256,bytes)"))`
       * (i.e. 0xf23a6e61, or its own function selector).
       *
       * @param operator The address which initiated the transfer (i.e. msg.sender)
       * @param from The address which previously owned the token
       * @param id The ID of the token being transferred
       * @param value The amount of tokens being transferred
       * @param data Additional data with no specified format
       * @return `bytes4(keccak256("onERC1155Received(address,address,uint256,uint256,bytes)"))` if transfer is allowed
       */
      function onERC1155Received(
          address operator,
          address from,
          uint256 id,
          uint256 value,
          bytes calldata data
      ) external returns (bytes4);
  
      /**
       * @dev Handles the receipt of a multiple ERC1155 token types. This function
       * is called at the end of a `safeBatchTransferFrom` after the balances have
       * been updated.
       *
       * NOTE: To accept the transfer(s), this must return
       * `bytes4(keccak256("onERC1155BatchReceived(address,address,uint256[],uint256[],bytes)"))`
       * (i.e. 0xbc197c81, or its own function selector).
       *
       * @param operator The address which initiated the batch transfer (i.e. msg.sender)
       * @param from The address which previously owned the token
       * @param ids An array containing ids of each token being transferred (order and length must match values array)
       * @param values An array containing amounts of each token being transferred (order and length must match ids array)
       * @param data Additional data with no specified format
       * @return `bytes4(keccak256("onERC1155BatchReceived(address,address,uint256[],uint256[],bytes)"))` if transfer is allowed
       */
      function onERC1155BatchReceived(
          address operator,
          address from,
          uint256[] calldata ids,
          uint256[] calldata values,
          bytes calldata data
      ) external returns (bytes4);
  }
  
  // File: @openzeppelin/contracts/token/ERC1155/IERC1155.sol
  
  
  // OpenZeppelin Contracts (last updated v5.0.1) (token/ERC1155/IERC1155.sol)
  
  pragma solidity ^0.8.20;
  
  
  /**
   * @dev Required interface of an ERC1155 compliant contract, as defined in the
   * https://eips.ethereum.org/EIPS/eip-1155[EIP].
   */
  interface IERC1155 is IERC165 {
      /**
       * @dev Emitted when `value` amount of tokens of 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 value 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 a `value` amount of tokens of type `id` from `from` to `to`.
       *
       * WARNING: This function can potentially allow a reentrancy attack when transferring tokens
       * to an untrusted contract, when invoking {onERC1155Received} on the receiver.
       * Ensure to follow the checks-effects-interactions pattern and consider employing
       * reentrancy guards when interacting with untrusted contracts.
       *
       * 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 `value` 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 value, bytes calldata data) external;
  
      /**
       * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {safeTransferFrom}.
       *
       * WARNING: This function can potentially allow a reentrancy attack when transferring tokens
       * to an untrusted contract, when invoking {onERC1155BatchReceived} on the receiver.
       * Ensure to follow the checks-effects-interactions pattern and consider employing
       * reentrancy guards when interacting with untrusted contracts.
       *
       * Emits either a {TransferSingle} or a {TransferBatch} event, depending on the length of the array arguments.
       *
       * Requirements:
       *
       * - `ids` and `values` 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 values,
          bytes calldata data
      ) external;
  }
  
  // File: @openzeppelin/contracts/token/ERC1155/extensions/IERC1155MetadataURI.sol
  
  
  // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC1155/extensions/IERC1155MetadataURI.sol)
  
  pragma solidity ^0.8.20;
  
  
  /**
   * @dev Interface of the optional ERC1155MetadataExtension interface, as defined
   * in the https://eips.ethereum.org/EIPS/eip-1155#metadata-extensions[EIP].
   */
  interface IERC1155MetadataURI is IERC1155 {
      /**
       * @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);
  }
  
  // File: @openzeppelin/contracts/token/ERC1155/ERC1155.sol
  
  
  // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC1155/ERC1155.sol)
  
  pragma solidity ^0.8.20;
  
  
  
  
  
  
  
  
  /**
   * @dev Implementation of the basic standard multi-token.
   * See https://eips.ethereum.org/EIPS/eip-1155
   * Originally based on code by Enjin: https://github.com/enjin/erc-1155
   */
  abstract contract ERC1155 is Context, ERC165, IERC1155, IERC1155MetadataURI, IERC1155Errors {
      using Arrays for uint256[];
      using Arrays for address[];
  
      mapping(uint256 id => mapping(address account => uint256)) private _balances;
  
      mapping(address account => mapping(address operator => bool)) private _operatorApprovals;
  
      // Used as the URI for all token types by relying on ID substitution, e.g. https://token-cdn-domain/{id}.json
      string private _uri;
  
      /**
       * @dev See {_setURI}.
       */
      constructor(string memory uri_) {
          _setURI(uri_);
      }
  
      /**
       * @dev See {IERC165-supportsInterface}.
       */
      function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165, IERC165) returns (bool) {
          return
              interfaceId == type(IERC1155).interfaceId ||
              interfaceId == type(IERC1155MetadataURI).interfaceId ||
              super.supportsInterface(interfaceId);
      }
  
      /**
       * @dev See {IERC1155MetadataURI-uri}.
       *
       * This implementation returns the same URI for *all* token types. It relies
       * on the token type ID substitution mechanism
       * https://eips.ethereum.org/EIPS/eip-1155#metadata[defined in the EIP].
       *
       * Clients calling this function must replace the `\{id\}` substring with the
       * actual token type ID.
       */
      function uri(uint256 /* id */) public view virtual returns (string memory) {
          return _uri;
      }
  
      /**
       * @dev See {IERC1155-balanceOf}.
       */
      function balanceOf(address account, uint256 id) public view virtual returns (uint256) {
          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 returns (uint256[] memory) {
          if (accounts.length != ids.length) {
              revert ERC1155InvalidArrayLength(ids.length, accounts.length);
          }
  
          uint256[] memory batchBalances = new uint256[](accounts.length);
  
          for (uint256 i = 0; i < accounts.length; ++i) {
              batchBalances[i] = balanceOf(accounts.unsafeMemoryAccess(i), ids.unsafeMemoryAccess(i));
          }
  
          return batchBalances;
      }
  
      /**
       * @dev See {IERC1155-setApprovalForAll}.
       */
      function setApprovalForAll(address operator, bool approved) public virtual {
          _setApprovalForAll(_msgSender(), operator, approved);
      }
  
      /**
       * @dev See {IERC1155-isApprovedForAll}.
       */
      function isApprovedForAll(address account, address operator) public view virtual returns (bool) {
          return _operatorApprovals[account][operator];
      }
  
      /**
       * @dev See {IERC1155-safeTransferFrom}.
       */
      function safeTransferFrom(address from, address to, uint256 id, uint256 value, bytes memory data) public virtual {
          address sender = _msgSender();
          if (from != sender && !isApprovedForAll(from, sender)) {
              revert ERC1155MissingApprovalForAll(sender, from);
          }
          _safeTransferFrom(from, to, id, value, data);
      }
  
      /**
       * @dev See {IERC1155-safeBatchTransferFrom}.
       */
      function safeBatchTransferFrom(
          address from,
          address to,
          uint256[] memory ids,
          uint256[] memory values,
          bytes memory data
      ) public virtual {
          address sender = _msgSender();
          if (from != sender && !isApprovedForAll(from, sender)) {
              revert ERC1155MissingApprovalForAll(sender, from);
          }
          _safeBatchTransferFrom(from, to, ids, values, data);
      }
  
      /**
       * @dev Transfers a `value` amount of tokens of type `id` from `from` to `to`. Will mint (or burn) if `from`
       * (or `to`) is the zero address.
       *
       * Emits a {TransferSingle} event if the arrays contain one element, and {TransferBatch} otherwise.
       *
       * Requirements:
       *
       * - If `to` refers to a smart contract, it must implement either {IERC1155Receiver-onERC1155Received}
       *   or {IERC1155Receiver-onERC1155BatchReceived} and return the acceptance magic value.
       * - `ids` and `values` must have the same length.
       *
       * NOTE: The ERC-1155 acceptance check is not performed in this function. See {_updateWithAcceptanceCheck} instead.
       */
      function _update(address from, address to, uint256[] memory ids, uint256[] memory values) internal virtual {
          if (ids.length != values.length) {
              revert ERC1155InvalidArrayLength(ids.length, values.length);
          }
  
          address operator = _msgSender();
  
          for (uint256 i = 0; i < ids.length; ++i) {
              uint256 id = ids.unsafeMemoryAccess(i);
              uint256 value = values.unsafeMemoryAccess(i);
  
              if (from != address(0)) {
                  uint256 fromBalance = _balances[id][from];
                  if (fromBalance < value) {
                      revert ERC1155InsufficientBalance(from, fromBalance, value, id);
                  }
                  unchecked {
                      // Overflow not possible: value <= fromBalance
                      _balances[id][from] = fromBalance - value;
                  }
              }
  
              if (to != address(0)) {
                  _balances[id][to] += value;
              }
          }
  
          if (ids.length == 1) {
              uint256 id = ids.unsafeMemoryAccess(0);
              uint256 value = values.unsafeMemoryAccess(0);
              emit TransferSingle(operator, from, to, id, value);
          } else {
              emit TransferBatch(operator, from, to, ids, values);
          }
      }
  
      /**
       * @dev Version of {_update} that performs the token acceptance check by calling
       * {IERC1155Receiver-onERC1155Received} or {IERC1155Receiver-onERC1155BatchReceived} on the receiver address if it
       * contains code (eg. is a smart contract at the moment of execution).
       *
       * IMPORTANT: Overriding this function is discouraged because it poses a reentrancy risk from the receiver. So any
       * update to the contract state after this function would break the check-effect-interaction pattern. Consider
       * overriding {_update} instead.
       */
      function _updateWithAcceptanceCheck(
          address from,
          address to,
          uint256[] memory ids,
          uint256[] memory values,
          bytes memory data
      ) internal virtual {
          _update(from, to, ids, values);
          if (to != address(0)) {
              address operator = _msgSender();
              if (ids.length == 1) {
                  uint256 id = ids.unsafeMemoryAccess(0);
                  uint256 value = values.unsafeMemoryAccess(0);
                  _doSafeTransferAcceptanceCheck(operator, from, to, id, value, data);
              } else {
                  _doSafeBatchTransferAcceptanceCheck(operator, from, to, ids, values, data);
              }
          }
      }
  
      /**
       * @dev Transfers a `value` tokens of token type `id` from `from` to `to`.
       *
       * Emits a {TransferSingle} event.
       *
       * Requirements:
       *
       * - `to` cannot be the zero address.
       * - `from` must have a balance of tokens of type `id` of at least `value` 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 value, bytes memory data) internal {
          if (to == address(0)) {
              revert ERC1155InvalidReceiver(address(0));
          }
          if (from == address(0)) {
              revert ERC1155InvalidSender(address(0));
          }
          (uint256[] memory ids, uint256[] memory values) = _asSingletonArrays(id, value);
          _updateWithAcceptanceCheck(from, to, ids, values, data);
      }
  
      /**
       * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {_safeTransferFrom}.
       *
       * Emits a {TransferBatch} event.
       *
       * Requirements:
       *
       * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155BatchReceived} and return the
       * acceptance magic value.
       * - `ids` and `values` must have the same length.
       */
      function _safeBatchTransferFrom(
          address from,
          address to,
          uint256[] memory ids,
          uint256[] memory values,
          bytes memory data
      ) internal {
          if (to == address(0)) {
              revert ERC1155InvalidReceiver(address(0));
          }
          if (from == address(0)) {
              revert ERC1155InvalidSender(address(0));
          }
          _updateWithAcceptanceCheck(from, to, ids, values, data);
      }
  
      /**
       * @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 values 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) internal virtual {
          _uri = newuri;
      }
  
      /**
       * @dev Creates a `value` amount of tokens of 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 value, bytes memory data) internal {
          if (to == address(0)) {
              revert ERC1155InvalidReceiver(address(0));
          }
          (uint256[] memory ids, uint256[] memory values) = _asSingletonArrays(id, value);
          _updateWithAcceptanceCheck(address(0), to, ids, values, data);
      }
  
      /**
       * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {_mint}.
       *
       * Emits a {TransferBatch} event.
       *
       * Requirements:
       *
       * - `ids` and `values` must have the same length.
       * - `to` cannot be the zero address.
       * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155BatchReceived} and return the
       * acceptance magic value.
       */
      function _mintBatch(address to, uint256[] memory ids, uint256[] memory values, bytes memory data) internal {
          if (to == address(0)) {
              revert ERC1155InvalidReceiver(address(0));
          }
          _updateWithAcceptanceCheck(address(0), to, ids, values, data);
      }
  
      /**
       * @dev Destroys a `value` amount of tokens of type `id` from `from`
       *
       * Emits a {TransferSingle} event.
       *
       * Requirements:
       *
       * - `from` cannot be the zero address.
       * - `from` must have at least `value` amount of tokens of type `id`.
       */
      function _burn(address from, uint256 id, uint256 value) internal {
          if (from == address(0)) {
              revert ERC1155InvalidSender(address(0));
          }
          (uint256[] memory ids, uint256[] memory values) = _asSingletonArrays(id, value);
          _updateWithAcceptanceCheck(from, address(0), ids, values, "");
      }
  
      /**
       * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {_burn}.
       *
       * Emits a {TransferBatch} event.
       *
       * Requirements:
       *
       * - `from` cannot be the zero address.
       * - `from` must have at least `value` amount of tokens of type `id`.
       * - `ids` and `values` must have the same length.
       */
      function _burnBatch(address from, uint256[] memory ids, uint256[] memory values) internal {
          if (from == address(0)) {
              revert ERC1155InvalidSender(address(0));
          }
          _updateWithAcceptanceCheck(from, address(0), ids, values, "");
      }
  
      /**
       * @dev Approve `operator` to operate on all of `owner` tokens
       *
       * Emits an {ApprovalForAll} event.
       *
       * Requirements:
       *
       * - `operator` cannot be the zero address.
       */
      function _setApprovalForAll(address owner, address operator, bool approved) internal virtual {
          if (operator == address(0)) {
              revert ERC1155InvalidOperator(address(0));
          }
          _operatorApprovals[owner][operator] = approved;
          emit ApprovalForAll(owner, operator, approved);
      }
  
      /**
       * @dev Performs an acceptance check by calling {IERC1155-onERC1155Received} on the `to` address
       * if it contains code at the moment of execution.
       */
      function _doSafeTransferAcceptanceCheck(
          address operator,
          address from,
          address to,
          uint256 id,
          uint256 value,
          bytes memory data
      ) private {
          if (to.code.length > 0) {
              try IERC1155Receiver(to).onERC1155Received(operator, from, id, value, data) returns (bytes4 response) {
                  if (response != IERC1155Receiver.onERC1155Received.selector) {
                      // Tokens rejected
                      revert ERC1155InvalidReceiver(to);
                  }
              } catch (bytes memory reason) {
                  if (reason.length == 0) {
                      // non-ERC1155Receiver implementer
                      revert ERC1155InvalidReceiver(to);
                  } else {
                      /// @solidity memory-safe-assembly
                      assembly {
                          revert(add(32, reason), mload(reason))
                      }
                  }
              }
          }
      }
  
      /**
       * @dev Performs a batch acceptance check by calling {IERC1155-onERC1155BatchReceived} on the `to` address
       * if it contains code at the moment of execution.
       */
      function _doSafeBatchTransferAcceptanceCheck(
          address operator,
          address from,
          address to,
          uint256[] memory ids,
          uint256[] memory values,
          bytes memory data
      ) private {
          if (to.code.length > 0) {
              try IERC1155Receiver(to).onERC1155BatchReceived(operator, from, ids, values, data) returns (
                  bytes4 response
              ) {
                  if (response != IERC1155Receiver.onERC1155BatchReceived.selector) {
                      // Tokens rejected
                      revert ERC1155InvalidReceiver(to);
                  }
              } catch (bytes memory reason) {
                  if (reason.length == 0) {
                      // non-ERC1155Receiver implementer
                      revert ERC1155InvalidReceiver(to);
                  } else {
                      /// @solidity memory-safe-assembly
                      assembly {
                          revert(add(32, reason), mload(reason))
                      }
                  }
              }
          }
      }
  
      /**
       * @dev Creates an array in memory with only one value for each of the elements provided.
       */
      function _asSingletonArrays(
          uint256 element1,
          uint256 element2
      ) private pure returns (uint256[] memory array1, uint256[] memory array2) {
          /// @solidity memory-safe-assembly
          assembly {
              // Load the free memory pointer
              array1 := mload(0x40)
              // Set array length to 1
              mstore(array1, 1)
              // Store the single element at the next word after the length (where content starts)
              mstore(add(array1, 0x20), element1)
  
              // Repeat for next array locating it right after the first array
              array2 := add(array1, 0x40)
              mstore(array2, 1)
              mstore(add(array2, 0x20), element2)
  
              // Update the free memory pointer by pointing after the second array
              mstore(0x40, add(array2, 0x40))
          }
      }
  }
  
  // File: @openzeppelin/contracts/token/ERC1155/extensions/ERC1155Burnable.sol
  
  
  // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC1155/extensions/ERC1155Burnable.sol)
  
  pragma solidity ^0.8.20;
  
  
  /**
   * @dev Extension of {ERC1155} that allows token holders to destroy both their
   * own tokens and those that they have been approved to use.
   */
  abstract contract ERC1155Burnable is ERC1155 {
      function burn(address account, uint256 id, uint256 value) public virtual {
          if (account != _msgSender() && !isApprovedForAll(account, _msgSender())) {
              revert ERC1155MissingApprovalForAll(_msgSender(), account);
          }
  
          _burn(account, id, value);
      }
  
      function burnBatch(address account, uint256[] memory ids, uint256[] memory values) public virtual {
          if (account != _msgSender() && !isApprovedForAll(account, _msgSender())) {
              revert ERC1155MissingApprovalForAll(_msgSender(), account);
          }
  
          _burnBatch(account, ids, values);
      }
  }
  
  // File: Y.sol
  
  
  pragma solidity ^0.8.25;
  
  
  
  
  
  
  contract BASC is ERC1155Burnable, Ownable, ReentrancyGuard {
      mapping(uint256 => uint256) public pricesETH;
      mapping(uint256 => uint256) public pricesAPE;
      mapping(uint256 => uint256) public maxSupply;
      mapping(uint256 => uint256) public currentSupply;
      mapping(uint256 => string) private tokenURIs;
      bool public saleIsActive = false;
  
      string public name = "BASC Statues Founders Collection";
      string public symbol = "BASC";
  
      IERC20 public APE =
          IERC20(address(0x4d224452801ACEd8B2F0aebE155379bb5D594381));
  
      event PriceUpdate(
          uint256 tokenId,
          uint256 newPriceETH,
          uint256 newPriceAPE
      );
      event SupplyUpdate(uint256 tokenId, uint256 newMaxSupply);
      event Mint(address indexed to, uint256 tokenId, uint256 amount);
  
      constructor() ERC1155("") Ownable(msg.sender) {
          // Initial Mint
          _mint(address(0x424c0d0b13b9CEd6A5F0D8EEE1C1e0171857E98A), 0, 1, "");
          currentSupply[0]++;
          // Initial setup for token IDs and prices
          //2MAC
          pricesETH[0] = 6 ether;
          pricesAPE[0] = 14300 ether;
          maxSupply[0] = 2;
          //Biggie
          pricesETH[1] = 3 ether;
          pricesAPE[1] = 7145 ether;
          maxSupply[1] = 10;
          //SHORTY
          pricesETH[2] = 1 ether;
          pricesAPE[2] = 2382 ether;
          maxSupply[2] = 18;
          //TABLE TOP
          pricesETH[3] = 0.42 ether;
          pricesAPE[3] = 1000 ether;
          maxSupply[3] = 70;
      }
  
      function setPublicSale(bool _saleIsActive) public onlyOwner {
          saleIsActive = _saleIsActive;
      }
  
      function setURI(uint256 tokenId, string memory newURI) public onlyOwner {
          tokenURIs[tokenId] = newURI;
      }
  
      function setPrices(
          uint256 tokenId,
          uint256 newPriceETH,
          uint256 newPriceAPE
      ) public onlyOwner {
          pricesETH[tokenId] = newPriceETH;
          pricesAPE[tokenId] = newPriceAPE;
          emit PriceUpdate(tokenId, newPriceETH, newPriceAPE);
      }
  
      function setMaxSupply(uint256 tokenId, uint256 newMaxSupply)
          public
          onlyOwner
      {
          maxSupply[tokenId] = newMaxSupply;
          emit SupplyUpdate(tokenId, newMaxSupply);
      }
  
      function withdraw() public onlyOwner nonReentrant {
          uint256 balance = address(this).balance;
          require(balance > 0, "Nothing to withdraw!");
          (bool sent, ) = payable(msg.sender).call{value: balance}("");
          require(sent, "Failed to withdraw");
      }
  
      function mint(
          uint256 tokenId,
          uint256 payment,
          bool useAPE
      ) public payable nonReentrant {
          require((tokenId < 4 && tokenId >= 0), "Token ID does not exist");
          require(saleIsActive, "Sale is not active");
          require(
              currentSupply[tokenId] < maxSupply[tokenId],
              "Max supply reached"
          );
          require(
              useAPE
                  ? (APE.balanceOf(msg.sender) >= payment &&
                      payment == pricesAPE[tokenId])
                  : (msg.value == payment && payment == pricesETH[tokenId]),
              "Incorrect payment"
          );
  
          if (useAPE) {
              APE.transferFrom(msg.sender, owner(), payment);
          }
  
          _mint(msg.sender, tokenId, 1, "");
          currentSupply[tokenId]++;
          emit Mint(msg.sender, tokenId, 1);
      }
  
      function uri(uint256 tokenId) public view override returns (string memory) {
          require(bytes(tokenURIs[tokenId]).length != 0, "URI not set");
          return tokenURIs[tokenId];
      }
  }