Deployment preparation: Composite Liquidity Router V3

README.md

@@ -126,7 +126,6 @@ Returns an object with all contracts from a deployment and their addresses.
 | V3 Hook Examples                                       | [`20241213-v3-hook-examples`](./v3/tasks/20241213-v3-hook-examples)                                     |
 | V3 Balancer Contract Registry                          | [`20250117-v3-contract-registry`](./v3/tasks/20250117-v3-contract-registry)                             |
 | V3 Gyro 2-CLP                                          | [`20250120-v3-gyro-2clp`](./v3/tasks/20250120-v3-gyro-2clp)                                             |
-| V3 Composite Liquidity Router (2)                      | [`20250123-v3-composite-liquidity-router-v2`](./v3/tasks/20250123-v3-composite-liquidity-router-v2)     |
 | V3 Gyro E-CLP                                          | [`20250124-v3-gyro-eclp`](./v3/tasks/20250124-v3-gyro-eclp)                                             |
 | V3 MEV Capture Hook                                    | [`20250212-v3-mev-capture-hook`](./v3/tasks/20250212-v3-mev-capture-hook)                               |
 | V3 Protocol Fee Controller V2                          | [`20250214-v3-protocol-fee-controller-v2`](./v3/tasks/20250214-v3-protocol-fee-controller-v2)           |
@@ -158,6 +157,7 @@ Returns an object with all contracts from a deployment and their addresses.
 | V3 Pool Swap Fee Helper (V2)                           | [`20250919-v3-pool-swap-fee-helper-v2`](./v3/tasks/20250919-v3-pool-swap-fee-helper-v2)                 |
 | Timelock Authorizer, governance contract (V2)          | [`20250925-timelock-authorizer`](./v2/tasks/20250925-timelock-authorizer)                               |
 | Timelock Authorizer, governance contract (V3)          | [`20250925-v3-timelock-authorizer`](./v3/tasks/20250925-v3-timelock-authorizer)                         |
+| V3 Composite Liquidity Router (V3)                     | [`20251010-v3-composite-liquidity-router-v3`](./v3/tasks/20251010-v3-composite-liquidity-router-v3)     |
 | Vault v2.1 (patched for new L2s)                       | [`20251020-vault-v2.1`](./v2/tasks/20251020-vault-v2.1)                                                 |
 
 ## Scripts
@@ -252,6 +252,7 @@ Go to each deprecated deployment's readme file to learn more about why it is dep
 | V3 Stable Pool                                      | [`20241205-v3-stable-pool`](./v3/deprecated/20241205-v3-stable-pool)                                     |
 | V3 Vault Explorer                                   | [`20241205-v3-vault-explorer`](./v3/deprecated/20241205-v3-vault-explorer)                               |
 | V3 Stable Surge Pool                                | [`20250121-v3-stable-surge`](./v3/deprecated/20250121-v3-stable-surge)                                   |
+| V3 Composite Liquidity Router (V2)                  | [`20250123-v3-composite-liquidity-router-v2`](./v3/deprecated/20250123-v3-composite-liquidity-router-v2) |
 | V3 Protocol Fee Sweeper                             | [`20250228-v3-protocol-fee-sweeper`](./v3/deprecated/20250228-v3-protocol-fee-sweeper)                   |
 | V3 Liquidity Bootstrapping Pool                     | [`20250307-v3-liquidity-bootstrapping-pool`](./v3/deprecated/20250307-v3-liquidity-bootstrapping-pool)   |
 | Balancer Contract Registry Initializer              | [`20250314-balancer-registry-initializer`](./v3/deprecated/20250314-balancer-registry-initializer)       |

addresses/arbitrum.json

@@ -1004,7 +1004,7 @@
         "address": "0xC1A64500E035D9159C8826E982dFb802003227f0"
       }
     ],
-    "status": "ACTIVE",
+    "status": "DEPRECATED",
     "version": "v3"
   },
   "20250124-v3-gyro-eclp": {

addresses/avalanche.json

@@ -564,7 +564,7 @@
         "address": "0x0C8f71D19f87c0bD1b9baD2484EcC3388D5DbB98"
       }
     ],
-    "status": "ACTIVE",
+    "status": "DEPRECATED",
     "version": "v3"
   },
   "20250124-v3-gyro-eclp": {

addresses/base.json

@@ -594,7 +594,7 @@
         "address": "0x9dA18982a33FD0c7051B19F0d7C76F2d5E7e017c"
       }
     ],
-    "status": "ACTIVE",
+    "status": "DEPRECATED",
     "version": "v3"
   },
   "20250124-v3-gyro-eclp": {

addresses/gnosis.json

@@ -724,7 +724,7 @@
         "address": "0x6eaD84Af26E997D27998Fc9f8614e8a19BB93938"
       }
     ],
-    "status": "ACTIVE",
+    "status": "DEPRECATED",
     "version": "v3"
   },
   "20250124-v3-gyro-eclp": {

addresses/hyperevm.json

@@ -110,7 +110,7 @@
         "address": "0xa523f47A933D5020b23629dDf689695AA94612Dc"
       }
     ],
-    "status": "ACTIVE",
+    "status": "DEPRECATED",
     "version": "v3"
   },
   "20250124-v3-gyro-eclp": {

addresses/mainnet.json

@@ -1562,7 +1562,7 @@
         "address": "0xb21A277466e7dB6934556a1Ce12eb3F032815c8A"
       }
     ],
-    "status": "ACTIVE",
+    "status": "DEPRECATED",
     "version": "v3"
   },
   "20250124-v3-gyro-eclp": {

addresses/optimism.json

@@ -854,7 +854,7 @@
         "address": "0xc9b36096f5201ea332Db35d6D195774ea0D5988f"
       }
     ],
-    "status": "ACTIVE",
+    "status": "DEPRECATED",
     "version": "v3"
   },
   "20250124-v3-gyro-eclp": {

addresses/plasma.json

@@ -110,7 +110,7 @@
         "address": "0x5cF4928a3205728bd12830E1840F7DB85c62a4B9"
       }
     ],
-    "status": "ACTIVE",
+    "status": "DEPRECATED",
     "version": "v3"
   },
   "20250124-v3-gyro-eclp": {

addresses/sepolia.json

@@ -818,7 +818,7 @@
         "address": "0x6A20a4b6DcFF78e6D21BF0dbFfD58C96644DB9cb"
       }
     ],
-    "status": "ACTIVE",
+    "status": "DEPRECATED",
     "version": "v3"
   },
   "20250124-v3-gyro-eclp": {

v3/tasks/20250123-v3-composite-liquidity-router-v2/readme.md → v3/deprecated/20250123-v3-composite-liquidity-router-v2/readme.md

@@ -1,5 +1,10 @@
 # 2025-01-23 - V3 Composite Liquidity Router (V2)
 
+> ⚠️ **DEPRECATED: do not use** ⚠️
+>
+> The Composite Liquidity Router V2, while still safe to use, was superseded by this [updated version](../../tasks/20251010-v3-composite-liquidity-router-v3/).
+> The new version supports nested pools, among other changes.
+
 Composite Liquidity Router deployment for Balancer V3, version 2.
 Contains `CompositeLiquidityRouter` for complex liquidity operations involving pools with ERC4626 wrappers.
 

v3/tasks/20250123-v3-composite-liquidity-router-v2/test/task.fork.ts → v3/deprecated/20250123-v3-composite-liquidity-router-v2/test/task.fork.ts

@@ -5,7 +5,7 @@ import { Contract } from 'ethers';
 import { SignerWithAddress } from '@nomiclabs/hardhat-ethers/signers';
 import { fp } from '@helpers/numbers';
 
-describeForkTest('CompositeLiquidityRouter-V3-2', 'mainnet', 21688700, function () {
+describeForkTest.skip('CompositeLiquidityRouter-V3-2', 'mainnet', 21688700, function () {
   let task: Task;
   let compositeLiquidityRouter: Contract;
   let wethSigner: SignerWithAddress, alice: SignerWithAddress;