@reptilianhq/uniswap-sdk 0.2.2 → 0.4.0

package/dist/abis.d.ts

@@ -157,5 +157,60 @@ export declare const v4PoolManagerAbi: readonly [{
         readonly name: "tick";
     }];
 }];
+export declare const v4PositionManagerAbi: readonly [{
+    readonly name: "initializePool";
+    readonly type: "function";
+    readonly stateMutability: "payable";
+    readonly inputs: readonly [{
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly type: "address";
+            readonly name: "currency0";
+        }, {
+            readonly type: "address";
+            readonly name: "currency1";
+        }, {
+            readonly type: "uint24";
+            readonly name: "fee";
+        }, {
+            readonly type: "int24";
+            readonly name: "tickSpacing";
+        }, {
+            readonly type: "address";
+            readonly name: "hooks";
+        }];
+        readonly name: "key";
+    }, {
+        readonly type: "uint160";
+        readonly name: "sqrtPriceX96";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "int24";
+    }];
+}, {
+    readonly name: "modifyLiquidities";
+    readonly type: "function";
+    readonly stateMutability: "payable";
+    readonly inputs: readonly [{
+        readonly type: "bytes";
+        readonly name: "unlockData";
+    }, {
+        readonly type: "uint256";
+        readonly name: "deadline";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "multicall";
+    readonly type: "function";
+    readonly stateMutability: "payable";
+    readonly inputs: readonly [{
+        readonly type: "bytes[]";
+        readonly name: "data";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "bytes[]";
+        readonly name: "results";
+    }];
+}];
 export * from './v3-abis.js';
 //# sourceMappingURL=abis.d.ts.map

package/dist/abis.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"abis.d.ts","sourceRoot":"","sources":["../src/abis.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMzB,CAAC;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKtB,CAAC;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE3B,CAAC;AAEH,cAAc,cAAc,CAAC"}
+{"version":3,"file":"abis.d.ts","sourceRoot":"","sources":["../src/abis.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMzB,CAAC;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKtB,CAAC;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE3B,CAAC;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAK/B,CAAC;AAEH,cAAc,cAAc,CAAC"}

package/dist/abis.js

@@ -17,5 +17,11 @@ export const v4QuoterAbi = parseAbi([
 export const v4PoolManagerAbi = parseAbi([
     'event Initialize(bytes32 indexed id, address indexed currency0, address indexed currency1, uint24 fee, int24 tickSpacing, address hooks, uint160 sqrtPriceX96, int24 tick)',
 ]);
+export const v4PositionManagerAbi = parseAbi([
+    'struct PoolKey { address currency0; address currency1; uint24 fee; int24 tickSpacing; address hooks; }',
+    'function initializePool(PoolKey key, uint160 sqrtPriceX96) payable returns (int24)',
+    'function modifyLiquidities(bytes unlockData, uint256 deadline) payable',
+    'function multicall(bytes[] data) payable returns (bytes[] results)',
+]);
 export * from './v3-abis.js';
 //# sourceMappingURL=abis.js.map

package/dist/abis.js.map

@@ -1 +1 @@
-{"version":3,"file":"abis.js","sourceRoot":"","sources":["../src/abis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAEhC,+EAA+E;AAC/E,oEAAoE;AACpE,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAC;IACrC,+CAA+C;IAC/C,qHAAqH;IACrH,wEAAwE;IACxE,2EAA2E;IAC3E,kHAAkH;CACnH,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC;IAClC,+CAA+C;IAC/C,wGAAwG;IACxG,0GAA0G;IAC1G,gHAAgH;CACjH,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAC;IACvC,4KAA4K;CAC7K,CAAC,CAAC;AAEH,cAAc,cAAc,CAAC","sourcesContent":["import { parseAbi } from 'viem';\n\n// Standard v4-core/periphery selectors; extracted from the bot's read surface.\n// They do not attest compatibility of a supplied custom deployment.\nexport const v4StateViewAbi = parseAbi([\n  'function poolManager() view returns (address)',\n  'function getSlot0(bytes32 poolId) view returns (uint160 sqrtPriceX96, int24 tick, uint24 protocolFee, uint24 lpFee)',\n  'function getLiquidity(bytes32 poolId) view returns (uint128 liquidity)',\n  'function getTickBitmap(bytes32 poolId, int16 word) view returns (uint256)',\n  'function getTickLiquidity(bytes32 poolId, int24 tick) view returns (uint128 liquidityGross, int128 liquidityNet)',\n]);\nexport const v4QuoterAbi = parseAbi([\n  'function poolManager() view returns (address)',\n  'struct PoolKey { address currency0; address currency1; uint24 fee; int24 tickSpacing; address hooks; }',\n  'struct QuoteExactSingleParams { PoolKey poolKey; bool zeroForOne; uint128 exactAmount; bytes hookData; }',\n  'function quoteExactInputSingle(QuoteExactSingleParams params) returns (uint256 amountOut, uint256 gasEstimate)',\n]);\nexport const v4PoolManagerAbi = parseAbi([\n  'event Initialize(bytes32 indexed id, address indexed currency0, address indexed currency1, uint24 fee, int24 tickSpacing, address hooks, uint160 sqrtPriceX96, int24 tick)',\n]);\n\nexport * from './v3-abis.js';\n"]}
+{"version":3,"file":"abis.js","sourceRoot":"","sources":["../src/abis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAEhC,+EAA+E;AAC/E,oEAAoE;AACpE,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAC;IACrC,+CAA+C;IAC/C,qHAAqH;IACrH,wEAAwE;IACxE,2EAA2E;IAC3E,kHAAkH;CACnH,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC;IAClC,+CAA+C;IAC/C,wGAAwG;IACxG,0GAA0G;IAC1G,gHAAgH;CACjH,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAC;IACvC,4KAA4K;CAC7K,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC3C,wGAAwG;IACxG,oFAAoF;IACpF,wEAAwE;IACxE,oEAAoE;CACrE,CAAC,CAAC;AAEH,cAAc,cAAc,CAAC","sourcesContent":["import { parseAbi } from 'viem';\n\n// Standard v4-core/periphery selectors; extracted from the bot's read surface.\n// They do not attest compatibility of a supplied custom deployment.\nexport const v4StateViewAbi = parseAbi([\n  'function poolManager() view returns (address)',\n  'function getSlot0(bytes32 poolId) view returns (uint160 sqrtPriceX96, int24 tick, uint24 protocolFee, uint24 lpFee)',\n  'function getLiquidity(bytes32 poolId) view returns (uint128 liquidity)',\n  'function getTickBitmap(bytes32 poolId, int16 word) view returns (uint256)',\n  'function getTickLiquidity(bytes32 poolId, int24 tick) view returns (uint128 liquidityGross, int128 liquidityNet)',\n]);\nexport const v4QuoterAbi = parseAbi([\n  'function poolManager() view returns (address)',\n  'struct PoolKey { address currency0; address currency1; uint24 fee; int24 tickSpacing; address hooks; }',\n  'struct QuoteExactSingleParams { PoolKey poolKey; bool zeroForOne; uint128 exactAmount; bytes hookData; }',\n  'function quoteExactInputSingle(QuoteExactSingleParams params) returns (uint256 amountOut, uint256 gasEstimate)',\n]);\nexport const v4PoolManagerAbi = parseAbi([\n  'event Initialize(bytes32 indexed id, address indexed currency0, address indexed currency1, uint24 fee, int24 tickSpacing, address hooks, uint160 sqrtPriceX96, int24 tick)',\n]);\nexport const v4PositionManagerAbi = parseAbi([\n  'struct PoolKey { address currency0; address currency1; uint24 fee; int24 tickSpacing; address hooks; }',\n  'function initializePool(PoolKey key, uint160 sqrtPriceX96) payable returns (int24)',\n  'function modifyLiquidities(bytes unlockData, uint256 deadline) payable',\n  'function multicall(bytes[] data) payable returns (bytes[] results)',\n]);\n\nexport * from './v3-abis.js';\n"]}

package/dist/hooks.d.ts

@@ -0,0 +1,44 @@
+import type { Address } from 'viem';
+/**
+ * A v4 hook's capability bits, decoded from its address. Field names match
+ * Uniswap's `Hooks.sol`. Declared independently of `@uniswap/v4-sdk`'s own
+ * `HookPermissions` (keyed by its nominal `HookOptions` enum) so callers can
+ * work with plain string keys instead of importing that enum too.
+ */
+export interface V4HookPermissions {
+    beforeInitialize: boolean;
+    afterInitialize: boolean;
+    beforeAddLiquidity: boolean;
+    afterAddLiquidity: boolean;
+    beforeRemoveLiquidity: boolean;
+    afterRemoveLiquidity: boolean;
+    beforeSwap: boolean;
+    afterSwap: boolean;
+    beforeDonate: boolean;
+    afterDonate: boolean;
+    beforeSwapReturnsDelta: boolean;
+    afterSwapReturnsDelta: boolean;
+    afterAddLiquidityReturnsDelta: boolean;
+    afterRemoveLiquidityReturnsDelta: boolean;
+}
+/**
+ * A v4 hook address encodes which PoolManager callbacks it implements in its low 14 bits
+ * (mined via CREATE2, so PoolManager can check permissions without an external call).
+ * Delegates the bit-to-callback mapping to `@uniswap/v4-sdk`'s `Hook` class rather than
+ * re-deriving it, so the mapping stays pinned to a versioned upstream dependency instead
+ * of drifting from memory.
+ */
+export declare function decodeV4HookPermissions(address: Address): V4HookPermissions;
+/**
+ * The permission flags a hook implements that are not in `modelled`, i.e. the
+ * behaviour a caller has not accounted for. Empty means every flag the hook
+ * sets is one the caller already knows how to price and verify.
+ *
+ * This does not judge economic safety (tax rates, whether principal is
+ * locked) — only whether the hook's *shape* is fully understood. That
+ * judgement, and what "modelled" means for a given protocol, belongs to the
+ * caller: a beforeSwap hook is fine to a caller that prices beforeSwap price
+ * moves and unsafe to one that does not.
+ */
+export declare function unmodelledV4HookPermissions(address: Address, modelled: Iterable<keyof V4HookPermissions>): (keyof V4HookPermissions)[];
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAGpC;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,eAAe,EAAE,OAAO,CAAC;IACzB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,sBAAsB,EAAE,OAAO,CAAC;IAChC,qBAAqB,EAAE,OAAO,CAAC;IAC/B,6BAA6B,EAAE,OAAO,CAAC;IACvC,gCAAgC,EAAE,OAAO,CAAC;CAC3C;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,CAE3E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,CAAC,MAAM,iBAAiB,CAAC,GAC1C,CAAC,MAAM,iBAAiB,CAAC,EAAE,CAM7B"}

package/dist/hooks.js

@@ -0,0 +1,29 @@
+import { Hook } from './official-sdk.cjs';
+import { checkedAddress } from './pool.js';
+/**
+ * A v4 hook address encodes which PoolManager callbacks it implements in its low 14 bits
+ * (mined via CREATE2, so PoolManager can check permissions without an external call).
+ * Delegates the bit-to-callback mapping to `@uniswap/v4-sdk`'s `Hook` class rather than
+ * re-deriving it, so the mapping stays pinned to a versioned upstream dependency instead
+ * of drifting from memory.
+ */
+export function decodeV4HookPermissions(address) {
+    return Hook.permissions(checkedAddress(address));
+}
+/**
+ * The permission flags a hook implements that are not in `modelled`, i.e. the
+ * behaviour a caller has not accounted for. Empty means every flag the hook
+ * sets is one the caller already knows how to price and verify.
+ *
+ * This does not judge economic safety (tax rates, whether principal is
+ * locked) — only whether the hook's *shape* is fully understood. That
+ * judgement, and what "modelled" means for a given protocol, belongs to the
+ * caller: a beforeSwap hook is fine to a caller that prices beforeSwap price
+ * moves and unsafe to one that does not.
+ */
+export function unmodelledV4HookPermissions(address, modelled) {
+    const allowed = new Set(modelled);
+    const permissions = decodeV4HookPermissions(address);
+    return Object.keys(permissions).filter(flag => permissions[flag] && !allowed.has(flag));
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE1C,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAyB3C;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,OAAO,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,OAAO,CAAC,CAAsB,CAAC;AACxE,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,2BAA2B,CACzC,OAAgB,EAChB,QAA2C;IAE3C,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,WAAW,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACrD,OAAQ,MAAM,CAAC,IAAI,CAAC,WAAW,CAAiC,CAAC,MAAM,CACrE,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAChD,CAAC;AACJ,CAAC","sourcesContent":["import { Hook } from './official-sdk.cjs';\nimport type { Address } from 'viem';\nimport { checkedAddress } from './pool.js';\n\n/**\n * A v4 hook's capability bits, decoded from its address. Field names match\n * Uniswap's `Hooks.sol`. Declared independently of `@uniswap/v4-sdk`'s own\n * `HookPermissions` (keyed by its nominal `HookOptions` enum) so callers can\n * work with plain string keys instead of importing that enum too.\n */\nexport interface V4HookPermissions {\n  beforeInitialize: boolean;\n  afterInitialize: boolean;\n  beforeAddLiquidity: boolean;\n  afterAddLiquidity: boolean;\n  beforeRemoveLiquidity: boolean;\n  afterRemoveLiquidity: boolean;\n  beforeSwap: boolean;\n  afterSwap: boolean;\n  beforeDonate: boolean;\n  afterDonate: boolean;\n  beforeSwapReturnsDelta: boolean;\n  afterSwapReturnsDelta: boolean;\n  afterAddLiquidityReturnsDelta: boolean;\n  afterRemoveLiquidityReturnsDelta: boolean;\n}\n\n/**\n * A v4 hook address encodes which PoolManager callbacks it implements in its low 14 bits\n * (mined via CREATE2, so PoolManager can check permissions without an external call).\n * Delegates the bit-to-callback mapping to `@uniswap/v4-sdk`'s `Hook` class rather than\n * re-deriving it, so the mapping stays pinned to a versioned upstream dependency instead\n * of drifting from memory.\n */\nexport function decodeV4HookPermissions(address: Address): V4HookPermissions {\n  return Hook.permissions(checkedAddress(address)) as V4HookPermissions;\n}\n\n/**\n * The permission flags a hook implements that are not in `modelled`, i.e. the\n * behaviour a caller has not accounted for. Empty means every flag the hook\n * sets is one the caller already knows how to price and verify.\n *\n * This does not judge economic safety (tax rates, whether principal is\n * locked) — only whether the hook's *shape* is fully understood. That\n * judgement, and what \"modelled\" means for a given protocol, belongs to the\n * caller: a beforeSwap hook is fine to a caller that prices beforeSwap price\n * moves and unsafe to one that does not.\n */\nexport function unmodelledV4HookPermissions(\n  address: Address,\n  modelled: Iterable<keyof V4HookPermissions>,\n): (keyof V4HookPermissions)[] {\n  const allowed = new Set(modelled);\n  const permissions = decodeV4HookPermissions(address);\n  return (Object.keys(permissions) as (keyof V4HookPermissions)[]).filter(\n    flag => permissions[flag] && !allowed.has(flag),\n  );\n}\n"]}

package/dist/official-sdk.cjs

@@ -1,9 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Pool = void 0;
+exports.Percent = exports.V4PositionManager = exports.Position = exports.Hook = exports.Pool = void 0;
 // Upstream 2.3.3's ESM export contains extensionless directory imports that
 // native Node cannot resolve. Its public require export works in Node and
 // bundlers. Keep this compatibility seam local instead of forking the SDK.
 var v4_sdk_1 = require("@uniswap/v4-sdk");
 Object.defineProperty(exports, "Pool", { enumerable: true, get: function () { return v4_sdk_1.Pool; } });
+Object.defineProperty(exports, "Hook", { enumerable: true, get: function () { return v4_sdk_1.Hook; } });
+Object.defineProperty(exports, "Position", { enumerable: true, get: function () { return v4_sdk_1.Position; } });
+Object.defineProperty(exports, "V4PositionManager", { enumerable: true, get: function () { return v4_sdk_1.V4PositionManager; } });
+var sdk_core_1 = require("@uniswap/sdk-core");
+Object.defineProperty(exports, "Percent", { enumerable: true, get: function () { return sdk_core_1.Percent; } });
 //# sourceMappingURL=official-sdk.cjs.map

package/dist/official-sdk.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"official-sdk.cjs","sourceRoot":"","sources":["../src/official-sdk.cts"],"names":[],"mappings":";;;AAAA,4EAA4E;AAC5E,0EAA0E;AAC1E,2EAA2E;AAC3E,0CAAuC;AAA9B,8FAAA,IAAI,OAAA","sourcesContent":["// Upstream 2.3.3's ESM export contains extensionless directory imports that\n// native Node cannot resolve. Its public require export works in Node and\n// bundlers. Keep this compatibility seam local instead of forking the SDK.\nexport { Pool } from '@uniswap/v4-sdk';\n"]}
+{"version":3,"file":"official-sdk.cjs","sourceRoot":"","sources":["../src/official-sdk.cts"],"names":[],"mappings":";;;AAAA,4EAA4E;AAC5E,0EAA0E;AAC1E,2EAA2E;AAC3E,0CAA0E;AAAjE,8FAAA,IAAI,OAAA;AAAE,8FAAA,IAAI,OAAA;AAAE,kGAAA,QAAQ,OAAA;AAAE,2GAAA,iBAAiB,OAAA;AAChD,8CAA4C;AAAnC,mGAAA,OAAO,OAAA","sourcesContent":["// Upstream 2.3.3's ESM export contains extensionless directory imports that\n// native Node cannot resolve. Its public require export works in Node and\n// bundlers. Keep this compatibility seam local instead of forking the SDK.\nexport { Pool, Hook, Position, V4PositionManager } from '@uniswap/v4-sdk';\nexport { Percent } from '@uniswap/sdk-core';\n"]}

package/dist/official-sdk.d.cts

@@ -1,2 +1,3 @@
-export { Pool } from '@uniswap/v4-sdk';
+export { Pool, Hook, Position, V4PositionManager } from '@uniswap/v4-sdk';
+export { Percent } from '@uniswap/sdk-core';
 //# sourceMappingURL=official-sdk.d.cts.map

package/dist/official-sdk.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"official-sdk.d.cts","sourceRoot":"","sources":["../src/official-sdk.cts"],"names":[],"mappings":"AAGA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"official-sdk.d.cts","sourceRoot":"","sources":["../src/official-sdk.cts"],"names":[],"mappings":"AAGA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/providers.d.ts

@@ -1,5 +1,6 @@
 import { type Address, type Hex } from 'viem';
 import { type V4PoolReference } from './pool.js';
+import { type V4HookPermissions } from './hooks.js';
 /** Structural contract implemented by protocol SDKs; contains no transport or signer. */
 export interface V4ProviderDescriptor {
     schemaVersion: 1;
@@ -10,6 +11,15 @@ export interface V4ProviderDescriptor {
     poolManager: Address;
     startBlock: bigint;
     hooks: readonly Address[];
+    /**
+     * Permission flags this provider has reviewed across `hooks` — what its hooks
+     * are known to do (tax a swap, gate initialization, etc.), not judged here.
+     * When present, every hook in `hooks` must implement only these flags, so a
+     * provider that has not reviewed a hook's full behaviour cannot silently pass
+     * verification once that hook starts using an extra callback. Optional so a
+     * provider can adopt this check independently of every other provider.
+     */
+    modelledHookPermissions?: readonly (keyof V4HookPermissions)[];
     discovery: {
         address: Address;
         eventSignature: string;

package/dist/providers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+C,KAAK,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,MAAM,CAAC;AAC3F,OAAO,EAA+B,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAG9E,yFAAyF;AACzF,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,CAAC,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,YAAY,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,SAAS,OAAO,EAAE,CAAC;IAC1B,SAAS,EAAE;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,uBAAuB,EAAE,GAAG,CAAC;KAC9B,CAAC;IACF,UAAU,EAAE,SAAS,WAAW,EAAE,CAAC;CACpC;AACD,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,MAAM,GAAG,iBAAiB,GAAG,QAAQ,CAAC;AAQ/E,6FAA6F;AAC7F,MAAM,WAAW,cAAe,SAAQ,eAAe;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE;QACV,aAAa,EAAE,OAAO,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,GAAG,CAAC;QACf,eAAe,EAAE,GAAG,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAQD,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAW/E;AAED,gGAAgG;AAChG,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAY/F;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,KAAK,EAAE,SAAS,cAAc,EAAE,EAAE,OAAO,EAAE;IAClH,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAClE,SAAS,EAAE;QAAE,qBAAqB,EAAE,OAAO,CAAA;KAAE,CAAC;CAC/C;gBA2B4B,MAAM;kBAAgB,MAAM;aAAW,MAAM;aAAW,OAAO;eAAa,MAAM;aAAW,MAAM;YAAU,SAAS,CAAC,GAAG,EAAE,SAAS,GAAG,EAAE,CAAC;IAWvK"}
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+C,KAAK,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,MAAM,CAAC;AAC3F,OAAO,EAA+B,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAC9E,OAAO,EAA+B,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAGjF,yFAAyF;AACzF,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,CAAC,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,YAAY,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,SAAS,OAAO,EAAE,CAAC;IAC1B;;;;;;;OAOG;IACH,uBAAuB,CAAC,EAAE,SAAS,CAAC,MAAM,iBAAiB,CAAC,EAAE,CAAC;IAC/D,SAAS,EAAE;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,uBAAuB,EAAE,GAAG,CAAC;KAC9B,CAAC;IACF,UAAU,EAAE,SAAS,WAAW,EAAE,CAAC;CACpC;AACD,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,MAAM,GAAG,iBAAiB,GAAG,QAAQ,CAAC;AAQ/E,6FAA6F;AAC7F,MAAM,WAAW,cAAe,SAAQ,eAAe;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE;QACV,aAAa,EAAE,OAAO,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,GAAG,CAAC;QACf,eAAe,EAAE,GAAG,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAQD,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAiB/E;AAED,gGAAgG;AAChG,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAY/F;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,KAAK,EAAE,SAAS,cAAc,EAAE,EAAE,OAAO,EAAE;IAClH,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAClE,SAAS,EAAE;QAAE,qBAAqB,EAAE,OAAO,CAAA;KAAE,CAAC;CAC/C;gBA2B4B,MAAM;kBAAgB,MAAM;aAAW,MAAM;aAAW,OAAO;eAAa,MAAM;aAAW,MAAM;YAAU,SAAS,CAAC,GAAG,EAAE,SAAS,GAAG,EAAE,CAAC;IAWvK"}

package/dist/providers.js

@@ -1,5 +1,6 @@
 import { getAddress, keccak256, toBytes, zeroAddress } from 'viem';
 import { checkedAddress, getV4PoolId } from './pool.js';
+import { unmodelledV4HookPermissions } from './hooks.js';
 import { invalid } from './errors.js';
 const signatures = {
     Initialize: 'Initialize(bytes32,address,address,uint24,int24,address,uint160,int24)',
@@ -31,6 +32,13 @@ export function verifyV4ProviderDescriptor(provider) {
     if (!provider.hooks.length)
         invalid('Provider must enumerate its reviewed hooks');
     provider.hooks.forEach(checkedAddress);
+    if (provider.modelledHookPermissions) {
+        for (const hookAddress of provider.hooks) {
+            const unmodelled = unmodelledV4HookPermissions(hookAddress, provider.modelledHookPermissions);
+            if (unmodelled.length)
+                invalid(`Provider hook implements unmodelled permissions: ${unmodelled.join(', ')}`);
+        }
+    }
     if (!provider.poolEvents.length || provider.poolEvents.some(event => !Object.hasOwn(signatures, event)))
         invalid('Explicit supported pool events are required');
 }

package/dist/providers.js.map

@@ -1 +1 @@
-{"version":3,"file":"providers.js","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"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","sourcesContent":["import { getAddress, keccak256, toBytes, zeroAddress, type Address, type Hex } from 'viem';\nimport { checkedAddress, getV4PoolId, type V4PoolReference } from './pool.js';\nimport { invalid } from './errors.js';\n\n/** Structural contract implemented by protocol SDKs; contains no transport or signer. */\nexport interface V4ProviderDescriptor {\n  schemaVersion: 1;\n  providerId: string;\n  deploymentId: string;\n  substrate: 'uniswap-v4';\n  chainId: number;\n  poolManager: Address;\n  startBlock: bigint;\n  hooks: readonly Address[];\n  discovery: {\n    address: Address;\n    eventSignature: string;\n    poolIdParameter: string;\n    expectedRuntimeCodeHash: Hex;\n  };\n  poolEvents: readonly V4PoolEvent[];\n}\nexport type V4PoolEvent = 'Initialize' | 'Swap' | 'ModifyLiquidity' | 'Donate';\nconst signatures: Record<V4PoolEvent, string> = {\n  Initialize: 'Initialize(bytes32,address,address,uint24,int24,address,uint160,int24)',\n  Swap: 'Swap(bytes32,address,int128,int128,uint160,uint128,int24,uint24)',\n  ModifyLiquidity: 'ModifyLiquidity(bytes32,address,int24,int24,int256,bytes32)',\n  Donate: 'Donate(bytes32,address,uint256,uint256)',\n};\n\n/** Evidence is historical, not execution authorization. Protocol SDKs verify its meaning. */\nexport interface V4ProviderPool extends V4PoolReference {\n  providerId: string;\n  deploymentId: string;\n  membership: {\n    sourceAddress: Address;\n    eventSignature: string;\n    blockNumber: bigint;\n    blockHash: Hex;\n    transactionHash: Hex;\n    logIndex: number;\n  };\n}\n\nfunction hash(value: Hex) {\n  if (!/^0x[\\da-f]{64}$/i.test(value) || /^0x0{64}$/i.test(value)) invalid('Expected a nonzero bytes32 hash');\n}\nfunction block(value: bigint) {\n  if (typeof value !== 'bigint' || value < 0n) invalid('Expected a nonnegative block number');\n}\nexport function verifyV4ProviderDescriptor(provider: V4ProviderDescriptor): void {\n  if (provider.schemaVersion !== 1 || provider.substrate !== 'uniswap-v4') invalid('Unsupported provider composition version or substrate');\n  if (!provider.providerId?.trim() || !provider.deploymentId?.trim()) invalid('Provider and deployment identifiers are required');\n  if (!Number.isSafeInteger(provider.chainId) || provider.chainId <= 0) invalid('Invalid provider chain ID');\n  if (checkedAddress(provider.poolManager) === zeroAddress || checkedAddress(provider.discovery.address) === zeroAddress) invalid('Provider contracts cannot be zero addresses');\n  block(provider.startBlock);\n  hash(provider.discovery.expectedRuntimeCodeHash);\n  if (!/^[A-Za-z]\\w*\\([^)]*\\)$/.test(provider.discovery.eventSignature) || !provider.discovery.poolIdParameter) invalid('Explicit pool membership discovery is required');\n  if (!provider.hooks.length) invalid('Provider must enumerate its reviewed hooks');\n  provider.hooks.forEach(checkedAddress);\n  if (!provider.poolEvents.length || provider.poolEvents.some(event => !Object.hasOwn(signatures, event))) invalid('Explicit supported pool events are required');\n}\n\n/** Structural/identity verification only; the protocol SDK verifies registration provenance. */\nexport function verifyV4ProviderPool(provider: V4ProviderDescriptor, pool: V4ProviderPool): void {\n  verifyV4ProviderDescriptor(provider);\n  if (pool.providerId !== provider.providerId || pool.deploymentId !== provider.deploymentId || pool.chainId !== provider.chainId\n    || checkedAddress(pool.poolManager) !== checkedAddress(provider.poolManager)) invalid('Pool belongs to a different provider deployment');\n  if (!provider.hooks.some(hook => checkedAddress(hook) === checkedAddress(pool.key.hooks))) invalid('Pool uses an unreviewed provider hook');\n  if (getV4PoolId(pool.key).toLowerCase() !== pool.poolId.toLowerCase()) invalid('Pool ID differs from its full key');\n  if (checkedAddress(pool.membership.sourceAddress) !== checkedAddress(provider.discovery.address)\n    || pool.membership.eventSignature !== provider.discovery.eventSignature) invalid('Pool membership uses a different discovery source');\n  block(pool.membership.blockNumber);\n  if (pool.membership.blockNumber < provider.startBlock) invalid('Pool membership predates deployment');\n  hash(pool.membership.blockHash); hash(pool.membership.transactionHash);\n  if (!Number.isSafeInteger(pool.membership.logIndex) || pool.membership.logIndex < 0) invalid('Invalid membership log index');\n}\n\n/** Bounded eth_getLogs-compatible plans. Empty selections return no requests, never a wildcard.\n * Hosts must apply topics upstream, retain canonical membership evidence, and replay discovery\n * blocks when the selection changes. Each query covers its whole first block, including events\n * emitted before the registration log. Hosts own reorg rollback, cursors and finality.\n */\nexport function buildV4PoolSubscriptions(provider: V4ProviderDescriptor, pools: readonly V4ProviderPool[], options: {\n  fromBlock: bigint; toBlock: bigint; maxPoolIdsPerRequest?: number;\n  transport: { indexedTopicFiltering: boolean };\n}) {\n  verifyV4ProviderDescriptor(provider);\n  block(options.fromBlock); block(options.toBlock);\n  if (options.toBlock < options.fromBlock) invalid('Invalid subscription block range');\n  if (!options.transport.indexedTopicFiltering) invalid('Selective v4 indexing requires upstream indexed-topic filtering');\n  const size = options.maxPoolIdsPerRequest ?? 64;\n  if (!Number.isSafeInteger(size) || size < 1 || size > 256) invalid('Pool filter batch size must be between 1 and 256');\n  if (pools.length > 4096) invalid('At most 4096 selected pools per planning call');\n  const selected = new Map<string, V4ProviderPool>();\n  for (const pool of pools) {\n    verifyV4ProviderPool(provider, pool);\n    const id = pool.poolId.toLowerCase();\n    const previous = selected.get(id);\n    if (previous && (previous.membership.blockHash.toLowerCase() !== pool.membership.blockHash.toLowerCase()\n      || previous.membership.blockNumber !== pool.membership.blockNumber\n      || previous.membership.transactionHash.toLowerCase() !== pool.membership.transactionHash.toLowerCase()\n      || previous.membership.logIndex !== pool.membership.logIndex)) invalid('Conflicting membership evidence; reconcile canonical history before subscribing');\n    selected.set(id, pool);\n  }\n  const groups = new Map<bigint, Hex[]>();\n  for (const [id, pool] of [...selected].sort(([a], [b]) => a.localeCompare(b))) {\n    const start = pool.membership.blockNumber > options.fromBlock ? pool.membership.blockNumber : options.fromBlock;\n    if (start > options.toBlock) continue;\n    const group = groups.get(start) ?? [];\n    group.push(id as Hex);\n    groups.set(start, group);\n  }\n  const plans: { providerId: string; deploymentId: string; chainId: number; address: Address; fromBlock: bigint; toBlock: bigint; topics: readonly [Hex, readonly Hex[]] }[] = [];\n  for (const [fromBlock, ids] of [...groups].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0)) {\n    for (let offset = 0; offset < ids.length; offset += size) {\n      for (const event of [...new Set(provider.poolEvents)]) plans.push({\n        providerId: provider.providerId, deploymentId: provider.deploymentId,\n        chainId: provider.chainId, address: getAddress(provider.poolManager), fromBlock, toBlock: options.toBlock,\n        topics: [keccak256(toBytes(signatures[event])), ids.slice(offset, offset + size)],\n      });\n    }\n  }\n  return plans;\n}\n"]}
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"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","sourcesContent":["import { getAddress, keccak256, toBytes, zeroAddress, type Address, type Hex } from 'viem';\nimport { checkedAddress, getV4PoolId, type V4PoolReference } from './pool.js';\nimport { unmodelledV4HookPermissions, type V4HookPermissions } from './hooks.js';\nimport { invalid } from './errors.js';\n\n/** Structural contract implemented by protocol SDKs; contains no transport or signer. */\nexport interface V4ProviderDescriptor {\n  schemaVersion: 1;\n  providerId: string;\n  deploymentId: string;\n  substrate: 'uniswap-v4';\n  chainId: number;\n  poolManager: Address;\n  startBlock: bigint;\n  hooks: readonly Address[];\n  /**\n   * Permission flags this provider has reviewed across `hooks` — what its hooks\n   * are known to do (tax a swap, gate initialization, etc.), not judged here.\n   * When present, every hook in `hooks` must implement only these flags, so a\n   * provider that has not reviewed a hook's full behaviour cannot silently pass\n   * verification once that hook starts using an extra callback. Optional so a\n   * provider can adopt this check independently of every other provider.\n   */\n  modelledHookPermissions?: readonly (keyof V4HookPermissions)[];\n  discovery: {\n    address: Address;\n    eventSignature: string;\n    poolIdParameter: string;\n    expectedRuntimeCodeHash: Hex;\n  };\n  poolEvents: readonly V4PoolEvent[];\n}\nexport type V4PoolEvent = 'Initialize' | 'Swap' | 'ModifyLiquidity' | 'Donate';\nconst signatures: Record<V4PoolEvent, string> = {\n  Initialize: 'Initialize(bytes32,address,address,uint24,int24,address,uint160,int24)',\n  Swap: 'Swap(bytes32,address,int128,int128,uint160,uint128,int24,uint24)',\n  ModifyLiquidity: 'ModifyLiquidity(bytes32,address,int24,int24,int256,bytes32)',\n  Donate: 'Donate(bytes32,address,uint256,uint256)',\n};\n\n/** Evidence is historical, not execution authorization. Protocol SDKs verify its meaning. */\nexport interface V4ProviderPool extends V4PoolReference {\n  providerId: string;\n  deploymentId: string;\n  membership: {\n    sourceAddress: Address;\n    eventSignature: string;\n    blockNumber: bigint;\n    blockHash: Hex;\n    transactionHash: Hex;\n    logIndex: number;\n  };\n}\n\nfunction hash(value: Hex) {\n  if (!/^0x[\\da-f]{64}$/i.test(value) || /^0x0{64}$/i.test(value)) invalid('Expected a nonzero bytes32 hash');\n}\nfunction block(value: bigint) {\n  if (typeof value !== 'bigint' || value < 0n) invalid('Expected a nonnegative block number');\n}\nexport function verifyV4ProviderDescriptor(provider: V4ProviderDescriptor): void {\n  if (provider.schemaVersion !== 1 || provider.substrate !== 'uniswap-v4') invalid('Unsupported provider composition version or substrate');\n  if (!provider.providerId?.trim() || !provider.deploymentId?.trim()) invalid('Provider and deployment identifiers are required');\n  if (!Number.isSafeInteger(provider.chainId) || provider.chainId <= 0) invalid('Invalid provider chain ID');\n  if (checkedAddress(provider.poolManager) === zeroAddress || checkedAddress(provider.discovery.address) === zeroAddress) invalid('Provider contracts cannot be zero addresses');\n  block(provider.startBlock);\n  hash(provider.discovery.expectedRuntimeCodeHash);\n  if (!/^[A-Za-z]\\w*\\([^)]*\\)$/.test(provider.discovery.eventSignature) || !provider.discovery.poolIdParameter) invalid('Explicit pool membership discovery is required');\n  if (!provider.hooks.length) invalid('Provider must enumerate its reviewed hooks');\n  provider.hooks.forEach(checkedAddress);\n  if (provider.modelledHookPermissions) {\n    for (const hookAddress of provider.hooks) {\n      const unmodelled = unmodelledV4HookPermissions(hookAddress, provider.modelledHookPermissions);\n      if (unmodelled.length) invalid(`Provider hook implements unmodelled permissions: ${unmodelled.join(', ')}`);\n    }\n  }\n  if (!provider.poolEvents.length || provider.poolEvents.some(event => !Object.hasOwn(signatures, event))) invalid('Explicit supported pool events are required');\n}\n\n/** Structural/identity verification only; the protocol SDK verifies registration provenance. */\nexport function verifyV4ProviderPool(provider: V4ProviderDescriptor, pool: V4ProviderPool): void {\n  verifyV4ProviderDescriptor(provider);\n  if (pool.providerId !== provider.providerId || pool.deploymentId !== provider.deploymentId || pool.chainId !== provider.chainId\n    || checkedAddress(pool.poolManager) !== checkedAddress(provider.poolManager)) invalid('Pool belongs to a different provider deployment');\n  if (!provider.hooks.some(hook => checkedAddress(hook) === checkedAddress(pool.key.hooks))) invalid('Pool uses an unreviewed provider hook');\n  if (getV4PoolId(pool.key).toLowerCase() !== pool.poolId.toLowerCase()) invalid('Pool ID differs from its full key');\n  if (checkedAddress(pool.membership.sourceAddress) !== checkedAddress(provider.discovery.address)\n    || pool.membership.eventSignature !== provider.discovery.eventSignature) invalid('Pool membership uses a different discovery source');\n  block(pool.membership.blockNumber);\n  if (pool.membership.blockNumber < provider.startBlock) invalid('Pool membership predates deployment');\n  hash(pool.membership.blockHash); hash(pool.membership.transactionHash);\n  if (!Number.isSafeInteger(pool.membership.logIndex) || pool.membership.logIndex < 0) invalid('Invalid membership log index');\n}\n\n/** Bounded eth_getLogs-compatible plans. Empty selections return no requests, never a wildcard.\n * Hosts must apply topics upstream, retain canonical membership evidence, and replay discovery\n * blocks when the selection changes. Each query covers its whole first block, including events\n * emitted before the registration log. Hosts own reorg rollback, cursors and finality.\n */\nexport function buildV4PoolSubscriptions(provider: V4ProviderDescriptor, pools: readonly V4ProviderPool[], options: {\n  fromBlock: bigint; toBlock: bigint; maxPoolIdsPerRequest?: number;\n  transport: { indexedTopicFiltering: boolean };\n}) {\n  verifyV4ProviderDescriptor(provider);\n  block(options.fromBlock); block(options.toBlock);\n  if (options.toBlock < options.fromBlock) invalid('Invalid subscription block range');\n  if (!options.transport.indexedTopicFiltering) invalid('Selective v4 indexing requires upstream indexed-topic filtering');\n  const size = options.maxPoolIdsPerRequest ?? 64;\n  if (!Number.isSafeInteger(size) || size < 1 || size > 256) invalid('Pool filter batch size must be between 1 and 256');\n  if (pools.length > 4096) invalid('At most 4096 selected pools per planning call');\n  const selected = new Map<string, V4ProviderPool>();\n  for (const pool of pools) {\n    verifyV4ProviderPool(provider, pool);\n    const id = pool.poolId.toLowerCase();\n    const previous = selected.get(id);\n    if (previous && (previous.membership.blockHash.toLowerCase() !== pool.membership.blockHash.toLowerCase()\n      || previous.membership.blockNumber !== pool.membership.blockNumber\n      || previous.membership.transactionHash.toLowerCase() !== pool.membership.transactionHash.toLowerCase()\n      || previous.membership.logIndex !== pool.membership.logIndex)) invalid('Conflicting membership evidence; reconcile canonical history before subscribing');\n    selected.set(id, pool);\n  }\n  const groups = new Map<bigint, Hex[]>();\n  for (const [id, pool] of [...selected].sort(([a], [b]) => a.localeCompare(b))) {\n    const start = pool.membership.blockNumber > options.fromBlock ? pool.membership.blockNumber : options.fromBlock;\n    if (start > options.toBlock) continue;\n    const group = groups.get(start) ?? [];\n    group.push(id as Hex);\n    groups.set(start, group);\n  }\n  const plans: { providerId: string; deploymentId: string; chainId: number; address: Address; fromBlock: bigint; toBlock: bigint; topics: readonly [Hex, readonly Hex[]] }[] = [];\n  for (const [fromBlock, ids] of [...groups].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0)) {\n    for (let offset = 0; offset < ids.length; offset += size) {\n      for (const event of [...new Set(provider.poolEvents)]) plans.push({\n        providerId: provider.providerId, deploymentId: provider.deploymentId,\n        chainId: provider.chainId, address: getAddress(provider.poolManager), fromBlock, toBlock: options.toBlock,\n        topics: [keccak256(toBytes(signatures[event])), ids.slice(offset, offset + size)],\n      });\n    }\n  }\n  return plans;\n}\n"]}

package/dist/v4-transactions.d.ts

@@ -0,0 +1,47 @@
+import type { Currency } from '@uniswap/sdk-core';
+import type { Address, Hex } from 'viem';
+export type V4TransactionMaterial = {
+    to: Address;
+    data: Hex;
+    value: bigint;
+};
+/** Pool state as read from PoolManager/StateView (e.g. via `readV4Pool`), not yet a mint target. */
+export type V4PoolState = {
+    currency0: Currency;
+    currency1: Currency;
+    fee: number;
+    tickSpacing: number;
+    hooks: Address;
+    sqrtPriceX96: bigint;
+    liquidity: bigint;
+    tickCurrent: number;
+};
+export type V4MintPositionParams = {
+    positionManager: Address;
+    pool: V4PoolState;
+    tickLower: number;
+    tickUpper: number;
+    /** Liquidity units to mint, not a token amount. */
+    liquidity: bigint;
+    recipient: Address;
+    /** Integer basis points, 0-10000. */
+    slippageToleranceBps: number;
+    deadlineSeconds: bigint;
+    /** Passed to the hook's callbacks verbatim; this SDK does not construct it. */
+    hookData?: Hex;
+    /** Atomically initializes the pool before minting. Requires `pool.sqrtPriceX96` to be the intended starting price. */
+    createPool?: boolean;
+};
+/**
+ * Builds unsigned calldata for `PositionManager.modifyLiquidities` minting a new v4 position.
+ * Delegates encoding to `@uniswap/v4-sdk`'s `V4PositionManager`/`V4PositionPlanner` (the same
+ * Actions/multicall encoding Uniswap's own SDK uses) rather than hand-rolling it, since v4's
+ * calldata is a sequence of packed actions, not a single ABI-encoded function call like v3's.
+ *
+ * No Permit2 support yet — callers must have already approved the position manager via a plain
+ * ERC20 approval, or the built transaction will revert on-chain. Hook-permission gating (refusing
+ * a pool whose hook implements more than the caller has modelled) is also the caller's
+ * responsibility; this function only encodes what it is given.
+ */
+export declare function buildV4MintPositionTransaction(input: V4MintPositionParams): V4TransactionMaterial;
+//# sourceMappingURL=v4-transactions.d.ts.map

package/dist/v4-transactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v4-transactions.d.ts","sourceRoot":"","sources":["../src/v4-transactions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAKzC,MAAM,MAAM,qBAAqB,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,GAAG,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9E,oGAAoG;AACpG,MAAM,MAAM,WAAW,GAAG;IACxB,SAAS,EAAE,QAAQ,CAAC;IACpB,SAAS,EAAE,QAAQ,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,eAAe,EAAE,OAAO,CAAC;IACzB,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,qCAAqC;IACrC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,sHAAsH;IACtH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AASF;;;;;;;;;;GAUG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,oBAAoB,GAAG,qBAAqB,CAyCjG"}

package/dist/v4-transactions.js

@@ -0,0 +1,57 @@
+import { Percent, Pool, Position, V4PositionManager } from './official-sdk.cjs';
+import { checkedAddress } from './pool.js';
+import { invalid, UniswapSdkError } from './errors.js';
+function slippagePercent(bps) {
+    if (!Number.isInteger(bps) || bps < 0 || bps > 10_000) {
+        invalid('slippageToleranceBps must be an integer between 0 and 10000');
+    }
+    return new Percent(bps, 10_000);
+}
+/**
+ * Builds unsigned calldata for `PositionManager.modifyLiquidities` minting a new v4 position.
+ * Delegates encoding to `@uniswap/v4-sdk`'s `V4PositionManager`/`V4PositionPlanner` (the same
+ * Actions/multicall encoding Uniswap's own SDK uses) rather than hand-rolling it, since v4's
+ * calldata is a sequence of packed actions, not a single ABI-encoded function call like v3's.
+ *
+ * No Permit2 support yet — callers must have already approved the position manager via a plain
+ * ERC20 approval, or the built transaction will revert on-chain. Hook-permission gating (refusing
+ * a pool whose hook implements more than the caller has modelled) is also the caller's
+ * responsibility; this function only encodes what it is given.
+ */
+export function buildV4MintPositionTransaction(input) {
+    if (input.liquidity <= 0n)
+        invalid('Mint liquidity must be positive');
+    if (!Number.isInteger(input.tickLower) || !Number.isInteger(input.tickUpper) || input.tickLower >= input.tickUpper) {
+        invalid('tickLower must be an integer less than tickUpper');
+    }
+    if (input.createPool && input.pool.sqrtPriceX96 <= 0n)
+        invalid('createPool requires a positive initial sqrtPriceX96');
+    const positionManager = checkedAddress(input.positionManager);
+    const recipient = checkedAddress(input.recipient);
+    const slippageTolerance = slippagePercent(input.slippageToleranceBps);
+    try {
+        const pool = new Pool(input.pool.currency0, input.pool.currency1, input.pool.fee, input.pool.tickSpacing, checkedAddress(input.pool.hooks), input.pool.sqrtPriceX96.toString(), input.pool.liquidity.toString(), input.pool.tickCurrent);
+        const position = new Position({
+            pool,
+            liquidity: input.liquidity.toString(),
+            tickLower: input.tickLower,
+            tickUpper: input.tickUpper,
+        });
+        const params = V4PositionManager.addCallParameters(position, {
+            recipient,
+            createPool: input.createPool ?? false,
+            ...(input.createPool ? { sqrtPriceX96: input.pool.sqrtPriceX96.toString() } : {}),
+            useNative: pool.currency0.isNative ? pool.currency0 : undefined,
+            slippageTolerance,
+            hookData: input.hookData,
+            deadline: input.deadlineSeconds.toString(),
+        });
+        return { to: positionManager, data: params.calldata, value: BigInt(params.value) };
+    }
+    catch (cause) {
+        if (cause instanceof UniswapSdkError)
+            throw cause;
+        throw new UniswapSdkError('INVALID_ARGUMENT', 'Official Uniswap SDK rejected the mint parameters', { cause });
+    }
+}
+//# sourceMappingURL=v4-transactions.js.map

package/dist/v4-transactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v4-transactions.js","sourceRoot":"","sources":["../src/v4-transactions.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Currency } from '@uniswap/sdk-core';\nimport type { Address, Hex } from 'viem';\nimport { Percent, Pool, Position, V4PositionManager } from './official-sdk.cjs';\nimport { checkedAddress } from './pool.js';\nimport { invalid, UniswapSdkError } from './errors.js';\n\nexport type V4TransactionMaterial = { to: Address; data: Hex; value: bigint };\n\n/** Pool state as read from PoolManager/StateView (e.g. via `readV4Pool`), not yet a mint target. */\nexport type V4PoolState = {\n  currency0: Currency;\n  currency1: Currency;\n  fee: number;\n  tickSpacing: number;\n  hooks: Address;\n  sqrtPriceX96: bigint;\n  liquidity: bigint;\n  tickCurrent: number;\n};\n\nexport type V4MintPositionParams = {\n  positionManager: Address;\n  pool: V4PoolState;\n  tickLower: number;\n  tickUpper: number;\n  /** Liquidity units to mint, not a token amount. */\n  liquidity: bigint;\n  recipient: Address;\n  /** Integer basis points, 0-10000. */\n  slippageToleranceBps: number;\n  deadlineSeconds: bigint;\n  /** Passed to the hook's callbacks verbatim; this SDK does not construct it. */\n  hookData?: Hex;\n  /** Atomically initializes the pool before minting. Requires `pool.sqrtPriceX96` to be the intended starting price. */\n  createPool?: boolean;\n};\n\nfunction slippagePercent(bps: number): Percent {\n  if (!Number.isInteger(bps) || bps < 0 || bps > 10_000) {\n    invalid('slippageToleranceBps must be an integer between 0 and 10000');\n  }\n  return new Percent(bps, 10_000);\n}\n\n/**\n * Builds unsigned calldata for `PositionManager.modifyLiquidities` minting a new v4 position.\n * Delegates encoding to `@uniswap/v4-sdk`'s `V4PositionManager`/`V4PositionPlanner` (the same\n * Actions/multicall encoding Uniswap's own SDK uses) rather than hand-rolling it, since v4's\n * calldata is a sequence of packed actions, not a single ABI-encoded function call like v3's.\n *\n * No Permit2 support yet — callers must have already approved the position manager via a plain\n * ERC20 approval, or the built transaction will revert on-chain. Hook-permission gating (refusing\n * a pool whose hook implements more than the caller has modelled) is also the caller's\n * responsibility; this function only encodes what it is given.\n */\nexport function buildV4MintPositionTransaction(input: V4MintPositionParams): V4TransactionMaterial {\n  if (input.liquidity <= 0n) invalid('Mint liquidity must be positive');\n  if (!Number.isInteger(input.tickLower) || !Number.isInteger(input.tickUpper) || input.tickLower >= input.tickUpper) {\n    invalid('tickLower must be an integer less than tickUpper');\n  }\n  if (input.createPool && input.pool.sqrtPriceX96 <= 0n) invalid('createPool requires a positive initial sqrtPriceX96');\n  const positionManager = checkedAddress(input.positionManager);\n  const recipient = checkedAddress(input.recipient);\n  const slippageTolerance = slippagePercent(input.slippageToleranceBps);\n\n  try {\n    const pool = new Pool(\n      input.pool.currency0,\n      input.pool.currency1,\n      input.pool.fee,\n      input.pool.tickSpacing,\n      checkedAddress(input.pool.hooks),\n      input.pool.sqrtPriceX96.toString(),\n      input.pool.liquidity.toString(),\n      input.pool.tickCurrent,\n    );\n    const position = new Position({\n      pool,\n      liquidity: input.liquidity.toString(),\n      tickLower: input.tickLower,\n      tickUpper: input.tickUpper,\n    });\n    const params = V4PositionManager.addCallParameters(position, {\n      recipient,\n      createPool: input.createPool ?? false,\n      ...(input.createPool ? { sqrtPriceX96: input.pool.sqrtPriceX96.toString() } : {}),\n      useNative: pool.currency0.isNative ? pool.currency0 : undefined,\n      slippageTolerance,\n      hookData: input.hookData,\n      deadline: input.deadlineSeconds.toString(),\n    });\n    return { to: positionManager, data: params.calldata as Hex, value: BigInt(params.value) };\n  } catch (cause) {\n    if (cause instanceof UniswapSdkError) throw cause;\n    throw new UniswapSdkError('INVALID_ARGUMENT', 'Official Uniswap SDK rejected the mint parameters', { cause });\n  }\n}\n"]}

package/dist/v4.d.ts

@@ -5,4 +5,8 @@ export type { V4ReadClient, V4Observation, V4PoolSnapshot, V4QuoteInput, V4Quote
 export { readV4TickWindow, ticksInWord } from './depth.js';
 export type { V4Tick, V4TickWindow } from './depth.js';
 export { decodeV4PoolInitialization } from './events.js';
+export { decodeV4HookPermissions, unmodelledV4HookPermissions } from './hooks.js';
+export type { V4HookPermissions } from './hooks.js';
+export { buildV4MintPositionTransaction } from './v4-transactions.js';
+export type { V4MintPositionParams, V4PoolState, V4TransactionMaterial } from './v4-transactions.js';
 //# sourceMappingURL=v4.d.ts.map

package/dist/v4.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"v4.d.ts","sourceRoot":"","sources":["../src/v4.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC9E,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,YAAY,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AACnG,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACpH,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC3D,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"v4.d.ts","sourceRoot":"","sources":["../src/v4.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC9E,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,YAAY,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AACnG,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACpH,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC3D,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAClF,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAC;AACtE,YAAY,EAAE,oBAAoB,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/v4.js

@@ -2,4 +2,6 @@ export { poolKeyFromCurrencies, getV4PoolId, poolReference } from './pool.js';
 export { readV4Pool, quoteV4ExactInput, quoteV4Batch, verifyV4DeploymentWiring } from './reads.js';
 export { readV4TickWindow, ticksInWord } from './depth.js';
 export { decodeV4PoolInitialization } from './events.js';
+export { decodeV4HookPermissions, unmodelledV4HookPermissions } from './hooks.js';
+export { buildV4MintPositionTransaction } from './v4-transactions.js';
 //# sourceMappingURL=v4.js.map

package/dist/v4.js.map

@@ -1 +1 @@
-{"version":3,"file":"v4.js","sourceRoot":"","sources":["../src/v4.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE9E,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,YAAY,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEnG,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC","sourcesContent":["export { poolKeyFromCurrencies, getV4PoolId, poolReference } from './pool.js';\nexport type { V4Deployment, V4PoolKey, V4PoolReference } from './pool.js';\nexport { readV4Pool, quoteV4ExactInput, quoteV4Batch, verifyV4DeploymentWiring } from './reads.js';\nexport type { V4ReadClient, V4Observation, V4PoolSnapshot, V4QuoteInput, V4Quote, V4QuoteResult } from './reads.js';\nexport { readV4TickWindow, ticksInWord } from './depth.js';\nexport type { V4Tick, V4TickWindow } from './depth.js';\nexport { decodeV4PoolInitialization } from './events.js';\n"]}
+{"version":3,"file":"v4.js","sourceRoot":"","sources":["../src/v4.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE9E,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,YAAY,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEnG,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAElF,OAAO,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAC","sourcesContent":["export { poolKeyFromCurrencies, getV4PoolId, poolReference } from './pool.js';\nexport type { V4Deployment, V4PoolKey, V4PoolReference } from './pool.js';\nexport { readV4Pool, quoteV4ExactInput, quoteV4Batch, verifyV4DeploymentWiring } from './reads.js';\nexport type { V4ReadClient, V4Observation, V4PoolSnapshot, V4QuoteInput, V4Quote, V4QuoteResult } from './reads.js';\nexport { readV4TickWindow, ticksInWord } from './depth.js';\nexport type { V4Tick, V4TickWindow } from './depth.js';\nexport { decodeV4PoolInitialization } from './events.js';\nexport { decodeV4HookPermissions, unmodelledV4HookPermissions } from './hooks.js';\nexport type { V4HookPermissions } from './hooks.js';\nexport { buildV4MintPositionTransaction } from './v4-transactions.js';\nexport type { V4MintPositionParams, V4PoolState, V4TransactionMaterial } from './v4-transactions.js';\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reptilianhq/uniswap-sdk",
-  "version": "0.2.2",
+  "version": "0.4.0",
   "description": "Deployment-explicit Uniswap observations and reviewed transaction material.",
   "license": "MIT",
   "type": "module",
@@ -119,6 +119,6 @@
   "reptilianRelease": {
     "schemaVersion": 1,
     "group": "uniswap-sdk",
-    "sourceSha": "d02bfdd8f80b6f95c7fc573ccd4eb17e6de6a0cf"
+    "sourceSha": "c050f60c50fa89a88acb7976429b4c08a18fdc84"
   }
 }