@logswap/sdk 0.5.43 → 0.5.45

package/dist/indexer.js

@@ -100,7 +100,7 @@ export async function indexerHealthy(url, signal) {
  */
 export async function discoverMarketsIndexed(url, signal) {
     const q = `{ allInitializes(first: 1000) { nodes {
-    poolId base quote tickSpacing phiMin kappa alpha x0 blockNumber txHash
+    poolId base quote tickSpacing phi x0 blockNumber txHash
   } } }`;
     const d = await gql(url, q, undefined, signal);
     return d.allInitializes.nodes.map((n) => {
@@ -108,9 +108,7 @@ export async function discoverMarketsIndexed(url, signal) {
             base: n.base,
             quote: n.quote,
             tickSpacing: BigInt(n.tickSpacing),
-            phiMin: BigInt(n.phiMin),
-            kappa: BigInt(n.kappa),
-            alpha: BigInt(n.alpha),
+            phi: BigInt(n.phi),
         };
         return {
             key,
@@ -142,7 +140,7 @@ export async function discoverMarketsBest(c, url, signal) {
                         await c.public.readContract({
                             address: c.addresses.cPoolManager,
                             abi: cPoolManagerAbi,
-                            functionName: "phiEff",
+                            functionName: "phiOf",
                             args: [m.key],
                         });
                         return m;

package/dist/keys.d.ts

@@ -20,18 +20,19 @@ 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;
 }
 /**
  * `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.
  */

package/dist/keys.js

@@ -18,17 +18,15 @@ 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" },
         ],
     },
 ];
 /**
  * `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.
  */
@@ -38,9 +36,7 @@ export function poolId(key) {
             base: key.base,
             quote: key.quote,
             tickSpacing: key.tickSpacing,
-            phiMin: key.phiMin,
-            kappa: key.kappa,
-            alpha: key.alpha,
+            phi: key.phi,
         },
     ]));
 }

package/dist/pools.d.ts

@@ -26,9 +26,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;
@@ -36,8 +35,12 @@ export interface PoolState {
 }
 /** Read a market's full state by key. */
 export declare function getPool(c: LogswapClient, key: PoolKey): Promise<PoolState>;
-/** The effective fee right now: $\max(\phi_{\min}, \kappa\sqrt{\sigma^2_{\text{ema}}})$, capped. */
-export declare 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 declare function phiOf(c: LogswapClient, key: PoolKey): Promise<bigint>;
 /**
  * Price from the stored log-price. **Lossy** — `x` is exact and this is a float, so use it for
  * display and never for arithmetic you intend to send back on-chain.

package/dist/pools.js

@@ -25,12 +25,16 @@ export async function getPool(c, key) {
     });
     return v;
 }
-/** The effective fee right now: $\max(\phi_{\min}, \kappa\sqrt{\sigma^2_{\text{ema}}})$, capped. */
-export async function phiEff(c, key) {
+/**
+ * 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, key) {
     return c.public.readContract({
         address: c.addresses.cPoolManager,
         abi: cPoolManagerAbi,
-        functionName: "phiEff",
+        functionName: "phiOf",
         args: [key],
     });
 }
@@ -88,9 +92,7 @@ export async function discoverMarkets(c, opts = {}) {
             base: a.base,
             quote: a.quote,
             tickSpacing: a.tickSpacing,
-            phiMin: a.phiMin,
-            kappa: a.kappa,
-            alpha: a.alpha,
+            phi: a.phi,
         };
         return {
             key,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@logswap/sdk",
-  "version": "0.5.43",
+  "version": "0.5.45",
   "description": "TypeScript SDK for Logswap, the liquidity primitive introducing the logarithmic invariant — typed wrappers over the CPoolManager / FPoolManager / Router / Lens surface.",
   "license": "GPL-2.0-or-later",
   "type": "module",

package/src/admin.ts

@@ -1,6 +1,9 @@
 /**
- * admin — the protocol's (feeCollector's) writes: the fee rates, the harvest-fee exemption, and
- * the two-step collector handover, on both managers. Plain writes to the managers; no router.
+ * admin — the protocol's (feeCollector's) writes: the protocol's cuts, the harvest-cut exemption,
+ * and the two-step collector handover, on both managers. Plain writes to the managers; no router.
+ * One vocabulary (decisions 040): both managers call the protocol's cut of the mint fee
+ * `MINT_FEE_PROTOCOL_CUT` and set it through `setFeeParams` — one cut on C (since version 4,
+ * decisions 042; `setProtocolFeeCut` / `PROTOCOL_FEE_CUT` before), two on F.
  */
 
 import type { Address, Hash, Hex } from "viem";
@@ -12,14 +15,17 @@ function wallet(c: LogswapClient) {
   return c.wallet;
 }
 
-export async function setProtocolFeeCut(c: LogswapClient, cutWad: bigint): Promise<Hash> {
-  return wallet(c).writeContract({ address: c.addresses.cPoolManager, abi: cPoolManagerAbi, functionName: "setProtocolFeeCut", args: [cutWad], chain: c.wallet!.chain, account: c.wallet!.account! } as never);
+/** The C manager's `setFeeParams(mintFeeProtocolCut)` — one cut. */
+export async function setFeeParamsC(c: LogswapClient, mintFeeProtocolCutWad: bigint): Promise<Hash> {
+  return wallet(c).writeContract({ address: c.addresses.cPoolManager, abi: cPoolManagerAbi, functionName: "setFeeParams", args: [mintFeeProtocolCutWad], chain: c.wallet!.chain, account: c.wallet!.account! } as never);
 }
-export async function setFeeParams(c: LogswapClient, mintFeeProtocolCutWad: bigint, harvestFeeWad: bigint): Promise<Hash> {
-  return wallet(c).writeContract({ address: c.addresses.fPoolManager as Address, abi: fPoolManagerAbi, functionName: "setFeeParams", args: [mintFeeProtocolCutWad, harvestFeeWad], chain: c.wallet!.chain, account: c.wallet!.account! } as never);
+/** The F manager's `setFeeParams(mintFeeProtocolCut, harvestProtocolCut)` — two cuts. */
+export async function setFeeParams(c: LogswapClient, mintFeeProtocolCutWad: bigint, harvestProtocolCutWad: bigint): Promise<Hash> {
+  return wallet(c).writeContract({ address: c.addresses.fPoolManager as Address, abi: fPoolManagerAbi, functionName: "setFeeParams", args: [mintFeeProtocolCutWad, harvestProtocolCutWad], chain: c.wallet!.chain, account: c.wallet!.account! } as never);
 }
-export async function setHarvestFeeExempt(c: LogswapClient, poolId: Hex, exempt: boolean): Promise<Hash> {
-  return wallet(c).writeContract({ address: c.addresses.fPoolManager as Address, abi: fPoolManagerAbi, functionName: "setHarvestFeeExempt", args: [poolId, exempt], chain: c.wallet!.chain, account: c.wallet!.account! } as never);
+/** Waive the protocol's cut of harvested income for one pool (`HARVEST_PROTOCOL_CUT`; F version 13 — `setHarvestFeeExempt` before). */
+export async function setHarvestCutExempt(c: LogswapClient, poolId: Hex, exempt: boolean): Promise<Hash> {
+  return wallet(c).writeContract({ address: c.addresses.fPoolManager as Address, abi: fPoolManagerAbi, functionName: "setHarvestCutExempt", args: [poolId, exempt], chain: c.wallet!.chain, account: c.wallet!.account! } as never);
 }
 export async function proposeCollector(c: LogswapClient, side: "C" | "F", next: Address): Promise<Hash> {
   const address = side === "C" ? c.addresses.cPoolManager : (c.addresses.fPoolManager as Address);

package/src/client.ts

@@ -58,8 +58,13 @@ export function createLogswapClient(args: {
  * **3** since 2026-09-03 (contracts `d8406fb`): `burnById` and `update` take an `owner`, `update`
  * mints to `to`, `positions()` returns `aps` as uint128 — and a returned quote flow now carries the
  * swept fees (decisions 018), which is why `exit`'s settle-to-one-asset math changed with it.
+ *
+ * **4** since 2026-09-18 (decisions 042 + 040): `PoolKey` is `(base, quote, tickSpacing, phi)` —
+ * the variance kernel and its two key fields are gone, so every pool id changed; `phiEff` is
+ * `phiOf`; `getPool` lost `sigma2Ema`; `Initialize` lost two fields; the cut is
+ * `MINT_FEE_PROTOCOL_CUT` / `setFeeParams`.
  */
-export const EXPECTED_VERSION = 3n;
+export const EXPECTED_VERSION = 4n;
 /**
  * The F manager's own tag (contracts 25a7bcf: 5 — the key's salt, pool names, the sponsor registry;
  * 4 was the income-only harvest cut).
@@ -91,7 +96,13 @@ export const EXPECTED_VERSION = 3n;
 // 12 (2026-09-17): one contract (decisions 039) — the sponsor facet is folded back into the
 // manager; `sponsor()` and the fallback are gone, every entry, error and event unchanged, so
 // `fPoolManagerAbi` is the manager's own ABI and no longer a union. Layout unchanged.
-export const EXPECTED_F_VERSION = 12n;
+// 13 (2026-09-18): one vocabulary (decisions 040) — `HARVEST_FEE` is `HARVEST_PROTOCOL_CUT` (a
+// cut of harvested income, not a fee on the harvest) and the exemption is `harvestCutExempt` /
+// `setHarvestCutExempt`; `acceptAuthority` clears the operator, pending and accepted (a mandate
+// is voided by the handover of the role that granted it); `setLegs` needs a generation to have
+// lived (`gen > 0`); `initialize` refuses a codeless base and `mint` refuses `to = address(0)`
+// on both managers. Layout unchanged.
+export const EXPECTED_F_VERSION = 13n;
 
 export async function assertVersion(c: LogswapClient, expected = EXPECTED_VERSION): Promise<void> {
   const { cPoolManagerAbi } = await import("./generated.js");

package/src/fpool.ts

@@ -930,8 +930,8 @@ export async function fPoolEmptyingHarvests(c: LogswapClient, poolId: Hex): Prom
   const [p, feePerL, fee, exempt, collector] = await Promise.all([
     rd<{ Q: bigint; L: bigint; kind: number; incomeTaken: bigint }>("getPool", [poolId]),
     rd<bigint>("feePerL", [poolId]),
-    rd<bigint>("HARVEST_FEE"),
-    rd<boolean>("harvestFeeExempt", [poolId]),
+    rd<bigint>("HARVEST_PROTOCOL_CUT"),
+    rd<boolean>("harvestCutExempt", [poolId]),
     rd<Address>("feeCollector"),
   ]);
   if (p.Q === 0n) return [];