@logswap/sdk 0.5.44 → 0.5.46

package/src/index.ts

@@ -19,5 +19,5 @@ export * from "./onboard.js";
 export * from "./indexer.js";
 export * from "./tokencache.js";
 export * from "./fpool.js";
-export { cPoolManagerAbi, fPoolManagerAbi, logswapLensAbi, logswapRouterAbi } from "./generated.js";
+export { cPoolManagerAbi, fPoolManagerAbi, logswapLensAbi, logswapRouterAbi, padHookAbi, polHookAbi, privateHookAbi, publicHookAbi } from "./generated.js";
 export * from "./admin.js";

package/src/indexer.ts

@@ -143,11 +143,11 @@ export async function indexerHealthy(url: string, signal?: AbortSignal): Promise
  */
 export async function discoverMarketsIndexed(url: string, signal?: AbortSignal): Promise<DiscoveredMarket[]> {
   const q = `{ allInitializes(first: 1000) { nodes {
-    poolId base quote tickSpacing phiMin kappa alpha x0 blockNumber txHash
+    poolId base quote tickSpacing phi x0 blockNumber txHash
   } } }`;
   type Row = {
-    poolId: Hex; base: Hex; quote: Hex; tickSpacing: string; phiMin: string;
-    kappa: string; alpha: string; x0: string; blockNumber: string; txHash: Hex;
+    poolId: Hex; base: Hex; quote: Hex; tickSpacing: string; phi: string;
+    x0: string; blockNumber: string; txHash: Hex;
   };
   const d = await gql<{ allInitializes: { nodes: Row[] } }>(url, q, undefined, signal);
   return d.allInitializes.nodes.map((n) => {
@@ -155,9 +155,7 @@ export async function discoverMarketsIndexed(url: string, signal?: AbortSignal):
       base: n.base as Address,
       quote: n.quote as Address,
       tickSpacing: BigInt(n.tickSpacing),
-      phiMin: BigInt(n.phiMin),
-      kappa: BigInt(n.kappa),
-      alpha: BigInt(n.alpha),
+      phi: BigInt(n.phi),
     };
     return {
       key,
@@ -196,7 +194,7 @@ export async function discoverMarketsBest(
                 await c.public.readContract({
                   address: c.addresses.cPoolManager,
                   abi: cPoolManagerAbi,
-                  functionName: "phiEff",
+                  functionName: "phiOf",
                   args: [m.key],
                 } as never);
                 return m;

package/src/keys.ts

@@ -22,12 +22,13 @@ export interface PoolKey {
   quote: Address;
   /** Log-tick spacing, WAD. The LP-boundary ladder — position floors and caps. */
   tickSpacing: bigint;
-  /** Fee floor, WAD. `0n` selects `DEFAULT_FEE_MIN` (2 bp) at read time. */
-  phiMin: bigint;
-  /** Variance-fee coefficient, WAD. `0n` disables the dynamic fee. */
-  kappa: bigint;
-  /** EMA decay, WAD. `0n` selects `DEFAULT_ALPHA` (1/2) at read time. */
-  alpha: bigint;
+  /**
+   * The swap fee, WAD, fixed for the life of the market: `FEE_MIN` (1 bp) ≤ φ ≤ `FEE_MAX` (25%),
+   * or `0n`, which selects `DEFAULT_FEE` (2 bp) at read time. Four fields since C version 4
+   * (decisions 042): `kappa` and `alpha` left with the variance kernel, and `phiMin` — a floor with
+   * nothing above it — became `phi`. Every pool id changed with the shape.
+   */
+  phi: bigint;
 }
 
 const POOL_KEY_ABI = [
@@ -37,9 +38,7 @@ const POOL_KEY_ABI = [
       { name: "base", type: "address" },
       { name: "quote", type: "address" },
       { name: "tickSpacing", type: "int256" },
-      { name: "phiMin", type: "uint256" },
-      { name: "kappa", type: "uint256" },
-      { name: "alpha", type: "uint256" },
+      { name: "phi", type: "uint256" },
     ],
   },
 ] as const;
@@ -47,8 +46,8 @@ const POOL_KEY_ABI = [
 /**
  * `poolId = keccak256(abi.encode(key))` — the primary key of the entire read model.
  *
- * Note the zero-vs-default caveat the Solidity type documents: `phiMin` and `alpha` of `0` resolve
- * to their defaults at READ time, so a key carrying `0n` and one carrying the resolved default are
+ * Note the zero-vs-default caveat the Solidity type documents: a `phi` of `0` resolves to
+ * `DEFAULT_FEE` at READ time, so a key carrying `0n` and one carrying the resolved default are
  * DIFFERENT markets with different ids, even though they behave identically. Always address a
  * market by the key it was initialized with.
  */
@@ -59,9 +58,7 @@ export function poolId(key: PoolKey): Hex {
         base: key.base,
         quote: key.quote,
         tickSpacing: key.tickSpacing,
-        phiMin: key.phiMin,
-        kappa: key.kappa,
-        alpha: key.alpha,
+        phi: key.phi,
       },
     ]),
   );

package/src/liquidity.ts

@@ -133,6 +133,8 @@ export interface ZapArgs extends WriteOptions {
   /** Fund entirely from base (true) or entirely from quote (false). */
   fundWithBase: boolean;
   amountIn: bigint;
+  /** The least the swap leg may return (contracts 7c82eed, decisions 043): the zap's own slippage bound, as `swapExactIn`'s. 0 = unbounded. */
+  minSwapOut?: bigint;
   targetFloor: bigint;
   cap?: bigint;
   L: bigint;
@@ -155,6 +157,7 @@ export async function zapIn(c: LogswapClient, a: ZapArgs): Promise<Hash> {
       a.key,
       a.fundWithBase,
       a.amountIn,
+      a.minSwapOut ?? 0n,
       a.targetFloor,
       a.cap ?? NO_CAP,
       a.L,

package/src/pools.ts

@@ -30,9 +30,8 @@ export interface PoolState {
   reserveQuote: bigint;
   /** Fee-per-unit-L accumulator: $\phi \cdot \mathrm{TV}(\log p)$. */
   F: bigint;
-  /** Quadratic variation of log-price, $\Sigma = \int (dx)^2$. */
+  /** Quadratic variation of log-price, $\Sigma = \sum_{\text{swaps}} (\Delta x_{\text{swap}})^2$ — one term per swap (decisions 042). */
   bigSigma: bigint;
-  sigma2Ema: bigint;
   currentK: bigint;
   protocolOwed: bigint;
   minBackstopL: bigint;
@@ -50,12 +49,16 @@ export async function getPool(c: LogswapClient, key: PoolKey): Promise<PoolState
   return v as unknown as PoolState;
 }
 
-/** The effective fee right now: $\max(\phi_{\min}, \kappa\sqrt{\sigma^2_{\text{ema}}})$, capped. */
-export async function phiEff(c: LogswapClient, key: PoolKey): Promise<bigint> {
+/**
+ * The market's fee: the key's `phi` with `0n` resolved to `DEFAULT_FEE`. Constant for the market's
+ * life (C version 4, decisions 042 — `phiEff` and the variance kernel before). Reverts for a key
+ * nobody initialized, which `discoverMarkets` relies on to drop a stale indexer's rows.
+ */
+export async function phiOf(c: LogswapClient, key: PoolKey): Promise<bigint> {
   return c.public.readContract({
     address: c.addresses.cPoolManager,
     abi: cPoolManagerAbi,
-    functionName: "phiEff",
+    functionName: "phiOf",
     args: [key],
   }) as Promise<bigint>;
 }
@@ -134,9 +137,7 @@ export async function discoverMarkets(
       base: a.base!,
       quote: a.quote!,
       tickSpacing: a.tickSpacing!,
-      phiMin: a.phiMin!,
-      kappa: a.kappa!,
-      alpha: a.alpha!,
+      phi: a.phi!,
     };
     return {
       key,