@reptilianhq/uniswap-sdk 0.2.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ReptilianHQ
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE

@@ -0,0 +1,4 @@
+This SDK depends on the MIT-licensed official Uniswap SDK packages.
+The official packages and their license notices remain in their distributions.
+The runtime bridge uses the upstream public CommonJS export without modifying it.
+Reptilian batch/read logic derives from ReptilianHQ/block-arb-bot.

package/README.md

@@ -0,0 +1,176 @@
+# Shared Uniswap protocol SDK
+
+Reptilian-maintained integration SDK, released independently through GitHub Packages.
+It owns Uniswap protocol mechanics: reviewed deployments, ABI encoding and decoding,
+unsigned v3 transaction material, calldata review, receipt evidence, and v4 observations.
+It never owns keys, authorization policy, transaction submission, persistence, or orchestration.
+
+## Capabilities and ownership
+
+- `./v4`: full pool identity, Initialize-log normalization, pool state,
+  exact-input Quoter simulation, ordered quote batches, initialized tick windows.
+- `./v3`: Robinhood v3 deployment identity, compatibility checks, unsigned
+  position transaction builders, strict calldata review, and receipt evidence.
+- `./deployments`, `./compatibility`, `./transactions`, `./receipts`: stable
+  capability subpaths for the capital-moving v3 surface.
+- `./batch`: host-owned multicall integration for quoting, state decoding, and tick discovery.
+- `./abis`: minimal v3 and v4 ABI surface used by the package.
+- `./errors`: stable error codes; JSON serialization omits underlying RPC errors,
+  which may contain credentials. The in-process `cause` is diagnostic only.
+
+The official `@uniswap/v4-sdk` and `@uniswap/sdk-core` versions are pinned.
+Currency normalization uses the official SDK. Pool ID encoding is checked
+against it for native/ERC-20 pairs and fee modes. On-chain Quoter simulation is
+used instead of offline SDK swap math because custom hooks can change results.
+The pinned upstream ESM export contains imports native Node cannot resolve;
+`official-sdk.cts` uses its public CommonJS export through a local compiled shim.
+The runtime smoke test exercises built ESM exports without a bundler. No upstream
+files are patched or forked.
+
+Reads/quotes/tick discovery were extracted from the bot's `scanner.ts`, `abi.ts`
+and `depth.ts` read patterns. They now require explicit deployments and preserve
+currency roles, hook data, failures and observation blocks. The bot consumes this package through an exact release dependency. Its host owns
+multicall transport and trading policy; this package owns protocol encoding and decoding.
+
+## Usage
+
+Inject the caller's configured viem client. Reptilian continues to resolve its
+chain and RPC through `@reptilianhq/evm-config`; this independent protocol SDK
+does not depend on the platform configuration package.
+
+```ts
+import { readV4Pool, quoteV4ExactInput } from '@reptilianhq/uniswap-sdk/v4';
+
+const pool = await readV4Pool(publicClient, reviewedDeployment, poolKey);
+const quote = await quoteV4ExactInput(publicClient, reviewedDeployment, poolKey, {
+  currencyIn, amountIn, account, hookData: protocolEncodedHookData,
+}, { blockNumber: pool.blockNumber });
+```
+
+V3 hosts select an exported reviewed deployment, verify it against their RPC,
+then build unsigned transaction material. The host must independently authorize,
+simulate, sign, submit, and reconcile that material.
+
+```ts
+import {
+  buildV3IncreaseLiquidityTransaction,
+  reviewV3IncreaseLiquidityCalldata,
+  robinhoodUniswapV3Mainnet,
+  verifyUniswapV3Compatibility,
+} from '@reptilianhq/uniswap-sdk/v3';
+
+await verifyUniswapV3Compatibility(publicClient, robinhoodUniswapV3Mainnet);
+const material = buildV3IncreaseLiquidityTransaction({
+  manager: robinhoodUniswapV3Mainnet.contracts.nonfungiblePositionManager,
+  params,
+});
+reviewV3IncreaseLiquidityCalldata(material.data, params.tokenId);
+```
+
+A complete deterministic consumer example is available in
+[`examples/read-only-consumer.mjs`](./examples/read-only-consumer.mjs). It uses
+the published package subpaths and demonstrates a pool observation, a partial
+tick result, and branching on `isUniswapSdkError`.
+
+The v4 `reviewedDeployment` contains chainId, PoolManager, StateView and Quoter addresses.
+There are no implicit v4 Robinhood or Arc deployments. Hosts own endpoint selection,
+finality, capability policy and secret storage. For multicall consumers, use
+`quoteV4WithBatch`, `v4PoolStateCalls`, `decodeV4PoolState`,
+`readV4PoolStatesWithBatch`, and `readV4TicksWithBatch` from `./batch`.
+Those helpers preserve the existing host's transport, block and sender context;
+the host must check chain/deployment identity and Quoter multicall compatibility.
+
+## Observation and quote guarantees
+
+The direct-client RPC operations check chain identity (the `./batch` host owns that check). Pool/tick reads check StateView's
+PoolManager pointer; quotes check the Quoter pointer at the observation block.
+`verifyV4DeploymentWiring` checks both pointers. This proves wiring only: a contract that
+returns the expected pointer is not necessarily the reviewed implementation.
+Source/code verification and hook-specific compatibility remain release gates.
+
+All state calls in an operation use one block number. Quote batches use up to
+four concurrent individual eth_calls by default (maximum 16; at most 256 quotes).
+They preserve account context rather than putting an extra Multicall contract
+between the caller and the Quoter. A quote failure is distinct from successful
+zero output. Invalid item input yields a typed item failure; chain/RPC identity
+errors abort the batch. Quotes expose the account, hookData, quoter, amount and
+observation block so consumers can retain exact context.
+
+A quote is an observation, not executable or durable authorization. The Quoter
+may call hooks differently from the intended router or custom executor. Arc's
+adapter must prove those semantics and simulate the complete final transaction
+with its actual sender, approvals and hook data before a write can be supported.
+Requote after approvals or changed state. Block-number pinning does not establish
+finality or protect against a reorg; the host must select appropriate blocks.
+
+Pool IDs are not globally unique: retain chainId, PoolManager, PoolKey and poolId.
+Native currency remains address(0), distinct from wrapped native ERC-20.
+Initialize logs must come from the configured manager and reproduce their pool
+ID. The decoder does not prove receipt finality, chain provenance or ingestion
+completeness; the indexer must supply canonical logs and handle reorgs.
+
+Tick windows return raw initialized ticks, never executable depth. Scans are
+limited to 16 bitmap words with at most 16 concurrent tick calls. A narrower
+range or any failed bitmap/tick sets `partial: true` and records missing
+coordinates. Consumers must not reconstruct complete depth from partial ticks.
+
+The `./batch` helpers preserve legacy host behavior deliberately. Unlike direct
+quotes, `quoteV4WithBatch` accepts zero input for sizing probes. Invalid input
+rejects the whole helper call; only Quoter reverts and malformed Quoter responses
+become item-level failures. `decodeV4PoolState` permits zero state for
+uninitialized-pool probes. `readV4TicksWithBatch` accepts an explicit set of up
+to 259 bitmap words and marks the result partial unless that set covers the full
+usable range without failures. Batch transports must pin the block and preserve
+the sender context themselves.
+
+## Verification and release boundary
+
+CI runs the full check suite on Node 24 and 26 with npm 11.5.2. Node 24
+remains the publication runtime and the minimum supported consumer version.
+
+From this independent repository:
+
+```sh
+npm ci --ignore-scripts
+npm run check
+```
+
+The local suite uses real viem ABI encoding/decoding over a deterministic RPC
+transport, plus official SDK identity comparisons, Hegel property invariants,
+and pinned finalized Robinhood mainnet receipt fixtures.
+It covers v3 construction/review identity, manager-scoped receipt evidence, multiple chain
+IDs, native/ERC-20 direction, dynamic-fee hook data, pointer/chain mismatch,
+partial depth, failed versus zero quotes, discovery identity, batched transport
+compatibility, exact reviewed runtime code hashes, and the runnable
+package-subpath consumer example. `npm run test:fork` additionally executes an
+SDK-built and reviewed full position close against the pinned Anvil fork
+documented in [docs/FORK_TESTING.md](./docs/FORK_TESTING.md).
+
+`npm run test:live-compatibility` rechecks both exported deployments against
+their public RPCs. `UNISWAP_MAINNET_RPC_URL` and `UNISWAP_TESTNET_RPC_URL` may
+override those read-only endpoints.
+
+Releases use the versioned Reptilian publisher, exact main-ancestry tags,
+immutable archive verification, and retained evidence; see [RELEASING.md](./RELEASING.md).
+The v3 surface is capital-moving protocol support: it prepares unsigned calldata
+and verifies protocol-specific transaction and receipt facts. It does not grant
+authorization or submit transactions. The v4 surface remains read-only and does
+not claim Arc deployment or custom-hook compatibility. Never treat a local test
+or a successful wiring check as source verification.
+
+Next: supply Arc contract/RPC details, verify code and hook/custody semantics,
+then add its adapter and a tested managed-position lifecycle. Existing v3-only
+application capability gates remain appropriate until that adapter is verified.
+
+## Protocol provider composition
+
+`./providers` exports portable `V4ProviderDescriptor` and `V4ProviderPool` types,
+structural verifiers, and `buildV4PoolSubscriptions`. Protocol SDKs own canonical
+membership, reviewed deployment/hook semantics and position capabilities. The
+shared planner checks complete identity and emits bounded event-topic requests
+for explicitly selected pools. Empty selection returns no requests; transports
+without indexed topic filtering are rejected.
+
+Callers own RPC selection, finality, canonical membership storage and reorg
+rollback. Replay the full discovery block. Structural checks cannot authenticate
+arbitrary supplied membership evidence and never authorize execution.

package/RELEASING.md

@@ -0,0 +1,114 @@
+# Uniswap SDK releases
+
+This repository owns `@reptilianhq/uniswap-sdk`. Publish to the public npm
+registry using the same Reptilian artifact publisher 1.2.2 used by the other
+standalone package owners. `scripts/artifacts/publisher.lock.json` pins the
+canonical publisher bytes; update them from the Reptilian root's vendor command.
+Do not edit the emitted publisher locally.
+
+## One-time npm setup
+
+The publish workflow authenticates via npm OIDC Trusted Publishing
+(`id-token: write`, no static token). Trusted Publishing is configured on an
+*existing* npm package, so it cannot be the very first thing you set up for a
+scope that has never published:
+
+1. Create/claim the `@reptilianhq` org on npmjs.org if it does not exist yet.
+2. Land the version on `main` and push its tag (`uniswap-sdk-v0.2.2`, the
+   first version targeting the public registry) as usual. This triggers
+   `publish.yml` automatically — let it fail; Trusted Publishing cannot exist
+   yet, so it will error on a plain E401/E403. That is expected for the
+   bootstrap version only.
+3. Publish that same tagged version yourself with a temporary org-scoped
+   access token (a granular token cannot target a package that doesn't exist
+   yet), using the **Local fallback** publisher flow below (`publisher.mjs
+   prepare` then `publish`) — not a raw `npm publish`. `prepare` injects the
+   `reptilianRelease` manifest metadata and repacks the tarball; a
+   hand-published tarball would be missing that and would permanently fail
+   CI's immutable-byte check on every later run for that same version, since
+   the only recovery for a byte mismatch is a new numbered RC. The publisher
+   shells out to `npm publish`/`npm dist-tag` from a temp directory, so put
+   the token in `~/.npmrc` (or `NPM_CONFIG_//registry.npmjs.org/:_authToken`)
+   — this repo has no `.npmrc`, and one placed in the repo root would be
+   ignored. Revoke the token once this succeeds.
+4. On the package's npmjs.org settings, add this repository and
+   `.github/workflows/publish.yml` as a Trusted Publisher. Optionally scope
+   it to the `npm` GitHub environment name — matching `launch-on-block-sdk`
+   — but this is optional metadata on npm's side; leaving it unscoped works
+   too. Set the Trusted Publisher itself to **always publish** rather than
+   the staged/approval default — the publisher script
+   (`scripts/artifacts/publisher.mjs`) runs a plain `npm publish` with no
+   support for a staged-approval step, so a staged config will hang the
+   workflow.
+5. The `npm` GitHub environment referenced by the job does not need to exist
+   on this repo ahead of time; GitHub creates it automatically the first time
+   the workflow runs. **Leave it with no protection rules** (no required
+   reviewers, no wait timer) — `launch-on-block-sdk`'s own `npm` environment
+   has a required-reviewer rule, but copying that here would reintroduce the
+   same staged-approval hang from step 4, just via GitHub's environment gate
+   instead of npm's. `timeout-minutes: 30` on the job bounds execution time,
+   not an approval wait, so a gated run would park rather than fail loudly.
+
+After that one-time setup, every subsequent release goes through the tagged
+CI flow below with no token in the repository.
+
+## Release verification
+
+Run `npm ci --ignore-scripts` and `npm run check`. Checks include TypeScript,
+lint, unit tests, built Node ESM runtime smoke, a runnable consumer example using
+the public package subpaths, publisher checksum and tests,
+packed export lint, and packed ESM/type resolution. The published scope includes
+v4 observations and provider plans plus v3 reviewed deployments, exact runtime
+code hashes, unsigned transaction construction, calldata review, compatibility
+checks, pinned receipt evidence, and a self-hash-checked copy of the shared SDK
+conformance rules. Run `npm run test:fork` separately with an
+archive-capable `SDK_FORK_EIP155_4663_RPC_URL`; it simulates and executes the
+reviewed close path on a pinned Anvil fork, then requires the collected receipt
+amounts to match the simulation. Run `npm run test:live-compatibility` before release to
+recheck both deployment records. Runtime code identity is not source verification or
+custom-hook compatibility. Arc details remain unavailable.
+
+Set one exact version such as `<version>` in package.json and package-lock.json,
+land the source on main, then push its immutable tag `uniswap-sdk-v<version>`.
+The publish workflow verifies version identity and main ancestry, reruns package
+checks, prepares archives and source metadata, publishes the archive without
+rerunning lifecycle scripts, and verifies the registry metadata and downloaded
+bytes. Numbered RCs use `rc`; stable releases use `latest`. Never move a tag,
+overwrite bytes, or move a channel backwards.
+
+Publication evidence is retained for 90 days as `release-record.json` and
+`verification.json`. A manual dispatch with the same exact version retries the
+same tag. Existing registry content must have matching source and archive bytes.
+If it differs, fix the source and publish a new numbered RC.
+
+On the public npm registry, automatic dist-tag/channel repair for an
+interrupted publish (version published, channel not yet moved) is not
+available — npm OIDC only authorizes the publish itself, not tag repair.
+If a run is interrupted after the version lands but before its channel moves,
+fix the dist-tag by hand (`npm dist-tag add <pkg>@<version> <channel>`) rather
+than relying on retry. If OIDC authentication itself is misconfigured (no
+Trusted Publisher entry for this repo/workflow, or it is set to staged
+rather than always-publish), `npm publish` fails with a plain E401/E403 with
+no specific OIDC diagnostic — check the npmjs.org package settings first.
+
+## Local fallback
+
+When CI minutes are unavailable, run the same checks locally and use the same
+publisher, from a clean tagged checkout with origin/main fetched:
+
+```sh
+ARTIFACT_RELEASE_TAG=uniswap-sdk-v<version> node scripts/artifacts/publisher.mjs prepare uniswap-sdk .release
+ARTIFACT_RELEASE_TAG=uniswap-sdk-v<version> node scripts/artifacts/publisher.mjs publish uniswap-sdk .release
+```
+
+Registry credentials must already be configured; do not print tokens or put
+them in committed configuration. Retain the two evidence files with the release.
+The fallback does not relax tag, ancestry, version, or immutable-byte checks.
+
+## Consumer adoption
+
+Consumers install an exact registry version and commit their lockfile. They must
+not reference a sibling checkout, git branch, or vendored SDK tarball. Run the
+bot's scanner/depth parity tests and browser build before promoting a new pin.
+Host multicall policy remains explicit: the bot preserves its zero fallback for
+failed sizing probes, while the SDK exposes those results as failures.

package/dist/abis.d.ts

@@ -0,0 +1,161 @@
+export declare const v4StateViewAbi: readonly [{
+    readonly name: "poolManager";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "address";
+    }];
+}, {
+    readonly name: "getSlot0";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "bytes32";
+        readonly name: "poolId";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint160";
+        readonly name: "sqrtPriceX96";
+    }, {
+        readonly type: "int24";
+        readonly name: "tick";
+    }, {
+        readonly type: "uint24";
+        readonly name: "protocolFee";
+    }, {
+        readonly type: "uint24";
+        readonly name: "lpFee";
+    }];
+}, {
+    readonly name: "getLiquidity";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "bytes32";
+        readonly name: "poolId";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint128";
+        readonly name: "liquidity";
+    }];
+}, {
+    readonly name: "getTickBitmap";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "bytes32";
+        readonly name: "poolId";
+    }, {
+        readonly type: "int16";
+        readonly name: "word";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "getTickLiquidity";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "bytes32";
+        readonly name: "poolId";
+    }, {
+        readonly type: "int24";
+        readonly name: "tick";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint128";
+        readonly name: "liquidityGross";
+    }, {
+        readonly type: "int128";
+        readonly name: "liquidityNet";
+    }];
+}];
+export declare const v4QuoterAbi: readonly [{
+    readonly name: "poolManager";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "address";
+    }];
+}, {
+    readonly name: "quoteExactInputSingle";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "poolKey";
+            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 type: "bool";
+            readonly name: "zeroForOne";
+        }, {
+            readonly type: "uint128";
+            readonly name: "exactAmount";
+        }, {
+            readonly type: "bytes";
+            readonly name: "hookData";
+        }];
+        readonly name: "params";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "amountOut";
+    }, {
+        readonly type: "uint256";
+        readonly name: "gasEstimate";
+    }];
+}];
+export declare const v4PoolManagerAbi: readonly [{
+    readonly name: "Initialize";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly type: "bytes32";
+        readonly name: "id";
+        readonly indexed: true;
+    }, {
+        readonly type: "address";
+        readonly name: "currency0";
+        readonly indexed: true;
+    }, {
+        readonly type: "address";
+        readonly name: "currency1";
+        readonly indexed: true;
+    }, {
+        readonly type: "uint24";
+        readonly name: "fee";
+    }, {
+        readonly type: "int24";
+        readonly name: "tickSpacing";
+    }, {
+        readonly type: "address";
+        readonly name: "hooks";
+    }, {
+        readonly type: "uint160";
+        readonly name: "sqrtPriceX96";
+    }, {
+        readonly type: "int24";
+        readonly name: "tick";
+    }];
+}];
+export * from './v3-abis.js';
+//# sourceMappingURL=abis.d.ts.map

package/dist/abis.d.ts.map

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

package/dist/abis.js

@@ -0,0 +1,21 @@
+import { parseAbi } from 'viem';
+// Standard v4-core/periphery selectors; extracted from the bot's read surface.
+// They do not attest compatibility of a supplied custom deployment.
+export const v4StateViewAbi = parseAbi([
+    'function poolManager() view returns (address)',
+    'function getSlot0(bytes32 poolId) view returns (uint160 sqrtPriceX96, int24 tick, uint24 protocolFee, uint24 lpFee)',
+    'function getLiquidity(bytes32 poolId) view returns (uint128 liquidity)',
+    'function getTickBitmap(bytes32 poolId, int16 word) view returns (uint256)',
+    'function getTickLiquidity(bytes32 poolId, int24 tick) view returns (uint128 liquidityGross, int128 liquidityNet)',
+]);
+export const v4QuoterAbi = parseAbi([
+    'function poolManager() view returns (address)',
+    'struct PoolKey { address currency0; address currency1; uint24 fee; int24 tickSpacing; address hooks; }',
+    'struct QuoteExactSingleParams { PoolKey poolKey; bool zeroForOne; uint128 exactAmount; bytes hookData; }',
+    'function quoteExactInputSingle(QuoteExactSingleParams params) returns (uint256 amountOut, uint256 gasEstimate)',
+]);
+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 * from './v3-abis.js';
+//# sourceMappingURL=abis.js.map

package/dist/abis.js.map

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

package/dist/batch.d.ts

@@ -0,0 +1,60 @@
+import { type Address, type Hex } from 'viem';
+import { UniswapSdkError } from './errors.js';
+import { type V4PoolKey } from './pool.js';
+/** Host-owned batch transport. Host owns chain/wiring checks, block pinning and sender. */
+export interface V4BatchCall {
+    target: Address;
+    allowFailure: boolean;
+    callData: Hex;
+}
+export interface V4BatchResult {
+    success: boolean;
+    returnData: Hex;
+}
+export type V4BatchTransport = (calls: V4BatchCall[]) => Promise<readonly V4BatchResult[]>;
+export interface V4PoolState {
+    sqrtPriceX96: bigint;
+    tick: number;
+    protocolFee: number;
+    lpFee: number;
+    liquidity: bigint;
+}
+export type V4BatchQuote = {
+    status: 'success';
+    amountOut: bigint;
+    gasEstimate: bigint;
+} | {
+    status: 'failure';
+    error: UniswapSdkError;
+};
+/** Slot0 then liquidity; callers may combine these with other venues in one RPC. */
+export declare function v4PoolStateCalls(stateView: Address, poolId: Hex): [V4BatchCall, V4BatchCall];
+/** Zero state is valid for the bot's uninitialized-pool probes. */
+export declare function decodeV4PoolState(results: readonly V4BatchResult[]): V4PoolState;
+export declare function readV4PoolStatesWithBatch(transport: V4BatchTransport, stateView: Address, poolIds: readonly Hex[]): Promise<V4PoolState[]>;
+/** Explicit multicall opt-in: hooks see the host's multicall/Quoter context. */
+export declare function quoteV4WithBatch(transport: V4BatchTransport, quoter: Address, inputKey: V4PoolKey, inputs: readonly {
+    currencyIn: Address;
+    amountIn: bigint;
+    hookData: Hex;
+}[]): Promise<V4BatchQuote[]>;
+export declare const V4_MIN_TICK = -887272;
+export declare const V4_MAX_TICK = 887272;
+export declare function usableV4TickRange(tickSpacing: number): {
+    min: number;
+    max: number;
+};
+export declare function v4WordPosition(tick: number, tickSpacing: number): number;
+/** Spot window plus the two extremes, retaining full-range LP boundary ticks. */
+export declare function v4DepthWordPositions(currentTick: number, tickSpacing: number, radius: number): number[];
+export declare function readV4TicksWithBatch(transport: V4BatchTransport, stateView: Address, poolId: Hex, tickSpacing: number, words: readonly number[]): Promise<{
+    ticks: {
+        tick: number;
+        liquidityGross: bigint;
+        liquidityNet: bigint;
+    }[];
+    failedWords: number[];
+    failedTicks: number[];
+    partial: boolean;
+}>;
+//# sourceMappingURL=batch.d.ts.map

package/dist/batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../src/batch.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4C,KAAK,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,MAAM,CAAC;AAExF,OAAO,EAAW,eAAe,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAmC,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAG5E,2FAA2F;AAC3F,MAAM,WAAW,WAAW;IAAG,MAAM,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,GAAG,CAAA;CAAE;AACtF,MAAM,WAAW,aAAa;IAAG,OAAO,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,GAAG,CAAA;CAAE;AACpE,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CAAC;AAC3F,MAAM,WAAW,WAAW;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;AAC1H,MAAM,MAAM,YAAY,GAAG;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,CAAC;AAczI,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,WAAW,EAAE,WAAW,CAAC,CAO5F;AAED,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,GAAG,WAAW,CAOhF;AAED,wBAAsB,yBAAyB,CAAC,SAAS,EAAE,gBAAgB,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,GAAG,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAQhJ;AAED,gFAAgF;AAChF,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,gBAAgB,EAC3B,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,SAAS,EACnB,MAAM,EAAE,SAAS;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,GAAG,CAAA;CAAE,EAAE,GAC1E,OAAO,CAAC,YAAY,EAAE,CAAC,CAuBzB;AAED,eAAO,MAAM,WAAW,UAAU,CAAC;AACnC,eAAO,MAAM,WAAW,SAAS,CAAC;AAClC,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM;;;EAGpD;AACD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,UAI/D;AACD,iFAAiF;AACjF,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,YAY5F;AAED,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,gBAAgB,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE;;cAqB/H,MAAM;wBAAkB,MAAM;sBAAgB,MAAM;;;;;GAgB1E"}