@skate-org/amm-evm-v2 2.0.0-alpha.4 → 2.0.0-alpha.6

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # @skate-org/amm-evm-v2
 
+## 2.0.0-alpha.6 — 2026-05-07
+
+- `getKernelPublicClient(mode)` now reads the kernel chain from
+  `KernelChain(mode)` (the new `KERNEL_CHAIN_BY_MODE` table in core)
+  instead of hardcoding `megaethChain`. Default behavior is unchanged
+  (every env still resolves to MegaETH today); future per-env kernel-chain
+  switches are one-line edits in core.
+- Lens helpers + readers continue to call `KernelManagerAddress(mode)`,
+  which now throws for STAGING / PRODUCTION (see `@skate-org/amm-core-v2`
+  alpha.6 notes). DEV behavior unchanged.
+
+## 2.0.0-alpha.5 — 2026-05-06
+
+- **Kernel lens helpers ported from v1.** Adds `simulateSwap`,
+  `simulateMint`, `simulateBurn`, `simulateDecreaseLiquidity` —
+  static-call wrappers around `KernelManager.lens{Swap,Mint,Burn,DecreaseLiquidity}`.
+  Each returns named fields matching the ABI output (e.g.
+  `simulateMint` → `{ amount0Used, amount1Used, liquidityAmount, returnData }`)
+  and accepts an optional viem client for test injection. Errors flow
+  through the read-path (`EvmReadError`) since lens calls don't write
+  state. Same DEV/STAGING/PRODUCTION mode handling as the readers.
+- Internal: extracted `resolveKernelClient` to `kernel/_client.ts` so
+  readers and lens helpers share the same client-resolution logic.
+- Internal (tests): extracted the `mockKernelClient` helper to
+  `test/_helpers.ts`. Reader and lens test suites now share one
+  union-ABI mock transport instead of duplicating the implementation.
+
 ## 2.0.0-alpha.4 — 2026-05-06
 
 Lockstep bump — paired with the `SwapQuote` schema fix in

package/dist/chain-clients.d.ts

@@ -16,12 +16,12 @@ import { CHAIN, type EnvModeWithConfig } from "@skate-org/amm-core-v2";
  */
 export declare const megaethChain: Chain;
 /**
- * Return a fresh `PublicClient` bound to the MegaETH kernel chain.
+ * Return a fresh `PublicClient` bound to the kernel chain for `mode`.
  *
- * MegaETH is the kernel chain for all environment modes (DEV/STAGING/
- * PRODUCTION) in SDK v2. The `mode` parameter is accepted for API
- * symmetry with the rest of the SDK and as a forward-compatible extension
- * point (e.g. a future testnet kernel).
+ * Today every env (`DEV` / `STAGING` / `PRODUCTION`) resolves to MegaETH —
+ * see `KERNEL_CHAIN_BY_MODE` in `@skate-org/amm-core-v2`. Pointing a future
+ * env at a different kernel chain is a one-line edit there; this factory
+ * reads from that mapping so client + address tables stay in sync.
  *
  * Pure — no singletons, no caching. Pass a custom `transport` to override
  * the default RPC (useful for tests and custom RPC providers).

package/dist/chain-clients.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chain-clients.d.ts","sourceRoot":"","sources":["../src/chain-clients.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,KAAK,EACV,KAAK,YAAY,EACjB,KAAK,SAAS,EACf,MAAM,MAAM,CAAC;AAEd,OAAO,EAEL,KAAK,EAIL,KAAK,iBAAiB,EACvB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,YAAY,EAAE,KAYzB,CAAC;AA4CH;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,iBAAiB,EACvB,SAAS,CAAC,EAAE,SAAS,GACpB,YAAY,CAKd;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,iBAAiB,EACvB,SAAS,CAAC,EAAE,SAAS,GACpB,YAAY,CAsBd"}
+{"version":3,"file":"chain-clients.d.ts","sourceRoot":"","sources":["../src/chain-clients.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,KAAK,EACV,KAAK,YAAY,EACjB,KAAK,SAAS,EACf,MAAM,MAAM,CAAC;AAEd,OAAO,EAEL,KAAK,EAKL,KAAK,iBAAiB,EACvB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,YAAY,EAAE,KAYzB,CAAC;AA4CH;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,iBAAiB,EACvB,SAAS,CAAC,EAAE,SAAS,GACpB,YAAY,CAcd;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,iBAAiB,EACvB,SAAS,CAAC,EAAE,SAAS,GACpB,YAAY,CAsBd"}

package/dist/index.cjs

@@ -39,6 +39,10 @@ __export(index_exports, {
   readTick: () => readTick,
   readTickBitmap: () => readTickBitmap,
   readUserPoolBalances: () => readUserPoolBalances,
+  simulateBurn: () => simulateBurn,
+  simulateDecreaseLiquidity: () => simulateDecreaseLiquidity,
+  simulateMint: () => simulateMint,
+  simulateSwap: () => simulateSwap,
   submitAction: () => submitAction,
   submitApproval: () => submitApproval,
   submitSwap: () => submitSwap,
@@ -83,9 +87,17 @@ function resolveRpcUrl(chain, mode) {
   return config?.rpcEndpoints?.[chain] ?? DEFAULT_RPC[chain];
 }
 function getKernelPublicClient(mode, transport) {
+  const { mode: baseMode } = (0, import_amm_core_v2.normalizeMode)(mode);
+  const kernelChainId = (0, import_amm_core_v2.KernelChain)(baseMode);
+  const chainDef = chainDefFor(kernelChainId);
+  if (!chainDef) {
+    throw new Error(
+      `getKernelPublicClient: no chain definition registered for kernel chain ${kernelChainId} (mode=${baseMode}); update chainDefFor() in chain-clients.ts to support it.`
+    );
+  }
   return (0, import_viem.createPublicClient)({
-    chain: megaethChain,
-    transport: transport ?? (0, import_viem.http)(resolveRpcUrl(import_amm_core_v2.CHAIN.MEGAETH, mode))
+    chain: chainDef,
+    transport: transport ?? (0, import_viem.http)(resolveRpcUrl(kernelChainId, mode))
   });
 }
 function getSourcePublicClient(chain, mode, transport) {
@@ -162,11 +174,15 @@ function wrapWriteError(err, functionName) {
 // src/kernel/reader.ts
 var import_amm_bindings = require("@skate-org/amm-bindings");
 var import_amm_core_v23 = require("@skate-org/amm-core-v2");
-function resolveClient(mode, client) {
+
+// src/kernel/_client.ts
+function resolveKernelClient(mode, client) {
   return client ?? getKernelPublicClient(mode);
 }
+
+// src/kernel/reader.ts
 async function readPool(kernelPool, mode, client) {
-  const c = resolveClient(mode, client);
+  const c = resolveKernelClient(mode, client);
   try {
     const [slot0, liquidity] = await Promise.all([
       c.readContract({
@@ -200,7 +216,7 @@ async function readPool(kernelPool, mode, client) {
 async function readPosition(tokenId, mode, client) {
   const { mode: baseMode } = (0, import_amm_core_v23.normalizeMode)(mode);
   const manager = (0, import_amm_core_v23.KernelManagerAddress)(baseMode);
-  const c = resolveClient(mode, client);
+  const c = resolveKernelClient(mode, client);
   try {
     const raw = await c.readContract({
       address: manager,
@@ -227,7 +243,7 @@ async function readPosition(tokenId, mode, client) {
   }
 }
 async function readTickBitmap(kernelPool, wordPos, mode, client) {
-  const c = resolveClient(mode, client);
+  const c = resolveKernelClient(mode, client);
   try {
     const word = await c.readContract({
       address: kernelPool,
@@ -241,7 +257,7 @@ async function readTickBitmap(kernelPool, wordPos, mode, client) {
   }
 }
 async function readTick(kernelPool, tick, mode, client) {
-  const c = resolveClient(mode, client);
+  const c = resolveKernelClient(mode, client);
   try {
     const raw = await c.readContract({
       address: kernelPool,
@@ -264,7 +280,7 @@ async function readTick(kernelPool, tick, mode, client) {
   }
 }
 async function computePositionAmounts(tokenId, mode, client) {
-  const c = resolveClient(mode, client);
+  const c = resolveKernelClient(mode, client);
   const position = await readPosition(tokenId, mode, c);
   const { slot0 } = await readPool(position.pool, mode, c);
   const sqrtLower = (0, import_amm_core_v23.getSqrtRatioAtTick)(position.tickLower);
@@ -319,15 +335,103 @@ function decodeTickBitmapWord(word, wordPos, tickSpacing) {
   return result;
 }
 
-// src/periphery/reader.ts
+// src/kernel/lens.ts
 var import_amm_bindings2 = require("@skate-org/amm-bindings");
 var import_amm_core_v24 = require("@skate-org/amm-core-v2");
-function resolveClient2(chain, mode, client) {
+async function simulateSwap(params, mode, client) {
+  const { mode: baseMode } = (0, import_amm_core_v24.normalizeMode)(mode);
+  const c = resolveKernelClient(mode, client);
+  try {
+    const out = await c.simulateContract({
+      address: (0, import_amm_core_v24.KernelManagerAddress)(baseMode),
+      abi: import_amm_bindings2.KernelManagerABI,
+      functionName: "lensSwap",
+      args: [
+        params.pool,
+        params.recipient,
+        params.zeroForOne,
+        params.amountSpecified,
+        params.sqrtPriceLimitX96
+      ]
+    });
+    const [amount0, amount1, sqrtPriceX96After, returnData] = out.result;
+    return { amount0, amount1, sqrtPriceX96After, returnData };
+  } catch (err) {
+    throw wrapReadError(err, "simulateSwap");
+  }
+}
+async function simulateMint(params, mode, client) {
+  const { mode: baseMode } = (0, import_amm_core_v24.normalizeMode)(mode);
+  const c = resolveKernelClient(mode, client);
+  try {
+    const out = await c.simulateContract({
+      address: (0, import_amm_core_v24.KernelManagerAddress)(baseMode),
+      abi: import_amm_bindings2.KernelManagerABI,
+      functionName: "lensMint",
+      args: [
+        params.pool,
+        params.recipient,
+        params.tickLower,
+        params.tickUpper,
+        params.amount0,
+        params.amount1,
+        params.data
+      ]
+    });
+    const [amount0Used, amount1Used, liquidityAmount, returnData] = out.result;
+    return { amount0Used, amount1Used, liquidityAmount, returnData };
+  } catch (err) {
+    throw wrapReadError(err, "simulateMint");
+  }
+}
+async function simulateBurn(params, mode, client) {
+  const { mode: baseMode } = (0, import_amm_core_v24.normalizeMode)(mode);
+  const c = resolveKernelClient(mode, client);
+  try {
+    const out = await c.simulateContract({
+      address: (0, import_amm_core_v24.KernelManagerAddress)(baseMode),
+      abi: import_amm_bindings2.KernelManagerABI,
+      functionName: "lensBurn",
+      args: [
+        params.pool,
+        params.recipient,
+        params.tickLower,
+        params.tickUpper,
+        params.amount
+      ]
+    });
+    const [amount0, amount1, returnData] = out.result;
+    return { amount0, amount1, returnData };
+  } catch (err) {
+    throw wrapReadError(err, "simulateBurn");
+  }
+}
+async function simulateDecreaseLiquidity(params, mode, client) {
+  const { mode: baseMode } = (0, import_amm_core_v24.normalizeMode)(mode);
+  const c = resolveKernelClient(mode, client);
+  try {
+    const out = await c.simulateContract({
+      address: (0, import_amm_core_v24.KernelManagerAddress)(baseMode),
+      abi: import_amm_bindings2.KernelManagerABI,
+      functionName: "lensDecreaseLiquidity",
+      args: [params.tokenId, params.liquidity]
+    });
+    const [amount0, amount1, returnData] = out.result;
+    return { amount0, amount1, returnData };
+  } catch (err) {
+    throw wrapReadError(err, "simulateDecreaseLiquidity");
+  }
+}
+
+// src/periphery/reader.ts
+var import_amm_bindings3 = require("@skate-org/amm-bindings");
+var import_amm_core_v25 = require("@skate-org/amm-core-v2");
+function resolveClient(chain, mode, client) {
   return client ?? getSourcePublicClient(chain, mode);
 }
 async function readPeripheryPool(chain, kernelPool, mode, client) {
-  const { mode: baseMode } = (0, import_amm_core_v24.normalizeMode)(mode);
-  const details = (0, import_amm_core_v24.getPeripheryDetailsByKernelPoolAndChainId)(
+  const { mode: baseMode } = (0, import_amm_core_v25.normalizeMode)(mode);
+  const details = (0, import_amm_core_v25.getPeripheryDetailsByKernelPoolAndChainId)(
     kernelPool,
     chain,
     baseMode
@@ -339,7 +443,7 @@ async function readPeripheryPool(chain, kernelPool, mode, client) {
     );
   }
   const address = details.address;
-  const c = resolveClient2(chain, mode, client);
+  const c = resolveClient(chain, mode, client);
   try {
     const [
       balancesAvailableRaw,
@@ -352,37 +456,37 @@ async function readPeripheryPool(chain, kernelPool, mode, client) {
     ] = await Promise.all([
       c.readContract({
         address,
-        abi: import_amm_bindings2.PeripheryPoolABI,
+        abi: import_amm_bindings3.PeripheryPoolABI,
         functionName: "balancesAvailable"
       }),
       c.readContract({
         address,
-        abi: import_amm_bindings2.PeripheryPoolABI,
+        abi: import_amm_bindings3.PeripheryPoolABI,
         functionName: "dustAmount0"
       }),
       c.readContract({
         address,
-        abi: import_amm_bindings2.PeripheryPoolABI,
+        abi: import_amm_bindings3.PeripheryPoolABI,
         functionName: "dustAmount1"
       }),
       c.readContract({
         address,
-        abi: import_amm_bindings2.PeripheryPoolABI,
+        abi: import_amm_bindings3.PeripheryPoolABI,
         functionName: "token0"
       }),
       c.readContract({
         address,
-        abi: import_amm_bindings2.PeripheryPoolABI,
+        abi: import_amm_bindings3.PeripheryPoolABI,
         functionName: "token1"
       }),
       c.readContract({
         address,
-        abi: import_amm_bindings2.PeripheryPoolABI,
+        abi: import_amm_bindings3.PeripheryPoolABI,
         functionName: "fee"
       }),
       c.readContract({
         address,
-        abi: import_amm_bindings2.PeripheryPoolABI,
+        abi: import_amm_bindings3.PeripheryPoolABI,
         functionName: "kernelPool"
       })
     ]);
@@ -405,8 +509,8 @@ async function readPeripheryPool(chain, kernelPool, mode, client) {
   }
 }
 async function readUserPoolBalances(chain, kernelPool, user, mode, client) {
-  const { mode: baseMode } = (0, import_amm_core_v24.normalizeMode)(mode);
-  const details = (0, import_amm_core_v24.getPeripheryDetailsByKernelPoolAndChainId)(
+  const { mode: baseMode } = (0, import_amm_core_v25.normalizeMode)(mode);
+  const details = (0, import_amm_core_v25.getPeripheryDetailsByKernelPoolAndChainId)(
     kernelPool,
     chain,
     baseMode
@@ -417,11 +521,11 @@ async function readUserPoolBalances(chain, kernelPool, user, mode, client) {
       `no periphery entry for kernelPool=${kernelPool} chain=${chain} mode=${baseMode}`
     );
   }
-  const c = resolveClient2(chain, mode, client);
+  const c = resolveClient(chain, mode, client);
   try {
     const raw = await c.readContract({
       address: details.address,
-      abi: import_amm_bindings2.PeripheryPoolABI,
+      abi: import_amm_bindings3.PeripheryPoolABI,
       functionName: "usersData",
       args: [user]
     });
@@ -483,7 +587,7 @@ async function submitApproval(wallet, params, mode) {
 
 // src/events/kernel.ts
 var import_viem2 = require("viem");
-var import_amm_bindings3 = require("@skate-org/amm-bindings");
+var import_amm_bindings4 = require("@skate-org/amm-bindings");
 var KERNEL_EVENT_NAMES = [
   "Burn",
   "Collect",
@@ -501,7 +605,7 @@ var KERNEL_EVENT_NAMES = [
 function parseKernelEventLog(log) {
   try {
     const decoded = (0, import_viem2.decodeEventLog)({
-      abi: import_amm_bindings3.KernelEventEmitterABI,
+      abi: import_amm_bindings4.KernelEventEmitterABI,
       data: log.data,
       topics: log.topics
     });
@@ -522,7 +626,7 @@ function parseKernelEventLog(log) {
 
 // src/events/periphery.ts
 var import_viem3 = require("viem");
-var import_amm_bindings4 = require("@skate-org/amm-bindings");
+var import_amm_bindings5 = require("@skate-org/amm-bindings");
 var PERIPHERY_EVENT_NAMES = [
   "AmountSettled",
   "Burned",
@@ -538,7 +642,7 @@ var PERIPHERY_EVENT_NAMES = [
 function parsePeripheryEventLog(log) {
   try {
     const decoded = (0, import_viem3.decodeEventLog)({
-      abi: import_amm_bindings4.PeripheryEventEmitterABI,
+      abi: import_amm_bindings5.PeripheryEventEmitterABI,
       data: log.data,
       topics: log.topics
     });
@@ -558,10 +662,10 @@ function parsePeripheryEventLog(log) {
 }
 
 // src/events/watch.ts
-var import_amm_bindings5 = require("@skate-org/amm-bindings");
+var import_amm_bindings6 = require("@skate-org/amm-bindings");
 function watchKernelEvents(client, address, opts) {
   return client.watchContractEvent({
-    abi: import_amm_bindings5.KernelEventEmitterABI,
+    abi: import_amm_bindings6.KernelEventEmitterABI,
     address,
     onLogs: (logs) => {
       for (const log of logs) {
@@ -576,7 +680,7 @@ function watchKernelEvents(client, address, opts) {
 }
 function watchPeripheryEvents(client, address, opts) {
   return client.watchContractEvent({
-    abi: import_amm_bindings5.PeripheryEventEmitterABI,
+    abi: import_amm_bindings6.PeripheryEventEmitterABI,
     address,
     onLogs: (logs) => {
       for (const log of logs) {
@@ -610,6 +714,10 @@ function watchPeripheryEvents(client, address, opts) {
   readTick,
   readTickBitmap,
   readUserPoolBalances,
+  simulateBurn,
+  simulateDecreaseLiquidity,
+  simulateMint,
+  simulateSwap,
   submitAction,
   submitApproval,
   submitSwap,