@reptilianhq/uniswap-sdk 0.2.2

package/dist/events.js

@@ -0,0 +1,27 @@
+import { decodeEventLog } from 'viem';
+import { v4PoolManagerAbi } from './abis.js';
+import { invalid, UniswapSdkError } from './errors.js';
+import { checkedAddress, poolReference } from './pool.js';
+/** Normalize an Initialize log supplied by an indexer or bounded RPC scan. */
+export function decodeV4PoolInitialization(deployment, log) {
+    if (log.removed)
+        invalid('Removed logs cannot establish pool discovery');
+    if (checkedAddress(log.address) !== checkedAddress(deployment.poolManager))
+        invalid('Initialize log came from a different PoolManager');
+    const decoded = (() => {
+        try {
+            return decodeEventLog({ abi: v4PoolManagerAbi, data: log.data, topics: log.topics, strict: true });
+        }
+        catch (cause) {
+            throw new UniswapSdkError('INVALID_ARGUMENT', 'Initialize log cannot be decoded', { cause });
+        }
+    })();
+    if (decoded.eventName !== 'Initialize')
+        invalid('Expected an Initialize event');
+    const reference = poolReference(deployment, decoded.args);
+    if (reference.poolId.toLowerCase() !== decoded.args.id.toLowerCase())
+        invalid('Initialize PoolKey does not match its pool ID');
+    return { ...reference, sqrtPriceX96: decoded.args.sqrtPriceX96, tick: decoded.args.tick,
+        blockNumber: log.blockNumber, transactionHash: log.transactionHash, logIndex: log.logIndex };
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAA0B,MAAM,MAAM,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAqB,MAAM,WAAW,CAAC;AAE7E,8EAA8E;AAC9E,MAAM,UAAU,0BAA0B,CAAC,UAAwB,EAAE,GAEpE;IACC,IAAI,GAAG,CAAC,OAAO;QAAE,OAAO,CAAC,8CAA8C,CAAC,CAAC;IACzE,IAAI,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,cAAc,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,CAAC,kDAAkD,CAAC,CAAC;IACxI,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE;QACpB,IAAI,CAAC;YACH,OAAO,cAAc,CAAC,EAAE,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACrG,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,kCAAkC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/F,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;IACL,IAAI,OAAO,CAAC,SAAS,KAAK,YAAY;QAAE,OAAO,CAAC,8BAA8B,CAAC,CAAC;IAChF,MAAM,SAAS,GAAG,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,IAAI,SAAS,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE;QAAE,OAAO,CAAC,+CAA+C,CAAC,CAAC;IAC/H,OAAO,EAAE,GAAG,SAAS,EAAE,YAAY,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI;QACrF,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,eAAe,EAAE,GAAG,CAAC,eAAe,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC;AACjG,CAAC","sourcesContent":["import { decodeEventLog, type Address, type Hex } from 'viem';\nimport { v4PoolManagerAbi } from './abis.js';\nimport { invalid, UniswapSdkError } from './errors.js';\nimport { checkedAddress, poolReference, type V4Deployment } from './pool.js';\n\n/** Normalize an Initialize log supplied by an indexer or bounded RPC scan. */\nexport function decodeV4PoolInitialization(deployment: V4Deployment, log: {\n  address: Address; data: Hex; topics: [Hex, ...Hex[]]; blockNumber: bigint; transactionHash: Hex; logIndex: number; removed?: boolean;\n}) {\n  if (log.removed) invalid('Removed logs cannot establish pool discovery');\n  if (checkedAddress(log.address) !== checkedAddress(deployment.poolManager)) invalid('Initialize log came from a different PoolManager');\n  const decoded = (() => {\n    try {\n      return decodeEventLog({ abi: v4PoolManagerAbi, data: log.data, topics: log.topics, strict: true });\n    } catch (cause) {\n      throw new UniswapSdkError('INVALID_ARGUMENT', 'Initialize log cannot be decoded', { cause });\n    }\n  })();\n  if (decoded.eventName !== 'Initialize') invalid('Expected an Initialize event');\n  const reference = poolReference(deployment, decoded.args);\n  if (reference.poolId.toLowerCase() !== decoded.args.id.toLowerCase()) invalid('Initialize PoolKey does not match its pool ID');\n  return { ...reference, sqrtPriceX96: decoded.args.sqrtPriceX96, tick: decoded.args.tick,\n    blockNumber: log.blockNumber, transactionHash: log.transactionHash, logIndex: log.logIndex };\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './v4.js';
+export { UniswapSdkError, isUniswapSdkError } from './errors.js';
+export * from './v3.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACjE,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from './v4.js';
+export { UniswapSdkError, isUniswapSdkError } from './errors.js';
+export * from './v3.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACjE,cAAc,SAAS,CAAC","sourcesContent":["export * from './v4.js';\nexport { UniswapSdkError, isUniswapSdkError } from './errors.js';\nexport * from './v3.js';\n"]}

package/dist/official-sdk.cjs

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+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; } });
+//# sourceMappingURL=official-sdk.cjs.map

package/dist/official-sdk.cjs.map

@@ -0,0 +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"]}

package/dist/official-sdk.d.cts

@@ -0,0 +1,2 @@
+export { Pool } from '@uniswap/v4-sdk';
+//# sourceMappingURL=official-sdk.d.cts.map

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

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

package/dist/pool.d.ts

@@ -0,0 +1,30 @@
+import type { Currency } from '@uniswap/sdk-core';
+import { type Address, type Hex } from 'viem';
+export interface V4PoolKey {
+    currency0: Address;
+    currency1: Address;
+    fee: number;
+    tickSpacing: number;
+    hooks: Address;
+}
+export interface V4Deployment {
+    chainId: number;
+    poolManager: Address;
+    stateView: Address;
+    quoter: Address;
+}
+export interface V4PoolReference {
+    chainId: number;
+    poolManager: Address;
+    poolId: Hex;
+    key: V4PoolKey;
+}
+export declare function checkedAddress(value: Address): Address;
+export declare function validateDeployment(deployment: V4Deployment): V4Deployment;
+export declare function validatePoolKey(key: V4PoolKey): V4PoolKey;
+/** Official SDK currency normalization; native currencies remain address(0). */
+export declare function poolKeyFromCurrencies(a: Currency, b: Currency, fee: number, tickSpacing: number, hooks: Address): V4PoolKey;
+/** Pool ID does not contain chain or manager identity; retain the full reference. */
+export declare function getV4PoolId(input: V4PoolKey): Hex;
+export declare function poolReference(deployment: V4Deployment, input: V4PoolKey): V4PoolReference;
+//# sourceMappingURL=pool.d.ts.map

package/dist/pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../src/pool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAsE,KAAK,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,MAAM,CAAC;AAGlH,MAAM,WAAW,SAAS;IAAG,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;AACvH,MAAM,WAAW,YAAY;IAAG,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE;AAC5G,MAAM,WAAW,eAAe;IAAG,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,GAAG,CAAC;IAAC,GAAG,EAAE,SAAS,CAAA;CAAE;AAEvG,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAGtD;AACD,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,YAAY,GAAG,YAAY,CAKzE;AACD,wBAAgB,eAAe,CAAC,GAAG,EAAE,SAAS,GAAG,SAAS,CAOzD;AAED,gFAAgF;AAChF,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,SAAS,CAU3H;AAED,qFAAqF;AACrF,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,GAAG,CAMjD;AACD,wBAAgB,aAAa,CAAC,UAAU,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,GAAG,eAAe,CAIzF"}

package/dist/pool.js

@@ -0,0 +1,55 @@
+import { Pool } from './official-sdk.cjs';
+import { encodeAbiParameters, getAddress, isAddress, keccak256, zeroAddress } from 'viem';
+import { invalid, UniswapSdkError } from './errors.js';
+export function checkedAddress(value) {
+    if (!isAddress(value))
+        invalid('Expected a valid EVM address');
+    return getAddress(value);
+}
+export function validateDeployment(deployment) {
+    if (!Number.isSafeInteger(deployment.chainId) || deployment.chainId <= 0)
+        invalid('chainId must be a positive safe integer');
+    const result = { chainId: deployment.chainId, poolManager: checkedAddress(deployment.poolManager), stateView: checkedAddress(deployment.stateView), quoter: checkedAddress(deployment.quoter) };
+    if ([result.poolManager, result.stateView, result.quoter].includes(zeroAddress))
+        invalid('Deployment contracts cannot be zero addresses');
+    return result;
+}
+export function validatePoolKey(key) {
+    const result = { ...key, currency0: checkedAddress(key.currency0), currency1: checkedAddress(key.currency1), hooks: checkedAddress(key.hooks) };
+    if (BigInt(result.currency0) >= BigInt(result.currency1))
+        invalid('PoolKey currencies must be distinct and in canonical address order');
+    if (!Number.isInteger(key.fee) || key.fee < 0 || (key.fee > 1_000_000 && key.fee !== 0x800000))
+        invalid('fee must be a static fee up to 1000000 or the dynamic fee flag');
+    if (key.fee === 0x800000 && result.hooks === zeroAddress)
+        invalid('Dynamic fee requires a hook');
+    if (!Number.isInteger(key.tickSpacing) || key.tickSpacing < 1 || key.tickSpacing > 32767)
+        invalid('tickSpacing must be between 1 and 32767');
+    return result;
+}
+/** Official SDK currency normalization; native currencies remain address(0). */
+export function poolKeyFromCurrencies(a, b, fee, tickSpacing, hooks) {
+    if (a.chainId !== b.chainId)
+        invalid('Pool currencies must belong to the same chain');
+    if (a.equals(b))
+        invalid('Pool currencies must be distinct');
+    try {
+        const key = Pool.getPoolKey(a, b, fee, tickSpacing, hooks);
+        return validatePoolKey({ ...key, currency0: checkedAddress(key.currency0), currency1: checkedAddress(key.currency1), hooks: checkedAddress(key.hooks) });
+    }
+    catch (cause) {
+        if (cause instanceof UniswapSdkError)
+            throw cause;
+        throw new UniswapSdkError('INVALID_ARGUMENT', 'Official Uniswap SDK rejected the pool parameters', { cause });
+    }
+}
+/** Pool ID does not contain chain or manager identity; retain the full reference. */
+export function getV4PoolId(input) {
+    const key = validatePoolKey(input);
+    return keccak256(encodeAbiParameters([{ type: 'address' }, { type: 'address' }, { type: 'uint24' }, { type: 'int24' }, { type: 'address' }], [key.currency0, key.currency1, key.fee, key.tickSpacing, key.hooks]));
+}
+export function poolReference(deployment, input) {
+    const { chainId, poolManager } = validateDeployment(deployment);
+    const key = validatePoolKey(input);
+    return { chainId, poolManager, key, poolId: getV4PoolId(key) };
+}
+//# sourceMappingURL=pool.js.map

package/dist/pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.js","sourceRoot":"","sources":["../src/pool.ts"],"names":[],"mappings":"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","sourcesContent":["import { Pool } from './official-sdk.cjs';\nimport type { Currency } from '@uniswap/sdk-core';\nimport { encodeAbiParameters, getAddress, isAddress, keccak256, zeroAddress, type Address, type Hex } from 'viem';\nimport { invalid, UniswapSdkError } from './errors.js';\n\nexport interface V4PoolKey { currency0: Address; currency1: Address; fee: number; tickSpacing: number; hooks: Address }\nexport interface V4Deployment { chainId: number; poolManager: Address; stateView: Address; quoter: Address }\nexport interface V4PoolReference { chainId: number; poolManager: Address; poolId: Hex; key: V4PoolKey }\n\nexport function checkedAddress(value: Address): Address {\n  if (!isAddress(value)) invalid('Expected a valid EVM address');\n  return getAddress(value);\n}\nexport function validateDeployment(deployment: V4Deployment): V4Deployment {\n  if (!Number.isSafeInteger(deployment.chainId) || deployment.chainId <= 0) invalid('chainId must be a positive safe integer');\n  const result = { chainId: deployment.chainId, poolManager: checkedAddress(deployment.poolManager), stateView: checkedAddress(deployment.stateView), quoter: checkedAddress(deployment.quoter) };\n  if ([result.poolManager, result.stateView, result.quoter].includes(zeroAddress)) invalid('Deployment contracts cannot be zero addresses');\n  return result;\n}\nexport function validatePoolKey(key: V4PoolKey): V4PoolKey {\n  const result = { ...key, currency0: checkedAddress(key.currency0), currency1: checkedAddress(key.currency1), hooks: checkedAddress(key.hooks) };\n  if (BigInt(result.currency0) >= BigInt(result.currency1)) invalid('PoolKey currencies must be distinct and in canonical address order');\n  if (!Number.isInteger(key.fee) || key.fee < 0 || (key.fee > 1_000_000 && key.fee !== 0x800000)) invalid('fee must be a static fee up to 1000000 or the dynamic fee flag');\n  if (key.fee === 0x800000 && result.hooks === zeroAddress) invalid('Dynamic fee requires a hook');\n  if (!Number.isInteger(key.tickSpacing) || key.tickSpacing < 1 || key.tickSpacing > 32767) invalid('tickSpacing must be between 1 and 32767');\n  return result;\n}\n\n/** Official SDK currency normalization; native currencies remain address(0). */\nexport function poolKeyFromCurrencies(a: Currency, b: Currency, fee: number, tickSpacing: number, hooks: Address): V4PoolKey {\n  if (a.chainId !== b.chainId) invalid('Pool currencies must belong to the same chain');\n  if (a.equals(b)) invalid('Pool currencies must be distinct');\n  try {\n    const key = Pool.getPoolKey(a, b, fee, tickSpacing, hooks);\n    return validatePoolKey({ ...key, currency0: checkedAddress(key.currency0 as Address), currency1: checkedAddress(key.currency1 as Address), hooks: checkedAddress(key.hooks as Address) });\n  } catch (cause) {\n    if (cause instanceof UniswapSdkError) throw cause;\n    throw new UniswapSdkError('INVALID_ARGUMENT', 'Official Uniswap SDK rejected the pool parameters', { cause });\n  }\n}\n\n/** Pool ID does not contain chain or manager identity; retain the full reference. */\nexport function getV4PoolId(input: V4PoolKey): Hex {\n  const key = validatePoolKey(input);\n  return keccak256(encodeAbiParameters(\n    [{ type: 'address' }, { type: 'address' }, { type: 'uint24' }, { type: 'int24' }, { type: 'address' }],\n    [key.currency0, key.currency1, key.fee, key.tickSpacing, key.hooks],\n  ));\n}\nexport function poolReference(deployment: V4Deployment, input: V4PoolKey): V4PoolReference {\n  const { chainId, poolManager } = validateDeployment(deployment);\n  const key = validatePoolKey(input);\n  return { chainId, poolManager, key, poolId: getV4PoolId(key) };\n}\n"]}

package/dist/providers.d.ts

@@ -0,0 +1,59 @@
+import { type Address, type Hex } from 'viem';
+import { type V4PoolReference } from './pool.js';
+/** Structural contract implemented by protocol SDKs; contains no transport or signer. */
+export interface V4ProviderDescriptor {
+    schemaVersion: 1;
+    providerId: string;
+    deploymentId: string;
+    substrate: 'uniswap-v4';
+    chainId: number;
+    poolManager: Address;
+    startBlock: bigint;
+    hooks: readonly Address[];
+    discovery: {
+        address: Address;
+        eventSignature: string;
+        poolIdParameter: string;
+        expectedRuntimeCodeHash: Hex;
+    };
+    poolEvents: readonly V4PoolEvent[];
+}
+export type V4PoolEvent = 'Initialize' | 'Swap' | 'ModifyLiquidity' | 'Donate';
+/** Evidence is historical, not execution authorization. Protocol SDKs verify its meaning. */
+export interface V4ProviderPool extends V4PoolReference {
+    providerId: string;
+    deploymentId: string;
+    membership: {
+        sourceAddress: Address;
+        eventSignature: string;
+        blockNumber: bigint;
+        blockHash: Hex;
+        transactionHash: Hex;
+        logIndex: number;
+    };
+}
+export declare function verifyV4ProviderDescriptor(provider: V4ProviderDescriptor): void;
+/** Structural/identity verification only; the protocol SDK verifies registration provenance. */
+export declare function verifyV4ProviderPool(provider: V4ProviderDescriptor, pool: V4ProviderPool): void;
+/** Bounded eth_getLogs-compatible plans. Empty selections return no requests, never a wildcard.
+ * Hosts must apply topics upstream, retain canonical membership evidence, and replay discovery
+ * blocks when the selection changes. Each query covers its whole first block, including events
+ * emitted before the registration log. Hosts own reorg rollback, cursors and finality.
+ */
+export declare function buildV4PoolSubscriptions(provider: V4ProviderDescriptor, pools: readonly V4ProviderPool[], options: {
+    fromBlock: bigint;
+    toBlock: bigint;
+    maxPoolIdsPerRequest?: number;
+    transport: {
+        indexedTopicFiltering: boolean;
+    };
+}): {
+    providerId: string;
+    deploymentId: string;
+    chainId: number;
+    address: Address;
+    fromBlock: bigint;
+    toBlock: bigint;
+    topics: readonly [Hex, readonly Hex[]];
+}[];
+//# sourceMappingURL=providers.d.ts.map

package/dist/providers.d.ts.map

@@ -0,0 +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"}

package/dist/providers.js

@@ -0,0 +1,110 @@
+import { getAddress, keccak256, toBytes, zeroAddress } from 'viem';
+import { checkedAddress, getV4PoolId } from './pool.js';
+import { invalid } from './errors.js';
+const signatures = {
+    Initialize: 'Initialize(bytes32,address,address,uint24,int24,address,uint160,int24)',
+    Swap: 'Swap(bytes32,address,int128,int128,uint160,uint128,int24,uint24)',
+    ModifyLiquidity: 'ModifyLiquidity(bytes32,address,int24,int24,int256,bytes32)',
+    Donate: 'Donate(bytes32,address,uint256,uint256)',
+};
+function hash(value) {
+    if (!/^0x[\da-f]{64}$/i.test(value) || /^0x0{64}$/i.test(value))
+        invalid('Expected a nonzero bytes32 hash');
+}
+function block(value) {
+    if (typeof value !== 'bigint' || value < 0n)
+        invalid('Expected a nonnegative block number');
+}
+export function verifyV4ProviderDescriptor(provider) {
+    if (provider.schemaVersion !== 1 || provider.substrate !== 'uniswap-v4')
+        invalid('Unsupported provider composition version or substrate');
+    if (!provider.providerId?.trim() || !provider.deploymentId?.trim())
+        invalid('Provider and deployment identifiers are required');
+    if (!Number.isSafeInteger(provider.chainId) || provider.chainId <= 0)
+        invalid('Invalid provider chain ID');
+    if (checkedAddress(provider.poolManager) === zeroAddress || checkedAddress(provider.discovery.address) === zeroAddress)
+        invalid('Provider contracts cannot be zero addresses');
+    block(provider.startBlock);
+    hash(provider.discovery.expectedRuntimeCodeHash);
+    if (!/^[A-Za-z]\w*\([^)]*\)$/.test(provider.discovery.eventSignature) || !provider.discovery.poolIdParameter)
+        invalid('Explicit pool membership discovery is required');
+    if (!provider.hooks.length)
+        invalid('Provider must enumerate its reviewed hooks');
+    provider.hooks.forEach(checkedAddress);
+    if (!provider.poolEvents.length || provider.poolEvents.some(event => !Object.hasOwn(signatures, event)))
+        invalid('Explicit supported pool events are required');
+}
+/** Structural/identity verification only; the protocol SDK verifies registration provenance. */
+export function verifyV4ProviderPool(provider, pool) {
+    verifyV4ProviderDescriptor(provider);
+    if (pool.providerId !== provider.providerId || pool.deploymentId !== provider.deploymentId || pool.chainId !== provider.chainId
+        || checkedAddress(pool.poolManager) !== checkedAddress(provider.poolManager))
+        invalid('Pool belongs to a different provider deployment');
+    if (!provider.hooks.some(hook => checkedAddress(hook) === checkedAddress(pool.key.hooks)))
+        invalid('Pool uses an unreviewed provider hook');
+    if (getV4PoolId(pool.key).toLowerCase() !== pool.poolId.toLowerCase())
+        invalid('Pool ID differs from its full key');
+    if (checkedAddress(pool.membership.sourceAddress) !== checkedAddress(provider.discovery.address)
+        || pool.membership.eventSignature !== provider.discovery.eventSignature)
+        invalid('Pool membership uses a different discovery source');
+    block(pool.membership.blockNumber);
+    if (pool.membership.blockNumber < provider.startBlock)
+        invalid('Pool membership predates deployment');
+    hash(pool.membership.blockHash);
+    hash(pool.membership.transactionHash);
+    if (!Number.isSafeInteger(pool.membership.logIndex) || pool.membership.logIndex < 0)
+        invalid('Invalid membership log index');
+}
+/** Bounded eth_getLogs-compatible plans. Empty selections return no requests, never a wildcard.
+ * Hosts must apply topics upstream, retain canonical membership evidence, and replay discovery
+ * blocks when the selection changes. Each query covers its whole first block, including events
+ * emitted before the registration log. Hosts own reorg rollback, cursors and finality.
+ */
+export function buildV4PoolSubscriptions(provider, pools, options) {
+    verifyV4ProviderDescriptor(provider);
+    block(options.fromBlock);
+    block(options.toBlock);
+    if (options.toBlock < options.fromBlock)
+        invalid('Invalid subscription block range');
+    if (!options.transport.indexedTopicFiltering)
+        invalid('Selective v4 indexing requires upstream indexed-topic filtering');
+    const size = options.maxPoolIdsPerRequest ?? 64;
+    if (!Number.isSafeInteger(size) || size < 1 || size > 256)
+        invalid('Pool filter batch size must be between 1 and 256');
+    if (pools.length > 4096)
+        invalid('At most 4096 selected pools per planning call');
+    const selected = new Map();
+    for (const pool of pools) {
+        verifyV4ProviderPool(provider, pool);
+        const id = pool.poolId.toLowerCase();
+        const previous = selected.get(id);
+        if (previous && (previous.membership.blockHash.toLowerCase() !== pool.membership.blockHash.toLowerCase()
+            || previous.membership.blockNumber !== pool.membership.blockNumber
+            || previous.membership.transactionHash.toLowerCase() !== pool.membership.transactionHash.toLowerCase()
+            || previous.membership.logIndex !== pool.membership.logIndex))
+            invalid('Conflicting membership evidence; reconcile canonical history before subscribing');
+        selected.set(id, pool);
+    }
+    const groups = new Map();
+    for (const [id, pool] of [...selected].sort(([a], [b]) => a.localeCompare(b))) {
+        const start = pool.membership.blockNumber > options.fromBlock ? pool.membership.blockNumber : options.fromBlock;
+        if (start > options.toBlock)
+            continue;
+        const group = groups.get(start) ?? [];
+        group.push(id);
+        groups.set(start, group);
+    }
+    const plans = [];
+    for (const [fromBlock, ids] of [...groups].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0)) {
+        for (let offset = 0; offset < ids.length; offset += size) {
+            for (const event of [...new Set(provider.poolEvents)])
+                plans.push({
+                    providerId: provider.providerId, deploymentId: provider.deploymentId,
+                    chainId: provider.chainId, address: getAddress(provider.poolManager), fromBlock, toBlock: options.toBlock,
+                    topics: [keccak256(toBytes(signatures[event])), ids.slice(offset, offset + size)],
+                });
+        }
+    }
+    return plans;
+}
+//# sourceMappingURL=providers.js.map

package/dist/providers.js.map

@@ -0,0 +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"]}

package/dist/reads.d.ts

@@ -0,0 +1,61 @@
+import { type Address, type Hex, type PublicClient } from 'viem';
+import { UniswapSdkError } from './errors.js';
+import { type V4Deployment, type V4PoolKey, type V4PoolReference } from './pool.js';
+export type V4ReadClient = Pick<PublicClient, 'getChainId' | 'getBlockNumber' | 'readContract' | 'simulateContract'>;
+export interface V4Observation extends V4PoolReference {
+    blockNumber: bigint;
+}
+export interface V4PoolSnapshot extends V4Observation {
+    sqrtPriceX96: bigint;
+    tick: number;
+    protocolFee: number;
+    lpFee: number;
+    liquidity: bigint;
+}
+export declare function assertManager(client: V4ReadClient, deployment: V4Deployment, address: Address, blockNumber: bigint): Promise<void>;
+export declare function observationBlock(client: V4ReadClient, deployment: V4Deployment, blockNumber?: bigint): Promise<bigint>;
+/** Wiring check only: not bytecode provenance or custom-hook compatibility. */
+export declare function verifyV4DeploymentWiring(client: V4ReadClient, deployment: V4Deployment, options?: {
+    blockNumber?: bigint;
+}): Promise<{
+    deployment: V4Deployment;
+    blockNumber: bigint;
+}>;
+export declare function readV4Pool(client: V4ReadClient, deployment: V4Deployment, key: V4PoolKey, options?: {
+    blockNumber?: bigint;
+}): Promise<V4PoolSnapshot>;
+export interface V4QuoteInput {
+    currencyIn: Address;
+    amountIn: bigint;
+    /** Required even when empty: custom hook encoding belongs to the protocol adapter. */
+    hookData: Hex;
+    /** eth_call sender; hooks may still see the Quoter as their caller. */
+    account: Address;
+}
+export interface V4Quote extends V4Observation {
+    currencyIn: Address;
+    currencyOut: Address;
+    amountIn: bigint;
+    amountOut: bigint;
+    gasEstimate: bigint;
+    account: Address;
+    hookData: Hex;
+    quoter: Address;
+}
+export declare function quoteV4ExactInput(client: V4ReadClient, deployment: V4Deployment, key: V4PoolKey, input: V4QuoteInput, options?: {
+    blockNumber?: bigint;
+}): Promise<V4Quote>;
+export type V4QuoteResult = {
+    status: 'success';
+    quote: V4Quote;
+} | {
+    status: 'failure';
+    index: number;
+    error: UniswapSdkError;
+};
+/** Bounded concurrency, individual eth_calls preserve sender and isolate failures. */
+export declare function quoteV4Batch(client: V4ReadClient, deployment: V4Deployment, key: V4PoolKey, inputs: readonly V4QuoteInput[], options?: {
+    blockNumber?: bigint;
+    concurrency?: number;
+}): Promise<V4QuoteResult[]>;
+//# sourceMappingURL=reads.d.ts.map

package/dist/reads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reads.d.ts","sourceRoot":"","sources":["../src/reads.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,YAAY,EAAE,MAAM,MAAM,CAAC;AAEjE,OAAO,EAAE,eAAe,EAAgB,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAqD,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAEvI,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,YAAY,GAAG,gBAAgB,GAAG,cAAc,GAAG,kBAAkB,CAAC,CAAC;AACrH,MAAM,WAAW,aAAc,SAAQ,eAAe;IAAG,WAAW,EAAE,MAAM,CAAA;CAAE;AAC9E,MAAM,WAAW,cAAe,SAAQ,aAAa;IAAG,YAAY,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE;AAEnJ,wBAAsB,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGxI;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAO5H;AAED,+EAA+E;AAC/E,wBAAsB,wBAAwB,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO;;;GAQpI;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAUhK;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,sFAAsF;IACtF,QAAQ,EAAE,GAAG,CAAC;IACd,uEAAuE;IACvE,OAAO,EAAE,OAAO,CAAC;CAClB;AACD,MAAM,WAAW,OAAQ,SAAQ,aAAa;IAC5C,UAAU,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IACpG,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,GAAG,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;CAClD;AAED,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAiBrL;AAED,MAAM,MAAM,aAAa,GAAG;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,CAAC;AAEjI,sFAAsF;AACtF,wBAAsB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,YAAY,EAAE,EAAE,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAkB1N"}

package/dist/reads.js

@@ -0,0 +1,92 @@
+import { v4QuoterAbi, v4StateViewAbi } from './abis.js';
+import { UniswapSdkError, invalid, rpc } from './errors.js';
+import { checkedAddress, poolReference, validateDeployment } from './pool.js';
+export async function assertManager(client, deployment, address, blockNumber) {
+    const manager = await rpc(() => client.readContract({ address, abi: v4StateViewAbi, functionName: 'poolManager', blockNumber }));
+    if (manager.toLowerCase() !== deployment.poolManager.toLowerCase())
+        throw new UniswapSdkError('DEPLOYMENT_MISMATCH', 'Periphery points to a different PoolManager');
+}
+export async function observationBlock(client, deployment, blockNumber) {
+    validateDeployment(deployment);
+    if (blockNumber !== undefined && (typeof blockNumber !== 'bigint' || blockNumber < 0n))
+        invalid('blockNumber must be a nonnegative bigint');
+    return rpc(async () => {
+        if (await client.getChainId() !== deployment.chainId)
+            throw new UniswapSdkError('CHAIN_MISMATCH', 'RPC chain does not match the requested deployment');
+        return blockNumber ?? await client.getBlockNumber();
+    });
+}
+/** Wiring check only: not bytecode provenance or custom-hook compatibility. */
+export async function verifyV4DeploymentWiring(client, deployment, options = {}) {
+    const blockNumber = await observationBlock(client, deployment, options.blockNumber);
+    const managers = await rpc(() => Promise.all([
+        client.readContract({ address: deployment.stateView, abi: v4StateViewAbi, functionName: 'poolManager', blockNumber }),
+        client.readContract({ address: deployment.quoter, abi: v4QuoterAbi, functionName: 'poolManager', blockNumber }),
+    ]));
+    if (managers.some(manager => manager.toLowerCase() !== deployment.poolManager.toLowerCase()))
+        throw new UniswapSdkError('DEPLOYMENT_MISMATCH', 'StateView or Quoter points to a different PoolManager');
+    return { deployment: validateDeployment(deployment), blockNumber };
+}
+export async function readV4Pool(client, deployment, key, options = {}) {
+    const reference = poolReference(deployment, key);
+    const blockNumber = await observationBlock(client, deployment, options.blockNumber);
+    await assertManager(client, deployment, deployment.stateView, blockNumber);
+    const [slot0, liquidity] = await rpc(() => Promise.all([
+        client.readContract({ address: deployment.stateView, abi: v4StateViewAbi, functionName: 'getSlot0', args: [reference.poolId], blockNumber }),
+        client.readContract({ address: deployment.stateView, abi: v4StateViewAbi, functionName: 'getLiquidity', args: [reference.poolId], blockNumber }),
+    ]));
+    if (slot0[0] === 0n)
+        throw new UniswapSdkError('POOL_NOT_FOUND', 'Pool is not initialized at the requested block');
+    return { ...reference, blockNumber, sqrtPriceX96: slot0[0], tick: slot0[1], protocolFee: slot0[2], lpFee: slot0[3], liquidity };
+}
+export async function quoteV4ExactInput(client, deployment, key, input, options = {}) {
+    const reference = poolReference(deployment, key);
+    const currencyIn = checkedAddress(input.currencyIn);
+    const account = checkedAddress(input.account);
+    if (currencyIn !== reference.key.currency0 && currencyIn !== reference.key.currency1)
+        invalid('Input currency does not belong to this pool');
+    if (typeof input.amountIn !== 'bigint' || input.amountIn <= 0n || input.amountIn >= 1n << 128n)
+        invalid('amountIn must be a positive uint128');
+    if (typeof input.hookData !== 'string' || !/^0x(?:[0-9a-fA-F]{2})*$/.test(input.hookData))
+        invalid('hookData must be explicit even-length hex bytes');
+    const blockNumber = await observationBlock(client, deployment, options.blockNumber);
+    await assertManager(client, deployment, deployment.quoter, blockNumber);
+    const zeroForOne = currencyIn === reference.key.currency0;
+    try {
+        const { result: [amountOut, gasEstimate] } = await client.simulateContract({
+            address: deployment.quoter, abi: v4QuoterAbi, functionName: 'quoteExactInputSingle', account, blockNumber,
+            args: [{ poolKey: reference.key, zeroForOne, exactAmount: input.amountIn, hookData: input.hookData }],
+        });
+        return { ...reference, blockNumber, currencyIn, currencyOut: zeroForOne ? reference.key.currency1 : reference.key.currency0, amountIn: input.amountIn, amountOut, gasEstimate, account, hookData: input.hookData, quoter: deployment.quoter };
+    }
+    catch (cause) {
+        throw new UniswapSdkError('QUOTE_FAILED', 'Quoter simulation failed; no executable quote is available', { cause });
+    }
+}
+/** Bounded concurrency, individual eth_calls preserve sender and isolate failures. */
+export async function quoteV4Batch(client, deployment, key, inputs, options = {}) {
+    const concurrency = options.concurrency ?? 4;
+    if (!Number.isInteger(concurrency) || concurrency < 1 || concurrency > 16)
+        invalid('concurrency must be between 1 and 16');
+    if (inputs.length > 256)
+        invalid('At most 256 quotes may be requested per batch');
+    poolReference(deployment, key);
+    if (inputs.length === 0)
+        return [];
+    const blockNumber = await observationBlock(client, deployment, options.blockNumber);
+    const results = [];
+    for (let offset = 0; offset < inputs.length; offset += concurrency) {
+        results.push(...await Promise.all(inputs.slice(offset, offset + concurrency).map(async (input, i) => {
+            try {
+                return { status: 'success', quote: await quoteV4ExactInput(client, deployment, key, input, { blockNumber }) };
+            }
+            catch (cause) {
+                if (!(cause instanceof UniswapSdkError) || cause.code === 'CHAIN_MISMATCH' || cause.code === 'RPC_ERROR')
+                    throw cause;
+                return { status: 'failure', index: offset + i, error: cause };
+            }
+        })));
+    }
+    return results;
+}
+//# sourceMappingURL=reads.js.map

package/dist/reads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reads.js","sourceRoot":"","sources":["../src/reads.ts"],"names":[],"mappings":"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","sourcesContent":["import { type Address, type Hex, type PublicClient } from 'viem';\nimport { v4QuoterAbi, v4StateViewAbi } from './abis.js';\nimport { UniswapSdkError, invalid, rpc } from './errors.js';\nimport { checkedAddress, poolReference, validateDeployment, type V4Deployment, type V4PoolKey, type V4PoolReference } from './pool.js';\n\nexport type V4ReadClient = Pick<PublicClient, 'getChainId' | 'getBlockNumber' | 'readContract' | 'simulateContract'>;\nexport interface V4Observation extends V4PoolReference { blockNumber: bigint }\nexport interface V4PoolSnapshot extends V4Observation { sqrtPriceX96: bigint; tick: number; protocolFee: number; lpFee: number; liquidity: bigint }\n\nexport async function assertManager(client: V4ReadClient, deployment: V4Deployment, address: Address, blockNumber: bigint): Promise<void> {\n  const manager = await rpc(() => client.readContract({ address, abi: v4StateViewAbi, functionName: 'poolManager', blockNumber }));\n  if (manager.toLowerCase() !== deployment.poolManager.toLowerCase()) throw new UniswapSdkError('DEPLOYMENT_MISMATCH', 'Periphery points to a different PoolManager');\n}\n\nexport async function observationBlock(client: V4ReadClient, deployment: V4Deployment, blockNumber?: bigint): Promise<bigint> {\n  validateDeployment(deployment);\n  if (blockNumber !== undefined && (typeof blockNumber !== 'bigint' || blockNumber < 0n)) invalid('blockNumber must be a nonnegative bigint');\n  return rpc(async () => {\n    if (await client.getChainId() !== deployment.chainId) throw new UniswapSdkError('CHAIN_MISMATCH', 'RPC chain does not match the requested deployment');\n    return blockNumber ?? await client.getBlockNumber();\n  });\n}\n\n/** Wiring check only: not bytecode provenance or custom-hook compatibility. */\nexport async function verifyV4DeploymentWiring(client: V4ReadClient, deployment: V4Deployment, options: { blockNumber?: bigint } = {}) {\n  const blockNumber = await observationBlock(client, deployment, options.blockNumber);\n  const managers = await rpc(() => Promise.all([\n    client.readContract({ address: deployment.stateView, abi: v4StateViewAbi, functionName: 'poolManager', blockNumber }),\n    client.readContract({ address: deployment.quoter, abi: v4QuoterAbi, functionName: 'poolManager', blockNumber }),\n  ]));\n  if (managers.some(manager => manager.toLowerCase() !== deployment.poolManager.toLowerCase())) throw new UniswapSdkError('DEPLOYMENT_MISMATCH', 'StateView or Quoter points to a different PoolManager');\n  return { deployment: validateDeployment(deployment), blockNumber };\n}\n\nexport async function readV4Pool(client: V4ReadClient, deployment: V4Deployment, key: V4PoolKey, options: { blockNumber?: bigint } = {}): Promise<V4PoolSnapshot> {\n  const reference = poolReference(deployment, key);\n  const blockNumber = await observationBlock(client, deployment, options.blockNumber);\n  await assertManager(client, deployment, deployment.stateView, blockNumber);\n  const [slot0, liquidity] = await rpc(() => Promise.all([\n    client.readContract({ address: deployment.stateView, abi: v4StateViewAbi, functionName: 'getSlot0', args: [reference.poolId], blockNumber }),\n    client.readContract({ address: deployment.stateView, abi: v4StateViewAbi, functionName: 'getLiquidity', args: [reference.poolId], blockNumber }),\n  ]));\n  if (slot0[0] === 0n) throw new UniswapSdkError('POOL_NOT_FOUND', 'Pool is not initialized at the requested block');\n  return { ...reference, blockNumber, sqrtPriceX96: slot0[0], tick: slot0[1], protocolFee: slot0[2], lpFee: slot0[3], liquidity };\n}\n\nexport interface V4QuoteInput {\n  currencyIn: Address;\n  amountIn: bigint;\n  /** Required even when empty: custom hook encoding belongs to the protocol adapter. */\n  hookData: Hex;\n  /** eth_call sender; hooks may still see the Quoter as their caller. */\n  account: Address;\n}\nexport interface V4Quote extends V4Observation {\n  currencyIn: Address; currencyOut: Address; amountIn: bigint; amountOut: bigint; gasEstimate: bigint;\n  account: Address; hookData: Hex; quoter: Address;\n}\n\nexport async function quoteV4ExactInput(client: V4ReadClient, deployment: V4Deployment, key: V4PoolKey, input: V4QuoteInput, options: { blockNumber?: bigint } = {}): Promise<V4Quote> {\n  const reference = poolReference(deployment, key);\n  const currencyIn = checkedAddress(input.currencyIn);\n  const account = checkedAddress(input.account);\n  if (currencyIn !== reference.key.currency0 && currencyIn !== reference.key.currency1) invalid('Input currency does not belong to this pool');\n  if (typeof input.amountIn !== 'bigint' || input.amountIn <= 0n || input.amountIn >= 1n << 128n) invalid('amountIn must be a positive uint128');\n  if (typeof input.hookData !== 'string' || !/^0x(?:[0-9a-fA-F]{2})*$/.test(input.hookData)) invalid('hookData must be explicit even-length hex bytes');\n  const blockNumber = await observationBlock(client, deployment, options.blockNumber);\n  await assertManager(client, deployment, deployment.quoter, blockNumber);\n  const zeroForOne = currencyIn === reference.key.currency0;\n  try {\n    const { result: [amountOut, gasEstimate] } = await client.simulateContract({\n      address: deployment.quoter, abi: v4QuoterAbi, functionName: 'quoteExactInputSingle', account, blockNumber,\n      args: [{ poolKey: reference.key, zeroForOne, exactAmount: input.amountIn, hookData: input.hookData }],\n    });\n    return { ...reference, blockNumber, currencyIn, currencyOut: zeroForOne ? reference.key.currency1 : reference.key.currency0, amountIn: input.amountIn, amountOut, gasEstimate, account, hookData: input.hookData, quoter: deployment.quoter };\n  } catch (cause) { throw new UniswapSdkError('QUOTE_FAILED', 'Quoter simulation failed; no executable quote is available', { cause }); }\n}\n\nexport type V4QuoteResult = { status: 'success'; quote: V4Quote } | { status: 'failure'; index: number; error: UniswapSdkError };\n\n/** Bounded concurrency, individual eth_calls preserve sender and isolate failures. */\nexport async function quoteV4Batch(client: V4ReadClient, deployment: V4Deployment, key: V4PoolKey, inputs: readonly V4QuoteInput[], options: { blockNumber?: bigint; concurrency?: number } = {}): Promise<V4QuoteResult[]> {\n  const concurrency = options.concurrency ?? 4;\n  if (!Number.isInteger(concurrency) || concurrency < 1 || concurrency > 16) invalid('concurrency must be between 1 and 16');\n  if (inputs.length > 256) invalid('At most 256 quotes may be requested per batch');\n  poolReference(deployment, key);\n  if (inputs.length === 0) return [];\n  const blockNumber = await observationBlock(client, deployment, options.blockNumber);\n  const results: V4QuoteResult[] = [];\n  for (let offset = 0; offset < inputs.length; offset += concurrency) {\n    results.push(...await Promise.all(inputs.slice(offset, offset + concurrency).map(async (input, i): Promise<V4QuoteResult> => {\n      try { return { status: 'success', quote: await quoteV4ExactInput(client, deployment, key, input, { blockNumber }) }; }\n      catch (cause) {\n        if (!(cause instanceof UniswapSdkError) || cause.code === 'CHAIN_MISMATCH' || cause.code === 'RPC_ERROR') throw cause;\n        return { status: 'failure', index: offset + i, error: cause };\n      }\n    })));\n  }\n  return results;\n}\n"]}

package/dist/receipts.d.ts

@@ -0,0 +1,2 @@
+export * from './v3-receipts.js';
+//# sourceMappingURL=receipts.d.ts.map

package/dist/receipts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipts.d.ts","sourceRoot":"","sources":["../src/receipts.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}

package/dist/receipts.js

@@ -0,0 +1,2 @@
+export * from './v3-receipts.js';
+//# sourceMappingURL=receipts.js.map

package/dist/receipts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipts.js","sourceRoot":"","sources":["../src/receipts.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC","sourcesContent":["export * from './v3-receipts.js';\n"]}

package/dist/transactions.d.ts

@@ -0,0 +1,2 @@
+export * from './v3-transactions.js';
+//# sourceMappingURL=transactions.d.ts.map

package/dist/transactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.d.ts","sourceRoot":"","sources":["../src/transactions.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC"}

package/dist/transactions.js

@@ -0,0 +1,2 @@
+export * from './v3-transactions.js';
+//# sourceMappingURL=transactions.js.map

package/dist/transactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.js","sourceRoot":"","sources":["../src/transactions.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC","sourcesContent":["export * from './v3-transactions.js';\n"]}