@logswap/sdk 0.5.43 → 0.5.45

package/README.md

@@ -85,9 +85,9 @@ runs once and explicitly rather than being chained into both.
 - **The SDK hides the manager/router/lens split.** Which contract hosts which action is currently
   decided by EIP-170 headroom, not by design — so a future re-homing must be an SDK patch, not a
   breaking change for consumers.
-- **Zero is not the default.** `phiMin` and `alpha` of `0n` resolve to their defaults at *read* time,
-  so a key carrying `0n` and one carrying the resolved value are **different markets with different
-  ids**. Always address a market by the key it was initialized with.
+- **Zero is not the default.** A `phi` of `0n` resolves to `DEFAULT_FEE` at *read* time, so a key
+  carrying `0n` and one carrying the resolved value are **different markets with different ids**.
+  Always address a market by the key it was initialized with.
 - **Split every ERC-6909 `Transfer` on bit 255.** Clear means a token claim, not a position; an
   indexer that ignores this reports phantom LP positions for market makers parking inventory.
 

package/dist/admin.d.ts

@@ -1,11 +1,17 @@
 /**
- * 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";
 import type { LogswapClient } from "./client.js";
-export declare function setProtocolFeeCut(c: LogswapClient, cutWad: bigint): Promise<Hash>;
-export declare function setFeeParams(c: LogswapClient, mintFeeProtocolCutWad: bigint, harvestFeeWad: bigint): Promise<Hash>;
-export declare function setHarvestFeeExempt(c: LogswapClient, poolId: Hex, exempt: boolean): Promise<Hash>;
+/** The C manager's `setFeeParams(mintFeeProtocolCut)` — one cut. */
+export declare function setFeeParamsC(c: LogswapClient, mintFeeProtocolCutWad: bigint): Promise<Hash>;
+/** The F manager's `setFeeParams(mintFeeProtocolCut, harvestProtocolCut)` — two cuts. */
+export declare function setFeeParams(c: LogswapClient, mintFeeProtocolCutWad: bigint, harvestProtocolCutWad: bigint): Promise<Hash>;
+/** Waive the protocol's cut of harvested income for one pool (`HARVEST_PROTOCOL_CUT`; F version 13 — `setHarvestFeeExempt` before). */
+export declare function setHarvestCutExempt(c: LogswapClient, poolId: Hex, exempt: boolean): Promise<Hash>;
 export declare function proposeCollector(c: LogswapClient, side: "C" | "F", next: Address): Promise<Hash>;
 export declare function acceptCollector(c: LogswapClient, side: "C" | "F"): Promise<Hash>;

package/dist/admin.js

@@ -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 { cPoolManagerAbi, fPoolManagerAbi } from "./generated.js";
 function wallet(c) {
@@ -8,14 +11,17 @@ function wallet(c) {
         throw new Error("a wallet client is required");
     return c.wallet;
 }
-export async function setProtocolFeeCut(c, cutWad) {
-    return wallet(c).writeContract({ address: c.addresses.cPoolManager, abi: cPoolManagerAbi, functionName: "setProtocolFeeCut", args: [cutWad], chain: c.wallet.chain, account: c.wallet.account });
+/** The C manager's `setFeeParams(mintFeeProtocolCut)` — one cut. */
+export async function setFeeParamsC(c, mintFeeProtocolCutWad) {
+    return wallet(c).writeContract({ address: c.addresses.cPoolManager, abi: cPoolManagerAbi, functionName: "setFeeParams", args: [mintFeeProtocolCutWad], chain: c.wallet.chain, account: c.wallet.account });
 }
-export async function setFeeParams(c, mintFeeProtocolCutWad, harvestFeeWad) {
-    return wallet(c).writeContract({ address: c.addresses.fPoolManager, abi: fPoolManagerAbi, functionName: "setFeeParams", args: [mintFeeProtocolCutWad, harvestFeeWad], chain: c.wallet.chain, account: c.wallet.account });
+/** The F manager's `setFeeParams(mintFeeProtocolCut, harvestProtocolCut)` — two cuts. */
+export async function setFeeParams(c, mintFeeProtocolCutWad, harvestProtocolCutWad) {
+    return wallet(c).writeContract({ address: c.addresses.fPoolManager, abi: fPoolManagerAbi, functionName: "setFeeParams", args: [mintFeeProtocolCutWad, harvestProtocolCutWad], chain: c.wallet.chain, account: c.wallet.account });
 }
-export async function setHarvestFeeExempt(c, poolId, exempt) {
-    return wallet(c).writeContract({ address: c.addresses.fPoolManager, abi: fPoolManagerAbi, functionName: "setHarvestFeeExempt", args: [poolId, exempt], chain: c.wallet.chain, account: c.wallet.account });
+/** Waive the protocol's cut of harvested income for one pool (`HARVEST_PROTOCOL_CUT`; F version 13 — `setHarvestFeeExempt` before). */
+export async function setHarvestCutExempt(c, poolId, exempt) {
+    return wallet(c).writeContract({ address: c.addresses.fPoolManager, abi: fPoolManagerAbi, functionName: "setHarvestCutExempt", args: [poolId, exempt], chain: c.wallet.chain, account: c.wallet.account });
 }
 export async function proposeCollector(c, side, next) {
     const address = side === "C" ? c.addresses.cPoolManager : c.addresses.fPoolManager;

package/dist/client.d.ts

@@ -51,8 +51,13 @@ export declare 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 declare const EXPECTED_VERSION = 3n;
+export declare 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).
@@ -64,5 +69,5 @@ export declare const EXPECTED_VERSION = 3n;
  * passes it; when one lands, raise this constant in the same change, which is the discipline
  * `EXPECTED_VERSION` enforces mechanically and this one asks for.
  */
-export declare const EXPECTED_F_VERSION = 12n;
+export declare const EXPECTED_F_VERSION = 13n;
 export declare function assertVersion(c: LogswapClient, expected?: bigint): Promise<void>;

package/dist/client.js

@@ -27,8 +27,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).
@@ -60,7 +65,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, expected = EXPECTED_VERSION) {
     const { cPoolManagerAbi } = await import("./generated.js");
     const got = await c.public.readContract({

package/dist/fpool.js

@@ -642,8 +642,8 @@ export async function fPoolEmptyingHarvests(c, poolId) {
     const [p, feePerL, fee, exempt, collector] = await Promise.all([
         rd("getPool", [poolId]),
         rd("feePerL", [poolId]),
-        rd("HARVEST_FEE"),
-        rd("harvestFeeExempt", [poolId]),
+        rd("HARVEST_PROTOCOL_CUT"),
+        rd("harvestCutExempt", [poolId]),
         rd("feeCollector"),
     ]);
     if (p.Q === 0n)