@reptilianhq/uniswap-sdk 0.4.0 → 0.5.0

package/dist/v4-transactions.d.ts

@@ -1,5 +1,5 @@
 import type { Currency } from '@uniswap/sdk-core';
-import type { Address, Hex } from 'viem';
+import { type Address, type Hex } from 'viem';
 export type V4TransactionMaterial = {
     to: Address;
     data: Hex;
@@ -44,4 +44,54 @@ export type V4MintPositionParams = {
  * responsibility; this function only encodes what it is given.
  */
 export declare function buildV4MintPositionTransaction(input: V4MintPositionParams): V4TransactionMaterial;
+export type V4PoolKeyMaterial = {
+    currency0: Address;
+    currency1: Address;
+    fee: number;
+    tickSpacing: number;
+    hooks: Address;
+};
+export type V4MintActionParams = {
+    poolKey: V4PoolKeyMaterial;
+    tickLower: number;
+    tickUpper: number;
+    liquidity: bigint;
+    amount0Max: bigint;
+    amount1Max: bigint;
+    owner: Address;
+    hookData: Hex;
+    deadline: bigint;
+    /** Present only if this mint atomically initializes the pool; the price it initializes at. */
+    createdAtSqrtPriceX96?: bigint;
+};
+export type V4ExpectedMint = V4PoolKeyMaterial & {
+    recipient: Address;
+    /**
+     * Required if this mint might atomically create the pool; the only price that
+     * mint may set. Checked only in that direction: supplying it does not require
+     * the calldata to actually create the pool — a plain mint into an
+     * already-initialized pool is unaffected either way, distinguishable from a
+     * pool-creating mint by `createdAtSqrtPriceX96` being absent from the result.
+     */
+    sqrtPriceX96?: bigint;
+};
+/**
+ * Decodes and verifies calldata built by `buildV4MintPositionTransaction`: a
+ * `modifyLiquidities` call — optionally wrapped in a `multicall` alongside pool
+ * initialization — encoding exactly a MINT_POSITION action, a SETTLE_PAIR, and,
+ * for a native-currency0 mint, a trailing SWEEP. This is the only action shape
+ * that function produces; any other sequence is calldata this decoder does not
+ * recognise as its own and refuses, rather than guessing at its meaning.
+ *
+ * `expected` must name the full pool (including `hooks`), not just the token
+ * pair — a mint into the same pair through a different, unreviewed hook is a
+ * different pool with different economics, not a cosmetic difference.
+ * `currency0`/`currency1` must already be in canonical (sorted) order, and a
+ * native-currency pool's `currency0` must be the zero address, matching how
+ * `V4PoolKey`/`Pool` represent it elsewhere in this SDK — this function does
+ * not reorder or reinterpret them. Pass `sqrtPriceX96` when the mint might
+ * atomically create the pool; omitting it fails closed rather than silently
+ * accepting whatever starting price the calldata sets.
+ */
+export declare function reviewV4MintPositionCalldata(data: Hex, expected: V4ExpectedMint): V4MintActionParams;
 //# sourceMappingURL=v4-transactions.d.ts.map

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

@@ -1 +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"}
+{"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,EAA4E,KAAK,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,MAAM,CAAC;AAMxH,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;AAgBD,MAAM,MAAM,iBAAiB,GAAG;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAC7H,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,GAAG,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,8FAA8F;IAC9F,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAwBF,MAAM,MAAM,cAAc,GAAG,iBAAiB,GAAG;IAC/C,SAAS,EAAE,OAAO,CAAC;IACnB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,cAAc,GAAG,kBAAkB,CAsEpG"}

package/dist/v4-transactions.js

@@ -1,6 +1,8 @@
+import { decodeAbiParameters, decodeFunctionData, parseAbiParameters, zeroAddress } from 'viem';
 import { Percent, Pool, Position, V4PositionManager } from './official-sdk.cjs';
 import { checkedAddress } from './pool.js';
 import { invalid, UniswapSdkError } from './errors.js';
+import { v4PositionManagerAbi } from './abis.js';
 function slippagePercent(bps) {
     if (!Number.isInteger(bps) || bps < 0 || bps > 10_000) {
         invalid('slippageToleranceBps must be an integer between 0 and 10000');
@@ -54,4 +56,125 @@ export function buildV4MintPositionTransaction(input) {
         throw new UniswapSdkError('INVALID_ARGUMENT', 'Official Uniswap SDK rejected the mint parameters', { cause });
     }
 }
+const MINT_POSITION_ACTION = 2;
+const SETTLE_PAIR_ACTION = 13;
+const SWEEP_ACTION = 20;
+/** PositionManager's `msgSender()` sentinel; the only address `SWEEP` may refund to. */
+const MSG_SENDER = '0x0000000000000000000000000000000000000001';
+const unlockDataParams = parseAbiParameters('bytes actions, bytes[] params');
+const poolKeyStruct = '(address currency0, address currency1, uint24 fee, int24 tickSpacing, address hooks)';
+const mintPositionParams = parseAbiParameters(`${poolKeyStruct} poolKey, int24 tickLower, int24 tickUpper, uint256 liquidity, uint128 amount0Max, uint128 amount1Max, address owner, bytes hookData`);
+const settlePairParams = parseAbiParameters('address currency0, address currency1');
+const sweepParams = parseAbiParameters('address currency, address to');
+function same(a, b) {
+    return a.toLowerCase() === b.toLowerCase();
+}
+function mismatch(message) {
+    throw new UniswapSdkError('CALLDATA_MISMATCH', message);
+}
+/** `bytes actions` packs one uint8 opcode per action, two hex characters each. */
+function decodeActionIds(actions) {
+    const hex = actions.slice(2);
+    if (hex.length % 2 !== 0)
+        mismatch('Mint calldata has a malformed action byte string');
+    const ids = [];
+    for (let i = 0; i < hex.length; i += 2)
+        ids.push(parseInt(hex.slice(i, i + 2), 16));
+    return ids;
+}
+function samePoolKey(a, b) {
+    return same(a.currency0, b.currency0) && same(a.currency1, b.currency1)
+        && a.fee === b.fee && a.tickSpacing === b.tickSpacing && same(a.hooks, b.hooks);
+}
+/**
+ * Decodes and verifies calldata built by `buildV4MintPositionTransaction`: a
+ * `modifyLiquidities` call — optionally wrapped in a `multicall` alongside pool
+ * initialization — encoding exactly a MINT_POSITION action, a SETTLE_PAIR, and,
+ * for a native-currency0 mint, a trailing SWEEP. This is the only action shape
+ * that function produces; any other sequence is calldata this decoder does not
+ * recognise as its own and refuses, rather than guessing at its meaning.
+ *
+ * `expected` must name the full pool (including `hooks`), not just the token
+ * pair — a mint into the same pair through a different, unreviewed hook is a
+ * different pool with different economics, not a cosmetic difference.
+ * `currency0`/`currency1` must already be in canonical (sorted) order, and a
+ * native-currency pool's `currency0` must be the zero address, matching how
+ * `V4PoolKey`/`Pool` represent it elsewhere in this SDK — this function does
+ * not reorder or reinterpret them. Pass `sqrtPriceX96` when the mint might
+ * atomically create the pool; omitting it fails closed rather than silently
+ * accepting whatever starting price the calldata sets.
+ */
+export function reviewV4MintPositionCalldata(data, expected) {
+    try {
+        const decoded = decodeFunctionData({ abi: v4PositionManagerAbi, data });
+        let unlockData;
+        let deadline;
+        let initialization;
+        if (decoded.functionName === 'multicall') {
+            const calls = decoded.args[0].map(call => decodeFunctionData({ abi: v4PositionManagerAbi, data: call }));
+            if (calls.length !== 2 || calls[0].functionName !== 'initializePool' || calls[1].functionName !== 'modifyLiquidities') {
+                mismatch('Mint calldata multicall must contain only pool initialization followed by one mint');
+            }
+            initialization = { key: calls[0].args[0], sqrtPriceX96: calls[0].args[1] };
+            [unlockData, deadline] = calls[1].args;
+        }
+        else if (decoded.functionName === 'modifyLiquidities') {
+            [unlockData, deadline] = decoded.args;
+        }
+        else {
+            return mismatch('Mint calldata is not a position-manager modifyLiquidities call');
+        }
+        const [actionsBytes, actionParams] = decodeAbiParameters(unlockDataParams, unlockData);
+        const actionIds = decodeActionIds(actionsBytes);
+        if (actionIds.length !== actionParams.length)
+            mismatch('Mint calldata has a different number of actions and action parameters');
+        if (actionIds.length < 2 || actionIds.length > 3)
+            mismatch('Mint calldata does not have the action count a plain mint produces');
+        if (actionIds[0] !== MINT_POSITION_ACTION)
+            mismatch('Mint calldata must begin with a MINT_POSITION action');
+        const [poolKey, tickLower, tickUpper, liquidity, amount0Max, amount1Max, owner, hookData] = decodeAbiParameters(mintPositionParams, actionParams[0]);
+        if (liquidity <= 0n)
+            mismatch('Mint calldata mints non-positive liquidity');
+        if (initialization && !samePoolKey(initialization.key, poolKey)) {
+            mismatch('Mint pool initialization targets a different pool than the position mint');
+        }
+        if (actionIds[1] !== SETTLE_PAIR_ACTION)
+            mismatch('MINT_POSITION must be followed by a SETTLE_PAIR');
+        const [settleCurrency0, settleCurrency1] = decodeAbiParameters(settlePairParams, actionParams[1]);
+        if (!same(settleCurrency0, poolKey.currency0) || !same(settleCurrency1, poolKey.currency1)) {
+            mismatch('SETTLE_PAIR settles a different pair than the minted position');
+        }
+        if (actionIds.length === 3) {
+            if (actionIds[2] !== SWEEP_ACTION)
+                mismatch('Mint calldata has an unreviewed action after SETTLE_PAIR');
+            const [sweepCurrency, sweepTo] = decodeAbiParameters(sweepParams, actionParams[2]);
+            if (!same(sweepCurrency, zeroAddress) && !same(sweepCurrency, poolKey.currency0)) {
+                mismatch('SWEEP refunds an unexpected currency');
+            }
+            if (!same(sweepTo, MSG_SENDER))
+                mismatch('SWEEP sends the refund to an unexpected recipient');
+        }
+        if (!samePoolKey(poolKey, expected))
+            mismatch('Mint calldata targets a different pool than expected');
+        if (!same(owner, expected.recipient))
+            mismatch('Mint calldata sends the position NFT to a different recipient');
+        if (initialization) {
+            if (expected.sqrtPriceX96 === undefined) {
+                mismatch('Mint calldata initializes the pool but no expected starting price was supplied to verify it');
+            }
+            if (initialization.sqrtPriceX96 !== expected.sqrtPriceX96) {
+                mismatch('Mint calldata initializes the pool at a different starting price than expected');
+            }
+        }
+        return {
+            poolKey, tickLower, tickUpper, liquidity, amount0Max, amount1Max, owner, hookData, deadline,
+            ...(initialization ? { createdAtSqrtPriceX96: initialization.sqrtPriceX96 } : {}),
+        };
+    }
+    catch (error) {
+        if (error instanceof UniswapSdkError)
+            throw error;
+        throw new UniswapSdkError('CALLDATA_MISMATCH', 'Mint calldata contains undecodable position-manager calls', { cause: error });
+    }
+}
 //# sourceMappingURL=v4-transactions.js.map

package/dist/v4-transactions.js.map

@@ -1 +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"]}
+{"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 { decodeAbiParameters, decodeFunctionData, parseAbiParameters, zeroAddress, type Address, type Hex } from 'viem';\nimport { Percent, Pool, Position, V4PositionManager } from './official-sdk.cjs';\nimport { checkedAddress } from './pool.js';\nimport { invalid, UniswapSdkError } from './errors.js';\nimport { v4PositionManagerAbi } from './abis.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\nconst MINT_POSITION_ACTION = 2;\nconst SETTLE_PAIR_ACTION = 13;\nconst SWEEP_ACTION = 20;\n/** PositionManager's `msgSender()` sentinel; the only address `SWEEP` may refund to. */\nconst MSG_SENDER: Address = '0x0000000000000000000000000000000000000001';\n\nconst unlockDataParams = parseAbiParameters('bytes actions, bytes[] params');\nconst poolKeyStruct = '(address currency0, address currency1, uint24 fee, int24 tickSpacing, address hooks)';\nconst mintPositionParams = parseAbiParameters(\n  `${poolKeyStruct} poolKey, int24 tickLower, int24 tickUpper, uint256 liquidity, uint128 amount0Max, uint128 amount1Max, address owner, bytes hookData`,\n);\nconst settlePairParams = parseAbiParameters('address currency0, address currency1');\nconst sweepParams = parseAbiParameters('address currency, address to');\n\nexport type V4PoolKeyMaterial = { currency0: Address; currency1: Address; fee: number; tickSpacing: number; hooks: Address };\nexport type V4MintActionParams = {\n  poolKey: V4PoolKeyMaterial;\n  tickLower: number;\n  tickUpper: number;\n  liquidity: bigint;\n  amount0Max: bigint;\n  amount1Max: bigint;\n  owner: Address;\n  hookData: Hex;\n  deadline: bigint;\n  /** Present only if this mint atomically initializes the pool; the price it initializes at. */\n  createdAtSqrtPriceX96?: bigint;\n};\n\nfunction same(a: string, b: string): boolean {\n  return a.toLowerCase() === b.toLowerCase();\n}\n\nfunction mismatch(message: string): never {\n  throw new UniswapSdkError('CALLDATA_MISMATCH', message);\n}\n\n/** `bytes actions` packs one uint8 opcode per action, two hex characters each. */\nfunction decodeActionIds(actions: Hex): number[] {\n  const hex = actions.slice(2);\n  if (hex.length % 2 !== 0) mismatch('Mint calldata has a malformed action byte string');\n  const ids: number[] = [];\n  for (let i = 0; i < hex.length; i += 2) ids.push(parseInt(hex.slice(i, i + 2), 16));\n  return ids;\n}\n\nfunction samePoolKey(a: V4PoolKeyMaterial, b: V4PoolKeyMaterial): boolean {\n  return same(a.currency0, b.currency0) && same(a.currency1, b.currency1)\n    && a.fee === b.fee && a.tickSpacing === b.tickSpacing && same(a.hooks, b.hooks);\n}\n\nexport type V4ExpectedMint = V4PoolKeyMaterial & {\n  recipient: Address;\n  /**\n   * Required if this mint might atomically create the pool; the only price that\n   * mint may set. Checked only in that direction: supplying it does not require\n   * the calldata to actually create the pool — a plain mint into an\n   * already-initialized pool is unaffected either way, distinguishable from a\n   * pool-creating mint by `createdAtSqrtPriceX96` being absent from the result.\n   */\n  sqrtPriceX96?: bigint;\n};\n\n/**\n * Decodes and verifies calldata built by `buildV4MintPositionTransaction`: a\n * `modifyLiquidities` call — optionally wrapped in a `multicall` alongside pool\n * initialization — encoding exactly a MINT_POSITION action, a SETTLE_PAIR, and,\n * for a native-currency0 mint, a trailing SWEEP. This is the only action shape\n * that function produces; any other sequence is calldata this decoder does not\n * recognise as its own and refuses, rather than guessing at its meaning.\n *\n * `expected` must name the full pool (including `hooks`), not just the token\n * pair — a mint into the same pair through a different, unreviewed hook is a\n * different pool with different economics, not a cosmetic difference.\n * `currency0`/`currency1` must already be in canonical (sorted) order, and a\n * native-currency pool's `currency0` must be the zero address, matching how\n * `V4PoolKey`/`Pool` represent it elsewhere in this SDK — this function does\n * not reorder or reinterpret them. Pass `sqrtPriceX96` when the mint might\n * atomically create the pool; omitting it fails closed rather than silently\n * accepting whatever starting price the calldata sets.\n */\nexport function reviewV4MintPositionCalldata(data: Hex, expected: V4ExpectedMint): V4MintActionParams {\n  try {\n    const decoded = decodeFunctionData({ abi: v4PositionManagerAbi, data });\n    let unlockData: Hex;\n    let deadline: bigint;\n    let initialization: { key: V4PoolKeyMaterial; sqrtPriceX96: bigint } | undefined;\n    if (decoded.functionName === 'multicall') {\n      const calls = decoded.args[0].map(call => decodeFunctionData({ abi: v4PositionManagerAbi, data: call }));\n      if (calls.length !== 2 || calls[0]!.functionName !== 'initializePool' || calls[1]!.functionName !== 'modifyLiquidities') {\n        mismatch('Mint calldata multicall must contain only pool initialization followed by one mint');\n      }\n      initialization = { key: calls[0]!.args[0] as V4PoolKeyMaterial, sqrtPriceX96: calls[0]!.args[1] as bigint };\n      [unlockData, deadline] = calls[1]!.args as [Hex, bigint];\n    } else if (decoded.functionName === 'modifyLiquidities') {\n      [unlockData, deadline] = decoded.args;\n    } else {\n      return mismatch('Mint calldata is not a position-manager modifyLiquidities call');\n    }\n\n    const [actionsBytes, actionParams] = decodeAbiParameters(unlockDataParams, unlockData) as [Hex, readonly Hex[]];\n    const actionIds = decodeActionIds(actionsBytes);\n    if (actionIds.length !== actionParams.length) mismatch('Mint calldata has a different number of actions and action parameters');\n    if (actionIds.length < 2 || actionIds.length > 3) mismatch('Mint calldata does not have the action count a plain mint produces');\n\n    if (actionIds[0] !== MINT_POSITION_ACTION) mismatch('Mint calldata must begin with a MINT_POSITION action');\n    const [poolKey, tickLower, tickUpper, liquidity, amount0Max, amount1Max, owner, hookData] = decodeAbiParameters(\n      mintPositionParams,\n      actionParams[0]!,\n    ) as [V4PoolKeyMaterial, number, number, bigint, bigint, bigint, Address, Hex];\n    if (liquidity <= 0n) mismatch('Mint calldata mints non-positive liquidity');\n\n    if (initialization && !samePoolKey(initialization.key, poolKey)) {\n      mismatch('Mint pool initialization targets a different pool than the position mint');\n    }\n\n    if (actionIds[1] !== SETTLE_PAIR_ACTION) mismatch('MINT_POSITION must be followed by a SETTLE_PAIR');\n    const [settleCurrency0, settleCurrency1] = decodeAbiParameters(settlePairParams, actionParams[1]!) as [Address, Address];\n    if (!same(settleCurrency0, poolKey.currency0) || !same(settleCurrency1, poolKey.currency1)) {\n      mismatch('SETTLE_PAIR settles a different pair than the minted position');\n    }\n\n    if (actionIds.length === 3) {\n      if (actionIds[2] !== SWEEP_ACTION) mismatch('Mint calldata has an unreviewed action after SETTLE_PAIR');\n      const [sweepCurrency, sweepTo] = decodeAbiParameters(sweepParams, actionParams[2]!) as [Address, Address];\n      if (!same(sweepCurrency, zeroAddress) && !same(sweepCurrency, poolKey.currency0)) {\n        mismatch('SWEEP refunds an unexpected currency');\n      }\n      if (!same(sweepTo, MSG_SENDER)) mismatch('SWEEP sends the refund to an unexpected recipient');\n    }\n\n    if (!samePoolKey(poolKey, expected)) mismatch('Mint calldata targets a different pool than expected');\n    if (!same(owner, expected.recipient)) mismatch('Mint calldata sends the position NFT to a different recipient');\n\n    if (initialization) {\n      if (expected.sqrtPriceX96 === undefined) {\n        mismatch('Mint calldata initializes the pool but no expected starting price was supplied to verify it');\n      }\n      if (initialization.sqrtPriceX96 !== expected.sqrtPriceX96) {\n        mismatch('Mint calldata initializes the pool at a different starting price than expected');\n      }\n    }\n\n    return {\n      poolKey, tickLower, tickUpper, liquidity, amount0Max, amount1Max, owner, hookData, deadline,\n      ...(initialization ? { createdAtSqrtPriceX96: initialization.sqrtPriceX96 } : {}),\n    };\n  } catch (error) {\n    if (error instanceof UniswapSdkError) throw error;\n    throw new UniswapSdkError('CALLDATA_MISMATCH', 'Mint calldata contains undecodable position-manager calls', { cause: error });\n  }\n}\n"]}

package/dist/v4.d.ts

@@ -7,6 +7,6 @@ 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';
+export { buildV4MintPositionTransaction, reviewV4MintPositionCalldata } from './v4-transactions.js';
+export type { V4ExpectedMint, V4MintActionParams, V4MintPositionParams, V4PoolKeyMaterial, 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;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"}
+{"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,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AACpG,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/v4.js

@@ -3,5 +3,5 @@ export { readV4Pool, quoteV4ExactInput, quoteV4Batch, verifyV4DeploymentWiring }
 export { readV4TickWindow, ticksInWord } from './depth.js';
 export { decodeV4PoolInitialization } from './events.js';
 export { decodeV4HookPermissions, unmodelledV4HookPermissions } from './hooks.js';
-export { buildV4MintPositionTransaction } from './v4-transactions.js';
+export { buildV4MintPositionTransaction, reviewV4MintPositionCalldata } 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;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"]}
+{"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,4BAA4B,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, reviewV4MintPositionCalldata } from './v4-transactions.js';\nexport type { V4ExpectedMint, V4MintActionParams, V4MintPositionParams, V4PoolKeyMaterial, V4PoolState, V4TransactionMaterial } from './v4-transactions.js';\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reptilianhq/uniswap-sdk",
-  "version": "0.4.0",
+  "version": "0.5.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": "c050f60c50fa89a88acb7976429b4c08a18fdc84"
+    "sourceSha": "ed44539b6ad5c269898c2c164b772d897e53f942"
   }
 }