@bananapus/nana-sdk-core 1.10.1 → 1.11.0

package/dist/cjs/v6/index.d.ts

@@ -15,6 +15,7 @@ export * from "./cashOut.js";
 export * from "./nft.js";
 export * from "./tokens.js";
 export * from "./uniswapV4.js";
+export * from "./uniswapV4Fees.js";
 export * from "./permissions.js";
 export * from "./suckers.js";
 export * from "./loans.js";

package/dist/cjs/v6/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/v6/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/v6/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/cjs/v6/index.js

@@ -31,6 +31,7 @@ __exportStar(require("./cashOut.js"), exports);
 __exportStar(require("./nft.js"), exports);
 __exportStar(require("./tokens.js"), exports);
 __exportStar(require("./uniswapV4.js"), exports);
+__exportStar(require("./uniswapV4Fees.js"), exports);
 __exportStar(require("./permissions.js"), exports);
 __exportStar(require("./suckers.js"), exports);
 __exportStar(require("./loans.js"), exports);

package/dist/cjs/v6/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v6/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,gDAA8B;AAC9B,4CAA0B;AAC1B,8CAA4B;AAC5B,iDAA+B;AAC/B,gDAA8B;AAC9B,8CAA4B;AAC5B,+CAA6B;AAC7B,iDAA+B;AAC/B,2CAAyB;AACzB,iDAA+B;AAC/B,+CAA6B;AAC7B,qDAAmC;AACnC,+CAA6B;AAC7B,2CAAyB;AACzB,8CAA4B;AAC5B,iDAA+B;AAC/B,mDAAiC;AACjC,+CAA6B;AAC7B,6CAA2B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v6/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,gDAA8B;AAC9B,4CAA0B;AAC1B,8CAA4B;AAC5B,iDAA+B;AAC/B,gDAA8B;AAC9B,8CAA4B;AAC5B,+CAA6B;AAC7B,iDAA+B;AAC/B,2CAAyB;AACzB,iDAA+B;AAC/B,+CAA6B;AAC7B,qDAAmC;AACnC,+CAA6B;AAC7B,2CAAyB;AACzB,8CAA4B;AAC5B,iDAA+B;AAC/B,qDAAmC;AACnC,mDAAiC;AACjC,+CAA6B;AAC7B,6CAA2B"}

package/dist/cjs/v6/uniswapV4Deployments.d.ts

@@ -8,6 +8,12 @@ export declare const UNISWAP_V4_POSITION_MANAGER_ADDRESSES: Readonly<Partial<Rec
 export declare const UNISWAP_V4_QUOTER_ADDRESSES: Readonly<Partial<Record<JBChainId, Address>>>;
 /** Canonical Universal Router deployments which support V4 swaps. */
 export declare const UNISWAP_V4_UNIVERSAL_ROUTER_ADDRESSES: Readonly<Partial<Record<JBChainId, Address>>>;
+/**
+ * Canonical StateView deployments — the periphery lens over PoolManager's
+ * `extsload` storage. Each address was verified by calling `poolManager()` and
+ * matching it against {@link UNISWAP_V4_POOL_MANAGER_ADDRESSES} for the chain.
+ */
+export declare const UNISWAP_V4_STATE_VIEW_ADDRESSES: Readonly<Partial<Record<JBChainId, Address>>>;
 /** Permit2 is deployed at the same address on supported EVM chains. */
 export declare const UNISWAP_PERMIT2_ADDRESS: Address;
 /** Resolve the supported V4 surface for a chain without guessing addresses. */
@@ -16,6 +22,7 @@ export declare function uniswapV4Deployment(chainId: number): {
     positionManager: Address | null;
     quoter: Address | null;
     universalRouter: Address | null;
+    stateView: Address | null;
     permit2: Address;
 } | null;
 //# sourceMappingURL=uniswapV4Deployments.d.ts.map

package/dist/cjs/v6/uniswapV4Deployments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uniswapV4Deployments.d.ts","sourceRoot":"","sources":["../../../src/v6/uniswapV4Deployments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,6DAA6D;AAC7D,eAAO,MAAM,iCAAiC,EAAE,QAAQ,CACtD,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CASpC,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,qCAAqC,EAAE,QAAQ,CAC1D,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CASpC,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,2BAA2B,EAAE,QAAQ,CAChD,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CASpC,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,qCAAqC,EAAE,QAAQ,CAC1D,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CASpC,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,uBAAuB,EAAE,OACQ,CAAC;AAE/C,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG;IACpD,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,eAAe,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,OAAO,EAAE,OAAO,CAAC;CAClB,GAAG,IAAI,CA6BP"}
+{"version":3,"file":"uniswapV4Deployments.d.ts","sourceRoot":"","sources":["../../../src/v6/uniswapV4Deployments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,6DAA6D;AAC7D,eAAO,MAAM,iCAAiC,EAAE,QAAQ,CACtD,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CASpC,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,qCAAqC,EAAE,QAAQ,CAC1D,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CASpC,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,2BAA2B,EAAE,QAAQ,CAChD,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CASpC,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,qCAAqC,EAAE,QAAQ,CAC1D,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CASpC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,EAAE,QAAQ,CACpD,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CASpC,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,uBAAuB,EAAE,OACQ,CAAC;AAE/C,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG;IACpD,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,eAAe,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;CAClB,GAAG,IAAI,CAmCP"}

package/dist/cjs/v6/uniswapV4Deployments.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UNISWAP_PERMIT2_ADDRESS = exports.UNISWAP_V4_UNIVERSAL_ROUTER_ADDRESSES = exports.UNISWAP_V4_QUOTER_ADDRESSES = exports.UNISWAP_V4_POSITION_MANAGER_ADDRESSES = exports.UNISWAP_V4_POOL_MANAGER_ADDRESSES = void 0;
+exports.UNISWAP_PERMIT2_ADDRESS = exports.UNISWAP_V4_STATE_VIEW_ADDRESSES = exports.UNISWAP_V4_UNIVERSAL_ROUTER_ADDRESSES = exports.UNISWAP_V4_QUOTER_ADDRESSES = exports.UNISWAP_V4_POSITION_MANAGER_ADDRESSES = exports.UNISWAP_V4_POOL_MANAGER_ADDRESSES = void 0;
 exports.uniswapV4Deployment = uniswapV4Deployment;
 /** Canonical PoolManager deployments used by Juicebox v6. */
 exports.UNISWAP_V4_POOL_MANAGER_ADDRESSES = {
@@ -42,6 +42,20 @@ exports.UNISWAP_V4_UNIVERSAL_ROUTER_ADDRESSES = {
     421614: "0xefd1d4bd4cf1e86da286bb4cb1b8bced9c10ba47",
     11155111: "0x3A9D48AB9751398BbFa63ad67599Bb04e4BdF98b",
 };
+/**
+ * Canonical StateView deployments — the periphery lens over PoolManager's
+ * `extsload` storage. Each address was verified by calling `poolManager()` and
+ * matching it against {@link UNISWAP_V4_POOL_MANAGER_ADDRESSES} for the chain.
+ */
+exports.UNISWAP_V4_STATE_VIEW_ADDRESSES = {
+    1: "0x7ffe42c4a5deea5b0fec41c94c136cf115597227",
+    10: "0xc18a3169788f4f75a170290584eca6395c75ecdb",
+    8453: "0xa3c0c9b65bad0b08107aa264b0f3db444b867a71",
+    42161: "0x76fd297e2d437cd7f76d50f01afe6160f86e9990",
+    84532: "0x571291b572ed32ce6751a2cb2486ebee8defb9b4",
+    421614: "0x9d467fa9062b6e9b1a46e26007ad82db116c67cb",
+    11155111: "0xe1dd9c3fa50edb962e442f60dfbc432e24537e4c",
+};
 /** Permit2 is deployed at the same address on supported EVM chains. */
 exports.UNISWAP_PERMIT2_ADDRESS = "0x000000000022D473030F116dDEE9F6B43aC78BA3";
 /** Resolve the supported V4 surface for a chain without guessing addresses. */
@@ -54,6 +68,7 @@ function uniswapV4Deployment(chainId) {
         positionManager: exports.UNISWAP_V4_POSITION_MANAGER_ADDRESSES[chainId] ?? null,
         quoter: exports.UNISWAP_V4_QUOTER_ADDRESSES[chainId] ?? null,
         universalRouter: exports.UNISWAP_V4_UNIVERSAL_ROUTER_ADDRESSES[chainId] ?? null,
+        stateView: exports.UNISWAP_V4_STATE_VIEW_ADDRESSES[chainId] ?? null,
         permit2: exports.UNISWAP_PERMIT2_ADDRESS,
     };
 }

package/dist/cjs/v6/uniswapV4Deployments.js.map

@@ -1 +1 @@
-{"version":3,"file":"uniswapV4Deployments.js","sourceRoot":"","sources":["../../../src/v6/uniswapV4Deployments.ts"],"names":[],"mappings":";;;AA4DA,kDAmCC;AA5FD,6DAA6D;AAChD,QAAA,iCAAiC,GAE1C;IACF,CAAC,EAAE,4CAA4C;IAC/C,EAAE,EAAE,4CAA4C;IAChD,IAAI,EAAE,4CAA4C;IAClD,KAAK,EAAE,4CAA4C;IACnD,KAAK,EAAE,4CAA4C;IACnD,MAAM,EAAE,4CAA4C;IACpD,QAAQ,EAAE,4CAA4C;CACvD,CAAC;AAEF,iEAAiE;AACpD,QAAA,qCAAqC,GAE9C;IACF,CAAC,EAAE,4CAA4C;IAC/C,EAAE,EAAE,4CAA4C;IAChD,IAAI,EAAE,4CAA4C;IAClD,KAAK,EAAE,4CAA4C;IACnD,KAAK,EAAE,4CAA4C;IACnD,MAAM,EAAE,4CAA4C;IACpD,QAAQ,EAAE,4CAA4C;CACvD,CAAC;AAEF,uEAAuE;AAC1D,QAAA,2BAA2B,GAEpC;IACF,CAAC,EAAE,4CAA4C;IAC/C,EAAE,EAAE,4CAA4C;IAChD,IAAI,EAAE,4CAA4C;IAClD,KAAK,EAAE,4CAA4C;IACnD,KAAK,EAAE,4CAA4C;IACnD,MAAM,EAAE,4CAA4C;IACpD,QAAQ,EAAE,4CAA4C;CACvD,CAAC;AAEF,qEAAqE;AACxD,QAAA,qCAAqC,GAE9C;IACF,CAAC,EAAE,4CAA4C;IAC/C,EAAE,EAAE,4CAA4C;IAChD,IAAI,EAAE,4CAA4C;IAClD,KAAK,EAAE,4CAA4C;IACnD,KAAK,EAAE,4CAA4C;IACnD,MAAM,EAAE,4CAA4C;IACpD,QAAQ,EAAE,4CAA4C;CACvD,CAAC;AAEF,uEAAuE;AAC1D,QAAA,uBAAuB,GAClC,4CAA4C,CAAC;AAE/C,+EAA+E;AAC/E,SAAgB,mBAAmB,CAAC,OAAe;IAOjD,MAAM,WAAW,GACf,yCAGD,CAAC,OAAO,CAAC,CAAC;IACX,IAAI,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IAC9B,OAAO;QACL,WAAW;QACX,eAAe,EAEX,6CAGD,CAAC,OAAO,CAAC,IAAI,IAAI;QACpB,MAAM,EAEF,mCAGD,CAAC,OAAO,CAAC,IAAI,IAAI;QACpB,eAAe,EAEX,6CAGD,CAAC,OAAO,CAAC,IAAI,IAAI;QACpB,OAAO,EAAE,+BAAuB;KACjC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"uniswapV4Deployments.js","sourceRoot":"","sources":["../../../src/v6/uniswapV4Deployments.ts"],"names":[],"mappings":";;;AA6EA,kDA0CC;AApHD,6DAA6D;AAChD,QAAA,iCAAiC,GAE1C;IACF,CAAC,EAAE,4CAA4C;IAC/C,EAAE,EAAE,4CAA4C;IAChD,IAAI,EAAE,4CAA4C;IAClD,KAAK,EAAE,4CAA4C;IACnD,KAAK,EAAE,4CAA4C;IACnD,MAAM,EAAE,4CAA4C;IACpD,QAAQ,EAAE,4CAA4C;CACvD,CAAC;AAEF,iEAAiE;AACpD,QAAA,qCAAqC,GAE9C;IACF,CAAC,EAAE,4CAA4C;IAC/C,EAAE,EAAE,4CAA4C;IAChD,IAAI,EAAE,4CAA4C;IAClD,KAAK,EAAE,4CAA4C;IACnD,KAAK,EAAE,4CAA4C;IACnD,MAAM,EAAE,4CAA4C;IACpD,QAAQ,EAAE,4CAA4C;CACvD,CAAC;AAEF,uEAAuE;AAC1D,QAAA,2BAA2B,GAEpC;IACF,CAAC,EAAE,4CAA4C;IAC/C,EAAE,EAAE,4CAA4C;IAChD,IAAI,EAAE,4CAA4C;IAClD,KAAK,EAAE,4CAA4C;IACnD,KAAK,EAAE,4CAA4C;IACnD,MAAM,EAAE,4CAA4C;IACpD,QAAQ,EAAE,4CAA4C;CACvD,CAAC;AAEF,qEAAqE;AACxD,QAAA,qCAAqC,GAE9C;IACF,CAAC,EAAE,4CAA4C;IAC/C,EAAE,EAAE,4CAA4C;IAChD,IAAI,EAAE,4CAA4C;IAClD,KAAK,EAAE,4CAA4C;IACnD,KAAK,EAAE,4CAA4C;IACnD,MAAM,EAAE,4CAA4C;IACpD,QAAQ,EAAE,4CAA4C;CACvD,CAAC;AAEF;;;;GAIG;AACU,QAAA,+BAA+B,GAExC;IACF,CAAC,EAAE,4CAA4C;IAC/C,EAAE,EAAE,4CAA4C;IAChD,IAAI,EAAE,4CAA4C;IAClD,KAAK,EAAE,4CAA4C;IACnD,KAAK,EAAE,4CAA4C;IACnD,MAAM,EAAE,4CAA4C;IACpD,QAAQ,EAAE,4CAA4C;CACvD,CAAC;AAEF,uEAAuE;AAC1D,QAAA,uBAAuB,GAClC,4CAA4C,CAAC;AAE/C,+EAA+E;AAC/E,SAAgB,mBAAmB,CAAC,OAAe;IAQjD,MAAM,WAAW,GACf,yCAGD,CAAC,OAAO,CAAC,CAAC;IACX,IAAI,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IAC9B,OAAO;QACL,WAAW;QACX,eAAe,EAEX,6CAGD,CAAC,OAAO,CAAC,IAAI,IAAI;QACpB,MAAM,EAEF,mCAGD,CAAC,OAAO,CAAC,IAAI,IAAI;QACpB,eAAe,EAEX,6CAGD,CAAC,OAAO,CAAC,IAAI,IAAI;QACpB,SAAS,EAEL,uCAGD,CAAC,OAAO,CAAC,IAAI,IAAI;QACpB,OAAO,EAAE,+BAAuB;KACjC,CAAC;AACJ,CAAC"}

package/dist/cjs/v6/uniswapV4Fees.d.ts

@@ -0,0 +1,76 @@
+import { type Address, type Hex, type PublicClient } from "viem";
+import type { JBChainId } from "../types.js";
+/**
+ * The PoolManager position key: `keccak256(abi.encodePacked(owner, tickLower,
+ * tickUpper, salt))`. For a PositionManager-held position the owner is the
+ * PositionManager and the salt is the position's token id.
+ */
+export declare function uniswapV4PositionId({ owner, tickLower, tickUpper, salt, }: {
+    owner: Address;
+    tickLower: number;
+    tickUpper: number;
+    salt: bigint;
+}): Hex;
+/**
+ * Fees a position has accrued since its last checkpoint, from the pool's fee
+ * growth accumulators.
+ *
+ * @remarks Fee growth accumulators are unchecked `uint256` in the pool and are
+ * expected to wrap; the difference is therefore taken modulo 2^256, exactly as
+ * Solidity computes it. A checked subtraction would read a wrapped accumulator
+ * as a negative (or enormous) balance.
+ */
+export declare function uniswapV4FeesOwed({ liquidity, feeGrowthInsideLastX128, feeGrowthInsideX128, }: {
+    liquidity: bigint;
+    feeGrowthInsideLastX128: bigint;
+    feeGrowthInsideX128: bigint;
+}): bigint;
+export interface UniswapV4PositionFees {
+    /** Unclaimed currency0 fees, in currency0's own decimals. */
+    amount0: bigint;
+    /** Unclaimed currency1 fees, in currency1's own decimals. */
+    amount1: bigint;
+    /** The position's live liquidity, as the pool records it. */
+    liquidity: bigint;
+}
+/**
+ * Read a position's unclaimed fees through StateView.
+ *
+ * This is the fees CLAIMABLE NOW, not the position's lifetime earnings: the
+ * pool rewrites `feeGrowthInsideLast` on every collect, so anything already
+ * taken is no longer visible here. Reconstructing lifetime earnings means
+ * replaying the position's `ModifyLiquidity` events against archive state.
+ */
+export declare function readUniswapV4PositionFees(client: Pick<PublicClient, "readContract">, { chainId, stateView, poolId, positionManager, tokenId, tickLower, tickUpper, }: {
+    chainId?: JBChainId;
+    /** Overrides the chain's canonical StateView deployment. */
+    stateView?: Address;
+    poolId: Hex;
+    positionManager: Address;
+    tokenId: bigint;
+    tickLower: number;
+    tickUpper: number;
+}): Promise<UniswapV4PositionFees>;
+export interface UniswapV4CollectFeesTxRequest {
+    to: Address;
+    data: Hex;
+    value: bigint;
+}
+/**
+ * Collect a position's fees without touching its liquidity.
+ *
+ * A V4 "collect" is a zero-liquidity decrease: the pool settles the accrued
+ * fees into the position's delta, and TAKE_PAIR pays both currencies out. The
+ * minimum-out parameters are 0 because nothing is swapped — the amounts are
+ * whatever the pool has already accrued, so a floor could only make a valid
+ * claim revert.
+ */
+export declare function buildCollectUniswapV4FeesTx({ positionManager, tokenId, currency0, currency1, recipient, deadline, }: {
+    positionManager: Address;
+    tokenId: bigint;
+    currency0: Address;
+    currency1: Address;
+    recipient: Address;
+    deadline: bigint;
+}): UniswapV4CollectFeesTxRequest;
+//# sourceMappingURL=uniswapV4Fees.d.ts.map

package/dist/cjs/v6/uniswapV4Fees.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniswapV4Fees.d.ts","sourceRoot":"","sources":["../../../src/v6/uniswapV4Fees.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,OAAO,EACZ,KAAK,GAAG,EACR,KAAK,YAAY,EAClB,MAAM,MAAM,CAAC;AAEd,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAsD7C;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,KAAK,EACL,SAAS,EACT,SAAS,EACT,IAAI,GACL,EAAE;IACD,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,GAAG,CAYN;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,SAAS,EACT,uBAAuB,EACvB,mBAAmB,GACpB,EAAE;IACD,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB,EAAE,MAAM,CAAC;IAChC,mBAAmB,EAAE,MAAM,CAAC;CAC7B,GAAG,MAAM,CAIT;AAED,MAAM,WAAW,qBAAqB;IACpC,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,EAC1C,EACE,OAAO,EACP,SAAS,EACT,MAAM,EACN,eAAe,EACf,OAAO,EACP,SAAS,EACT,SAAS,GACV,EAAE;IACD,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,GAAG,CAAC;IACZ,eAAe,EAAE,OAAO,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,GACA,OAAO,CAAC,qBAAqB,CAAC,CAsDhC;AAED,MAAM,WAAW,6BAA6B;IAC5C,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,GAAG,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,EAC1C,eAAe,EACf,OAAO,EACP,SAAS,EACT,SAAS,EACT,SAAS,EACT,QAAQ,GACT,EAAE;IACD,eAAe,EAAE,OAAO,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,6BAA6B,CAiChC"}

package/dist/cjs/v6/uniswapV4Fees.js

@@ -0,0 +1,167 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uniswapV4PositionId = uniswapV4PositionId;
+exports.uniswapV4FeesOwed = uniswapV4FeesOwed;
+exports.readUniswapV4PositionFees = readUniswapV4PositionFees;
+exports.buildCollectUniswapV4FeesTx = buildCollectUniswapV4FeesTx;
+const viem_1 = require("viem");
+const uniswapV4Deployments_js_1 = require("./uniswapV4Deployments.js");
+const UINT256_MAX = (1n << 256n) - 1n;
+const Q128 = 1n << 128n;
+const STATE_VIEW_ABI = [
+    {
+        type: "function",
+        name: "getFeeGrowthInside",
+        stateMutability: "view",
+        inputs: [
+            { name: "poolId", type: "bytes32" },
+            { name: "tickLower", type: "int24" },
+            { name: "tickUpper", type: "int24" },
+        ],
+        outputs: [
+            { name: "feeGrowthInside0X128", type: "uint256" },
+            { name: "feeGrowthInside1X128", type: "uint256" },
+        ],
+    },
+    {
+        type: "function",
+        name: "getPositionInfo",
+        stateMutability: "view",
+        inputs: [
+            { name: "poolId", type: "bytes32" },
+            { name: "positionId", type: "bytes32" },
+        ],
+        outputs: [
+            { name: "liquidity", type: "uint128" },
+            { name: "feeGrowthInside0LastX128", type: "uint256" },
+            { name: "feeGrowthInside1LastX128", type: "uint256" },
+        ],
+    },
+];
+const POSITION_MANAGER_ABI = [
+    {
+        type: "function",
+        name: "modifyLiquidities",
+        stateMutability: "payable",
+        inputs: [
+            { name: "unlockData", type: "bytes" },
+            { name: "deadline", type: "uint256" },
+        ],
+        outputs: [],
+    },
+];
+/** v4-periphery `Actions.DECREASE_LIQUIDITY`. */
+const ACTION_DECREASE_LIQUIDITY = 0x01;
+/** v4-periphery `Actions.TAKE_PAIR`. */
+const ACTION_TAKE_PAIR = 0x11;
+/**
+ * The PoolManager position key: `keccak256(abi.encodePacked(owner, tickLower,
+ * tickUpper, salt))`. For a PositionManager-held position the owner is the
+ * PositionManager and the salt is the position's token id.
+ */
+function uniswapV4PositionId({ owner, tickLower, tickUpper, salt, }) {
+    return (0, viem_1.keccak256)((0, viem_1.encodePacked)(["address", "int24", "int24", "bytes32"], [
+        owner,
+        tickLower,
+        tickUpper,
+        `0x${salt.toString(16).padStart(64, "0")}`,
+    ]));
+}
+/**
+ * Fees a position has accrued since its last checkpoint, from the pool's fee
+ * growth accumulators.
+ *
+ * @remarks Fee growth accumulators are unchecked `uint256` in the pool and are
+ * expected to wrap; the difference is therefore taken modulo 2^256, exactly as
+ * Solidity computes it. A checked subtraction would read a wrapped accumulator
+ * as a negative (or enormous) balance.
+ */
+function uniswapV4FeesOwed({ liquidity, feeGrowthInsideLastX128, feeGrowthInsideX128, }) {
+    if (liquidity <= 0n)
+        return 0n;
+    const delta = (feeGrowthInsideX128 - feeGrowthInsideLastX128) & UINT256_MAX;
+    return (delta * liquidity) / Q128;
+}
+/**
+ * Read a position's unclaimed fees through StateView.
+ *
+ * This is the fees CLAIMABLE NOW, not the position's lifetime earnings: the
+ * pool rewrites `feeGrowthInsideLast` on every collect, so anything already
+ * taken is no longer visible here. Reconstructing lifetime earnings means
+ * replaying the position's `ModifyLiquidity` events against archive state.
+ */
+async function readUniswapV4PositionFees(client, { chainId, stateView, poolId, positionManager, tokenId, tickLower, tickUpper, }) {
+    const lens = stateView ??
+        (chainId
+            ? uniswapV4Deployments_js_1.UNISWAP_V4_STATE_VIEW_ADDRESSES[chainId]
+            : undefined);
+    if (!lens) {
+        throw new Error(`No Uniswap V4 StateView deployment for chain ${chainId ?? "unknown"}.`);
+    }
+    const positionId = uniswapV4PositionId({
+        owner: positionManager,
+        tickLower,
+        tickUpper,
+        salt: tokenId,
+    });
+    const [position, inside] = await Promise.all([
+        client.readContract({
+            address: lens,
+            abi: STATE_VIEW_ABI,
+            functionName: "getPositionInfo",
+            args: [poolId, positionId],
+        }),
+        client.readContract({
+            address: lens,
+            abi: STATE_VIEW_ABI,
+            functionName: "getFeeGrowthInside",
+            args: [poolId, tickLower, tickUpper],
+        }),
+    ]);
+    const [liquidity, feeGrowthInside0Last, feeGrowthInside1Last] = position;
+    const [feeGrowthInside0, feeGrowthInside1] = inside;
+    return {
+        liquidity,
+        amount0: uniswapV4FeesOwed({
+            liquidity,
+            feeGrowthInsideLastX128: feeGrowthInside0Last,
+            feeGrowthInsideX128: feeGrowthInside0,
+        }),
+        amount1: uniswapV4FeesOwed({
+            liquidity,
+            feeGrowthInsideLastX128: feeGrowthInside1Last,
+            feeGrowthInsideX128: feeGrowthInside1,
+        }),
+    };
+}
+/**
+ * Collect a position's fees without touching its liquidity.
+ *
+ * A V4 "collect" is a zero-liquidity decrease: the pool settles the accrued
+ * fees into the position's delta, and TAKE_PAIR pays both currencies out. The
+ * minimum-out parameters are 0 because nothing is swapped — the amounts are
+ * whatever the pool has already accrued, so a floor could only make a valid
+ * claim revert.
+ */
+function buildCollectUniswapV4FeesTx({ positionManager, tokenId, currency0, currency1, recipient, deadline, }) {
+    const decreaseParams = (0, viem_1.encodeAbiParameters)([
+        { type: "uint256" },
+        { type: "uint128" },
+        { type: "uint128" },
+        { type: "uint128" },
+        { type: "bytes" },
+    ], [tokenId, 0n, 0n, 0n, "0x"]);
+    const takeParams = (0, viem_1.encodeAbiParameters)([{ type: "address" }, { type: "address" }, { type: "address" }], [currency0, currency1, recipient]);
+    const actions = (0, viem_1.encodePacked)(["uint8", "uint8"], [ACTION_DECREASE_LIQUIDITY, ACTION_TAKE_PAIR]);
+    const unlockData = (0, viem_1.encodeAbiParameters)([{ type: "bytes" }, { type: "bytes[]" }], [actions, [decreaseParams, takeParams]]);
+    return {
+        to: positionManager,
+        data: (0, viem_1.encodeFunctionData)({
+            abi: POSITION_MANAGER_ABI,
+            functionName: "modifyLiquidities",
+            args: [unlockData, deadline],
+        }),
+        value: 0n,
+    };
+}
+//# sourceMappingURL=uniswapV4Fees.js.map

package/dist/cjs/v6/uniswapV4Fees.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniswapV4Fees.js","sourceRoot":"","sources":["../../../src/v6/uniswapV4Fees.ts"],"names":[],"mappings":"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"}

package/dist/esm/v6/index.d.ts

@@ -15,6 +15,7 @@ export * from "./cashOut.js";
 export * from "./nft.js";
 export * from "./tokens.js";
 export * from "./uniswapV4.js";
+export * from "./uniswapV4Fees.js";
 export * from "./permissions.js";
 export * from "./suckers.js";
 export * from "./loans.js";

package/dist/esm/v6/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/v6/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/v6/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/esm/v6/index.js

@@ -15,6 +15,7 @@ export * from "./cashOut.js";
 export * from "./nft.js";
 export * from "./tokens.js";
 export * from "./uniswapV4.js";
+export * from "./uniswapV4Fees.js";
 export * from "./permissions.js";
 export * from "./suckers.js";
 export * from "./loans.js";

package/dist/esm/v6/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v6/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v6/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/esm/v6/uniswapV4Deployments.d.ts

@@ -8,6 +8,12 @@ export declare const UNISWAP_V4_POSITION_MANAGER_ADDRESSES: Readonly<Partial<Rec
 export declare const UNISWAP_V4_QUOTER_ADDRESSES: Readonly<Partial<Record<JBChainId, Address>>>;
 /** Canonical Universal Router deployments which support V4 swaps. */
 export declare const UNISWAP_V4_UNIVERSAL_ROUTER_ADDRESSES: Readonly<Partial<Record<JBChainId, Address>>>;
+/**
+ * Canonical StateView deployments — the periphery lens over PoolManager's
+ * `extsload` storage. Each address was verified by calling `poolManager()` and
+ * matching it against {@link UNISWAP_V4_POOL_MANAGER_ADDRESSES} for the chain.
+ */
+export declare const UNISWAP_V4_STATE_VIEW_ADDRESSES: Readonly<Partial<Record<JBChainId, Address>>>;
 /** Permit2 is deployed at the same address on supported EVM chains. */
 export declare const UNISWAP_PERMIT2_ADDRESS: Address;
 /** Resolve the supported V4 surface for a chain without guessing addresses. */
@@ -16,6 +22,7 @@ export declare function uniswapV4Deployment(chainId: number): {
     positionManager: Address | null;
     quoter: Address | null;
     universalRouter: Address | null;
+    stateView: Address | null;
     permit2: Address;
 } | null;
 //# sourceMappingURL=uniswapV4Deployments.d.ts.map

package/dist/esm/v6/uniswapV4Deployments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uniswapV4Deployments.d.ts","sourceRoot":"","sources":["../../../src/v6/uniswapV4Deployments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,6DAA6D;AAC7D,eAAO,MAAM,iCAAiC,EAAE,QAAQ,CACtD,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CASpC,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,qCAAqC,EAAE,QAAQ,CAC1D,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CASpC,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,2BAA2B,EAAE,QAAQ,CAChD,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CASpC,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,qCAAqC,EAAE,QAAQ,CAC1D,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CASpC,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,uBAAuB,EAAE,OACQ,CAAC;AAE/C,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG;IACpD,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,eAAe,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,OAAO,EAAE,OAAO,CAAC;CAClB,GAAG,IAAI,CA6BP"}
+{"version":3,"file":"uniswapV4Deployments.d.ts","sourceRoot":"","sources":["../../../src/v6/uniswapV4Deployments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,6DAA6D;AAC7D,eAAO,MAAM,iCAAiC,EAAE,QAAQ,CACtD,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CASpC,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,qCAAqC,EAAE,QAAQ,CAC1D,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CASpC,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,2BAA2B,EAAE,QAAQ,CAChD,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CASpC,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,qCAAqC,EAAE,QAAQ,CAC1D,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CASpC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,EAAE,QAAQ,CACpD,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CASpC,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,uBAAuB,EAAE,OACQ,CAAC;AAE/C,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG;IACpD,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,eAAe,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;CAClB,GAAG,IAAI,CAmCP"}

package/dist/esm/v6/uniswapV4Deployments.js

@@ -38,6 +38,20 @@ export const UNISWAP_V4_UNIVERSAL_ROUTER_ADDRESSES = {
     421614: "0xefd1d4bd4cf1e86da286bb4cb1b8bced9c10ba47",
     11155111: "0x3A9D48AB9751398BbFa63ad67599Bb04e4BdF98b",
 };
+/**
+ * Canonical StateView deployments — the periphery lens over PoolManager's
+ * `extsload` storage. Each address was verified by calling `poolManager()` and
+ * matching it against {@link UNISWAP_V4_POOL_MANAGER_ADDRESSES} for the chain.
+ */
+export const UNISWAP_V4_STATE_VIEW_ADDRESSES = {
+    1: "0x7ffe42c4a5deea5b0fec41c94c136cf115597227",
+    10: "0xc18a3169788f4f75a170290584eca6395c75ecdb",
+    8453: "0xa3c0c9b65bad0b08107aa264b0f3db444b867a71",
+    42161: "0x76fd297e2d437cd7f76d50f01afe6160f86e9990",
+    84532: "0x571291b572ed32ce6751a2cb2486ebee8defb9b4",
+    421614: "0x9d467fa9062b6e9b1a46e26007ad82db116c67cb",
+    11155111: "0xe1dd9c3fa50edb962e442f60dfbc432e24537e4c",
+};
 /** Permit2 is deployed at the same address on supported EVM chains. */
 export const UNISWAP_PERMIT2_ADDRESS = "0x000000000022D473030F116dDEE9F6B43aC78BA3";
 /** Resolve the supported V4 surface for a chain without guessing addresses. */
@@ -50,6 +64,7 @@ export function uniswapV4Deployment(chainId) {
         positionManager: UNISWAP_V4_POSITION_MANAGER_ADDRESSES[chainId] ?? null,
         quoter: UNISWAP_V4_QUOTER_ADDRESSES[chainId] ?? null,
         universalRouter: UNISWAP_V4_UNIVERSAL_ROUTER_ADDRESSES[chainId] ?? null,
+        stateView: UNISWAP_V4_STATE_VIEW_ADDRESSES[chainId] ?? null,
         permit2: UNISWAP_PERMIT2_ADDRESS,
     };
 }

package/dist/esm/v6/uniswapV4Deployments.js.map

@@ -1 +1 @@
-{"version":3,"file":"uniswapV4Deployments.js","sourceRoot":"","sources":["../../../src/v6/uniswapV4Deployments.ts"],"names":[],"mappings":"AAGA,6DAA6D;AAC7D,MAAM,CAAC,MAAM,iCAAiC,GAE1C;IACF,CAAC,EAAE,4CAA4C;IAC/C,EAAE,EAAE,4CAA4C;IAChD,IAAI,EAAE,4CAA4C;IAClD,KAAK,EAAE,4CAA4C;IACnD,KAAK,EAAE,4CAA4C;IACnD,MAAM,EAAE,4CAA4C;IACpD,QAAQ,EAAE,4CAA4C;CACvD,CAAC;AAEF,iEAAiE;AACjE,MAAM,CAAC,MAAM,qCAAqC,GAE9C;IACF,CAAC,EAAE,4CAA4C;IAC/C,EAAE,EAAE,4CAA4C;IAChD,IAAI,EAAE,4CAA4C;IAClD,KAAK,EAAE,4CAA4C;IACnD,KAAK,EAAE,4CAA4C;IACnD,MAAM,EAAE,4CAA4C;IACpD,QAAQ,EAAE,4CAA4C;CACvD,CAAC;AAEF,uEAAuE;AACvE,MAAM,CAAC,MAAM,2BAA2B,GAEpC;IACF,CAAC,EAAE,4CAA4C;IAC/C,EAAE,EAAE,4CAA4C;IAChD,IAAI,EAAE,4CAA4C;IAClD,KAAK,EAAE,4CAA4C;IACnD,KAAK,EAAE,4CAA4C;IACnD,MAAM,EAAE,4CAA4C;IACpD,QAAQ,EAAE,4CAA4C;CACvD,CAAC;AAEF,qEAAqE;AACrE,MAAM,CAAC,MAAM,qCAAqC,GAE9C;IACF,CAAC,EAAE,4CAA4C;IAC/C,EAAE,EAAE,4CAA4C;IAChD,IAAI,EAAE,4CAA4C;IAClD,KAAK,EAAE,4CAA4C;IACnD,KAAK,EAAE,4CAA4C;IACnD,MAAM,EAAE,4CAA4C;IACpD,QAAQ,EAAE,4CAA4C;CACvD,CAAC;AAEF,uEAAuE;AACvE,MAAM,CAAC,MAAM,uBAAuB,GAClC,4CAA4C,CAAC;AAE/C,+EAA+E;AAC/E,MAAM,UAAU,mBAAmB,CAAC,OAAe;IAOjD,MAAM,WAAW,GACf,iCAGD,CAAC,OAAO,CAAC,CAAC;IACX,IAAI,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IAC9B,OAAO;QACL,WAAW;QACX,eAAe,EAEX,qCAGD,CAAC,OAAO,CAAC,IAAI,IAAI;QACpB,MAAM,EAEF,2BAGD,CAAC,OAAO,CAAC,IAAI,IAAI;QACpB,eAAe,EAEX,qCAGD,CAAC,OAAO,CAAC,IAAI,IAAI;QACpB,OAAO,EAAE,uBAAuB;KACjC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"uniswapV4Deployments.js","sourceRoot":"","sources":["../../../src/v6/uniswapV4Deployments.ts"],"names":[],"mappings":"AAGA,6DAA6D;AAC7D,MAAM,CAAC,MAAM,iCAAiC,GAE1C;IACF,CAAC,EAAE,4CAA4C;IAC/C,EAAE,EAAE,4CAA4C;IAChD,IAAI,EAAE,4CAA4C;IAClD,KAAK,EAAE,4CAA4C;IACnD,KAAK,EAAE,4CAA4C;IACnD,MAAM,EAAE,4CAA4C;IACpD,QAAQ,EAAE,4CAA4C;CACvD,CAAC;AAEF,iEAAiE;AACjE,MAAM,CAAC,MAAM,qCAAqC,GAE9C;IACF,CAAC,EAAE,4CAA4C;IAC/C,EAAE,EAAE,4CAA4C;IAChD,IAAI,EAAE,4CAA4C;IAClD,KAAK,EAAE,4CAA4C;IACnD,KAAK,EAAE,4CAA4C;IACnD,MAAM,EAAE,4CAA4C;IACpD,QAAQ,EAAE,4CAA4C;CACvD,CAAC;AAEF,uEAAuE;AACvE,MAAM,CAAC,MAAM,2BAA2B,GAEpC;IACF,CAAC,EAAE,4CAA4C;IAC/C,EAAE,EAAE,4CAA4C;IAChD,IAAI,EAAE,4CAA4C;IAClD,KAAK,EAAE,4CAA4C;IACnD,KAAK,EAAE,4CAA4C;IACnD,MAAM,EAAE,4CAA4C;IACpD,QAAQ,EAAE,4CAA4C;CACvD,CAAC;AAEF,qEAAqE;AACrE,MAAM,CAAC,MAAM,qCAAqC,GAE9C;IACF,CAAC,EAAE,4CAA4C;IAC/C,EAAE,EAAE,4CAA4C;IAChD,IAAI,EAAE,4CAA4C;IAClD,KAAK,EAAE,4CAA4C;IACnD,KAAK,EAAE,4CAA4C;IACnD,MAAM,EAAE,4CAA4C;IACpD,QAAQ,EAAE,4CAA4C;CACvD,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAExC;IACF,CAAC,EAAE,4CAA4C;IAC/C,EAAE,EAAE,4CAA4C;IAChD,IAAI,EAAE,4CAA4C;IAClD,KAAK,EAAE,4CAA4C;IACnD,KAAK,EAAE,4CAA4C;IACnD,MAAM,EAAE,4CAA4C;IACpD,QAAQ,EAAE,4CAA4C;CACvD,CAAC;AAEF,uEAAuE;AACvE,MAAM,CAAC,MAAM,uBAAuB,GAClC,4CAA4C,CAAC;AAE/C,+EAA+E;AAC/E,MAAM,UAAU,mBAAmB,CAAC,OAAe;IAQjD,MAAM,WAAW,GACf,iCAGD,CAAC,OAAO,CAAC,CAAC;IACX,IAAI,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IAC9B,OAAO;QACL,WAAW;QACX,eAAe,EAEX,qCAGD,CAAC,OAAO,CAAC,IAAI,IAAI;QACpB,MAAM,EAEF,2BAGD,CAAC,OAAO,CAAC,IAAI,IAAI;QACpB,eAAe,EAEX,qCAGD,CAAC,OAAO,CAAC,IAAI,IAAI;QACpB,SAAS,EAEL,+BAGD,CAAC,OAAO,CAAC,IAAI,IAAI;QACpB,OAAO,EAAE,uBAAuB;KACjC,CAAC;AACJ,CAAC"}

package/dist/esm/v6/uniswapV4Fees.d.ts

@@ -0,0 +1,76 @@
+import { type Address, type Hex, type PublicClient } from "viem";
+import type { JBChainId } from "../types.js";
+/**
+ * The PoolManager position key: `keccak256(abi.encodePacked(owner, tickLower,
+ * tickUpper, salt))`. For a PositionManager-held position the owner is the
+ * PositionManager and the salt is the position's token id.
+ */
+export declare function uniswapV4PositionId({ owner, tickLower, tickUpper, salt, }: {
+    owner: Address;
+    tickLower: number;
+    tickUpper: number;
+    salt: bigint;
+}): Hex;
+/**
+ * Fees a position has accrued since its last checkpoint, from the pool's fee
+ * growth accumulators.
+ *
+ * @remarks Fee growth accumulators are unchecked `uint256` in the pool and are
+ * expected to wrap; the difference is therefore taken modulo 2^256, exactly as
+ * Solidity computes it. A checked subtraction would read a wrapped accumulator
+ * as a negative (or enormous) balance.
+ */
+export declare function uniswapV4FeesOwed({ liquidity, feeGrowthInsideLastX128, feeGrowthInsideX128, }: {
+    liquidity: bigint;
+    feeGrowthInsideLastX128: bigint;
+    feeGrowthInsideX128: bigint;
+}): bigint;
+export interface UniswapV4PositionFees {
+    /** Unclaimed currency0 fees, in currency0's own decimals. */
+    amount0: bigint;
+    /** Unclaimed currency1 fees, in currency1's own decimals. */
+    amount1: bigint;
+    /** The position's live liquidity, as the pool records it. */
+    liquidity: bigint;
+}
+/**
+ * Read a position's unclaimed fees through StateView.
+ *
+ * This is the fees CLAIMABLE NOW, not the position's lifetime earnings: the
+ * pool rewrites `feeGrowthInsideLast` on every collect, so anything already
+ * taken is no longer visible here. Reconstructing lifetime earnings means
+ * replaying the position's `ModifyLiquidity` events against archive state.
+ */
+export declare function readUniswapV4PositionFees(client: Pick<PublicClient, "readContract">, { chainId, stateView, poolId, positionManager, tokenId, tickLower, tickUpper, }: {
+    chainId?: JBChainId;
+    /** Overrides the chain's canonical StateView deployment. */
+    stateView?: Address;
+    poolId: Hex;
+    positionManager: Address;
+    tokenId: bigint;
+    tickLower: number;
+    tickUpper: number;
+}): Promise<UniswapV4PositionFees>;
+export interface UniswapV4CollectFeesTxRequest {
+    to: Address;
+    data: Hex;
+    value: bigint;
+}
+/**
+ * Collect a position's fees without touching its liquidity.
+ *
+ * A V4 "collect" is a zero-liquidity decrease: the pool settles the accrued
+ * fees into the position's delta, and TAKE_PAIR pays both currencies out. The
+ * minimum-out parameters are 0 because nothing is swapped — the amounts are
+ * whatever the pool has already accrued, so a floor could only make a valid
+ * claim revert.
+ */
+export declare function buildCollectUniswapV4FeesTx({ positionManager, tokenId, currency0, currency1, recipient, deadline, }: {
+    positionManager: Address;
+    tokenId: bigint;
+    currency0: Address;
+    currency1: Address;
+    recipient: Address;
+    deadline: bigint;
+}): UniswapV4CollectFeesTxRequest;
+//# sourceMappingURL=uniswapV4Fees.d.ts.map

package/dist/esm/v6/uniswapV4Fees.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniswapV4Fees.d.ts","sourceRoot":"","sources":["../../../src/v6/uniswapV4Fees.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,OAAO,EACZ,KAAK,GAAG,EACR,KAAK,YAAY,EAClB,MAAM,MAAM,CAAC;AAEd,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAsD7C;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,KAAK,EACL,SAAS,EACT,SAAS,EACT,IAAI,GACL,EAAE;IACD,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,GAAG,CAYN;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,SAAS,EACT,uBAAuB,EACvB,mBAAmB,GACpB,EAAE;IACD,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB,EAAE,MAAM,CAAC;IAChC,mBAAmB,EAAE,MAAM,CAAC;CAC7B,GAAG,MAAM,CAIT;AAED,MAAM,WAAW,qBAAqB;IACpC,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,EAC1C,EACE,OAAO,EACP,SAAS,EACT,MAAM,EACN,eAAe,EACf,OAAO,EACP,SAAS,EACT,SAAS,GACV,EAAE;IACD,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,GAAG,CAAC;IACZ,eAAe,EAAE,OAAO,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,GACA,OAAO,CAAC,qBAAqB,CAAC,CAsDhC;AAED,MAAM,WAAW,6BAA6B;IAC5C,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,GAAG,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,EAC1C,eAAe,EACf,OAAO,EACP,SAAS,EACT,SAAS,EACT,SAAS,EACT,QAAQ,GACT,EAAE;IACD,eAAe,EAAE,OAAO,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,6BAA6B,CAiChC"}

package/dist/esm/v6/uniswapV4Fees.js

@@ -0,0 +1,161 @@
+import { encodeAbiParameters, encodeFunctionData, encodePacked, keccak256, } from "viem";
+import { UNISWAP_V4_STATE_VIEW_ADDRESSES } from "./uniswapV4Deployments.js";
+const UINT256_MAX = (1n << 256n) - 1n;
+const Q128 = 1n << 128n;
+const STATE_VIEW_ABI = [
+    {
+        type: "function",
+        name: "getFeeGrowthInside",
+        stateMutability: "view",
+        inputs: [
+            { name: "poolId", type: "bytes32" },
+            { name: "tickLower", type: "int24" },
+            { name: "tickUpper", type: "int24" },
+        ],
+        outputs: [
+            { name: "feeGrowthInside0X128", type: "uint256" },
+            { name: "feeGrowthInside1X128", type: "uint256" },
+        ],
+    },
+    {
+        type: "function",
+        name: "getPositionInfo",
+        stateMutability: "view",
+        inputs: [
+            { name: "poolId", type: "bytes32" },
+            { name: "positionId", type: "bytes32" },
+        ],
+        outputs: [
+            { name: "liquidity", type: "uint128" },
+            { name: "feeGrowthInside0LastX128", type: "uint256" },
+            { name: "feeGrowthInside1LastX128", type: "uint256" },
+        ],
+    },
+];
+const POSITION_MANAGER_ABI = [
+    {
+        type: "function",
+        name: "modifyLiquidities",
+        stateMutability: "payable",
+        inputs: [
+            { name: "unlockData", type: "bytes" },
+            { name: "deadline", type: "uint256" },
+        ],
+        outputs: [],
+    },
+];
+/** v4-periphery `Actions.DECREASE_LIQUIDITY`. */
+const ACTION_DECREASE_LIQUIDITY = 0x01;
+/** v4-periphery `Actions.TAKE_PAIR`. */
+const ACTION_TAKE_PAIR = 0x11;
+/**
+ * The PoolManager position key: `keccak256(abi.encodePacked(owner, tickLower,
+ * tickUpper, salt))`. For a PositionManager-held position the owner is the
+ * PositionManager and the salt is the position's token id.
+ */
+export function uniswapV4PositionId({ owner, tickLower, tickUpper, salt, }) {
+    return keccak256(encodePacked(["address", "int24", "int24", "bytes32"], [
+        owner,
+        tickLower,
+        tickUpper,
+        `0x${salt.toString(16).padStart(64, "0")}`,
+    ]));
+}
+/**
+ * Fees a position has accrued since its last checkpoint, from the pool's fee
+ * growth accumulators.
+ *
+ * @remarks Fee growth accumulators are unchecked `uint256` in the pool and are
+ * expected to wrap; the difference is therefore taken modulo 2^256, exactly as
+ * Solidity computes it. A checked subtraction would read a wrapped accumulator
+ * as a negative (or enormous) balance.
+ */
+export function uniswapV4FeesOwed({ liquidity, feeGrowthInsideLastX128, feeGrowthInsideX128, }) {
+    if (liquidity <= 0n)
+        return 0n;
+    const delta = (feeGrowthInsideX128 - feeGrowthInsideLastX128) & UINT256_MAX;
+    return (delta * liquidity) / Q128;
+}
+/**
+ * Read a position's unclaimed fees through StateView.
+ *
+ * This is the fees CLAIMABLE NOW, not the position's lifetime earnings: the
+ * pool rewrites `feeGrowthInsideLast` on every collect, so anything already
+ * taken is no longer visible here. Reconstructing lifetime earnings means
+ * replaying the position's `ModifyLiquidity` events against archive state.
+ */
+export async function readUniswapV4PositionFees(client, { chainId, stateView, poolId, positionManager, tokenId, tickLower, tickUpper, }) {
+    const lens = stateView ??
+        (chainId
+            ? UNISWAP_V4_STATE_VIEW_ADDRESSES[chainId]
+            : undefined);
+    if (!lens) {
+        throw new Error(`No Uniswap V4 StateView deployment for chain ${chainId ?? "unknown"}.`);
+    }
+    const positionId = uniswapV4PositionId({
+        owner: positionManager,
+        tickLower,
+        tickUpper,
+        salt: tokenId,
+    });
+    const [position, inside] = await Promise.all([
+        client.readContract({
+            address: lens,
+            abi: STATE_VIEW_ABI,
+            functionName: "getPositionInfo",
+            args: [poolId, positionId],
+        }),
+        client.readContract({
+            address: lens,
+            abi: STATE_VIEW_ABI,
+            functionName: "getFeeGrowthInside",
+            args: [poolId, tickLower, tickUpper],
+        }),
+    ]);
+    const [liquidity, feeGrowthInside0Last, feeGrowthInside1Last] = position;
+    const [feeGrowthInside0, feeGrowthInside1] = inside;
+    return {
+        liquidity,
+        amount0: uniswapV4FeesOwed({
+            liquidity,
+            feeGrowthInsideLastX128: feeGrowthInside0Last,
+            feeGrowthInsideX128: feeGrowthInside0,
+        }),
+        amount1: uniswapV4FeesOwed({
+            liquidity,
+            feeGrowthInsideLastX128: feeGrowthInside1Last,
+            feeGrowthInsideX128: feeGrowthInside1,
+        }),
+    };
+}
+/**
+ * Collect a position's fees without touching its liquidity.
+ *
+ * A V4 "collect" is a zero-liquidity decrease: the pool settles the accrued
+ * fees into the position's delta, and TAKE_PAIR pays both currencies out. The
+ * minimum-out parameters are 0 because nothing is swapped — the amounts are
+ * whatever the pool has already accrued, so a floor could only make a valid
+ * claim revert.
+ */
+export function buildCollectUniswapV4FeesTx({ positionManager, tokenId, currency0, currency1, recipient, deadline, }) {
+    const decreaseParams = encodeAbiParameters([
+        { type: "uint256" },
+        { type: "uint128" },
+        { type: "uint128" },
+        { type: "uint128" },
+        { type: "bytes" },
+    ], [tokenId, 0n, 0n, 0n, "0x"]);
+    const takeParams = encodeAbiParameters([{ type: "address" }, { type: "address" }, { type: "address" }], [currency0, currency1, recipient]);
+    const actions = encodePacked(["uint8", "uint8"], [ACTION_DECREASE_LIQUIDITY, ACTION_TAKE_PAIR]);
+    const unlockData = encodeAbiParameters([{ type: "bytes" }, { type: "bytes[]" }], [actions, [decreaseParams, takeParams]]);
+    return {
+        to: positionManager,
+        data: encodeFunctionData({
+            abi: POSITION_MANAGER_ABI,
+            functionName: "modifyLiquidities",
+            args: [unlockData, deadline],
+        }),
+        value: 0n,
+    };
+}
+//# sourceMappingURL=uniswapV4Fees.js.map

package/dist/esm/v6/uniswapV4Fees.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniswapV4Fees.js","sourceRoot":"","sources":["../../../src/v6/uniswapV4Fees.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bananapus/nana-sdk-core",
-  "version": "1.10.1",
+  "version": "1.11.0",
   "type": "module",
   "sideEffects": false,
   "repository": {