damm-sdk 1.4.36 → 1.4.37

package/src/integrations/lagoonV2/lagoon.v2.ts

@@ -0,0 +1,345 @@
+import { encodeAbiParameters, encodeFunctionData, getAddress, keccak256, encodePacked } from "viem";
+import type { Address, Hex } from "viem";
+import { createCall, ZERO_ADDRESS, type Call, type HexString, type Unwrapable } from "../..";
+import lagoonV2FactoryAbi from "./factory.abi.ts";
+
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+/**
+ * AccessMode enum for Lagoon v0.6 vault.
+ * Blacklist = 0 (default): all addresses permitted unless explicitly blocked.
+ * Whitelist = 1: only explicitly whitelisted addresses permitted.
+ */
+export const LagoonV2AccessMode = {
+    Blacklist: 0,
+    Whitelist: 1,
+} as const;
+export type LagoonV2AccessModeValue = (typeof LagoonV2AccessMode)[keyof typeof LagoonV2AccessMode];
+
+/**
+ * 19-field InitStruct for Lagoon v0.6.
+ *
+ * Field order matches the Solidity ABI encoding order exactly (required for abi.encode):
+ *   underlying, name, symbol, safe, whitelistManager, valuationManager, admin,
+ *   feeReceiver, managementRate, performanceRate, accessMode, entryRate, exitRate,
+ *   haircutRate, securityCouncil, externalSanctionsList, initialTotalAssets,
+ *   superOperator, allowHighWaterMarkReset
+ *
+ * Key differences from v0.5:
+ *   - `accessMode` (uint8 enum) replaces `enableWhitelist` (bool)
+ *   - `entryRate`, `exitRate`, `haircutRate` are new fee rate fields (uint16)
+ *   - `securityCouncil`, `externalSanctionsList`, `superOperator` are new roles (address)
+ *   - `initialTotalAssets` (uint256) is new
+ *   - `allowHighWaterMarkReset` (bool) is new
+ *   - `rateUpdateCooldown` is REMOVED
+ * All fields are required — no defaults are applied.
+ */
+export type LagoonV2InitStruct = Readonly<{
+    underlying: Address;
+    name: string;
+    symbol: string;
+    safe: Address;
+    whitelistManager: Address;
+    valuationManager: Address;
+    admin: Address;
+    feeReceiver: Address;
+    managementRate: number; // uint16 (0–10_000)
+    performanceRate: number; // uint16 (0–10_000)
+    accessMode: LagoonV2AccessModeValue; // uint8: 0=Blacklist, 1=Whitelist
+    entryRate: number; // uint16 (0–10_000)
+    exitRate: number; // uint16 (0–10_000)
+    haircutRate: number; // uint16 (0–10_000)
+    securityCouncil: Address;
+    externalSanctionsList: Address;
+    initialTotalAssets: bigint; // uint256
+    superOperator: Address;
+    allowHighWaterMarkReset: boolean;
+}>;
+
+/**
+ * Full args for the v0.6 bytes-overload createVaultProxy call.
+ * `logic` MUST be the explicit v0.6 vault implementation address — never address(0).
+ * Passing address(0) resolves to the registry's v0.5.0 default logic and silently deploys v0.5.
+ */
+export type LagoonV2CreateVaultProxyArgs = Readonly<{
+    logic: Address;
+    initialOwner: Address;
+    initialDelay: bigint;
+    initStruct: LagoonV2InitStruct;
+    /** Registry address (per-chain constant; obtained from factory.registry()). */
+    registry: Address;
+    /** Wrapped native token address (per-chain constant; obtained from factory.wrappedNativeToken()). */
+    wrappedNative: Address;
+    salt: HexString;
+}>;
+
+// ---------------------------------------------------------------------------
+// ABI parameter types for encoding
+// ---------------------------------------------------------------------------
+
+const INIT_STRUCT_ABI_TYPE = {
+    type: "tuple",
+    components: [
+        { name: "underlying", type: "address" },
+        { name: "name", type: "string" },
+        { name: "symbol", type: "string" },
+        { name: "safe", type: "address" },
+        { name: "whitelistManager", type: "address" },
+        { name: "valuationManager", type: "address" },
+        { name: "admin", type: "address" },
+        { name: "feeReceiver", type: "address" },
+        { name: "managementRate", type: "uint16" },
+        { name: "performanceRate", type: "uint16" },
+        { name: "accessMode", type: "uint8" },
+        { name: "entryRate", type: "uint16" },
+        { name: "exitRate", type: "uint16" },
+        { name: "haircutRate", type: "uint16" },
+        { name: "securityCouncil", type: "address" },
+        { name: "externalSanctionsList", type: "address" },
+        { name: "initialTotalAssets", type: "uint256" },
+        { name: "superOperator", type: "address" },
+        { name: "allowHighWaterMarkReset", type: "bool" },
+    ],
+} as const;
+
+// initialize(bytes _data, address _feeRegistry, address _wrappedNativeToken)
+const INITIALIZE_ABI = [
+    {
+        name: "initialize",
+        type: "function",
+        inputs: [
+            { name: "_data", type: "bytes" },
+            { name: "_feeRegistry", type: "address" },
+            { name: "_wrappedNativeToken", type: "address" },
+        ],
+        outputs: [],
+        stateMutability: "nonpayable",
+    },
+] as const;
+
+// ---------------------------------------------------------------------------
+// Validation helpers
+// ---------------------------------------------------------------------------
+
+function validateRates({
+    managementRate,
+    performanceRate,
+    entryRate,
+    exitRate,
+    haircutRate,
+}: LagoonV2InitStruct): void {
+    const MAX_RATE = 10_000;
+    if (performanceRate > MAX_RATE) throw new Error(`performanceRate ${performanceRate} exceeds max ${MAX_RATE}`);
+    if (managementRate > MAX_RATE) throw new Error(`managementRate ${managementRate} exceeds max ${MAX_RATE}`);
+    if (entryRate > MAX_RATE) throw new Error(`entryRate ${entryRate} exceeds max ${MAX_RATE}`);
+    if (exitRate > MAX_RATE) throw new Error(`exitRate ${exitRate} exceeds max ${MAX_RATE}`);
+    if (haircutRate > MAX_RATE) throw new Error(`haircutRate ${haircutRate} exceeds max ${MAX_RATE}`);
+}
+
+// ---------------------------------------------------------------------------
+// Inner init calldata builder
+// ---------------------------------------------------------------------------
+
+/**
+ * Builds the `call_data` bytes that the LagoonVaultProxy's initialize function expects.
+ *
+ * call_data = initialize(abi.encode(<19-field InitStruct tuple>), registry, wrappedNative)
+ *
+ * This is passed to the bytes-overload createVaultProxy as the `call_data` argument.
+ * The factory forwards it verbatim to the proxy's constructor, which delegatecalls it
+ * into the vault implementation during initialization.
+ */
+export const buildLagoonV2InitCalldata = ({
+    initStruct,
+    registry,
+    wrappedNative,
+}: {
+    initStruct: LagoonV2InitStruct;
+    registry: Address;
+    wrappedNative: Address;
+}): Hex => {
+    validateRates(initStruct);
+
+    // Step 1: ABI-encode the 19-field InitStruct as a tuple (bytes _data parameter)
+    const encodedInitStruct = encodeAbiParameters(
+        [INIT_STRUCT_ABI_TYPE],
+        [
+            {
+                underlying: initStruct.underlying,
+                name: initStruct.name,
+                symbol: initStruct.symbol,
+                safe: initStruct.safe,
+                whitelistManager:
+                    initStruct.accessMode === LagoonV2AccessMode.Whitelist
+                        ? initStruct.whitelistManager
+                        : (ZERO_ADDRESS as Address),
+                valuationManager: initStruct.valuationManager,
+                admin: initStruct.admin,
+                feeReceiver: initStruct.feeReceiver,
+                managementRate: initStruct.managementRate,
+                performanceRate: initStruct.performanceRate,
+                accessMode: initStruct.accessMode,
+                entryRate: initStruct.entryRate,
+                exitRate: initStruct.exitRate,
+                haircutRate: initStruct.haircutRate,
+                securityCouncil: initStruct.securityCouncil,
+                externalSanctionsList: initStruct.externalSanctionsList,
+                initialTotalAssets: initStruct.initialTotalAssets,
+                superOperator: initStruct.superOperator,
+                allowHighWaterMarkReset: initStruct.allowHighWaterMarkReset,
+            },
+        ],
+    );
+
+    // Step 2: Encode initialize(bytes,address,address) call
+    return encodeFunctionData({
+        abi: INITIALIZE_ABI,
+        functionName: "initialize",
+        args: [encodedInitStruct, registry, wrappedNative],
+    });
+};
+
+// ---------------------------------------------------------------------------
+// Factory calldata encoder
+// ---------------------------------------------------------------------------
+
+/**
+ * Encodes the bytes-overload `createVaultProxy` calldata for the v3 Lagoon factory.
+ *
+ * Uses selector 0x9dfe49f2 = keccak4("createVaultProxy(address,address,uint256,bytes,bytes32)").
+ * The `logic` argument MUST be the explicit v0.6 vault implementation — never address(0).
+ *
+ * @returns ABI-encoded transaction calldata (including 4-byte selector).
+ */
+export const CreateLagoonV2VaultProxyCalldata = ({
+    logic,
+    initialOwner,
+    initialDelay,
+    initStruct,
+    registry,
+    wrappedNative,
+    salt,
+}: LagoonV2CreateVaultProxyArgs): HexString => {
+    if (logic === ZERO_ADDRESS) {
+        throw new Error(
+            "logic must be the explicit v0.6 vault implementation address. " +
+                "address(0) resolves to the registry default (v0.5.0) and silently deploys v0.5.",
+        );
+    }
+
+    const callData = buildLagoonV2InitCalldata({ initStruct, registry, wrappedNative });
+
+    return encodeFunctionData({
+        abi: lagoonV2FactoryAbi,
+        functionName: "createVaultProxy",
+        args: [logic, initialOwner, initialDelay, callData, salt as Hex],
+    }) as HexString;
+};
+
+/**
+ * Wraps CreateLagoonV2VaultProxyCalldata in a Call object suitable for Safe execution.
+ */
+export const createLagoonV2VaultProxyTrx = ({
+    createVaultProxyParams,
+    factory,
+}: {
+    createVaultProxyParams: LagoonV2CreateVaultProxyArgs;
+    factory: Address;
+}): Unwrapable<Call> => {
+    return createCall({
+        operation: 0,
+        to: factory,
+        value: 0n,
+        data: CreateLagoonV2VaultProxyCalldata(createVaultProxyParams),
+    });
+};
+
+// ---------------------------------------------------------------------------
+// CREATE2 deterministic address predictor
+// ---------------------------------------------------------------------------
+
+/**
+ * LagoonVaultProxy creation bytecode (v0.6).
+ *
+ * Extracted from the v3 factory implementation at 0xd8c3dfb8e47b153913fe217d6ff4c9ecc4bb5544
+ * (Arbitrum mainnet) via CODECOPY analysis: 5580 bytes at factory bytecode offset 0x0aa1.
+ * The same factory implementation is deployed on Ethereum mainnet at the same address.
+ *
+ * Constructor signature: (address logic, address registry, address initialOwner, uint256 initialDelay, bytes call_data)
+ * The factory passes: (logic, registry, initialOwner, initialDelay, call_data) where
+ * registry is read from factory storage, and call_data is the bytes arg from the factory call.
+ *
+ * This bytecode is different from v0.5's OptinProxy creation bytecode.
+ * Using the wrong creation bytecode produces a mismatched CREATE2 address.
+ */
+export const LAGOON_VAULT_PROXY_CREATION_BYTECODE =
+    "0x60c06040526040516115cc3803806115cc833981016040819052610022916104b2565b61002c85856100a8565b8161003782826101b8565b5050828260405161004790610454565b6001600160a01b0390921682526020820152604001604051809103905ff080158015610075573d5f803e3d5ffd5b506001600160a01b031660805261009361008e60805190565b610216565b5050506001600160a01b031660a0525061061d565b5f6001600160a01b03831661011e57816001600160a01b03166345f55b3c6040518163ffffffff1660e01b8152600401602060405180830381865afa1580156100f3573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610117919061059c565b90506101b2565b6001600160a01b03821663f3c665f7610135610262565b856040518363ffffffff1660e01b81526004016101539291906105b5565b602060405180830381865afa15801561016e573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061019291906105cf565b6101af5760405163474245d760e11b815260040160405180910390fd5b50815b92915050565b6101c18261027f565b6040516001600160a01b038316907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b905f90a280511561020a5761020582826102e5565b505050565b610212610358565b5050565b7f7e644d79422f17c01e4894b5f4f588d331ebfa28653d42ae832dc59e38c9798f61023f610379565b8260405161024e9291906105b5565b60405180910390a161025f81610398565b50565b5f61027a5f5f805160206115ac833981519152610389565b905090565b806001600160a01b03163b5f036102b45780604051634c9c8ce360e01b81526004016102ab91906105ee565b60405180910390fd5b805f805160206115ac8339815191525b80546001600160a01b0319166001600160a01b039290921691909117905550565b60605f80846001600160a01b0316846040516103019190610602565b5f60405180830381855af49150503d805f8114610339576040519150601f19603f3d011682016040523d82523d5f602084013e61033e565b606091505b50909250905061034f8583836103d5565b95945050505050565b34156103775760405163b398979f60e01b815260040160405180910390fd5b565b5f5f8051602061158c8339815191525b546001600160a01b0316919050565b6001600160a01b0381166103c1575f604051633173bdd160e11b81526004016102ab91906105ee565b805f8051602061158c8339815191526102c4565b6060826103ea576103e58261042b565b610424565b815115801561040157506001600160a01b0384163b155b156104215783604051639996b31560e01b81526004016102ab91906105ee565b50805b9392505050565b80511561043b5780518082602001fd5b604051630a12f52160e11b815260040160405180910390fd5b6109a180610beb83390190565b80516001600160a01b0381168114610477575f80fd5b919050565b634e487b7160e01b5f52604160045260245ffd5b5f5b838110156104aa578181015183820152602001610492565b50505f910152565b5f805f805f60a086880312156104c6575f80fd5b6104cf86610461565b94506104dd60208701610461565b93506104eb60408701610461565b6060870151608088015191945092506001600160401b0381111561050d575f80fd5b8601601f8101881361051d575f80fd5b80516001600160401b038111156105365761053661047c565b604051601f8201601f19908116603f011681016001600160401b03811182821017156105645761056461047c565b6040528181528282016020018a101561057b575f80fd5b61058c826020830160208601610490565b8093505050509295509295909350565b5f602082840312156105ac575f80fd5b61042482610461565b6001600160a01b0392831681529116602082015260400190565b5f602082840312156105df575f80fd5b81518015158114610424575f80fd5b6001600160a01b0391909116815260200190565b5f8251610613818460208701610490565b9190910192915050565b60805160a0516105a96106425f395f81816038015260f401525f607201526105a95ff3fe60806040526004361061001d575f3560e01c806306433b1b14610027575b610025610070565b005b348015610032575f80fd5b5061005a7f000000000000000000000000000000000000000000000000000000000000000081565b60405161006791906103eb565b60405180910390f35b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031633036101c2575f356001600160e01b03191663278f794360e11b146100d2576040516334ad5dbb60e21b815260040160405180910390fd5b5f806100e136600481846103ff565b8101906100ee919061043a565b915091507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663f3c665f76101296101cc565b6040516001600160e01b031960e084901b1681526001600160a01b0391821660048201529085166024820152604401602060405180830381865afa158015610173573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906101979190610508565b6101b45760405163474245d760e11b815260040160405180910390fd5b6101be82826101f0565b5050565b6101ca61024a565b565b5f6101eb5f80516020610554833981519152546001600160a01b031690565b905090565b6101f98261025a565b6040516001600160a01b038316907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b905f90a28051156102425761023d82826102bd565b505050565b6101be61032f565b6101ca6102556101cc565b61034e565b806001600160a01b03163b5f0361028f5780604051634c9c8ce360e01b815260040161028691906103eb565b60405180910390fd5b5f8051602061055483398151915280546001600160a01b0319166001600160a01b0392909216919091179055565b60605f80846001600160a01b0316846040516102d99190610527565b5f60405180830381855af49150503d805f8114610311576040519150601f19603f3d011682016040523d82523d5f602084013e610316565b606091505b509150915061032685838361036c565b95945050505050565b34156101ca5760405163b398979f60e01b815260040160405180910390fd5b365f80375f80365f845af43d5f803e808015610368573d5ff35b3d5ffd5b6060826103815761037c826103c2565b6103bb565b815115801561039857506001600160a01b0384163b155b156103b85783604051639996b31560e01b815260040161028691906103eb565b50805b9392505050565b8051156103d25780518082602001fd5b604051630a12f52160e11b815260040160405180910390fd5b6001600160a01b0391909116815260200190565b5f808585111561040d575f80fd5b83861115610419575f80fd5b5050820193919092039150565b634e487b7160e01b5f52604160045260245ffd5b5f806040838503121561044b575f80fd5b82356001600160a01b0381168114610461575f80fd5b915060208301356001600160401b0381111561047b575f80fd5b8301601f8101851361048b575f80fd5b80356001600160401b038111156104a4576104a4610426565b604051601f8201601f19908116603f011681016001600160401b03811182821017156104d2576104d2610426565b6040528181528282016020018710156104e9575f80fd5b816020840160208301375f602083830101528093505050509250929050565b5f60208284031215610518575f80fd5b815180151581146103bb575f80fd5b5f82515f5b81811015610546576020818601810151858301520161052c565b505f92019182525091905056fe360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbca26469706673582212201310de98019309a7eb9fb8d90a862cfb1e8bb0576f4d1ffc2eaf580c61d7e42864736f6c634300081a0033608060405234801561000f575f80fd5b506040516109a13803806109a183398101604081905261002e91610158565b81806001600160a01b03811661005e57604051631e4fbdf760e01b81525f60048201526024015b60405180910390fd5b61006781610109565b5050620151808110156100925760405163013ccc8d60e01b8152620151806004820152602401610055565b62278d008111156100bb57604051630b94129b60e31b815262278d006004820152602401610055565b5f1960018190556003556005819055604080518281525f60208201527fa580b4a9812995ffed1b336481c3f3bfeb3414df9f587a9d73856bab25aa4eee910160405180910390a1505061018f565b5f80546001600160a01b038381166001600160a01b0319831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b5f8060408385031215610169575f80fd5b82516001600160a01b038116811461017f575f80fd5b6020939093015192949293505050565b6108058061019c5f395ff3fe6080604052600436106100b7575f3560e01c8063033f8dbc146100bb5780634125ff90146100e3578063432efade146100f9578063554f94db1461011a578063657081b31461012e5780636a42b8f81461014d578063715018a6146101625780638b677b03146101765780638da5cb5b146101a25780639623609d146101b65780639f81aed7146101c9578063a36f141c146101df578063ad3cb1cc146101f4578063f2fde38b14610231578063f6b12cf914610250575b5f80fd5b3480156100c6575f80fd5b506100d060045481565b6040519081526020015b60405180910390f35b3480156100ee575f80fd5b506100d062278d0081565b348015610104575f80fd5b506101186101133660046105e1565b610265565b005b348015610125575f80fd5b50610118610326565b348015610139575f80fd5b5061011861014836600461060c565b6103a8565b348015610158575f80fd5b506100d060055481565b34801561016d575f80fd5b50610118610420565b348015610181575f80fd5b50600254610195906001600160a01b031681565b6040516100da919061062e565b3480156101ad575f80fd5b50610195610433565b6101186101c4366004610656565b610441565b3480156101d4575f80fd5b506100d06201518081565b3480156101ea575f80fd5b506100d060035481565b3480156101ff575f80fd5b50610224604051806040016040528060058152602001640352e302e360dc1b81525081565b6040516100da919061076d565b34801561023c575f80fd5b5061011861024b36600461060c565b610523565b34801561025b575f80fd5b506100d060015481565b61026d610560565b6201518081101561029b5760405163013ccc8d60e01b81526201518060048201526024015b60405180910390fd5b62278d008111156102c457604051630b94129b60e31b815262278d006004820152602401610292565b60048190556005546102d6904261077f565b60038190556005546004546040805192835260208301919091528101919091527fab7d3921ca5710b1f874b995128f2d434b8b28080cc90e5b7ae542d01a41dd6e9060600160405180910390a150565b61032e610560565b60035442101561035157604051634040f3a760e01b815260040160405180910390fd5b7fa580b4a9812995ffed1b336481c3f3bfeb3414df9f587a9d73856bab25aa4eee60045460055460405161038f929190918252602082015260400190565b60405180910390a1600480546005555f90555f19600355565b6103b0610560565b600280546001600160a01b0319166001600160a01b0383161790556005546103d8904261077f565b60018190556002546040519182526001600160a01b0316907fb995d606597d17deae0e0b28f4668c00c67c22d7bed7b95db2a5ac7f1b96aa2b9060200160405180910390a250565b610428610560565b6104315f610592565b565b5f546001600160a01b031690565b610449610560565b60015442101561046c57604051634040f3a760e01b815260040160405180910390fd5b6002546001600160a01b038381169116146104a757600254604051631a160ecd60e11b8152610292916001600160a01b03169060040161062e565b60025460405163278f794360e11b81526001600160a01b0380861692634f1ef2869234926104db92169086906004016107a4565b5f604051808303818588803b1580156104f2575f80fd5b505af1158015610504573d5f803e3d5ffd5b5050600280546001600160a01b031916905550505f1960015550505050565b61052b610560565b6001600160a01b038116610554575f604051631e4fbdf760e01b8152600401610292919061062e565b61055d81610592565b50565b33610569610433565b6001600160a01b031614610431573360405163118cdaa760e01b8152600401610292919061062e565b5f80546001600160a01b038381166001600160a01b0319831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b5f602082840312156105f1575f80fd5b5035919050565b6001600160a01b038116811461055d575f80fd5b5f6020828403121561061c575f80fd5b8135610627816105f8565b9392505050565b6001600160a01b0391909116815260200190565b634e487b7160e01b5f52604160045260245ffd5b5f805f60608486031215610668575f80fd5b8335610673816105f8565b92506020840135610683816105f8565b915060408401356001600160401b0381111561069d575f80fd5b8401601f810186136106ad575f80fd5b80356001600160401b038111156106c6576106c6610642565b604051601f8201601f19908116603f011681016001600160401b03811182821017156106f4576106f4610642565b60405281815282820160200188101561070b575f80fd5b816020840160208301375f602083830101528093505050509250925092565b5f81518084525f5b8181101561074e57602081850181015186830182015201610732565b505f602082860101526020601f19601f83011685010191505092915050565b602081525f610627602083018461072a565b8082018082111561079e57634e487b7160e01b5f52601160045260245ffd5b92915050565b6001600160a01b03831681526040602082018190525f906107c79083018461072a565b94935050505056fea264697066735822122036804f99dd8956664ddace0c969782ec219cf2ab51ffe4b46a5fa0641d88cc0c64736f6c634300081a0033b53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc";
+
+/**
+ * Computes the deterministic CREATE2 vault address for a v0.6 Lagoon vault.
+ *
+ * The factory deploys `new LagoonVaultProxy{salt: salt}(logic, registry, initialOwner, initialDelay, call_data)`.
+ * The CREATE2 address is: keccak256(0xff ++ factory ++ salt ++ keccak256(initCode))[-20:]
+ * where initCode = LAGOON_VAULT_PROXY_CREATION_BYTECODE + abi.encode(logic, registry, initialOwner, initialDelay, call_data)
+ *
+ * @returns EIP-55 checksummed address of the vault that would be deployed.
+ */
+export const calculateLagoonV2DeterministicVaultAddress = ({
+    factoryAddress,
+    logic,
+    initialOwner,
+    initialDelay,
+    initStruct,
+    registry,
+    wrappedNative,
+    salt,
+}: {
+    factoryAddress: Address;
+    logic: Address;
+    initialOwner: Address;
+    initialDelay: bigint;
+    initStruct: LagoonV2InitStruct;
+    registry: Address;
+    wrappedNative: Address;
+    salt: HexString;
+}): Address => {
+    if (logic === ZERO_ADDRESS) {
+        throw new Error(
+            "logic must be the explicit v0.6 vault implementation address. " +
+                "address(0) resolves to the registry default (v0.5.0) and silently deploys v0.5.",
+        );
+    }
+
+    // Build the call_data (same as what gets passed to the factory bytes overload)
+    const callData = buildLagoonV2InitCalldata({ initStruct, registry, wrappedNative });
+
+    // ABI-encode constructor args: (address logic, address registry, address initialOwner, uint256 initialDelay, bytes call_data)
+    const constructorEncoded = encodeAbiParameters(
+        [
+            { name: "logic", type: "address" },
+            { name: "registry", type: "address" },
+            { name: "initialOwner", type: "address" },
+            { name: "initialDelay", type: "uint256" },
+            { name: "call_data", type: "bytes" },
+        ],
+        [logic, registry, initialOwner, initialDelay, callData],
+    );
+
+    // Full init code = creation bytecode + abi.encode(constructor args)
+    const initCode = (LAGOON_VAULT_PROXY_CREATION_BYTECODE + constructorEncoded.slice(2)) as Hex;
+    const initCodeHash = keccak256(initCode);
+
+    // CREATE2: keccak256(0xff ++ factory ++ salt ++ keccak256(initCode))
+    // Use encodePacked (solidity-packed, no length/offset padding) for the create2 preimage.
+    const create2Input = encodePacked(
+        ["bytes1", "address", "bytes32", "bytes32"],
+        ["0xff", factoryAddress, salt as Hex, initCodeHash],
+    );
+
+    const hash = keccak256(create2Input);
+    // Take the last 20 bytes of the hash as the address
+    const addressHex = `0x${hash.slice(-40)}`;
+    return getAddress(addressHex) as Address;
+};