@safe-global/safe-deployments 1.37.1 → 1.37.2

package/src/assets/v1.3.0/simulate_tx_accessor.json

@@ -2,11 +2,19 @@
   "released": true,
   "contractName": "SimulateTxAccessor",
   "version": "1.3.0",
-  "codeHash": "0xb3fb9763869f2c09a2ac5a425d2dd6060bf7ef46b3899049d71a711e71e00f04",
-  "addresses": {
-    "canonical": "0x59AD6735bCd8152B84860Cb256dD9e96b85F69Da",
-    "eip155": "0x727a77a074D1E6c4530e814F89E618a3298FC044",
-    "zksync": "0x4191E2e12E8BC5002424CE0c51f9947b02675a44"
+  "deployments": {
+    "canonical": {
+      "address": "0x59AD6735bCd8152B84860Cb256dD9e96b85F69Da",
+      "codeHash": "0xb3fb9763869f2c09a2ac5a425d2dd6060bf7ef46b3899049d71a711e71e00f04"
+    },
+    "eip155": {
+      "address": "0x727a77a074D1E6c4530e814F89E618a3298FC044",
+      "codeHash": "0x66712e1d9161706f826d8d74a3cc03db0289b2530a1202f24d52986952b69a02"
+    },
+    "zksync": {
+      "address": "0x4191E2e12E8BC5002424CE0c51f9947b02675a44",
+      "codeHash": "0x18c486b76cb76981360e96ca4f90fc745fde6a8575b8c2b35ac98eab3856fd72"
+    }
   },
   "networkAddresses": {
     "1": ["canonical", "eip155"],
@@ -70,6 +78,7 @@
     "369": "canonical",
     "420": "eip155",
     "424": "canonical",
+    "480": "canonical",
     "570": "eip155",
     "588": "eip155",
     "592": "canonical",
@@ -182,6 +191,7 @@
     "42161": "canonical",
     "42170": "canonical",
     "42220": ["eip155", "canonical"],
+    "42793": "eip155",
     "43113": ["canonical", "eip155"],
     "43114": ["eip155", "canonical"],
     "43288": "eip155",
@@ -201,6 +211,7 @@
     "73799": "canonical",
     "80001": "canonical",
     "80002": "canonical",
+    "80084": "canonical",
     "80085": ["canonical", "eip155"],
     "81457": "canonical",
     "83291": "canonical",
@@ -208,6 +219,7 @@
     "84532": ["eip155", "canonical"],
     "103454": "eip155",
     "111188": "canonical",
+    "128123": ["eip155", "canonical"],
     "167000": ["eip155", "canonical"],
     "167008": "canonical",
     "167009": ["eip155", "canonical"],

package/src/assets/v1.4.1/compatibility_fallback_handler.json

@@ -2,9 +2,11 @@
   "released": true,
   "contractName": "CompatibilityFallbackHandler",
   "version": "1.4.1",
-  "codeHash": "0x7c6007a5d711cea8dfd5d91f5940ec29c7f200fe511eb1fc1397b367af3c42f9",
-  "addresses": {
-    "canonical": "0xfd0732Dc9E303f09fCEf3a7388Ad10A83459Ec99"
+  "deployments": {
+    "canonical": {
+      "address": "0xfd0732Dc9E303f09fCEf3a7388Ad10A83459Ec99",
+      "codeHash": "0x7c6007a5d711cea8dfd5d91f5940ec29c7f200fe511eb1fc1397b367af3c42f9"
+    }
   },
   "networkAddresses": {
     "1": "canonical",
@@ -27,7 +29,9 @@
     "336": "canonical",
     "338": "canonical",
     "369": "canonical",
+    "480": "canonical",
     "530": "canonical",
+    "592": "canonical",
     "690": "canonical",
     "919": "canonical",
     "1030": "canonical",
@@ -57,6 +61,7 @@
     "5000": "canonical",
     "5003": "canonical",
     "6001": "canonical",
+    "6322": "canonical",
     "7000": "canonical",
     "7001": "canonical",
     "7171": "canonical",

package/src/assets/v1.4.1/create_call.json

@@ -2,9 +2,11 @@
   "released": true,
   "contractName": "CreateCall",
   "version": "1.4.1",
-  "codeHash": "0x2b3060c55fcb8275653e99ad511a71f67ba76934ed66a7d74d6e68b52afff889",
-  "addresses": {
-    "canonical": "0x9b35Af71d77eaf8d7e40252370304687390A1A52"
+  "deployments": {
+    "canonical": {
+      "address": "0x9b35Af71d77eaf8d7e40252370304687390A1A52",
+      "codeHash": "0x2b3060c55fcb8275653e99ad511a71f67ba76934ed66a7d74d6e68b52afff889"
+    }
   },
   "networkAddresses": {
     "1": "canonical",
@@ -27,7 +29,9 @@
     "336": "canonical",
     "338": "canonical",
     "369": "canonical",
+    "480": "canonical",
     "530": "canonical",
+    "592": "canonical",
     "690": "canonical",
     "919": "canonical",
     "1030": "canonical",
@@ -57,6 +61,7 @@
     "5000": "canonical",
     "5003": "canonical",
     "6001": "canonical",
+    "6322": "canonical",
     "7000": "canonical",
     "7001": "canonical",
     "7171": "canonical",

package/src/assets/v1.4.1/multi_send.json

@@ -2,9 +2,11 @@
   "released": true,
   "contractName": "MultiSend",
   "version": "1.4.1",
-  "codeHash": "0x0e4f7fc66550a322d1e7688e181b75e217e662a4f3f4d6a29b22bc61217c4b77",
-  "addresses": {
-    "canonical": "0x38869bf66a61cF6bDB996A6aE40D5853Fd43B526"
+  "deployments": {
+    "canonical": {
+      "address": "0x38869bf66a61cF6bDB996A6aE40D5853Fd43B526",
+      "codeHash": "0x0e4f7fc66550a322d1e7688e181b75e217e662a4f3f4d6a29b22bc61217c4b77"
+    }
   },
   "networkAddresses": {
     "1": "canonical",
@@ -27,7 +29,9 @@
     "336": "canonical",
     "338": "canonical",
     "369": "canonical",
+    "480": "canonical",
     "530": "canonical",
+    "592": "canonical",
     "690": "canonical",
     "919": "canonical",
     "1030": "canonical",
@@ -57,6 +61,7 @@
     "5000": "canonical",
     "5003": "canonical",
     "6001": "canonical",
+    "6322": "canonical",
     "7000": "canonical",
     "7001": "canonical",
     "7171": "canonical",

package/src/assets/v1.4.1/multi_send_call_only.json

@@ -2,9 +2,11 @@
   "released": true,
   "contractName": "MultiSendCallOnly",
   "version": "1.4.1",
-  "codeHash": "0xecd5bd14a08c5d2122379900b2f272bdf107a7e92423c10dd5fe3254386c9939",
-  "addresses": {
-    "canonical": "0x9641d764fc13c8B624c04430C7356C1C7C8102e2"
+  "deployments": {
+    "canonical": {
+      "address": "0x9641d764fc13c8B624c04430C7356C1C7C8102e2",
+      "codeHash": "0xecd5bd14a08c5d2122379900b2f272bdf107a7e92423c10dd5fe3254386c9939"
+    }
   },
   "networkAddresses": {
     "1": "canonical",
@@ -27,7 +29,9 @@
     "336": "canonical",
     "338": "canonical",
     "369": "canonical",
+    "480": "canonical",
     "530": "canonical",
+    "592": "canonical",
     "690": "canonical",
     "919": "canonical",
     "1030": "canonical",
@@ -57,6 +61,7 @@
     "5000": "canonical",
     "5003": "canonical",
     "6001": "canonical",
+    "6322": "canonical",
     "7000": "canonical",
     "7001": "canonical",
     "7171": "canonical",

package/src/assets/v1.4.1/safe.json

@@ -2,9 +2,11 @@
   "released": true,
   "contractName": "Safe",
   "version": "1.4.1",
-  "codeHash": "0x1fe2df852ba3299d6534ef416eefa406e56ced995bca886ab7a553e6d0c5e1c4",
-  "addresses": {
-    "canonical": "0x41675C099F32341bf84BFc5382aF534df5C7461a"
+  "deployments": {
+    "canonical": {
+      "address": "0x41675C099F32341bf84BFc5382aF534df5C7461a",
+      "codeHash": "0x1fe2df852ba3299d6534ef416eefa406e56ced995bca886ab7a553e6d0c5e1c4"
+    }
   },
   "networkAddresses": {
     "1": "canonical",
@@ -27,7 +29,9 @@
     "336": "canonical",
     "338": "canonical",
     "369": "canonical",
+    "480": "canonical",
     "530": "canonical",
+    "592": "canonical",
     "690": "canonical",
     "919": "canonical",
     "1030": "canonical",
@@ -57,6 +61,7 @@
     "5000": "canonical",
     "5003": "canonical",
     "6001": "canonical",
+    "6322": "canonical",
     "7000": "canonical",
     "7001": "canonical",
     "7171": "canonical",

package/src/assets/v1.4.1/safe_l2.json

@@ -2,9 +2,11 @@
   "released": true,
   "contractName": "SafeL2",
   "version": "1.4.1",
-  "codeHash": "0xb1f926978a0f44a2c0ec8fe822418ae969bd8c3f18d61e5103100339894f81ff",
-  "addresses": {
-    "canonical": "0x29fcB43b46531BcA003ddC8FCB67FFE91900C762"
+  "deployments": {
+    "canonical": {
+      "address": "0x29fcB43b46531BcA003ddC8FCB67FFE91900C762",
+      "codeHash": "0xb1f926978a0f44a2c0ec8fe822418ae969bd8c3f18d61e5103100339894f81ff"
+    }
   },
   "networkAddresses": {
     "1": "canonical",
@@ -27,7 +29,9 @@
     "336": "canonical",
     "338": "canonical",
     "369": "canonical",
+    "480": "canonical",
     "530": "canonical",
+    "592": "canonical",
     "690": "canonical",
     "919": "canonical",
     "1030": "canonical",
@@ -57,6 +61,7 @@
     "5000": "canonical",
     "5003": "canonical",
     "6001": "canonical",
+    "6322": "canonical",
     "7000": "canonical",
     "7001": "canonical",
     "7171": "canonical",

package/src/assets/v1.4.1/safe_proxy_factory.json

@@ -2,9 +2,11 @@
   "released": true,
   "contractName": "SafeProxyFactory",
   "version": "1.4.1",
-  "codeHash": "0x50c3cdc4074750a7a974204a716c999edd37482f907608d960b2b025ee0b3317",
-  "addresses": {
-    "canonical": "0x4e1DCf7AD4e460CfD30791CCC4F9c8a4f820ec67"
+  "deployments": {
+    "canonical": {
+      "address": "0x4e1DCf7AD4e460CfD30791CCC4F9c8a4f820ec67",
+      "codeHash": "0x50c3cdc4074750a7a974204a716c999edd37482f907608d960b2b025ee0b3317"
+    }
   },
   "networkAddresses": {
     "1": "canonical",
@@ -27,7 +29,9 @@
     "336": "canonical",
     "338": "canonical",
     "369": "canonical",
+    "480": "canonical",
     "530": "canonical",
+    "592": "canonical",
     "690": "canonical",
     "919": "canonical",
     "1030": "canonical",
@@ -57,6 +61,7 @@
     "5000": "canonical",
     "5003": "canonical",
     "6001": "canonical",
+    "6322": "canonical",
     "7000": "canonical",
     "7001": "canonical",
     "7171": "canonical",

package/src/assets/v1.4.1/sign_message_lib.json

@@ -2,9 +2,11 @@
   "released": true,
   "contractName": "SignMessageLib",
   "version": "1.4.1",
-  "codeHash": "0x525c754a46b79e05543a59bb61e8de3c9eee0d955a59352409cbe67ea1077528",
-  "addresses": {
-    "canonical": "0xd53cd0aB83D845Ac265BE939c57F53AD838012c9"
+  "deployments": {
+    "canonical": {
+      "address": "0xd53cd0aB83D845Ac265BE939c57F53AD838012c9",
+      "codeHash": "0x525c754a46b79e05543a59bb61e8de3c9eee0d955a59352409cbe67ea1077528"
+    }
   },
   "networkAddresses": {
     "1": "canonical",
@@ -27,7 +29,9 @@
     "336": "canonical",
     "338": "canonical",
     "369": "canonical",
+    "480": "canonical",
     "530": "canonical",
+    "592": "canonical",
     "690": "canonical",
     "919": "canonical",
     "1030": "canonical",
@@ -57,6 +61,7 @@
     "5000": "canonical",
     "5003": "canonical",
     "6001": "canonical",
+    "6322": "canonical",
     "7000": "canonical",
     "7001": "canonical",
     "7171": "canonical",

package/src/assets/v1.4.1/simulate_tx_accessor.json

@@ -2,9 +2,11 @@
   "released": true,
   "contractName": "SimulateTxAccessor",
   "version": "1.4.1",
-  "codeHash": "0x91f82615581fc73b190b83d72e883608b25e392f72322035df1b13d51766cf8d",
-  "addresses": {
-    "canonical": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199"
+  "deployments": {
+    "canonical": {
+      "address": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
+      "codeHash": "0x91f82615581fc73b190b83d72e883608b25e392f72322035df1b13d51766cf8d"
+    }
   },
   "networkAddresses": {
     "1": "canonical",
@@ -27,7 +29,9 @@
     "336": "canonical",
     "338": "canonical",
     "369": "canonical",
+    "480": "canonical",
     "530": "canonical",
+    "592": "canonical",
     "690": "canonical",
     "919": "canonical",
     "1030": "canonical",
@@ -57,6 +61,7 @@
     "5000": "canonical",
     "5003": "canonical",
     "6001": "canonical",
+    "6322": "canonical",
     "7000": "canonical",
     "7001": "canonical",
     "7171": "canonical",

package/src/deployments.ts

@@ -0,0 +1,90 @@
+import { SingletonDeploymentJSON } from './types';
+
+// This is a file where all the deployments are consolidated
+// We do it in a separate file so we don't have to repeat comments about the array order and the type casting.
+// We use some specific types (like `AddressType`) in the `SingletonDeploymentJSON` type, but the TypeScript cannot infer that from the JSON files.
+// So we need to cast them to `SingletonDeploymentJSON` manually. The casting is valid because we have a test in `__tests__/assets.test.ts` that checks that the JSON files are valid.
+// The arrays are sorted by preference, which at the moment means from the most recent version to the oldest.
+// The arrays are prefixed with an underscore because they are not meant to be imported directly.
+
+import SimulateTxAccessor130 from './assets/v1.3.0/simulate_tx_accessor.json';
+import SimulateTxAccessor141 from './assets/v1.4.1/simulate_tx_accessor.json';
+
+const _ACCESSOR_DEPLOYMENTS = [SimulateTxAccessor141, SimulateTxAccessor130] as SingletonDeploymentJSON[];
+
+import ProxyFactory100 from './assets/v1.0.0/proxy_factory.json';
+import ProxyFactory111 from './assets/v1.1.1/proxy_factory.json';
+import ProxyFactory130 from './assets/v1.3.0/proxy_factory.json';
+import SafeProxyFactory141 from './assets/v1.4.1/safe_proxy_factory.json';
+
+const _FACTORY_DEPLOYMENTS = [
+  SafeProxyFactory141,
+  ProxyFactory130,
+  ProxyFactory111,
+  ProxyFactory100,
+] as SingletonDeploymentJSON[];
+
+import DefaultCallbackHandler130 from './assets/v1.1.1/default_callback_handler.json';
+
+const _DEFAULT_CALLBACK_HANDLER_DEPLOYMENTS = [DefaultCallbackHandler130] as SingletonDeploymentJSON[];
+
+import CompatibilityFallbackHandler130 from './assets/v1.3.0/compatibility_fallback_handler.json';
+import CompatibilityFallbackHandler141 from './assets/v1.4.1/compatibility_fallback_handler.json';
+
+const _COMPAT_FALLBACK_HANDLER_DEPLOYMENTS = [
+  CompatibilityFallbackHandler141,
+  CompatibilityFallbackHandler130,
+] as SingletonDeploymentJSON[];
+
+import Safe141 from './assets/v1.4.1/safe.json';
+import GnosisSafe130 from './assets/v1.3.0/gnosis_safe.json';
+import GnosisSafe120 from './assets/v1.2.0/gnosis_safe.json';
+import GnosisSafe111 from './assets/v1.1.1/gnosis_safe.json';
+import GnosisSafe100 from './assets/v1.0.0/gnosis_safe.json';
+
+const _SAFE_DEPLOYMENTS = [
+  Safe141,
+  GnosisSafe130,
+  GnosisSafe120,
+  GnosisSafe111,
+  GnosisSafe100,
+] as SingletonDeploymentJSON[];
+
+import SafeL2141 from './assets/v1.4.1/safe_l2.json';
+import GnosisSafeL2130 from './assets/v1.3.0/gnosis_safe_l2.json';
+
+const _SAFE_L2_DEPLOYMENTS = [SafeL2141, GnosisSafeL2130] as SingletonDeploymentJSON[];
+
+import MultiSend111 from './assets/v1.1.1/multi_send.json';
+import MultiSend130 from './assets/v1.3.0/multi_send.json';
+import MultiSend141 from './assets/v1.4.1/multi_send.json';
+
+const _MULTI_SEND_DEPLOYMENTS = [MultiSend141, MultiSend130, MultiSend111] as SingletonDeploymentJSON[];
+
+import MultiSendCallOnly130 from './assets/v1.3.0/multi_send_call_only.json';
+import MultiSendCallOnly141 from './assets/v1.4.1/multi_send_call_only.json';
+
+const _MULTI_SEND_CALL_ONLY_DEPLOYMENTS = [MultiSendCallOnly141, MultiSendCallOnly130] as SingletonDeploymentJSON[];
+
+import CreateCall130 from './assets/v1.3.0/create_call.json';
+import CreateCall141 from './assets/v1.4.1/create_call.json';
+
+const _CREATE_CALL_DEPLOYMENTS = [CreateCall141, CreateCall130] as SingletonDeploymentJSON[];
+
+import SignMessageLib130 from './assets/v1.3.0/sign_message_lib.json';
+import SignMessageLib141 from './assets/v1.4.1/sign_message_lib.json';
+
+const _SIGN_MESSAGE_LIB_DEPLOYMENTS = [SignMessageLib141, SignMessageLib130] as SingletonDeploymentJSON[];
+
+export {
+  _ACCESSOR_DEPLOYMENTS,
+  _FACTORY_DEPLOYMENTS,
+  _DEFAULT_CALLBACK_HANDLER_DEPLOYMENTS,
+  _COMPAT_FALLBACK_HANDLER_DEPLOYMENTS,
+  _SAFE_DEPLOYMENTS,
+  _SAFE_L2_DEPLOYMENTS,
+  _MULTI_SEND_DEPLOYMENTS,
+  _MULTI_SEND_CALL_ONLY_DEPLOYMENTS,
+  _CREATE_CALL_DEPLOYMENTS,
+  _SIGN_MESSAGE_LIB_DEPLOYMENTS,
+};

package/src/factories.ts

@@ -1,19 +1,21 @@
-import ProxyFactory100 from './assets/v1.0.0/proxy_factory.json';
-import ProxyFactory111 from './assets/v1.1.1/proxy_factory.json';
-import ProxyFactory130 from './assets/v1.3.0/proxy_factory.json';
-import SafeProxyFactory141 from './assets/v1.4.1/safe_proxy_factory.json';
-
-import { DeploymentFilter, SingletonDeployment, SingletonDeploymentJSON } from './types';
+import { DeploymentFilter, DeploymentFormats, SingletonDeployment, SingletonDeploymentV2 } from './types';
 import { findDeployment } from './utils';
+import { _FACTORY_DEPLOYMENTS } from './deployments';
 
-// This is a sorted array (newest to oldest)
-const factoryDeployments: SingletonDeploymentJSON[] = [
-  SafeProxyFactory141,
-  ProxyFactory130,
-  ProxyFactory111,
-  ProxyFactory100,
-];
-
+/**
+ * Finds the latest proxy factory deployment that matches the given filter.
+ * @param {DeploymentFilter} [filter] - The filter to apply when searching for the deployment.
+ * @returns {SingletonDeployment | undefined} - The found deployment or undefined if no deployment matches the filter.
+ */
 export const getProxyFactoryDeployment = (filter?: DeploymentFilter): SingletonDeployment | undefined => {
-  return findDeployment(filter, factoryDeployments);
+  return findDeployment(filter, _FACTORY_DEPLOYMENTS);
+};
+
+/**
+ * Finds all proxy factory deployments that match the given filter.
+ * @param {DeploymentFilter} [filter] - The filter to apply when searching for the deployments.
+ * @returns {SingletonDeploymentV2 | undefined} - The found deployments or undefined if no deployments match the filter.
+ */
+export const getProxyFactoryDeployments = (filter?: DeploymentFilter): SingletonDeploymentV2 | undefined => {
+  return findDeployment(filter, _FACTORY_DEPLOYMENTS, DeploymentFormats.MULTIPLE);
 };

package/src/handler.ts

@@ -1,35 +1,68 @@
-import DefaultCallbackHandler130 from './assets/v1.1.1/default_callback_handler.json';
-import CompatibilityFallbackHandler130 from './assets/v1.3.0/compatibility_fallback_handler.json';
-import CompatibilityFallbackHandler141 from './assets/v1.4.1/compatibility_fallback_handler.json';
-import { DeploymentFilter, SingletonDeployment, SingletonDeploymentJSON } from './types';
+import { DeploymentFilter, DeploymentFormats, SingletonDeployment, SingletonDeploymentV2 } from './types';
 import { findDeployment } from './utils';
+import { _DEFAULT_CALLBACK_HANDLER_DEPLOYMENTS, _COMPAT_FALLBACK_HANDLER_DEPLOYMENTS } from './deployments';
 
-// This is a sorted array (by preference)
-const defaultCallbackHandlerDeployments: SingletonDeploymentJSON[] = [DefaultCallbackHandler130];
-
+/**
+ * Get the default callback handler deployment based on the provided filter.
+ * @param {DeploymentFilter} [filter] - Optional filter to apply to the deployment search.
+ * @returns {SingletonDeployment | undefined} - The found deployment or undefined if not found.
+ */
 export const getDefaultCallbackHandlerDeployment = (filter?: DeploymentFilter): SingletonDeployment | undefined => {
-  return findDeployment(filter, defaultCallbackHandlerDeployments);
+  return findDeployment(filter, _DEFAULT_CALLBACK_HANDLER_DEPLOYMENTS);
 };
 
-// This is a sorted array (by preference)
-const compatFallbackHandlerDeployments: SingletonDeploymentJSON[] = [
-  CompatibilityFallbackHandler141,
-  CompatibilityFallbackHandler130,
-];
+/**
+ * Get all default callback handler deployments based on the provided filter.
+ * @param {DeploymentFilter} [filter] - Optional filter to apply to the deployment search.
+ * @returns {SingletonDeploymentV2 | undefined} - The found deployments in version 2 format or undefined if not found.
+ */
+export const getDefaultCallbackHandlerDeployments = (filter?: DeploymentFilter): SingletonDeploymentV2 | undefined => {
+  return findDeployment(filter, _DEFAULT_CALLBACK_HANDLER_DEPLOYMENTS, DeploymentFormats.MULTIPLE);
+};
 
+/**
+ * Get the compatibility fallback handler deployment based on the provided filter.
+ * @param {DeploymentFilter} [filter] - Optional filter to apply to the deployment search.
+ * @returns {SingletonDeployment | undefined} - The found deployment or undefined if not found.
+ */
 export const getCompatibilityFallbackHandlerDeployment = (
   filter?: DeploymentFilter,
 ): SingletonDeployment | undefined => {
-  return findDeployment(filter, compatFallbackHandlerDeployments);
+  return findDeployment(filter, _COMPAT_FALLBACK_HANDLER_DEPLOYMENTS);
 };
 
-// This is a sorted array (by preference)
-const fallbackHandlerDeployments: SingletonDeploymentJSON[] = [
-  CompatibilityFallbackHandler141,
-  CompatibilityFallbackHandler130,
-  DefaultCallbackHandler130,
-];
-
-export const getFallbackHandlerDeployment = (filter?: DeploymentFilter): SingletonDeployment | undefined => {
-  return findDeployment(filter, fallbackHandlerDeployments);
+/**
+ * Get all compatibility fallback handler deployments based on the provided filter.
+ * @param {DeploymentFilter} [filter] - Optional filter to apply to the deployment search.
+ * @returns {SingletonDeploymentV2 | undefined} - The found deployments in version 2 format or undefined if not found.
+ */
+export const getCompatibilityFallbackHandlerDeployments = (
+  filter?: DeploymentFilter,
+): SingletonDeploymentV2 | undefined => {
+  return findDeployment(filter, _COMPAT_FALLBACK_HANDLER_DEPLOYMENTS, DeploymentFormats.MULTIPLE);
 };
+
+/**
+ * Get the fallback handler deployment based on the provided filter. This method is an alias for `getCompatibilityFallbackHandlerDeployment`.
+ * Kept for backwards compatibility.
+ * @param {DeploymentFilter} [filter] - Optional filter to apply to the deployment search.
+ * @returns {SingletonDeployment | undefined} - The found deployment or undefined if not found.
+ */
+export const getFallbackHandlerDeployment = getCompatibilityFallbackHandlerDeployment;
+// Leaving the comment here so it's not a part of the JSDoc
+// Previously, the function code was this:
+// // This is a sorted array (by preference)
+// const fallbackHandlerDeployments: SingletonDeploymentJSON[] = [
+//   CompatibilityFallbackHandler141,
+//   CompatibilityFallbackHandler130,
+//   DefaultCallbackHandler130,
+// ];
+// export const getFallbackHandlerDeployment = (filter?: DeploymentFilter): SingletonDeployment | undefined => {
+//   return findDeployment(filter, fallbackHandlerDeployments);
+// };
+// The problem with the function is that there’s no possible filter that would make the function return the last element of the array
+// (DefaultCallbackHandler130 ), since we only allow to filter by version, networks and released flag. The only possible way is to have
+// the default callback handler deployed to a network where the compatibility fallback handler isn’t deployed, but we require the whole
+// suite of the contracts be deployed to a network.
+// Since we didn't want to enforce a preferred fallback handler on the deployments package level,
+// we decided to alias it to getCompatibilityFallbackHandlerDeployment (previously returned value)