feat(contract): Introduce CustomRevert library for efficient reverts

Adds a new `CustomRevert` library to streamline and optimize custom error handling by using efficient assembly code.

contracts/src/utils/libraries/CustomRevert.sol

@@ -0,0 +1,35 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.0;
+
+/// @title Library for reverting with custom errors efficiently
+/// @notice Contains functions for reverting with custom errors with different argument types efficiently
+/// @dev To use this library, declare `using CustomRevert for bytes4;` and replace `revert CustomError()` with
+/// `CustomError.selector.revertWith()`
+/// @dev The functions may tamper with the free memory pointer but it is fine since the call context is exited immediately
+library CustomRevert {
+  /// @dev Reverts with the selector of a custom error in the scratch space
+  function revertWith(bytes4 selector) internal pure {
+    assembly ("memory-safe") {
+      mstore(0, selector)
+      revert(0, 0x04)
+    }
+  }
+
+  /// @dev Reverts with a custom error with a uint256 argument in the scratch space
+  function revertWith(bytes4 selector, uint256 value) internal pure {
+    assembly ("memory-safe") {
+      mstore(0, selector)
+      mstore(0x04, value)
+      revert(0, 0x24)
+    }
+  }
+
+  /// @dev Reverts with a custom error with an address argument in the scratch space
+  function revertWith(bytes4 selector, address addr) internal pure {
+    assembly ("memory-safe") {
+      mstore(0, selector)
+      mstore(0x04, and(addr, 0xffffffffffffffffffffffffffffffffffffffff))
+      revert(0, 0x24)
+    }
+  }
+}