Change supported versions to 1.3.0 L2 and 1.4.1 L2

Co-authored-by: katspaugh <381895+katspaugh@users.noreply.github.com>

Author: Copilot

docs/CUSTOM_MASTERCOPY_GUIDE.md

@@ -4,7 +4,7 @@
 
 The Safe protocol-kit now supports Safe contracts that use custom-deployed L2 mastercopies (also called singletons), as long as the mastercopy bytecode exactly matches an official Safe L2 version. This enables using the SDK on custom networks, testnets, or with independently deployed Safe contracts.
 
-**Supported versions**: Only **1.1.1 L2** and **1.3.0 L2** mastercopies are supported for bytecode matching.
+**Supported versions**: Only **1.3.0 L2** and **1.4.1 L2** mastercopies are supported for bytecode matching.
 
 ## How It Works
 
@@ -14,7 +14,7 @@ When you initialize a Safe instance, the SDK will:
 2. **Fallback mechanism**: If the VERSION() call fails:
    - Read the mastercopy address from storage slot 0 of the Safe proxy
    - Fetch the bytecode of the mastercopy contract
-   - Compare the bytecode hash against supported Safe L2 versions (1.1.1 L2 and 1.3.0 L2)
+   - Compare the bytecode hash against supported Safe L2 versions (1.3.0 L2 and 1.4.1 L2)
    - If a match is found, use that version to initialize the SDK
    - If no match is found, fall back to the default version (1.3.0)
 
@@ -47,7 +47,7 @@ For the mastercopy matching to work, the following conditions must be met:
 
 1. **Exact bytecode match**: The mastercopy bytecode must be byte-for-byte identical to an official Safe L2 deployment
 2. **Contract must be deployed**: Both the Safe proxy and the mastercopy must be deployed on the network
-3. **Supported version**: The mastercopy must match one of the supported Safe L2 versions (**1.1.1 L2** or **1.3.0 L2** only)
+3. **Supported version**: The mastercopy must match one of the supported Safe L2 versions (**1.3.0 L2** or **1.4.1 L2** only)
 
 ## Benefits
 
@@ -59,13 +59,13 @@ For the mastercopy matching to work, the following conditions must be met:
 ## What Gets Detected
 
 The mastercopy matching detects:
-- **Safe version**: Which Safe L2 contract version (1.1.1 or 1.3.0)
+- **Safe version**: Which Safe L2 contract version (1.3.0 or 1.4.1)
 - **Singleton type**: Always L2 singleton
 - **Mastercopy address**: The address of the matched mastercopy
 
 ## Limitations
 
-- **Only L2 versions supported**: Only 1.1.1 L2 and 1.3.0 L2 mastercopies are supported
+- **Only L2 versions supported**: Only 1.3.0 L2 and 1.4.1 L2 mastercopies are supported
 - Only works with official Safe bytecode (no modified versions)
 - The mastercopy must be deployed and accessible on the network
 - Performance: The first initialization with a custom mastercopy will require additional RPC calls to fetch and compare bytecode
@@ -122,7 +122,7 @@ const safe = await Safe.init({
 // 3. If that fails:
 //    - Read mastercopy address from storage (gets 0xabc...)
 //    - Fetch bytecode from 0xabc...
-//    - Compare with supported Safe L2 versions (1.1.1 L2 and 1.3.0 L2)
+//    - Compare with supported Safe L2 versions (1.3.0 L2 and 1.4.1 L2)
 //    - Find it matches v1.3.0 L2
 //    - Initialize using v1.3.0 ABI
 

packages/protocol-kit/src/utils/mastercopyMatcher.ts

@@ -27,7 +27,7 @@ export async function getMasterCopyAddressFromProxy(
 
 /**
  * Attempts to match a contract's bytecode hash against supported Safe L2 singleton versions.
- * Only supports 1.1.1 L2 and 1.3.0 L2 mastercopies.
+ * Only supports 1.3.0 L2 and 1.4.1 L2 mastercopies.
  *
  * @param safeProvider - The SafeProvider instance
  * @param contractAddress - The address of the contract to check
@@ -49,8 +49,8 @@ export async function matchContractCodeToSafeVersion(
   // Compute the keccak256 hash of the bytecode
   const contractCodeHash = keccak256(contractCode as `0x${string}`)
 
-  // Only check 1.1.1 L2 and 1.3.0 L2 versions
-  const versionsToCheck: SafeVersion[] = ['1.3.0', '1.1.1']
+  // Only check 1.3.0 L2 and 1.4.1 L2 versions
+  const versionsToCheck: SafeVersion[] = ['1.4.1', '1.3.0']
 
   // Try to match against each version - L2 only
   for (const version of versionsToCheck) {
@@ -87,7 +87,7 @@ export async function matchContractCodeToSafeVersion(
 /**
  * Attempts to determine the Safe version by matching the mastercopy code.
  * This is used as a fallback when the Safe address is not in the safe-deployments package.
- * Only supports 1.1.1 L2 and 1.3.0 L2 mastercopies.
+ * Only supports 1.3.0 L2 and 1.4.1 L2 mastercopies.
  *
  * @param safeProvider - The SafeProvider instance
  * @param safeAddress - The address of the Safe proxy

packages/protocol-kit/tests/unit/mastercopy-matcher.test.ts

@@ -71,7 +71,7 @@ describe('Mastercopy Matcher', () => {
     it('should match contract code against supported Safe L2 versions', async () => {
       // This test would require actual contract bytecode from safe-deployments
       // For now, we test that it correctly computes the hash and tries to match
-      // Only 1.1.1 L2 and 1.3.0 L2 are supported
+      // Only 1.3.0 L2 and 1.4.1 L2 are supported
       const mockCode = '0x1234567890abcdef'
       ;(safeProvider.getContractCode as sinon.SinonStub).resolves(mockCode)
 
@@ -101,7 +101,7 @@ describe('Mastercopy Matcher', () => {
 
       const result = await detectSafeVersionFromMastercopy(safeProvider, '0xSafeAddress', 1n)
 
-      // Since we're using mock code that won't match any real Safe L2 (1.1.1 or 1.3.0), expect undefined
+      // Since we're using mock code that won't match any real Safe L2 (1.3.0 or 1.4.1), expect undefined
       chai.expect(result).to.be.undefined
     })
 
@@ -113,7 +113,7 @@ describe('Mastercopy Matcher', () => {
 
       ;(safeProvider.getStorageAt as sinon.SinonStub).resolves(storageValue)
 
-      // If a match were found for 1.1.1 L2 or 1.3.0 L2, it would return an object with version, mastercopyAddress, and isL1=false
+      // If a match were found for 1.3.0 L2 or 1.4.1 L2, it would return an object with version, mastercopyAddress, and isL1=false
       // For this test with mock data, it will return undefined
       const result = await detectSafeVersionFromMastercopy(safeProvider, '0xSafeAddress', 1n)