@safe-vanity-blockie/safe-config 0.4.1 → 1.0.0

package/README.md

@@ -21,6 +21,7 @@ npm install @safe-vanity-blockie/safe-config
 | Export | Purpose |
 | --- | --- |
 | `loadSafeConstants` | resolve proxy factory, singleton and init code hash for a chain |
+| `addressClassFor` | which chains give a Safe the same address on a version, offline from safe-deployments |
 | `verifyWithProtocolKit` | cross-check a derived address against the official Safe Protocol Kit |
 | `ZKSYNC_CHAIN_IDS` | chains whose CREATE2 derivation differs, so an address is not portable |
 | `SafeSetup`, `SetupInput` | the setup shape and its input form |

package/dist/address-class.d.ts

@@ -0,0 +1,17 @@
+import type { SupportedSafeVersion } from './versions.js';
+/**
+ * Which chains give a Safe the same address, per Safe version: two chains with the same class give
+ * every (owners, threshold, saltNonce) the same address, and two with different classes do not.
+ *
+ * Resolved from safe-deployments the way `loadSafeConstants` resolves it through protocol-kit: the
+ * proxy factory, the singleton (L1 on mainnet, L2 elsewhere — protocol-kit's default, so a forced
+ * `isL1SafeSingleton` is not modelled) and the compatibility fallback handler, each the first
+ * address listed for the chain. Those three are what a chain contributes to a standard-EVM Safe
+ * address — the factory directly, the singleton through the initCodeHash, and the handler through
+ * the initializerHash. test/address-class.test.ts pins the resulting partition against what was
+ * measured on live RPCs.
+ *
+ * Undefined for a chain safe-deployments has no deployment for, and for zkSync-family chains.
+ */
+export declare function addressClassFor(chainId: number, safeVersion: SupportedSafeVersion): string | undefined;
+//# sourceMappingURL=address-class.d.ts.map

package/dist/address-class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address-class.d.ts","sourceRoot":"","sources":["../src/address-class.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAqCzD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,oBAAoB,GAChC,MAAM,GAAG,SAAS,CAIpB"}

package/dist/address-class.js

@@ -0,0 +1,49 @@
+import { getCompatibilityFallbackHandlerDeployment, getProxyFactoryDeployment, getSafeL2SingletonDeployment, getSafeSingletonDeployment, } from '@safe-global/safe-deployments';
+import { ZKSYNC_CHAIN_IDS } from './setup.js';
+/**
+ * Chains on which protocol-kit defaults to the L1 singleton (Safe.sol) rather than SafeL2.sol.
+ * Mirrors protocol-kit's own `safeDeploymentsL1ChainIds`, which it does not export.
+ */
+const L1_SINGLETON_CHAIN_IDS = new Set([1]);
+/** The address protocol-kit resolves for a deployment on a chain: the first one listed. */
+function deployedAddress(deployment, chainId) {
+    const addresses = deployment?.networkAddresses[String(chainId)];
+    return (Array.isArray(addresses) ? addresses[0] : addresses)?.toLowerCase();
+}
+function resolveAddressClass(chainId, safeVersion) {
+    // Same contract addresses, different CREATE2 formula: sharing them says nothing about the Safe.
+    if (ZKSYNC_CHAIN_IDS.has(BigInt(chainId)))
+        return undefined;
+    const filter = { version: safeVersion, network: String(chainId), released: true };
+    const singleton = L1_SINGLETON_CHAIN_IDS.has(chainId)
+        ? getSafeSingletonDeployment(filter)
+        : getSafeL2SingletonDeployment(filter);
+    const parts = [
+        deployedAddress(getProxyFactoryDeployment(filter), chainId),
+        deployedAddress(singleton, chainId),
+        deployedAddress(getCompatibilityFallbackHandlerDeployment(filter), chainId),
+    ];
+    return parts.every((part) => part !== undefined) ? parts.join(' ') : undefined;
+}
+const classes = new Map();
+/**
+ * Which chains give a Safe the same address, per Safe version: two chains with the same class give
+ * every (owners, threshold, saltNonce) the same address, and two with different classes do not.
+ *
+ * Resolved from safe-deployments the way `loadSafeConstants` resolves it through protocol-kit: the
+ * proxy factory, the singleton (L1 on mainnet, L2 elsewhere — protocol-kit's default, so a forced
+ * `isL1SafeSingleton` is not modelled) and the compatibility fallback handler, each the first
+ * address listed for the chain. Those three are what a chain contributes to a standard-EVM Safe
+ * address — the factory directly, the singleton through the initCodeHash, and the handler through
+ * the initializerHash. test/address-class.test.ts pins the resulting partition against what was
+ * measured on live RPCs.
+ *
+ * Undefined for a chain safe-deployments has no deployment for, and for zkSync-family chains.
+ */
+export function addressClassFor(chainId, safeVersion) {
+    const key = `${chainId}:${safeVersion}`;
+    if (!classes.has(key))
+        classes.set(key, resolveAddressClass(chainId, safeVersion));
+    return classes.get(key);
+}
+//# sourceMappingURL=address-class.js.map

package/dist/address-class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address-class.js","sourceRoot":"","sources":["../src/address-class.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yCAAyC,EACzC,yBAAyB,EACzB,4BAA4B,EAC5B,0BAA0B,GAE3B,MAAM,+BAA+B,CAAA;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAG7C;;;GAGG;AACH,MAAM,sBAAsB,GAAwB,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAEhE,2FAA2F;AAC3F,SAAS,eAAe,CACtB,UAA2C,EAC3C,OAAe;IAEf,MAAM,SAAS,GAAG,UAAU,EAAE,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;IAC/D,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,CAAA;AAC7E,CAAC;AAED,SAAS,mBAAmB,CAC1B,OAAe,EACf,WAAiC;IAEjC,gGAAgG;IAChG,IAAI,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAAE,OAAO,SAAS,CAAA;IAC3D,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;IACjF,MAAM,SAAS,GAAG,sBAAsB,CAAC,GAAG,CAAC,OAAO,CAAC;QACnD,CAAC,CAAC,0BAA0B,CAAC,MAAM,CAAC;QACpC,CAAC,CAAC,4BAA4B,CAAC,MAAM,CAAC,CAAA;IACxC,MAAM,KAAK,GAAG;QACZ,eAAe,CAAC,yBAAyB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAC3D,eAAe,CAAC,SAAS,EAAE,OAAO,CAAC;QACnC,eAAe,CAAC,yCAAyC,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;KAC5E,CAAA;IACD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AAChF,CAAC;AAED,MAAM,OAAO,GAAG,IAAI,GAAG,EAA8B,CAAA;AAErD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAe,EACf,WAAiC;IAEjC,MAAM,GAAG,GAAG,GAAG,OAAO,IAAI,WAAW,EAAE,CAAA;IACvC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,mBAAmB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAA;IAClF,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AACzB,CAAC"}

package/dist/index.d.ts

@@ -1,2 +1,4 @@
+export { addressClassFor } from './address-class.js';
 export { loadSafeConstants, type SafeSetup, type SetupInput, verifyWithProtocolKit, ZKSYNC_CHAIN_IDS, } from './setup.js';
+export { DEFAULT_SAFE_VERSION, SUPPORTED_SAFE_VERSIONS, type SupportedSafeVersion, } from './versions.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EACL,iBAAiB,EACjB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,KAAK,oBAAoB,GAC1B,MAAM,eAAe,CAAA"}

package/dist/index.js

@@ -1,2 +1,4 @@
+export { addressClassFor } from './address-class.js';
 export { loadSafeConstants, verifyWithProtocolKit, ZKSYNC_CHAIN_IDS, } from './setup.js';
+export { DEFAULT_SAFE_VERSION, SUPPORTED_SAFE_VERSIONS, } from './versions.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EAGjB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EACL,iBAAiB,EAGjB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,oBAAoB,EACpB,uBAAuB,GAExB,MAAM,eAAe,CAAA"}

package/dist/setup.d.ts

@@ -31,8 +31,9 @@ export interface SafeSetup {
  * These are the chain IDs protocol-kit itself gates its zkSync formula on internally
  * (ZKSYNC_MAINNET = 324, ZKSYNC_TESTNET = 300, ZKSYNC_LENS = 232), per the installed
  * @safe-global/protocol-kit@8.0.5 source. protocol-kit additionally gates on
- * `safeVersion <= 1.4.1`, which covers every version this CLI supports (1.4.1 and 1.3.0),
- * so a plain set membership check on chain ID is sufficient here.
+ * `safeVersion <= 1.4.1`, so for 1.5.0 it would predict with the standard EVM formula instead.
+ * This tool has not verified that against a live zkSync deployment, so every version is
+ * rejected on these chains alike: a plain set membership check on chain ID.
  */
 export declare const ZKSYNC_CHAIN_IDS: ReadonlySet<bigint>;
 /**

package/dist/setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,YAAY,EACb,MAAM,2BAA2B,CAAA;AAClC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAC1E,OAAO,EAAU,KAAK,GAAG,EAAa,MAAM,MAAM,CAAA;AAElD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,WAAW,CAAA;IACxB,kFAAkF;IAClF,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,aAAa,CAAA;IACxB,YAAY,EAAE;QAAE,eAAe,EAAE,GAAG,CAAC;QAAC,OAAO,EAAE,GAAG,CAAC;QAAC,YAAY,EAAE,GAAG,CAAA;KAAE,CAAA;IACvE,YAAY,EAAE,YAAY,CAAA;IAC1B,iBAAiB,EAAE;QAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IAC1D,WAAW,EAAE,WAAW,CAAA;IACxB,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAA+B,CAAA;AAEhF;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAkD7E;AAED,6FAA6F;AAC7F,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,SAAS,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAcf"}
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,YAAY,EACb,MAAM,2BAA2B,CAAA;AAClC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAC1E,OAAO,EAAU,KAAK,GAAG,EAAa,MAAM,MAAM,CAAA;AAElD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,WAAW,CAAA;IACxB,kFAAkF;IAClF,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,aAAa,CAAA;IACxB,YAAY,EAAE;QAAE,eAAe,EAAE,GAAG,CAAC;QAAC,OAAO,EAAE,GAAG,CAAC;QAAC,YAAY,EAAE,GAAG,CAAA;KAAE,CAAA;IACvE,YAAY,EAAE,YAAY,CAAA;IAC1B,iBAAiB,EAAE;QAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IAC1D,WAAW,EAAE,WAAW,CAAA;IACxB,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAA+B,CAAA;AAEhF;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAkD7E;AAED,6FAA6F;AAC7F,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,SAAS,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/dist/setup.js

@@ -6,8 +6,9 @@ import { concat, keccak256 } from 'viem';
  * These are the chain IDs protocol-kit itself gates its zkSync formula on internally
  * (ZKSYNC_MAINNET = 324, ZKSYNC_TESTNET = 300, ZKSYNC_LENS = 232), per the installed
  * @safe-global/protocol-kit@8.0.5 source. protocol-kit additionally gates on
- * `safeVersion <= 1.4.1`, which covers every version this CLI supports (1.4.1 and 1.3.0),
- * so a plain set membership check on chain ID is sufficient here.
+ * `safeVersion <= 1.4.1`, so for 1.5.0 it would predict with the standard EVM formula instead.
+ * This tool has not verified that against a live zkSync deployment, so every version is
+ * rejected on these chains alike: a plain set membership check on chain ID.
  */
 export const ZKSYNC_CHAIN_IDS = new Set([324n, 300n, 232n]);
 /**

package/dist/setup.js.map

@@ -1 +1 @@
-{"version":3,"file":"setup.js","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"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"}

package/dist/versions.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The Safe versions the CLI and the web app accept, newest first. One list for both, so a version
+ * cannot be minable in one and rejected by the other. Each must be a version protocol-kit knows,
+ * which the `satisfies` below enforces at compile time.
+ */
+export declare const SUPPORTED_SAFE_VERSIONS: readonly ["1.5.0", "1.4.1", "1.3.0"];
+export type SupportedSafeVersion = (typeof SUPPORTED_SAFE_VERSIONS)[number];
+/** What a config that names no version mines and deploys. It is part of the address. */
+export declare const DEFAULT_SAFE_VERSION: SupportedSafeVersion;
+//# sourceMappingURL=versions.d.ts.map

package/dist/versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.d.ts","sourceRoot":"","sources":["../src/versions.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,sCAIO,CAAA;AAC3C,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE3E,wFAAwF;AACxF,eAAO,MAAM,oBAAoB,EAAE,oBAA8B,CAAA"}

package/dist/versions.js

@@ -0,0 +1,13 @@
+/**
+ * The Safe versions the CLI and the web app accept, newest first. One list for both, so a version
+ * cannot be minable in one and rejected by the other. Each must be a version protocol-kit knows,
+ * which the `satisfies` below enforces at compile time.
+ */
+export const SUPPORTED_SAFE_VERSIONS = [
+    '1.5.0',
+    '1.4.1',
+    '1.3.0',
+];
+/** What a config that names no version mines and deploys. It is part of the address. */
+export const DEFAULT_SAFE_VERSION = '1.5.0';
+//# sourceMappingURL=versions.js.map

package/dist/versions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.js","sourceRoot":"","sources":["../src/versions.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,OAAO;IACP,OAAO;IACP,OAAO;CACkC,CAAA;AAG3C,wFAAwF;AACxF,MAAM,CAAC,MAAM,oBAAoB,GAAyB,OAAO,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@safe-vanity-blockie/safe-config",
-  "version": "0.4.1",
+  "version": "1.0.0",
   "description": "Resolve canonical Safe contract addresses and build the setup inputs for counterfactual address derivation",
   "engines": {
     "node": ">=22"
@@ -36,10 +36,11 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@safe-global/protocol-kit": "^8.0.6",
+    "@safe-global/protocol-kit": "^8.0.7",
+    "@safe-global/safe-deployments": "^1.37.63",
     "@safe-global/types-kit": "^4.0.1",
-    "viem": "^2.55.16",
-    "@safe-vanity-blockie/core": "0.4.1"
+    "viem": "^2.57.2",
+    "@safe-vanity-blockie/core": "1.0.0"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",

package/src/address-class.ts

@@ -0,0 +1,67 @@
+import {
+  getCompatibilityFallbackHandlerDeployment,
+  getProxyFactoryDeployment,
+  getSafeL2SingletonDeployment,
+  getSafeSingletonDeployment,
+  type SingletonDeployment,
+} from '@safe-global/safe-deployments'
+import { ZKSYNC_CHAIN_IDS } from './setup.js'
+import type { SupportedSafeVersion } from './versions.js'
+
+/**
+ * Chains on which protocol-kit defaults to the L1 singleton (Safe.sol) rather than SafeL2.sol.
+ * Mirrors protocol-kit's own `safeDeploymentsL1ChainIds`, which it does not export.
+ */
+const L1_SINGLETON_CHAIN_IDS: ReadonlySet<number> = new Set([1])
+
+/** The address protocol-kit resolves for a deployment on a chain: the first one listed. */
+function deployedAddress(
+  deployment: SingletonDeployment | undefined,
+  chainId: number,
+): string | undefined {
+  const addresses = deployment?.networkAddresses[String(chainId)]
+  return (Array.isArray(addresses) ? addresses[0] : addresses)?.toLowerCase()
+}
+
+function resolveAddressClass(
+  chainId: number,
+  safeVersion: SupportedSafeVersion,
+): string | undefined {
+  // Same contract addresses, different CREATE2 formula: sharing them says nothing about the Safe.
+  if (ZKSYNC_CHAIN_IDS.has(BigInt(chainId))) return undefined
+  const filter = { version: safeVersion, network: String(chainId), released: true }
+  const singleton = L1_SINGLETON_CHAIN_IDS.has(chainId)
+    ? getSafeSingletonDeployment(filter)
+    : getSafeL2SingletonDeployment(filter)
+  const parts = [
+    deployedAddress(getProxyFactoryDeployment(filter), chainId),
+    deployedAddress(singleton, chainId),
+    deployedAddress(getCompatibilityFallbackHandlerDeployment(filter), chainId),
+  ]
+  return parts.every((part) => part !== undefined) ? parts.join(' ') : undefined
+}
+
+const classes = new Map<string, string | undefined>()
+
+/**
+ * Which chains give a Safe the same address, per Safe version: two chains with the same class give
+ * every (owners, threshold, saltNonce) the same address, and two with different classes do not.
+ *
+ * Resolved from safe-deployments the way `loadSafeConstants` resolves it through protocol-kit: the
+ * proxy factory, the singleton (L1 on mainnet, L2 elsewhere — protocol-kit's default, so a forced
+ * `isL1SafeSingleton` is not modelled) and the compatibility fallback handler, each the first
+ * address listed for the chain. Those three are what a chain contributes to a standard-EVM Safe
+ * address — the factory directly, the singleton through the initCodeHash, and the handler through
+ * the initializerHash. test/address-class.test.ts pins the resulting partition against what was
+ * measured on live RPCs.
+ *
+ * Undefined for a chain safe-deployments has no deployment for, and for zkSync-family chains.
+ */
+export function addressClassFor(
+  chainId: number,
+  safeVersion: SupportedSafeVersion,
+): string | undefined {
+  const key = `${chainId}:${safeVersion}`
+  if (!classes.has(key)) classes.set(key, resolveAddressClass(chainId, safeVersion))
+  return classes.get(key)
+}

package/src/index.ts

@@ -1,3 +1,4 @@
+export { addressClassFor } from './address-class.js'
 export {
   loadSafeConstants,
   type SafeSetup,
@@ -5,3 +6,8 @@ export {
   verifyWithProtocolKit,
   ZKSYNC_CHAIN_IDS,
 } from './setup.js'
+export {
+  DEFAULT_SAFE_VERSION,
+  SUPPORTED_SAFE_VERSIONS,
+  type SupportedSafeVersion,
+} from './versions.js'

package/src/setup.ts

@@ -33,8 +33,9 @@ export interface SafeSetup {
  * These are the chain IDs protocol-kit itself gates its zkSync formula on internally
  * (ZKSYNC_MAINNET = 324, ZKSYNC_TESTNET = 300, ZKSYNC_LENS = 232), per the installed
  * @safe-global/protocol-kit@8.0.5 source. protocol-kit additionally gates on
- * `safeVersion <= 1.4.1`, which covers every version this CLI supports (1.4.1 and 1.3.0),
- * so a plain set membership check on chain ID is sufficient here.
+ * `safeVersion <= 1.4.1`, so for 1.5.0 it would predict with the standard EVM formula instead.
+ * This tool has not verified that against a live zkSync deployment, so every version is
+ * rejected on these chains alike: a plain set membership check on chain ID.
  */
 export const ZKSYNC_CHAIN_IDS: ReadonlySet<bigint> = new Set([324n, 300n, 232n])
 

package/src/versions.ts

@@ -0,0 +1,16 @@
+import type { SafeVersion } from '@safe-global/types-kit'
+
+/**
+ * The Safe versions the CLI and the web app accept, newest first. One list for both, so a version
+ * cannot be minable in one and rejected by the other. Each must be a version protocol-kit knows,
+ * which the `satisfies` below enforces at compile time.
+ */
+export const SUPPORTED_SAFE_VERSIONS = [
+  '1.5.0',
+  '1.4.1',
+  '1.3.0',
+] as const satisfies readonly SafeVersion[]
+export type SupportedSafeVersion = (typeof SUPPORTED_SAFE_VERSIONS)[number]
+
+/** What a config that names no version mines and deploys. It is part of the address. */
+export const DEFAULT_SAFE_VERSION: SupportedSafeVersion = '1.5.0'