@nradko/metric-omm-sdk-v1 0.2.0 → 0.3.0

package/src/abis/SwapAllowlistExtension.ts

@@ -0,0 +1,571 @@
+export const SwapAllowlistExtensionAbi = [
+  {
+    inputs: [
+      {
+        internalType: "address",
+        name: "factory_",
+        type: "address",
+      },
+    ],
+    stateMutability: "nonpayable",
+    type: "constructor",
+  },
+  {
+    inputs: [],
+    name: "ExtensionNotImplemented",
+    type: "error",
+  },
+  {
+    inputs: [],
+    name: "NotAllowedToSwap",
+    type: "error",
+  },
+  {
+    inputs: [
+      {
+        internalType: "address",
+        name: "caller",
+        type: "address",
+      },
+      {
+        internalType: "address",
+        name: "factory",
+        type: "address",
+      },
+    ],
+    name: "OnlyFactory",
+    type: "error",
+  },
+  {
+    inputs: [
+      {
+        internalType: "address",
+        name: "caller",
+        type: "address",
+      },
+      {
+        internalType: "address",
+        name: "factory",
+        type: "address",
+      },
+    ],
+    name: "OnlyPool",
+    type: "error",
+  },
+  {
+    inputs: [
+      {
+        internalType: "address",
+        name: "pool",
+        type: "address",
+      },
+      {
+        internalType: "address",
+        name: "caller",
+        type: "address",
+      },
+      {
+        internalType: "address",
+        name: "admin",
+        type: "address",
+      },
+    ],
+    name: "OnlyPoolAdmin",
+    type: "error",
+  },
+  {
+    anonymous: false,
+    inputs: [
+      {
+        indexed: true,
+        internalType: "address",
+        name: "pool",
+        type: "address",
+      },
+      {
+        indexed: true,
+        internalType: "address",
+        name: "swapper",
+        type: "address",
+      },
+      {
+        indexed: false,
+        internalType: "bool",
+        name: "allowed",
+        type: "bool",
+      },
+    ],
+    name: "AllowedToSwapSet",
+    type: "event",
+  },
+  {
+    inputs: [],
+    name: "FACTORY",
+    outputs: [
+      {
+        internalType: "address",
+        name: "",
+        type: "address",
+      },
+    ],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [
+      {
+        internalType: "address",
+        name: "",
+        type: "address",
+      },
+      {
+        internalType: "address",
+        name: "",
+        type: "address",
+      },
+      {
+        internalType: "uint80",
+        name: "",
+        type: "uint80",
+      },
+      {
+        components: [
+          {
+            internalType: "int256[]",
+            name: "binIdxs",
+            type: "int256[]",
+          },
+          {
+            internalType: "uint256[]",
+            name: "shares",
+            type: "uint256[]",
+          },
+        ],
+        internalType: "struct LiquidityDelta",
+        name: "",
+        type: "tuple",
+      },
+      {
+        internalType: "uint256",
+        name: "",
+        type: "uint256",
+      },
+      {
+        internalType: "uint256",
+        name: "",
+        type: "uint256",
+      },
+      {
+        internalType: "bytes",
+        name: "",
+        type: "bytes",
+      },
+    ],
+    name: "afterAddLiquidity",
+    outputs: [
+      {
+        internalType: "bytes4",
+        name: "",
+        type: "bytes4",
+      },
+    ],
+    stateMutability: "nonpayable",
+    type: "function",
+  },
+  {
+    inputs: [
+      {
+        internalType: "address",
+        name: "",
+        type: "address",
+      },
+      {
+        internalType: "address",
+        name: "",
+        type: "address",
+      },
+      {
+        internalType: "uint80",
+        name: "",
+        type: "uint80",
+      },
+      {
+        components: [
+          {
+            internalType: "int256[]",
+            name: "binIdxs",
+            type: "int256[]",
+          },
+          {
+            internalType: "uint256[]",
+            name: "shares",
+            type: "uint256[]",
+          },
+        ],
+        internalType: "struct LiquidityDelta",
+        name: "",
+        type: "tuple",
+      },
+      {
+        internalType: "uint256",
+        name: "",
+        type: "uint256",
+      },
+      {
+        internalType: "uint256",
+        name: "",
+        type: "uint256",
+      },
+      {
+        internalType: "bytes",
+        name: "",
+        type: "bytes",
+      },
+    ],
+    name: "afterRemoveLiquidity",
+    outputs: [
+      {
+        internalType: "bytes4",
+        name: "",
+        type: "bytes4",
+      },
+    ],
+    stateMutability: "nonpayable",
+    type: "function",
+  },
+  {
+    inputs: [
+      {
+        internalType: "address",
+        name: "",
+        type: "address",
+      },
+      {
+        internalType: "address",
+        name: "",
+        type: "address",
+      },
+      {
+        internalType: "bool",
+        name: "",
+        type: "bool",
+      },
+      {
+        internalType: "int128",
+        name: "",
+        type: "int128",
+      },
+      {
+        internalType: "uint128",
+        name: "",
+        type: "uint128",
+      },
+      {
+        internalType: "uint256",
+        name: "",
+        type: "uint256",
+      },
+      {
+        internalType: "uint256",
+        name: "",
+        type: "uint256",
+      },
+      {
+        internalType: "uint128",
+        name: "",
+        type: "uint128",
+      },
+      {
+        internalType: "uint128",
+        name: "",
+        type: "uint128",
+      },
+      {
+        internalType: "int128",
+        name: "",
+        type: "int128",
+      },
+      {
+        internalType: "int128",
+        name: "",
+        type: "int128",
+      },
+      {
+        internalType: "uint256",
+        name: "",
+        type: "uint256",
+      },
+      {
+        internalType: "bytes",
+        name: "",
+        type: "bytes",
+      },
+    ],
+    name: "afterSwap",
+    outputs: [
+      {
+        internalType: "bytes4",
+        name: "",
+        type: "bytes4",
+      },
+    ],
+    stateMutability: "nonpayable",
+    type: "function",
+  },
+  {
+    inputs: [
+      {
+        internalType: "address",
+        name: "pool",
+        type: "address",
+      },
+      {
+        internalType: "address",
+        name: "swapper",
+        type: "address",
+      },
+    ],
+    name: "allowedSwapper",
+    outputs: [
+      {
+        internalType: "bool",
+        name: "",
+        type: "bool",
+      },
+    ],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [
+      {
+        internalType: "address",
+        name: "",
+        type: "address",
+      },
+      {
+        internalType: "address",
+        name: "",
+        type: "address",
+      },
+      {
+        internalType: "uint80",
+        name: "",
+        type: "uint80",
+      },
+      {
+        components: [
+          {
+            internalType: "int256[]",
+            name: "binIdxs",
+            type: "int256[]",
+          },
+          {
+            internalType: "uint256[]",
+            name: "shares",
+            type: "uint256[]",
+          },
+        ],
+        internalType: "struct LiquidityDelta",
+        name: "",
+        type: "tuple",
+      },
+      {
+        internalType: "bytes",
+        name: "",
+        type: "bytes",
+      },
+    ],
+    name: "beforeAddLiquidity",
+    outputs: [
+      {
+        internalType: "bytes4",
+        name: "",
+        type: "bytes4",
+      },
+    ],
+    stateMutability: "nonpayable",
+    type: "function",
+  },
+  {
+    inputs: [
+      {
+        internalType: "address",
+        name: "",
+        type: "address",
+      },
+      {
+        internalType: "address",
+        name: "",
+        type: "address",
+      },
+      {
+        internalType: "uint80",
+        name: "",
+        type: "uint80",
+      },
+      {
+        components: [
+          {
+            internalType: "int256[]",
+            name: "binIdxs",
+            type: "int256[]",
+          },
+          {
+            internalType: "uint256[]",
+            name: "shares",
+            type: "uint256[]",
+          },
+        ],
+        internalType: "struct LiquidityDelta",
+        name: "",
+        type: "tuple",
+      },
+      {
+        internalType: "bytes",
+        name: "",
+        type: "bytes",
+      },
+    ],
+    name: "beforeRemoveLiquidity",
+    outputs: [
+      {
+        internalType: "bytes4",
+        name: "",
+        type: "bytes4",
+      },
+    ],
+    stateMutability: "nonpayable",
+    type: "function",
+  },
+  {
+    inputs: [
+      {
+        internalType: "address",
+        name: "sender",
+        type: "address",
+      },
+      {
+        internalType: "address",
+        name: "",
+        type: "address",
+      },
+      {
+        internalType: "bool",
+        name: "",
+        type: "bool",
+      },
+      {
+        internalType: "int128",
+        name: "",
+        type: "int128",
+      },
+      {
+        internalType: "uint128",
+        name: "",
+        type: "uint128",
+      },
+      {
+        internalType: "uint256",
+        name: "",
+        type: "uint256",
+      },
+      {
+        internalType: "uint128",
+        name: "",
+        type: "uint128",
+      },
+      {
+        internalType: "uint128",
+        name: "",
+        type: "uint128",
+      },
+      {
+        internalType: "bytes",
+        name: "",
+        type: "bytes",
+      },
+    ],
+    name: "beforeSwap",
+    outputs: [
+      {
+        internalType: "bytes4",
+        name: "",
+        type: "bytes4",
+      },
+    ],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [
+      {
+        internalType: "address",
+        name: "",
+        type: "address",
+      },
+      {
+        internalType: "bytes",
+        name: "",
+        type: "bytes",
+      },
+    ],
+    name: "initialize",
+    outputs: [
+      {
+        internalType: "bytes4",
+        name: "",
+        type: "bytes4",
+      },
+    ],
+    stateMutability: "nonpayable",
+    type: "function",
+  },
+  {
+    inputs: [
+      {
+        internalType: "address",
+        name: "pool_",
+        type: "address",
+      },
+      {
+        internalType: "address",
+        name: "swapper",
+        type: "address",
+      },
+    ],
+    name: "isAllowedToSwap",
+    outputs: [
+      {
+        internalType: "bool",
+        name: "",
+        type: "bool",
+      },
+    ],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [
+      {
+        internalType: "address",
+        name: "pool_",
+        type: "address",
+      },
+      {
+        internalType: "address",
+        name: "swapper",
+        type: "address",
+      },
+      {
+        internalType: "bool",
+        name: "allowed",
+        type: "bool",
+      },
+    ],
+    name: "setAllowedToSwap",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function",
+  },
+] as const;

package/src/abis/index.ts

@@ -7,5 +7,9 @@ export { MetricOmmPoolDataProviderAbi } from "./MetricOmmPoolDataProvider.js";
 export { MetricOmmPoolSwapperAbi } from "./MetricOmmPoolSwapper.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 { PriceProviderAbi } from "./PriceProvider.js";
 export { PriceProviderUiAbi } from "./PriceProviderUi.js";

package/src/addresses.ts

@@ -1,8 +1,8 @@
 /**
  * MetricAMM SDK — v1 deployed addresses.
  *
- * Only Ethereum mainnet is configured (no other chain deployments for this release).
- * Pool state reads (slot0, bins, position shares) and depth/quote views use `dataProvider`
+ * Ethereum mainnet and Base use the same protocol deployment addresses (CREATE2).
+ * Pool state reads (slot0, bins, position shares) and depth/quote views use dataProvider
  * (MetricOmmPoolDataProvider — the single deployed lens per factory).
  */
 
@@ -24,8 +24,8 @@ export const ChainId = {
 
 export type ChainId = (typeof ChainId)[keyof typeof ChainId];
 
-/** Chains that have entries in `ADDRESSES` for this SDK release. */
-export type DeployedChainId = typeof ChainId.ETHEREUM;
+/** Chains that have entries in ADDRESSES for this SDK release. */
+export type DeployedChainId = typeof ChainId.ETHEREUM | typeof ChainId.BASE;
 
 // ============ Contract Address Types ============
 
@@ -44,49 +44,75 @@ export interface ChainAddresses {
   simpleRouter: Address;
   /** MetricOmmPoolSwapper */
   swapper: Address;
-  /** Wrapped native (WETH on Ethereum) */
+  /** Wrapped native (WETH on Ethereum / Base) */
   wrappedNative: Address;
+
+  /** Per-pool extensions (configure at pool creation). */
+  extensions: {
+    depositAllowlistExtension: Address;
+    swapAllowlistExtension: Address;
+    oracleValueStopLossExtension: Address;
+    priceVelocityGuardExtension: Address;
+  };
 }
 
 // ============ Deployed addresses ============
 
-/** hooks-era deployment — Ethereum mainnet (Jun 2026). */
+/** Shared protocol deployment (Ethereum + Base). */
+const PROTOCOL_ADDRESSES = {
+  factory: "0x175851292f22621F337D76fE5445e9372fb06f9C",
+  poolDeployer: "0x1C0502457231fF2BE9af4468115B33c112A580eF",
+  liquidityAdder: "0x7A2C0A39A48c526F1Cae4d67cb0e7aE883A7B623",
+  dataProvider: "0xD0C4df72910Fd70C89CBa5f0FE0ef45638D12775",
+  stateView: "0xb40F8B0cfBB6a01c3232c6D063B1F87d1C0bE40f",
+  simpleRouter: "0x818a948B25f32F41547a7B9175cB174d2B1e6AD7",
+  swapper: "0x3B8F17A4cb4f91805338f4b6c2f2aAf94243587e",
+  extensions: {
+    depositAllowlistExtension: "0xa56f616c1C8108750b8a5BF387a34C757B8Bdc2c",
+    swapAllowlistExtension: "0x1aee646900bE4aa1D0A7Ec6c98483923E1aBf481",
+    oracleValueStopLossExtension: "0x3CB3EdCce50Bdc95e746F6e7C23fd61d439fA02a",
+    priceVelocityGuardExtension: "0x65D5C490fF5Df1861D966A671dB43a8d0c22b9C4",
+  },
+} as const satisfies Omit<ChainAddresses, "wrappedNative">;
+
+/** Extensions-era deployment — Ethereum mainnet and Base (Jun 2026). */
 export const ADDRESSES: Record<DeployedChainId, ChainAddresses> = {
   [ChainId.ETHEREUM]: {
-    factory: "0xDd41F182630A395E2ED8b9c1D5f1E22F1f9b133a",
-    poolDeployer: "0xb9bb9364FEA5170713709Ba67Aec649eF043e885",
-    liquidityAdder: "0x9de47a0C84c7F9486Af77C8135CE7f480d121B44",
-    dataProvider: "0xf06454dB7E9b8BCa2FC77bF6e88f9B98dF0b52e8",
-    stateView: "0x124C2853E316d1585621560E35D4dcC8318F97FF",
-    simpleRouter: "0x94DD3A9308A1060f4BD9A95dE65F27f0F048f863",
-    swapper: "0xc73407A1d240e08EB34654e706cc3B19E356b8C4",
+    ...PROTOCOL_ADDRESSES,
     wrappedNative: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
   },
+  [ChainId.BASE]: {
+    ...PROTOCOL_ADDRESSES,
+    wrappedNative: "0x4200000000000000000000000000000000000006",
+  },
 } as const;
 
 // ============ Helper Functions ============
 
+const DEPLOYED_CHAIN_IDS: readonly DeployedChainId[] = [ChainId.ETHEREUM, ChainId.BASE];
+
 export function getAddresses(chainId: number): ChainAddresses | undefined {
-  if (chainId !== ChainId.ETHEREUM) return undefined;
-  return ADDRESSES[ChainId.ETHEREUM];
+  if (chainId === ChainId.ETHEREUM) return ADDRESSES[ChainId.ETHEREUM];
+  if (chainId === ChainId.BASE) return ADDRESSES[ChainId.BASE];
+  return undefined;
 }
 
 export function getAddressesOrThrow(chainId: number): ChainAddresses {
   const addresses = getAddresses(chainId);
   if (!addresses) {
     throw new Error(
-      `Chain ${chainId} has no v1 deployment in this SDK (only Ethereum mainnet is configured)`,
+      `Chain ${chainId} has no v1 deployment in this SDK (Ethereum and Base are configured)`,
     );
   }
   return addresses;
 }
 
 export function isChainSupported(chainId: number): chainId is DeployedChainId {
-  return chainId === ChainId.ETHEREUM;
+  return chainId === ChainId.ETHEREUM || chainId === ChainId.BASE;
 }
 
 export function getSupportedChainIds(): DeployedChainId[] {
-  return [ChainId.ETHEREUM];
+  return [...DEPLOYED_CHAIN_IDS];
 }
 
 export function isChainDeployed(chainId: number): boolean {

package/src/extensions/admin/depositAllowlist.ts

@@ -0,0 +1,16 @@
+import type { Address, Hex } from "viem";
+import { encodeFunctionData } from "viem";
+import { DepositAllowlistExtensionAbi } from "../../abis/DepositAllowlistExtension.js";
+
+export function encodeSetAllowedToDepositCalldata(params: {
+  extension: Address;
+  pool: Address;
+  depositor: Address;
+  allowed: boolean;
+}): Hex {
+  return encodeFunctionData({
+    abi: DepositAllowlistExtensionAbi,
+    functionName: "setAllowedToDeposit",
+    args: [params.pool, params.depositor, params.allowed],
+  });
+}