@safe-global/safe-deployments 1.37.0 → 1.37.2

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

@@ -1,116 +1,127 @@
 {
-  "defaultAddress": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
   "released": true,
   "contractName": "SimulateTxAccessor",
   "version": "1.4.1",
+  "deployments": {
+    "canonical": {
+      "address": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
+      "codeHash": "0x91f82615581fc73b190b83d72e883608b25e392f72322035df1b13d51766cf8d"
+    }
+  },
   "networkAddresses": {
-    "1": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "5": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "10": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "25": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "31": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "40": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "41": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "56": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "71": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "97": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "100": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "137": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "155": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "169": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "250": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "252": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "255": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "336": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "338": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "369": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "690": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "919": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "1030": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "1101": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "1111": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "1112": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "1135": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "1284": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "1285": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "1287": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "1329": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "1442": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "1625": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "1729": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "2000": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "2039": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "2358": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "2810": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "3636": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "3776": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "4002": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "4157": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "4202": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "4337": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "4653": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "5000": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "5003": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "6001": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "7000": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "7001": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "7171": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "7560": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "7771": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "8192": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "8194": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "8453": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "9001": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "10242": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "10243": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "11235": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "13337": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "17000": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "17069": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "18233": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "23294": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "23295": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "32769": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "33101": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "34443": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "42161": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "42220": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "43114": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "54211": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "59140": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "59141": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "59144": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "80001": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "80085": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "81457": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "84531": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "84532": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "105105": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "111188": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "167000": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "167009": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "205205": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "444444": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "534351": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "534352": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "555666": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "713715": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "6038361": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "7225878": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "7777777": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "11155111": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "11155420": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "94204209": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "111557560": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "123420111": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "168587773": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "666666666": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "999999999": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "1313161554": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "1313161555": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "1666600000": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "1666700000": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199",
-    "88153591557": "0x3d4BA2E0884aa488718476ca2FB8Efc291A46199"
+    "1": "canonical",
+    "5": "canonical",
+    "10": "canonical",
+    "25": "canonical",
+    "31": "canonical",
+    "40": "canonical",
+    "41": "canonical",
+    "56": "canonical",
+    "71": "canonical",
+    "97": "canonical",
+    "100": "canonical",
+    "137": "canonical",
+    "155": "canonical",
+    "169": "canonical",
+    "250": "canonical",
+    "252": "canonical",
+    "255": "canonical",
+    "336": "canonical",
+    "338": "canonical",
+    "369": "canonical",
+    "480": "canonical",
+    "530": "canonical",
+    "592": "canonical",
+    "690": "canonical",
+    "919": "canonical",
+    "1030": "canonical",
+    "1101": "canonical",
+    "1111": "canonical",
+    "1112": "canonical",
+    "1135": "canonical",
+    "1284": "canonical",
+    "1285": "canonical",
+    "1287": "canonical",
+    "1329": "canonical",
+    "1337": "canonical",
+    "1442": "canonical",
+    "1625": "canonical",
+    "1729": "canonical",
+    "2000": "canonical",
+    "2039": "canonical",
+    "2358": "canonical",
+    "2810": "canonical",
+    "3636": "canonical",
+    "3776": "canonical",
+    "4002": "canonical",
+    "4157": "canonical",
+    "4202": "canonical",
+    "4337": "canonical",
+    "4653": "canonical",
+    "5000": "canonical",
+    "5003": "canonical",
+    "6001": "canonical",
+    "6322": "canonical",
+    "7000": "canonical",
+    "7001": "canonical",
+    "7171": "canonical",
+    "7560": "canonical",
+    "7771": "canonical",
+    "8192": "canonical",
+    "8194": "canonical",
+    "8453": "canonical",
+    "9001": "canonical",
+    "10242": "canonical",
+    "10243": "canonical",
+    "11235": "canonical",
+    "13337": "canonical",
+    "17000": "canonical",
+    "17069": "canonical",
+    "18233": "canonical",
+    "23294": "canonical",
+    "23295": "canonical",
+    "32769": "canonical",
+    "33101": "canonical",
+    "34443": "canonical",
+    "42161": "canonical",
+    "42220": "canonical",
+    "43114": "canonical",
+    "54211": "canonical",
+    "59140": "canonical",
+    "59141": "canonical",
+    "59144": "canonical",
+    "80001": "canonical",
+    "80085": "canonical",
+    "81457": "canonical",
+    "84531": "canonical",
+    "84532": "canonical",
+    "90001": "canonical",
+    "105105": "canonical",
+    "111188": "canonical",
+    "167000": "canonical",
+    "167009": "canonical",
+    "205205": "canonical",
+    "444444": "canonical",
+    "534351": "canonical",
+    "534352": "canonical",
+    "555666": "canonical",
+    "713715": "canonical",
+    "6038361": "canonical",
+    "7225878": "canonical",
+    "7777777": "canonical",
+    "11155111": "canonical",
+    "11155420": "canonical",
+    "94204209": "canonical",
+    "111557560": "canonical",
+    "123420111": "canonical",
+    "168587773": "canonical",
+    "666666666": "canonical",
+    "999999999": "canonical",
+    "1313161554": "canonical",
+    "1313161555": "canonical",
+    "1666600000": "canonical",
+    "1666700000": "canonical",
+    "88153591557": "canonical"
   },
   "abi": [
     {

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,16 +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 } from './types'
-import { findDeployment } from './utils'
-
-// This is a sorted array (newest to oldest)
-const factoryDeployments: SingletonDeployment[] = [
-    SafeProxyFactory141, ProxyFactory130, ProxyFactory111, ProxyFactory100
-]
+import { DeploymentFilter, DeploymentFormats, SingletonDeployment, SingletonDeploymentV2 } from './types';
+import { findDeployment } from './utils';
+import { _FACTORY_DEPLOYMENTS } from './deployments';
 
+/**
+ * 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,32 +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 } from './types'
-import { findDeployment } from './utils'
-
-// This is a sorted array (by preference)
-const defaultCallbackHandlerDeployments: SingletonDeployment[] = [
-  DefaultCallbackHandler130
-]
+import { DeploymentFilter, DeploymentFormats, SingletonDeployment, SingletonDeploymentV2 } from './types';
+import { findDeployment } from './utils';
+import { _DEFAULT_CALLBACK_HANDLER_DEPLOYMENTS, _COMPAT_FALLBACK_HANDLER_DEPLOYMENTS } from './deployments';
 
+/**
+ * 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: SingletonDeployment[] = [
-  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);
+};
 
-export const getCompatibilityFallbackHandlerDeployment = (filter?: DeploymentFilter): SingletonDeployment | undefined => {
-    return findDeployment(filter, compatFallbackHandlerDeployments)
-}
+/**
+ * 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, _COMPAT_FALLBACK_HANDLER_DEPLOYMENTS);
+};
 
-// This is a sorted array (by preference)
-const fallbackHandlerDeployments: SingletonDeployment[] = [
-  CompatibilityFallbackHandler141,  CompatibilityFallbackHandler130, DefaultCallbackHandler130
-]
+/**
+ * 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);
+};
 
-export const getFallbackHandlerDeployment = (filter?: DeploymentFilter): SingletonDeployment | undefined => {
-    return findDeployment(filter, fallbackHandlerDeployments)
-}
+/**
+ * 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)

package/src/index.ts

@@ -1,6 +1,6 @@
-export * from './types'
-export * from './safes'
-export * from './factories'
-export * from './libs'
-export * from './handler'
-export * from './accessors'
+export * from './types';
+export * from './safes';
+export * from './factories';
+export * from './libs';
+export * from './handler';
+export * from './accessors';

package/src/libs.ts

@@ -1,46 +1,80 @@
-import CreateCall130 from './assets/v1.3.0/create_call.json'
-import CreateCall141 from './assets/v1.4.1/create_call.json'
-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'
-import MultiSendCallOnly130 from './assets/v1.3.0/multi_send_call_only.json'
-import MultiSendCallOnly141 from './assets/v1.4.1/multi_send_call_only.json'
-import SignMessageLib130 from './assets/v1.3.0/sign_message_lib.json'
-import SignMessageLib141 from './assets/v1.4.1/sign_message_lib.json'
-import { DeploymentFilter, SingletonDeployment } from './types'
-import { findDeployment } from './utils'
-
-// This is a sorted array (by preference, currently we use 111 in most cases)
-const multiSendDeployments: SingletonDeployment[] = [
-  MultiSend141, MultiSend130, MultiSend111
-]
+import {
+  _CREATE_CALL_DEPLOYMENTS,
+  _MULTI_SEND_CALL_ONLY_DEPLOYMENTS,
+  _MULTI_SEND_DEPLOYMENTS,
+  _SIGN_MESSAGE_LIB_DEPLOYMENTS,
+} from './deployments';
+import { DeploymentFilter, DeploymentFormats, SingletonDeployment, SingletonDeploymentV2 } from './types';
+import { findDeployment } from './utils';
 
+/**
+ * Get the MultiSend deployment based on the provided filter.
+ * @param {DeploymentFilter} [filter] - The filter criteria for the deployment.
+ * @returns {SingletonDeployment | undefined} - The matched deployment or undefined if not found.
+ */
 export const getMultiSendDeployment = (filter?: DeploymentFilter): SingletonDeployment | undefined => {
-    return findDeployment(filter, multiSendDeployments)
-}
+  return findDeployment(filter, _MULTI_SEND_DEPLOYMENTS);
+};
 
-// This is a sorted array (by preference)
-const multiSendCallOnlyDeployments: SingletonDeployment[] = [
-  MultiSendCallOnly141, MultiSendCallOnly130
-]
+/**
+ * Get all MultiSend deployments based on the provided filter.
+ * @param {DeploymentFilter} [filter] - The filter criteria for the deployments.
+ * @returns {SingletonDeploymentV2 | undefined} - The matched deployments or undefined if not found.
+ */
+export const getMultiSendDeployments = (filter?: DeploymentFilter): SingletonDeploymentV2 | undefined => {
+  return findDeployment(filter, _MULTI_SEND_DEPLOYMENTS, DeploymentFormats.MULTIPLE);
+};
 
+/**
+ * Get the MultiSendCallOnly deployment based on the provided filter.
+ * @param {DeploymentFilter} [filter] - The filter criteria for the deployment.
+ * @returns {SingletonDeployment | undefined} - The matched deployment or undefined if not found.
+ */
 export const getMultiSendCallOnlyDeployment = (filter?: DeploymentFilter): SingletonDeployment | undefined => {
-    return findDeployment(filter, multiSendCallOnlyDeployments)
-}
+  return findDeployment(filter, _MULTI_SEND_CALL_ONLY_DEPLOYMENTS);
+};
 
-// This is a sorted array (by preference)
-const createCallDeployments: SingletonDeployment[] = [
-  CreateCall141, CreateCall130
-]
+/**
+ * Get all MultiSendCallOnly deployments based on the provided filter.
+ * @param {DeploymentFilter} [filter] - The filter criteria for the deployments.
+ * @returns {SingletonDeploymentV2 | undefined} - The matched deployments or undefined if not found.
+ */
+export const getMultiSendCallOnlyDeployments = (filter?: DeploymentFilter): SingletonDeploymentV2 | undefined => {
+  return findDeployment(filter, _MULTI_SEND_CALL_ONLY_DEPLOYMENTS, DeploymentFormats.MULTIPLE);
+};
 
+/**
+ * Get the CreateCall deployment based on the provided filter.
+ * @param {DeploymentFilter} [filter] - The filter criteria for the deployment.
+ * @returns {SingletonDeployment | undefined} - The matched deployment or undefined if not found.
+ */
 export const getCreateCallDeployment = (filter?: DeploymentFilter): SingletonDeployment | undefined => {
-    return findDeployment(filter, createCallDeployments)
-}
+  return findDeployment(filter, _CREATE_CALL_DEPLOYMENTS);
+};
 
-const signMessageLibDeployments: SingletonDeployment[] = [
-  SignMessageLib141, SignMessageLib130
-]
+/**
+ * Get all CreateCall deployments based on the provided filter.
+ * @param {DeploymentFilter} [filter] - The filter criteria for the deployments.
+ * @returns {SingletonDeploymentV2 | undefined} - The matched deployments or undefined if not found.
+ */
+export const getCreateCallDeployments = (filter?: DeploymentFilter): SingletonDeploymentV2 | undefined => {
+  return findDeployment(filter, _CREATE_CALL_DEPLOYMENTS, DeploymentFormats.MULTIPLE);
+};
 
+/**
+ * Get the SignMessageLib deployment based on the provided filter.
+ * @param {DeploymentFilter} [filter] - The filter criteria for the deployment.
+ * @returns {SingletonDeployment | undefined} - The matched deployment or undefined if not found.
+ */
 export const getSignMessageLibDeployment = (filter?: DeploymentFilter): SingletonDeployment | undefined => {
-    return findDeployment(filter, signMessageLibDeployments)
-}
+  return findDeployment(filter, _SIGN_MESSAGE_LIB_DEPLOYMENTS);
+};
+
+/**
+ * Get all SignMessageLib deployments based on the provided filter.
+ * @param {DeploymentFilter} [filter] - The filter criteria for the deployments.
+ * @returns {SingletonDeploymentV2 | undefined} - The matched deployments or undefined if not found.
+ */
+export const getSignMessageLibDeployments = (filter?: DeploymentFilter): SingletonDeploymentV2 | undefined => {
+  return findDeployment(filter, _SIGN_MESSAGE_LIB_DEPLOYMENTS, DeploymentFormats.MULTIPLE);
+};