@nradko/metric-omm-sdk-v1 0.4.2 → 0.4.4

package/src/abis/SwapAllowlistExtension.ts

@@ -73,6 +73,25 @@ export const SwapAllowlistExtensionAbi = [
     name: "OnlyPoolAdmin",
     type: "error",
   },
+  {
+    anonymous: false,
+    inputs: [
+      {
+        indexed: true,
+        internalType: "address",
+        name: "pool",
+        type: "address",
+      },
+      {
+        indexed: false,
+        internalType: "bool",
+        name: "allowed",
+        type: "bool",
+      },
+    ],
+    name: "AllowAllSwappersSet",
+    type: "event",
+  },
   {
     anonymous: false,
     inputs: [
@@ -312,6 +331,25 @@ export const SwapAllowlistExtensionAbi = [
     stateMutability: "nonpayable",
     type: "function",
   },
+  {
+    inputs: [
+      {
+        internalType: "address",
+        name: "pool",
+        type: "address",
+      },
+    ],
+    name: "allowAllSwappers",
+    outputs: [
+      {
+        internalType: "bool",
+        name: "",
+        type: "bool",
+      },
+    ],
+    stateMutability: "view",
+    type: "function",
+  },
   {
     inputs: [
       {
@@ -545,6 +583,24 @@ export const SwapAllowlistExtensionAbi = [
     stateMutability: "view",
     type: "function",
   },
+  {
+    inputs: [
+      {
+        internalType: "address",
+        name: "pool_",
+        type: "address",
+      },
+      {
+        internalType: "bool",
+        name: "allowed",
+        type: "bool",
+      },
+    ],
+    name: "setAllowAllSwappers",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function",
+  },
   {
     inputs: [
       {

package/src/abis/index.ts

@@ -4,14 +4,13 @@
 
 export { MetricOmmPoolAbi } from "./MetricOmmPool.js";
 export { MetricOmmPoolDataProviderAbi } from "./MetricOmmPoolDataProvider.js";
-export { MetricOmmSwapQuoterAbi } from "./MetricOmmSwapQuoter.js";
-export { MetricOmmPoolStateViewAbi } from "./MetricOmmPoolStateView.js";
 export { MetricOmmSimpleRouterAbi } from "./MetricOmmSimpleRouter.js";
+export { MetricOmmSwapQuoterAbi } from "./MetricOmmSwapQuoter.js";
 export { MetricOmmPoolLiquidityAdderAbi } from "./MetricOmmPoolLiquidityAdder.js";
 export { MetricOmmPoolFactoryAbi } from "./MetricOmmPoolFactory.js";
 export { DepositAllowlistExtensionAbi } from "./DepositAllowlistExtension.js";
 export { SwapAllowlistExtensionAbi } from "./SwapAllowlistExtension.js";
-export { PriceVelocityGuardExtensionAbi } from "./PriceVelocityGuardExtension.js";
 export { OracleValueStopLossExtensionAbi } from "./OracleValueStopLossExtension.js";
+export { PriceVelocityGuardExtensionAbi } from "./PriceVelocityGuardExtension.js";
 export { PriceProviderAbi } from "./PriceProvider.js";
 export { OracleProviderAbi } from "./OracleProvider.js";

package/src/addresses.ts

@@ -38,9 +38,7 @@ export interface ChainAddresses {
   liquidityAdder: Address;
   /** MetricOmmPoolDataProvider (pool reads, swap depth, revert quotes). */
   dataProvider: Address;
-  /** MetricOmmPoolStateView (raw pool storage reads). */
-  stateView: Address;
-  /** MetricOmmSimpleRouter (single- and multi-hop ERC-20 swaps). */
+  /** MetricOmmSimpleRouter (single- and multi-hop swaps). */
   simpleRouter: Address;
   /** MetricOmmSwapQuoter (live pool quotes via revert callback). */
   quoter: Address;
@@ -60,22 +58,21 @@ export interface ChainAddresses {
 
 /** Shared protocol deployment (Ethereum + Base). */
 const PROTOCOL_ADDRESSES = {
-  factory: "0x567C7205107257650dC73a73d87b879a45F5b6F6",
-  poolDeployer: "0xBe34D0cEb6CF1acbf55dEf35E4dC3e17BDfb6AE4",
-  liquidityAdder: "0x323B95ABcE8b3025829980bb19d1Fd819808FCB2",
-  dataProvider: "0x5A100da447833D94b8e50AeD1916D7488D15D3fc",
-  stateView: "0xb40F8B0cfBB6a01c3232c6D063B1F87d1C0bE40f",
-  simpleRouter: "0x18f85056444452E718cD680A08f219B2347FE672",
-  quoter: "0x0000000000000000000000000000000000000000",
+  factory: "0xf98aD80FE666B9a23075CdF64aF5971802844Fd8",
+  poolDeployer: "0xf93e1ea4516E99A4Ee81D4979C8D3C8Ab636e397",
+  liquidityAdder: "0xdd615506d83e2d94f30aaf17e846330164ab599e",
+  dataProvider: "0x7dc8eD16661A5003D9708B55f768484f9E963AdB",
+  simpleRouter: "0xa4d4be6a6b6d9f6532cacfe61fc666ef2f9997ed",
+  quoter: "0xfa13b57b570B43c8b9A61ba8D2C1781aB064f617",
   extensions: {
-    depositAllowlistExtension: "0x088B0CCBdb17531132173a30428f66c1d5A73794",
-    swapAllowlistExtension: "0x952D844e166E6FAaF73a5e56F0fB0C54543a0f69",
-    oracleValueStopLossExtension: "0x9694959a452283d86eBF4EF4eB5651dEAa1eCec1",
-    priceVelocityGuardExtension: "0xa53E5db6c18Ce258b3090F1470c5fE7f2e0215Fc",
+    depositAllowlistExtension: "0xC93BdA96021650DBfCEab6470c5329a0F391C160",
+    swapAllowlistExtension: "0x50c58A0bf9711Ae091c3aF5C3eab49544062662e",
+    oracleValueStopLossExtension: "0x34822E3D4265a8E42284Ce9807A1a804b7552838",
+    priceVelocityGuardExtension: "0x07A5c4821cd84a9A6162a6b1f756aA458B7616E3",
   },
 } as const satisfies Omit<ChainAddresses, "wrappedNative">;
 
-/** Extensions-era deployment — Ethereum mainnet and Base (Jun 2026). */
+/** Periphery deployment — Ethereum mainnet and Base (CREATE2, same protocol addresses). */
 export const ADDRESSES: Record<DeployedChainId, ChainAddresses> = {
   [ChainId.ETHEREUM]: {
     ...PROTOCOL_ADDRESSES,

package/src/dataProvider/index.ts

@@ -10,7 +10,6 @@ export {
   getBinStatesScaled,
   getBinTotalShares,
   getPositionBinSharesFromDataProvider,
-  getPositionBinSharesFromStateView,
   toPositionBinKey,
   getPositionBinSharesRange,
   getPriceProvider,

package/src/dataProvider/read.ts

@@ -1,6 +1,6 @@
 /**
  * MetricAMM SDK - DataProvider read functions
- * Batch reads via MetricOmmPoolDataProvider (mainnet lens; inherits StateView reads).
+ * Batch reads via MetricOmmPoolDataProvider.
  */
 
 import type { Address, PublicClient } from "viem";
@@ -341,6 +341,3 @@ export async function getPriceProvider(
     args: [poolAddress],
   })) as Address;
 }
-
-/** @deprecated Use getPositionBinSharesFromDataProvider */
-export const getPositionBinSharesFromStateView = getPositionBinSharesFromDataProvider;

package/src/index.ts

@@ -47,7 +47,6 @@ export {
   MetricOmmPoolAbi,
   MetricOmmPoolDataProviderAbi,
   MetricOmmSwapQuoterAbi,
-  MetricOmmPoolStateViewAbi,
   MetricOmmSimpleRouterAbi,
   MetricOmmPoolLiquidityAdderAbi,
   MetricOmmPoolFactoryAbi,
@@ -95,7 +94,6 @@ export {
   getBinStatesScaled,
   getBinTotalShares,
   getPositionBinSharesFromDataProvider,
-  getPositionBinSharesFromStateView,
   toPositionBinKey,
   getPositionBinSharesRange,
   getPriceProvider,
@@ -132,6 +130,25 @@ export {
   type BinRemovalSpec,
 } from "./pool/liquidity.js";
 
+export {
+  prepareAddLiquidityExactSharesSelfSupportingNativePaymentCalldata,
+  prepareAddLiquidityExactSharesWithOwnerSupportingNativePaymentCalldata,
+  prepareAddLiquidityWeightedSelfSupportingNativePaymentCalldata,
+  prepareAddLiquidityWeightedWithOwnerSupportingNativePaymentCalldata,
+  UNCONSTRAINED_LIQUIDITY_CURSOR_BOUNDS,
+  type LiquidityCursorBounds,
+  prepareLiquidityCursorBounds,
+  computeLiquidityCursorBounds,
+  cursorMovementToPositionDelta,
+} from "./pool/index.js";
+
+// ============ PeripheryPayments ============
+export {
+  encodeMulticallCalldata,
+  encodeRefundETHCalldata,
+  encodeUnwrapWETH9Calldata,
+} from "./peripheryPayments/index.js";
+
 // ============ Quoter Functions ============
 export {
   quoteLiveExactInSingle,
@@ -170,6 +187,14 @@ export {
   prepareExactOutputSingleCalldata,
   prepareExactInputCalldata,
   prepareExactOutputCalldata,
+  prepareExactInputSingleAndUnwrapCalldata,
+  prepareExactInputAndUnwrapCalldata,
+  prepareExactInputSingleSupportingNativePaymentCalldata,
+  prepareExactInputSupportingNativePaymentCalldata,
+  prepareExactOutputSupportingNativePaymentCalldata,
+  prepareExactOutputSingleSupportingNativePaymentCalldata,
+  prepareExactOutputSingleAndUnwrapCalldata,
+  prepareExactOutputAndUnwrapCalldata,
   type ExactInputSingleParams,
   type ExactOutputSingleParams,
   type ExactInputParams,
@@ -178,6 +203,17 @@ export {
   type BuildExactOutputSingleParams,
   type BuildExactInputParams,
   type BuildExactOutputParams,
+  prepareExactInputFromRoute,
+  prepareExactOutputFromRoute,
+  type TradeType,
+  type RouteType,
+  type RouteLegResponse,
+  type RouteOptionResponse,
+  type RouteResponse,
+  type PrepareExactInputFromRouteParams,
+  type PrepareExactOutputFromRouteParams,
+  type PreparedExactInputFromRoute,
+  type PreparedExactOutputFromRoute,
 } from "./router/index.js";
 
 // ============ Factory Functions ============

package/src/peripheryPayments/index.ts

@@ -0,0 +1,5 @@
+export {
+  encodeMulticallCalldata,
+  encodeRefundETHCalldata,
+  encodeUnwrapWETH9Calldata,
+} from "./simpleRouter.js";

package/src/peripheryPayments/simpleRouter.ts

@@ -0,0 +1,31 @@
+/** MetricOmmSimpleRouter multicall and PeripheryPayments calldata encoders. */
+
+import type { Address, Hex } from "viem";
+import { encodeFunctionData } from "viem";
+import { SIMPLE_ROUTER_ABI } from "../constants.js";
+
+/** `multicall(bytes[])`. */
+export function encodeMulticallCalldata(calls: readonly Hex[]): Hex {
+  return encodeFunctionData({
+    abi: SIMPLE_ROUTER_ABI,
+    functionName: "multicall",
+    args: [calls],
+  });
+}
+
+/** `refundETH()` — unused native balance on the router back to caller. */
+export function encodeRefundETHCalldata(): Hex {
+  return encodeFunctionData({
+    abi: SIMPLE_ROUTER_ABI,
+    functionName: "refundETH",
+  });
+}
+
+/** `unwrapWETH9(amountMinimum, recipient)`. */
+export function encodeUnwrapWETH9Calldata(amountMinimum: bigint, recipient: Address): Hex {
+  return encodeFunctionData({
+    abi: SIMPLE_ROUTER_ABI,
+    functionName: "unwrapWETH9",
+    args: [amountMinimum, recipient],
+  });
+}

package/src/pool/cursorBounds.ts

@@ -0,0 +1,112 @@
+/**
+ * Helpers for weighted-add LiquidityAdder cursor bounds.
+ *
+ * Cursor position is measured in linear units: each bin spans MAX_UINT104 + 1
+ * positions (0 … MAX_UINT104). Movement can cross bin boundaries; distance is
+ * summed across bins.
+ */
+
+import type { Address, PublicClient } from "viem";
+import { MAX_UINT104 } from "../constants.js";
+import { getSlot0 } from "../dataProvider/read.js";
+import { getAddressesOrThrow } from "../addresses.js";
+import { UNCONSTRAINED_LIQUIDITY_CURSOR_BOUNDS, type LiquidityCursorBounds } from "./liquidity.js";
+
+const POSITIONS_PER_BIN = MAX_UINT104 + 1n;
+const CURSOR_MOVEMENT_SCALE = 1_000_000_000n;
+
+function floorDiv(a: bigint, b: bigint): bigint {
+  const q = a / b;
+  const r = a % b;
+  if (r !== 0n && a < 0n) return q - 1n;
+  return q;
+}
+
+function floorMod(a: bigint, b: bigint): bigint {
+  return a - floorDiv(a, b) * b;
+}
+
+function cursorToLinear(curBinIdx: number, curPosInBin: bigint): bigint {
+  return BigInt(curBinIdx) * POSITIONS_PER_BIN + curPosInBin;
+}
+
+function linearToCursor(linear: bigint): { curBinIdx: number; curPosInBin: bigint } {
+  return {
+    curBinIdx: Number(floorDiv(linear, POSITIONS_PER_BIN)),
+    curPosInBin: floorMod(linear, POSITIONS_PER_BIN),
+  };
+}
+
+/** Convert a movement factor to position units (1.0 = MAX_UINT104 positions). */
+export function cursorMovementToPositionDelta(maximalCursorMovement: number): bigint {
+  if (!Number.isFinite(maximalCursorMovement) || maximalCursorMovement < 0) {
+    throw new Error("maximalCursorMovement must be a non-negative finite number");
+  }
+  const scaledMovement = BigInt(Math.round(maximalCursorMovement * Number(CURSOR_MOVEMENT_SCALE)));
+  return (scaledMovement * MAX_UINT104) / CURSOR_MOVEMENT_SCALE;
+}
+
+/**
+ * Build LiquidityCursorBounds around a cursor by allowing up to
+ * `maximalCursorMovement * MAX_UINT104` positions of movement left or right.
+ */
+export function computeLiquidityCursorBounds(
+  curBinIdx: number,
+  curPosInBin: bigint,
+  maximalCursorMovement: number,
+): LiquidityCursorBounds {
+  const delta = cursorMovementToPositionDelta(maximalCursorMovement);
+  const currentLinear = cursorToLinear(curBinIdx, curPosInBin);
+
+  const protocolMinLinear = cursorToLinear(
+    UNCONSTRAINED_LIQUIDITY_CURSOR_BOUNDS.minimalCurBin,
+    UNCONSTRAINED_LIQUIDITY_CURSOR_BOUNDS.minimalPosition,
+  );
+  const protocolMaxLinear = cursorToLinear(
+    UNCONSTRAINED_LIQUIDITY_CURSOR_BOUNDS.maximalCurBin,
+    UNCONSTRAINED_LIQUIDITY_CURSOR_BOUNDS.maximalPosition,
+  );
+
+  const clampedMinLinear =
+    currentLinear - delta < protocolMinLinear ? protocolMinLinear : currentLinear - delta;
+  const clampedMaxLinear =
+    currentLinear + delta > protocolMaxLinear ? protocolMaxLinear : currentLinear + delta;
+
+  const minimal = linearToCursor(clampedMinLinear);
+  const maximal = linearToCursor(clampedMaxLinear);
+
+  return {
+    minimalCurBin: minimal.curBinIdx,
+    minimalPosition: minimal.curPosInBin,
+    maximalCurBin: maximal.curBinIdx,
+    maximalPosition: maximal.curPosInBin,
+  };
+}
+
+/**
+ * Read the pool cursor and return LiquidityCursorBounds for weighted add encoders.
+ *
+ * @param maximalCursorMovement - 1.0 allows up to MAX_UINT104 positions of movement
+ *   left or right from the current cursor (summing across bin boundaries).
+ */
+export async function prepareLiquidityCursorBounds(params: {
+  publicClient: PublicClient;
+  pool: Address;
+  maximalCursorMovement: number;
+  dataProviderAddress?: Address;
+}): Promise<LiquidityCursorBounds> {
+  const chainId = params.publicClient.chain?.id;
+  if (chainId === undefined) {
+    throw new Error("publicClient.chain.id is required to resolve dataProvider address");
+  }
+
+  const dataProviderAddress =
+    params.dataProviderAddress ?? getAddressesOrThrow(chainId).dataProvider;
+  const slot0 = await getSlot0(params.publicClient, dataProviderAddress, params.pool);
+
+  return computeLiquidityCursorBounds(
+    slot0.curBinIdx,
+    slot0.curPosInBin,
+    params.maximalCursorMovement,
+  );
+}

package/src/pool/index.ts

@@ -39,6 +39,8 @@ export {
   encodeAddLiquidityWeightedSelfCalldata,
   encodeAddLiquidityWeightedWithOwnerCalldata,
   encodeRemoveLiquidityCalldata,
+  UNCONSTRAINED_LIQUIDITY_CURSOR_BOUNDS,
+  type LiquidityCursorBounds,
   getPositionShares,
   getPositionSharesForBins,
   NO_SLIPPAGE_LIMIT,
@@ -52,3 +54,16 @@ export {
   type RemoveLiquidityParams,
   type BinRemovalSpec,
 } from "./liquidity.js";
+
+export {
+  prepareAddLiquidityExactSharesSelfSupportingNativePaymentCalldata,
+  prepareAddLiquidityExactSharesWithOwnerSupportingNativePaymentCalldata,
+  prepareAddLiquidityWeightedSelfSupportingNativePaymentCalldata,
+  prepareAddLiquidityWeightedWithOwnerSupportingNativePaymentCalldata,
+} from "./nativeLiquidity.js";
+
+export {
+  prepareLiquidityCursorBounds,
+  computeLiquidityCursorBounds,
+  cursorMovementToPositionDelta,
+} from "./cursorBounds.js";