@reptilianhq/uniswap-sdk 0.3.0 → 0.5.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/official-sdk.cjs

@@ -1,10 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Hook = 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,0CAA6C;AAApC,8FAAA,IAAI,OAAA;AAAE,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, Hook } 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, Hook } 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,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/v4-transactions.d.ts

@@ -0,0 +1,97 @@
+import type { Currency } from '@uniswap/sdk-core';
+import { type Address, type 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;
+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

@@ -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,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

@@ -0,0 +1,180 @@
+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');
+    }
+    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 });
+    }
+}
+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

@@ -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 { 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,4 +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, 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"}
+{"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,4 +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, 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","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';\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.3.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": "5f41e24057e8865a6df61ba4c13c0272a870e4a3"
+    "sourceSha": "ed44539b6ad5c269898c2c164b772d897e53f942"
   }
 }