feat: deployment scripts, E2E tests, and documentation

- DeployBase: shared deployment logic with OptimizerV3 UUPS proxy
- DeployBaseMainnet: Base mainnet configuration (feeDest, WETH, factory)
- DeployLocal: local Anvil deployment with OptimizerV3
- UpgradeOptimizer: UUPS upgrade script for existing proxy
- DEPLOYMENT_RUNBOOK: step-by-step mainnet deployment guide
- E2E tests: recenter position verification, optimizer integration
- Landing page: updated docs for OptimizerV3 and protocol changes
- Remove dead DeployScript2.sol

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

onchain/deployments-local.json

@@ -2,6 +2,7 @@
   "contracts": {
     "Kraiken": "0xff196f1e3a895404d073b8611252cf97388773a7",
     "Stake": "0xc36e784e1dff616bdae4eac7b310f0934faf04a4",
-    "LiquidityManager": "0x33d10f2449ffede92b43d4fba562f132ba6a766a"
+    "LiquidityManager": "0x33d10f2449ffede92b43d4fba562f132ba6a766a",
+    "OptimizerProxy": "0x1cf34658e7df9a46ad61486d007a8d62aec9891e"
   }
 }

onchain/script/DeployBase.sol

@@ -4,7 +4,7 @@ pragma solidity ^0.8.19;
 import "../src/Kraiken.sol";
 
 import { LiquidityManager } from "../src/LiquidityManager.sol";
-import "../src/Optimizer.sol";
+import "../src/OptimizerV3.sol";
 import "../src/Stake.sol";
 import "../src/helpers/UniswapHelpers.sol";
 import { ERC1967Proxy } from "@openzeppelin/proxy/ERC1967/ERC1967Proxy.sol";
@@ -71,14 +71,14 @@ contract DeployBase is Script {
             console.log("Pool initialized");
         }
 
-        // Deploy Optimizer (if not already deployed)
+        // Deploy OptimizerV3 (if not already deployed)
         address optimizerAddress;
         if (optimizer == address(0)) {
-            Optimizer optimizerImpl = new Optimizer();
+            OptimizerV3 optimizerImpl = new OptimizerV3();
             bytes memory params = abi.encodeWithSignature("initialize(address,address)", address(kraiken), address(stake));
             ERC1967Proxy proxy = new ERC1967Proxy(address(optimizerImpl), params);
             optimizerAddress = address(proxy);
-            console.log("Optimizer deployed at:", optimizerAddress);
+            console.log("OptimizerV3 deployed at:", optimizerAddress);
         } else {
             optimizerAddress = optimizer;
             console.log("Using existing optimizer at:", optimizerAddress);
@@ -94,16 +94,16 @@ contract DeployBase is Script {
         // Set liquidity manager in Kraiken
         kraiken.setLiquidityManager(address(liquidityManager));
 
-        // Note: Fund liquidity manager manually after deployment
-        console.log("Remember to fund LiquidityManager with ETH");
-
         console.log("\n=== Deployment Complete ===");
         console.log("Kraiken:", address(kraiken));
         console.log("Stake:", address(stake));
         console.log("Pool:", address(pool));
         console.log("LiquidityManager:", address(liquidityManager));
-        console.log("Optimizer:", optimizerAddress);
+        console.log("OptimizerV3:", optimizerAddress);
-        console.log("\nNext step: Wait a few minutes then call liquidityManager.recenter()");
+        console.log("\nPost-deploy steps:");
+        console.log("  1. Fund LiquidityManager with ETH");
+        console.log("  2. Set recenterAccess to txnBot: lm.setRecenterAccess(txnBot) from feeDestination");
+        console.log("  3. Wait a few minutes, then call recenter()");
 
         vm.stopBroadcast();
     }

onchain/script/DeployBaseMainnet.sol

@@ -12,13 +12,12 @@ import { DeployBase } from "./DeployBase.sol";
 contract DeployBaseMainnet is DeployBase {
     constructor() {
         // Base mainnet configuration
-        // TODO: Update fee destination for mainnet
+        feeDest = 0xf6a3eef9088A255c32b6aD2025f83E57291D9011;
-        feeDest = 0xf6a3eef9088A255c32b6aD2025f83E57291D9011; // UPDATE THIS FOR MAINNET
 
-        weth = 0x4200000000000000000000000000000000000006; // WETH on Base mainnet
+        weth = 0x4200000000000000000000000000000000000006; // WETH on Base
-        v3Factory = 0x33128a8fC17869897dcE68Ed026d694621f6FDfD; // Uniswap V3 Factory on Base mainnet
+        v3Factory = 0x33128a8fC17869897dcE68Ed026d694621f6FDfD; // Uniswap V3 Factory on Base
 
-        // Leave as address(0) to deploy new optimizer
+        // Deploy fresh OptimizerV3 (UUPS proxy)
         optimizer = address(0);
     }
 }

onchain/script/DeployLocal.sol

@@ -4,7 +4,7 @@ pragma solidity ^0.8.19;
 import "../src/Kraiken.sol";
 
 import { LiquidityManager } from "../src/LiquidityManager.sol";
-import "../src/Optimizer.sol";
+import "../src/OptimizerV3.sol";
 import "../src/Stake.sol";
 import "../src/helpers/UniswapHelpers.sol";
 import { ERC1967Proxy } from "@openzeppelin/proxy/ERC1967/ERC1967Proxy.sol";
@@ -86,12 +86,12 @@ contract DeployLocal is Script {
             console.log("      Pool initialized at 1 cent price");
         }
 
-        // Deploy Optimizer
+        // Deploy OptimizerV3
-        Optimizer optimizerImpl = new Optimizer();
+        OptimizerV3 optimizerImpl = new OptimizerV3();
         bytes memory params = abi.encodeWithSignature("initialize(address,address)", address(kraiken), address(stake));
         ERC1967Proxy proxy = new ERC1967Proxy(address(optimizerImpl), params);
         address optimizerAddress = address(proxy);
-        console.log("\n[4/6] Optimizer deployed:", optimizerAddress);
+        console.log("\n[4/6] OptimizerV3 deployed:", optimizerAddress);
 
         // Deploy LiquidityManager
         liquidityManager = new LiquidityManager(v3Factory, weth, address(kraiken), optimizerAddress);
@@ -112,7 +112,7 @@ contract DeployLocal is Script {
         console.log("Stake:", address(stake));
         console.log("Pool:", address(pool));
         console.log("LiquidityManager:", address(liquidityManager));
-        console.log("Optimizer:", optimizerAddress);
+        console.log("OptimizerV3:", optimizerAddress);
 
         console.log("\n=== Next Steps ===");
         console.log("1. Fund LiquidityManager with ETH:");

onchain/script/DeployScript2.sol

@@ -1,32 +0,0 @@
-pragma solidity ^0.8.19;
-
-import "../src/Kraiken.sol";
-
-import { LiquidityManager } from "../src/LiquidityManager.sol";
-import "../src/Optimizer.sol";
-import "../src/Stake.sol";
-import "../src/helpers/UniswapHelpers.sol";
-import { ERC1967Proxy } from "@openzeppelin/proxy/ERC1967/ERC1967Proxy.sol";
-import "@uniswap-v3-core/interfaces/IUniswapV3Factory.sol";
-import "@uniswap-v3-core/interfaces/IUniswapV3Pool.sol";
-import "forge-std/Script.sol";
-
-uint24 constant FEE = uint24(10_000);
-
-contract DeployScript is Script {
-    using UniswapHelpers for IUniswapV3Pool;
-
-    bool internal token0isWeth;
-    address internal feeDest;
-    address internal weth;
-    address internal v3Factory;
-    address internal twabc;
-
-    function run() public {
-        string memory seedPhrase = vm.readFile(".secret");
-        uint256 privateKey = vm.deriveKey(seedPhrase, 0);
-        vm.startBroadcast(privateKey);
-        address sender = vm.addr(privateKey);
-        console.log(sender);
-    }
-}

onchain/script/UpgradeOptimizer.sol

@@ -0,0 +1,50 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+pragma solidity ^0.8.19;
+
+import "../src/OptimizerV3.sol";
+import { UUPSUpgradeable } from "@openzeppelin/proxy/utils/UUPSUpgradeable.sol";
+import "forge-std/Script.sol";
+
+/**
+ * @title UpgradeOptimizer
+ * @notice Upgrades an existing Optimizer UUPS proxy to OptimizerV3 implementation.
+ * @dev Usage:
+ *   OPTIMIZER_PROXY=0x... forge script script/UpgradeOptimizer.sol \
+ *     --rpc-url <RPC_URL> --broadcast
+ *
+ *   The caller must be the proxy admin (the address that called initialize()).
+ */
+contract UpgradeOptimizer is Script {
+    function run() public {
+        address proxyAddress = vm.envAddress("OPTIMIZER_PROXY");
+        require(proxyAddress != address(0), "OPTIMIZER_PROXY env var required");
+
+        string memory seedPhrase = vm.readFile(".secret");
+        uint256 privateKey = vm.deriveKey(seedPhrase, 0);
+        vm.startBroadcast(privateKey);
+        address sender = vm.addr(privateKey);
+
+        console.log("\n=== Optimizer UUPS Upgrade ===");
+        console.log("Proxy address:", proxyAddress);
+        console.log("Admin (sender):", sender);
+
+        // Deploy new OptimizerV3 implementation
+        OptimizerV3 newImpl = new OptimizerV3();
+        console.log("New OptimizerV3 implementation:", address(newImpl));
+
+        // Upgrade proxy to new implementation (no reinitialize needed — storage layout compatible)
+        UUPSUpgradeable(proxyAddress).upgradeTo(address(newImpl));
+        console.log("Proxy upgraded to OptimizerV3");
+
+        // Verify upgrade by calling getLiquidityParams through the proxy
+        OptimizerV3 upgraded = OptimizerV3(proxyAddress);
+        (uint256 ci, uint256 as_, uint24 aw, uint256 dd) = upgraded.getLiquidityParams();
+        console.log("\n=== Post-Upgrade Verification ===");
+        console.log("capitalInefficiency:", ci);
+        console.log("anchorShare:", as_);
+        console.log("anchorWidth:", uint256(aw));
+        console.log("discoveryDepth:", dd);
+
+        vm.stopBroadcast();
+    }
+}