@skate-org/amm-evm-v2 2.0.0-beta.1 → 2.0.0-beta.11

package/CHANGELOG.md

@@ -1,131 +1,54 @@
 # @skate-org/amm-evm-v2
 
-## 2.0.0-beta.1 — 2026-05-07
+## 2.0.0-beta.11 — 2026-05-30
 
-Lockstep bump — paired with the `findTokensBySymbol` /
-`getTokenSymbol` additions in `@skate-org/amm-core-v2`. This package's
-source is unchanged versus `2.0.0-beta.0`.
+Adds the periphery calldata-builder surface needed by the backend v1 → v2
+port (quote routes that need to mirror on-chain calldata without
+submitting), plus a kernel-side balances reader.
 
-## 2.0.0-beta.0 — 2026-05-07
+- `periphery/calldata.ts` (new module): `getSwapCalldata`,
+  `getMintCalldata`, `getBurnCalldata`, `getIncreaseLiquidityCalldata`,
+  `getDecreaseLiquidityCalldata`. Pure ABI encoders over `PeripheryPoolABI`
+  — no client / no signing / no submission. Use submitters in `submit.ts`
+  for the full build-and-send flow.
+- `kernel/reader.ts`: `readKernelBalances(kernelPool, mode)` returning
+  `{ balance0, balance1 }`. Parallel reads; mirrors the `readPool` style.
+- Note: `getMintCalldata` uses correct camelCase (v1 was `getMintcalldata`,
+  a typo); the rest match v1 names verbatim.
 
-First **beta**. Promoted under the `beta` dist-tag; `latest` stays at
-`1.0.0` (v1 line) per the policy in `CLAUDE.md`. **Loose beta** —
-documented breaking changes are still allowed within `2.0.0-beta.x`;
-`2.0.0` final is the strict surface freeze.
+## 2.0.0-beta.10 — 2026-05-29
 
-**Breaking — internal-leak surface pull.**
+Lockstep — no source changes. `KernelManagerAddress(mode)` / `PeripheryDeploymentFor(chain, mode)`
+re-exported from `@skate-org/amm-core-v2@2.0.0-beta.10` now resolve for STAGING/PRODUCTION
+(alias DEV) instead of throwing `notDeployed`. EVM readers/writers that route on `EnvMode`
+get coverage for all three modes without call-site changes.
 
-- `DEFAULT_DEV_API_ENDPOINT` is no longer re-exported from the package
-  barrel. It was `createDevConfig`'s private default value and
-  duplicated the canonical URL in `@skate-org/amm-api-v2`. Use
-  `createDevConfig({...})` (which still accepts a custom
-  `apiEndpoint`); the previously-public string was never needed.
+## 2.0.0-beta.9 — 2026-05-26
 
-Surface count: 28 → 27. See `STABILITY.md` (repo root) for the full
-classification.
+Lockstep — no source changes. Paired with `@skate-org/amm-core-v2@2.0.0-beta.9`
+which added STAGING/PRODUCTION env support to the deployment maps.
 
-## 2.0.0-alpha.8 — 2026-05-07
+## 2.0.0-beta.8 — 2026-05-21
 
-Lockstep bump — paired with the api `streamSwapQuote` going live as a
-polling stub for the deferred WebSocket. This package's source is
-unchanged versus `2.0.0-alpha.7`.
+Lockstep — no source changes. Paired with `@skate-org/amm-sui-v2@2.0.0-beta.8`.
 
-## 2.0.0-alpha.7 — 2026-05-07
+## 2.0.0-beta.7 — 2026-05-21
 
-Lockstep bump — paired with the api action-by-user clients, polling
-`subscribeSwapQuote` helper, and svm browser-bundle build fix.
-This package's source is unchanged versus `2.0.0-alpha.6`.
+Made `DEFAULT_DEV_API_ENDPOINT` module-private in `devConfig.ts`
+(already off the barrel since beta.0; this drops the `export`
+keyword). No public surface change.
 
-## 2.0.0-alpha.6 — 2026-05-07
+## 2.0.0-beta (cumulative, 2026-05-07 → 2026-05-21)
 
-- `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.
+- **Surface pull (beta.0):** `DEFAULT_DEV_API_ENDPOINT` removed
+  from the package barrel; only the per-pool / per-chain DEV config
+  helpers are public.
+- **Kernel lens helpers (alpha.5 → beta):** `simulateSwap`,
+  `simulateMint`, `simulateBurn`, `simulateDecreaseLiquidity`
+  static-call wrappers over `KernelManager.lens*`. Now consumed by
+  the api package's quote routes.
+- **Per-env kernel chain (alpha.6 → beta):** `getKernelPublicClient(mode)`
+  reads `KernelChain(mode)` instead of hardcoding `megaethChain`.
+  DEV resolves to MegaETH today.
 
-## 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
-`@skate-org/amm-api-v2`. This package's source is unchanged versus
-`2.0.0-alpha.3`.
-
-## 2.0.0-alpha.3 — 2026-05-06
-
-Lockstep bump — paired with the SVM/Sui efficiency pass in
-`@skate-org/amm-svm-v2` and `@skate-org/amm-sui-v2`. This package's
-source is unchanged versus `2.0.0-alpha.2`.
-
-## 2.0.0-alpha.2 — 2026-05-05
-
-Plan C of the SVM/Sui integration. Adds `@skate-org/amm-sui-v2` to
-the workspace; this package's source is unchanged versus
-`2.0.0-alpha.1` (re-versioned in lockstep).
-
-## 2.0.0-alpha.1 — 2026-05-05
-
-Plan B of the SVM/Sui integration. Adds `@skate-org/amm-svm-v2` to
-the workspace; this package's source is unchanged versus
-`2.0.0-alpha.0` (re-versioned in lockstep).
-
-## 2.0.0-alpha.0 — 2026-05-05
-
-Plan A of the SVM/Sui integration.
-
-- **Breaking:** uniswap-v3 math no longer ships from
-  `@skate-org/amm-evm-v2`. Import from `@skate-org/amm-core-v2`
-  instead. All function names unchanged. Top-level barrel re-exports
-  via the umbrella (`@skate-org/amm-v2`) continue to work without
-  callsite changes.
-- Removed: `packages/evm/src/math/` directory and corresponding
-  tests (relocated to `core`).
-
-## 1.0.0 — 2026-05-04
-
-Realigning all four `@skate-org/amm-*-v2` packages at a single version
-for the coherent v1 SDK release. No source changes vs 0.4.1 — purely a
-versioning realignment so the four packages move together going forward.
-
-## 0.4.1 — 2026-04-29
-
-- Flip DEV MegaETH RPC default to `https://mainnet.megaeth.com/rpc` (the
-  carrot.megaeth.com endpoint is no longer the canonical DEV RPC).
-- Extend DEV smoke to exercise `readPool` (kernel) and `readPeripheryPool`
-  (Arbitrum) against real contracts.
-
-## 0.4.0 — 2026-04-25
-
-- Phase 4: kernel + periphery event-decoding framework. `decodeKernel*`
-  / `decodePeriphery*` helpers; `watch*` event subscription utilities.
-
-## 0.3.0 — 2026-04-23
-
-- Phase 3: `readPool`, `readPeripheryPool`, `readPosition` reader helpers;
-  uniswap-v3 tick math; action submitters.
-
-## 0.2.0 — 2026-04-22
-
-- `createPublicClient` factory; `createDevConfig` for DEV mode tuples.
-
-## 0.1.0 — 2026-04-21
-
-- Initial scaffold: viem chain definitions, RPC defaults, `chain-clients.ts`.
+Surface count: 28 → 27 (one-time pull at beta.0).

package/README.md

@@ -29,10 +29,12 @@ pnpm add @skate-org/amm-evm-v2
 
 Peer deps: `@skate-org/amm-core-v2`, `@skate-org/amm-bindings`, `viem`.
 
-## DEV defaults (as of 2026-04-29)
+## DEV defaults
 
 - MegaETH RPC: `https://mainnet.megaeth.com/rpc`
 - Kernel manager: `0x17B7207837e8884f7f687f1f4057751BDAf70a01`
 - USDC/USDT kernel pool: `0x2c23334eE3b030e6bacEDEDf7C511eEA08Cf7E7e`
 
+STAGING + PRODUCTION on-chain addresses alias DEV as of `2.0.0-beta.10`.
+
 See `CHANGELOG.md` for version history.

package/dist/devConfig.d.ts

@@ -1,6 +1,4 @@
 import type { DevModeConfig } from "@skate-org/amm-core-v2";
-/** Default DEV api endpoint — matches Phase 1's api client default. */
-export declare const DEFAULT_DEV_API_ENDPOINT = "https://dev.api.skatechain.org/amm-action-v2";
 /**
  * Convenience factory for the `{ mode: "DEV"; config: DevModeConfig }` tuple.
  *

package/dist/devConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"devConfig.d.ts","sourceRoot":"","sources":["../src/devConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,uEAAuE;AACvE,eAAO,MAAM,wBAAwB,iDACW,CAAC;AAEjD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAC7B,SAAS,GAAE,OAAO,CAAC,aAAa,CAAM,GACrC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,CAUxC"}
+{"version":3,"file":"devConfig.d.ts","sourceRoot":"","sources":["../src/devConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAM5D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAC7B,SAAS,GAAE,OAAO,CAAC,aAAa,CAAM,GACrC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,CAUxC"}

package/dist/index.cjs

@@ -27,11 +27,17 @@ __export(index_exports, {
   computePositionAmounts: () => computePositionAmounts,
   createDevConfig: () => createDevConfig,
   decodeTickBitmapWord: () => decodeTickBitmapWord,
+  getBurnCalldata: () => getBurnCalldata,
+  getDecreaseLiquidityCalldata: () => getDecreaseLiquidityCalldata,
+  getIncreaseLiquidityCalldata: () => getIncreaseLiquidityCalldata,
   getKernelPublicClient: () => getKernelPublicClient,
+  getMintCalldata: () => getMintCalldata,
   getSourcePublicClient: () => getSourcePublicClient,
+  getSwapCalldata: () => getSwapCalldata,
   megaethChain: () => megaethChain,
   parseKernelEventLog: () => parseKernelEventLog,
   parsePeripheryEventLog: () => parsePeripheryEventLog,
+  readKernelBalances: () => readKernelBalances,
   readPeripheryPool: () => readPeripheryPool,
   readPool: () => readPool,
   readPosition: () => readPosition,
@@ -212,6 +218,26 @@ async function readPool(kernelPool, mode, client) {
     throw wrapReadError(err, "readPool");
   }
 }
+async function readKernelBalances(kernelPool, mode, client) {
+  const c = resolveKernelClient(mode, client);
+  try {
+    const [balance0, balance1] = await Promise.all([
+      c.readContract({
+        address: kernelPool,
+        abi: import_amm_bindings.KernelPoolABI,
+        functionName: "balance0"
+      }),
+      c.readContract({
+        address: kernelPool,
+        abi: import_amm_bindings.KernelPoolABI,
+        functionName: "balance1"
+      })
+    ]);
+    return { balance0, balance1 };
+  } catch (err) {
+    throw wrapReadError(err, "readKernelBalances");
+  }
+}
 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);
@@ -584,9 +610,96 @@ async function submitApproval(wallet, params, mode) {
   }
 }
 
-// src/events/kernel.ts
+// src/periphery/calldata.ts
 var import_viem2 = require("viem");
 var import_amm_bindings4 = require("@skate-org/amm-bindings");
+function getSwapCalldata(params) {
+  const {
+    recipient,
+    zeroForOne,
+    amount,
+    sqrtPriceLimitX96,
+    destVmType,
+    destChainId,
+    minAmountOut,
+    deadline
+  } = params;
+  const extraData = (0, import_viem2.encodeAbiParameters)(
+    (0, import_viem2.parseAbiParameters)("uint256,uint256,uint256,uint256"),
+    [
+      minAmountOut ?? 0n,
+      BigInt(destChainId),
+      BigInt(destVmType),
+      deadline ?? import_viem2.maxUint256
+    ]
+  );
+  return (0, import_viem2.encodeFunctionData)({
+    abi: import_amm_bindings4.PeripheryPoolABI,
+    functionName: "swap",
+    args: [recipient, zeroForOne, amount, sqrtPriceLimitX96, extraData]
+  });
+}
+function getMintCalldata(params) {
+  const {
+    recipient,
+    tickLower,
+    tickUpper,
+    amount0,
+    amount1,
+    amount0Min,
+    amount1Min,
+    deadline
+  } = params;
+  const extraData = (0, import_viem2.encodeAbiParameters)(
+    (0, import_viem2.parseAbiParameters)("uint256,uint256,uint256"),
+    [amount0Min ?? 0n, amount1Min ?? 0n, deadline ?? import_viem2.maxUint256]
+  );
+  return (0, import_viem2.encodeFunctionData)({
+    abi: import_amm_bindings4.PeripheryPoolABI,
+    functionName: "mint",
+    args: [recipient, tickLower, tickUpper, amount0, amount1, extraData]
+  });
+}
+function getBurnCalldata(params) {
+  const { tokenId, amount0Min, amount1Min, deadline } = params;
+  const extraData = (0, import_viem2.encodeAbiParameters)(
+    (0, import_viem2.parseAbiParameters)("uint256,uint256,uint256"),
+    [amount0Min ?? 0n, amount1Min ?? 0n, deadline ?? import_viem2.maxUint256]
+  );
+  return (0, import_viem2.encodeFunctionData)({
+    abi: import_amm_bindings4.PeripheryPoolABI,
+    functionName: "burn",
+    args: [tokenId, extraData]
+  });
+}
+function getIncreaseLiquidityCalldata(params) {
+  const { tokenId, amount0, amount1, amount0Min, amount1Min, deadline } = params;
+  const extraData = (0, import_viem2.encodeAbiParameters)(
+    (0, import_viem2.parseAbiParameters)("uint256,uint256,uint256"),
+    [amount0Min ?? 0n, amount1Min ?? 0n, deadline ?? import_viem2.maxUint256]
+  );
+  return (0, import_viem2.encodeFunctionData)({
+    abi: import_amm_bindings4.PeripheryPoolABI,
+    functionName: "increaseLiquidity",
+    args: [tokenId, amount0, amount1, extraData]
+  });
+}
+function getDecreaseLiquidityCalldata(params) {
+  const { tokenId, liquidityAmount, amount0Min, amount1Min, deadline } = params;
+  const extraData = (0, import_viem2.encodeAbiParameters)(
+    (0, import_viem2.parseAbiParameters)("uint256,uint256,uint256"),
+    [amount0Min ?? 0n, amount1Min ?? 0n, deadline ?? import_viem2.maxUint256]
+  );
+  return (0, import_viem2.encodeFunctionData)({
+    abi: import_amm_bindings4.PeripheryPoolABI,
+    functionName: "decreaseLiquidity",
+    args: [tokenId, liquidityAmount, extraData]
+  });
+}
+
+// src/events/kernel.ts
+var import_viem3 = require("viem");
+var import_amm_bindings5 = require("@skate-org/amm-bindings");
 var KERNEL_EVENT_NAMES = [
   "Burn",
   "Collect",
@@ -603,8 +716,8 @@ var KERNEL_EVENT_NAMES = [
 ];
 function parseKernelEventLog(log) {
   try {
-    const decoded = (0, import_viem2.decodeEventLog)({
-      abi: import_amm_bindings4.KernelEventEmitterABI,
+    const decoded = (0, import_viem3.decodeEventLog)({
+      abi: import_amm_bindings5.KernelEventEmitterABI,
       data: log.data,
       topics: log.topics
     });
@@ -624,8 +737,8 @@ function parseKernelEventLog(log) {
 }
 
 // src/events/periphery.ts
-var import_viem3 = require("viem");
-var import_amm_bindings5 = require("@skate-org/amm-bindings");
+var import_viem4 = require("viem");
+var import_amm_bindings6 = require("@skate-org/amm-bindings");
 var PERIPHERY_EVENT_NAMES = [
   "AmountSettled",
   "Burned",
@@ -640,8 +753,8 @@ var PERIPHERY_EVENT_NAMES = [
 ];
 function parsePeripheryEventLog(log) {
   try {
-    const decoded = (0, import_viem3.decodeEventLog)({
-      abi: import_amm_bindings5.PeripheryEventEmitterABI,
+    const decoded = (0, import_viem4.decodeEventLog)({
+      abi: import_amm_bindings6.PeripheryEventEmitterABI,
       data: log.data,
       topics: log.topics
     });
@@ -661,10 +774,10 @@ function parsePeripheryEventLog(log) {
 }
 
 // src/events/watch.ts
-var import_amm_bindings6 = require("@skate-org/amm-bindings");
+var import_amm_bindings7 = require("@skate-org/amm-bindings");
 function watchKernelEvents(client, address, opts) {
   return client.watchContractEvent({
-    abi: import_amm_bindings6.KernelEventEmitterABI,
+    abi: import_amm_bindings7.KernelEventEmitterABI,
     address,
     onLogs: (logs) => {
       for (const log of logs) {
@@ -679,7 +792,7 @@ function watchKernelEvents(client, address, opts) {
 }
 function watchPeripheryEvents(client, address, opts) {
   return client.watchContractEvent({
-    abi: import_amm_bindings6.PeripheryEventEmitterABI,
+    abi: import_amm_bindings7.PeripheryEventEmitterABI,
     address,
     onLogs: (logs) => {
       for (const log of logs) {
@@ -701,11 +814,17 @@ function watchPeripheryEvents(client, address, opts) {
   computePositionAmounts,
   createDevConfig,
   decodeTickBitmapWord,
+  getBurnCalldata,
+  getDecreaseLiquidityCalldata,
+  getIncreaseLiquidityCalldata,
   getKernelPublicClient,
+  getMintCalldata,
   getSourcePublicClient,
+  getSwapCalldata,
   megaethChain,
   parseKernelEventLog,
   parsePeripheryEventLog,
+  readKernelBalances,
   readPeripheryPool,
   readPool,
   readPosition,