@yummybait/uniswap-tx-builder-mcp 0.3.1

package/dist/mcp.js

@@ -0,0 +1,363 @@
+#!/usr/bin/env node
+import { createServer } from "node:http";
+import { createRequire } from "node:module";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { z } from "zod";
+import { closeOp, collectOp, increaseOp, mintOp, planOp, poolStateOp, swapOp, wrapOp, } from "./operations.js";
+// uniswap-tx-builder-mcp — a PUBLIC, KEYLESS MCP server.
+//
+// It builds *unsigned* Uniswap v3 position transactions (collect / close /
+// mint) and, optionally, simulates them via eth_call. It never holds keys and
+// never signs or broadcasts — signing is the caller's wallet's job. Simulation
+// is opt-in to let a caller prove a tx would succeed before signing, which
+// boosts trust without taking custody.
+const addressSchema = z
+    .string()
+    .regex(/^0x[a-fA-F0-9]{40}$/, "must be a 0x EVM address");
+// uint256 token ids / amounts exceed JS safe integers → accept decimal strings.
+const uintStringSchema = z.string().regex(/^\d+$/, "must be a decimal integer string");
+// Single-source the version from package.json (resolves from src/ in dev and
+// dist/ once built — package.json sits one level up in both layouts).
+const { version } = createRequire(import.meta.url)("../package.json");
+// All logging goes to stderr: in stdio mode stdout carries the MCP protocol.
+function log(msg) {
+    process.stderr.write(`${new Date().toISOString()} [uniswap-tx-builder] ${msg}\n`);
+}
+// JSON for log lines: long hex blobs (calldata) collapse to a prefix + byte
+// count so the readable parts of a result (to, value, description, position)
+// aren't drowned out; anything still oversized is hard-capped.
+function loggable(data, max = 1200) {
+    const json = JSON.stringify(data, (_key, value) => typeof value === "string" && value.length > 80 && /^0x[0-9a-fA-F]+$/.test(value)
+        ? `${value.slice(0, 18)}…(${(value.length - 2) / 2} bytes)`
+        : value);
+    return json.length <= max ? json : `${json.slice(0, max)}…(+${json.length - max} chars)`;
+}
+function ok(data) {
+    return { content: [{ type: "text", text: JSON.stringify(data) }] };
+}
+function fail(message) {
+    return { content: [{ type: "text", text: message }], isError: true };
+}
+// Shared tool-call wrapper: logs the call with its args, the outcome with
+// duration, and converts thrown errors into MCP tool errors.
+async function run(name, args, fn) {
+    const started = Date.now();
+    log(`→ ${name} ${loggable(args)}`);
+    try {
+        const data = await fn();
+        log(`← ${name} ok ${Date.now() - started}ms ${loggable(data)}`);
+        return ok(data);
+    }
+    catch (err) {
+        const message = `${name} failed: ${err instanceof Error ? err.message : String(err)}`;
+        log(`← ${name} ERROR ${Date.now() - started}ms ${message}`);
+        return fail(message);
+    }
+}
+// A factory rather than a singleton: an SDK server/transport pair is 1:1 with
+// a session, so the HTTP mode below builds a fresh instance per request.
+function buildServer() {
+    const server = new McpServer({ name: "uniswap-tx-builder", version });
+    server.registerTool("build_collect", {
+        title: "Build a collect-fees transaction",
+        description: "Build an UNSIGNED tx that collects all uncollected fees from a Uniswap v3 " +
+            "position to `recipient`. Returns tx={to,data,value,chainId} plus rlp (the " +
+            "unsigned EIP-1559 serialization for signing services). Set simulate=false " +
+            "to skip the eth_call dry-run (on by default).",
+        inputSchema: {
+            chainId: z.number().int(),
+            positionId: uintStringSchema,
+            recipient: addressSchema,
+            simulate: z.boolean().optional(),
+        },
+    }, async (args) => run("build_collect", args, () => collectOp({
+        chainId: args.chainId,
+        positionId: BigInt(args.positionId),
+        recipient: args.recipient,
+        simulate: args.simulate,
+    })));
+    server.registerTool("build_close", {
+        title: "Build a close-position transaction",
+        description: "Build an UNSIGNED tx that removes all liquidity and collects everything from a " +
+            "Uniswap v3 position (multicalls when needed). Returns the tx (+ unsigned rlp) " +
+            "plus the read position. Set burn=true to also burn the now-empty NFT in the " +
+            "same multicall. Set simulate=false to skip the eth_call dry-run (on by default).",
+        inputSchema: {
+            chainId: z.number().int(),
+            positionId: uintStringSchema,
+            recipient: addressSchema,
+            burn: z.boolean().optional(),
+            simulate: z.boolean().optional(),
+        },
+    }, async (args) => run("build_close", args, () => closeOp({
+        chainId: args.chainId,
+        positionId: BigInt(args.positionId),
+        recipient: args.recipient,
+        burn: args.burn,
+        simulate: args.simulate,
+    })));
+    server.registerTool("build_mint", {
+        title: "Build a mint-position transaction",
+        description: "Build an UNSIGNED tx that mints a new Uniswap v3 position. Amounts are decimal " +
+            "strings (wei) — compute them with get_pool_state (live ratio) right before " +
+            "minting, or stale prices revert the mint. Returns the tx plus unsigned rlp. " +
+            "Simulation is OFF by default here (minting needs token approvals and balances, " +
+            "so eth_call usually reverts); pass simulate=true to attempt it.",
+        inputSchema: {
+            chainId: z.number().int(),
+            token0: addressSchema,
+            token1: addressSchema,
+            fee: z.number().int(),
+            tickLower: z.number().int(),
+            tickUpper: z.number().int(),
+            amount0Desired: uintStringSchema,
+            amount1Desired: uintStringSchema,
+            recipient: addressSchema,
+            slippageBps: z.number().int().optional(),
+            simulate: z.boolean().optional(),
+        },
+    }, async (args) => run("build_mint", args, () => mintOp({
+        chainId: args.chainId,
+        token0: args.token0,
+        token1: args.token1,
+        fee: args.fee,
+        tickLower: args.tickLower,
+        tickUpper: args.tickUpper,
+        amount0Desired: BigInt(args.amount0Desired),
+        amount1Desired: BigInt(args.amount1Desired),
+        recipient: args.recipient,
+        slippageBps: args.slippageBps,
+        simulate: args.simulate,
+    })));
+    server.registerTool("build_increase", {
+        title: "Build an increase-liquidity transaction",
+        description: "Build an UNSIGNED tx that adds liquidity to an EXISTING Uniswap v3 position. " +
+            "Amounts are decimal strings (wei); mins are derived from slippageBps (default 0.5%). " +
+            "Returns the tx plus unsigned rlp. Simulation is OFF by default (needs token " +
+            "approvals + balances); pass simulate=true to attempt it.",
+        inputSchema: {
+            chainId: z.number().int(),
+            positionId: uintStringSchema,
+            amount0Desired: uintStringSchema,
+            amount1Desired: uintStringSchema,
+            recipient: addressSchema,
+            slippageBps: z.number().int().optional(),
+            simulate: z.boolean().optional(),
+        },
+    }, async (args) => run("build_increase", args, () => increaseOp({
+        chainId: args.chainId,
+        positionId: BigInt(args.positionId),
+        amount0Desired: BigInt(args.amount0Desired),
+        amount1Desired: BigInt(args.amount1Desired),
+        recipient: args.recipient,
+        slippageBps: args.slippageBps,
+        simulate: args.simulate,
+    })));
+    server.registerTool("plan_position", {
+        title: "Plan a position from a human price range",
+        description: "READ-ONLY helper (builds no tx). Given a human price range (token1 per token0) and " +
+            "optional human token amounts, reads each token's decimals over RPC and returns the " +
+            "aligned tickLower/tickUpper (for the fee's tick spacing) plus wei amount0Desired/" +
+            "amount1Desired — ready to feed into build_mint. token0 must be < token1 by address. " +
+            "Does NOT compute the optimal amount ratio for the range.",
+        inputSchema: {
+            chainId: z.number().int(),
+            token0: addressSchema,
+            token1: addressSchema,
+            fee: z.number().int(),
+            priceLower: z.number().positive(),
+            priceUpper: z.number().positive(),
+            amount0: z.string().optional(),
+            amount1: z.string().optional(),
+        },
+    }, async (args) => run("plan_position", args, () => planOp({
+        chainId: args.chainId,
+        token0: args.token0,
+        token1: args.token1,
+        fee: args.fee,
+        priceLower: args.priceLower,
+        priceUpper: args.priceUpper,
+        amount0: args.amount0,
+        amount1: args.amount1,
+    })));
+    server.registerTool("get_pool_state", {
+        title: "Read live pool state; plan a range and mint amounts from it",
+        description: "READ-ONLY (builds no tx). Returns the pool's LIVE state: pool address, tick, " +
+            "sqrtPriceX96, price (token1 per token0, human units), tickSpacing. " +
+            "With rangePct: suggested tickLower/tickUpper within ±pct of spot, rounded INWARD " +
+            "to tick spacing. With balance0+balance1 (raw wei) + tickLower/tickUpper: " +
+            "amount0Desired/amount1Desired for build_mint computed from the live sqrtPrice " +
+            "ratio, plus which side limits. Errors if spot is outside the range. ALWAYS " +
+            "recompute amounts with this right before build_mint — stale ratios revert with " +
+            "'Price slippage check'.",
+        inputSchema: {
+            chainId: z.number().int(),
+            token0: addressSchema,
+            token1: addressSchema,
+            fee: z.number().int(),
+            rangePct: z.number().positive().optional(),
+            tickLower: z.number().int().optional(),
+            tickUpper: z.number().int().optional(),
+            balance0: uintStringSchema.optional(),
+            balance1: uintStringSchema.optional(),
+        },
+    }, async (args) => run("get_pool_state", args, () => poolStateOp({
+        chainId: args.chainId,
+        token0: args.token0,
+        token1: args.token1,
+        fee: args.fee,
+        rangePct: args.rangePct,
+        tickLower: args.tickLower,
+        tickUpper: args.tickUpper,
+        balance0: args.balance0 === undefined ? undefined : BigInt(args.balance0),
+        balance1: args.balance1 === undefined ? undefined : BigInt(args.balance1),
+    })));
+    server.registerTool("build_wrap", {
+        title: "Build a wrap-native-ETH transaction (Universal Router)",
+        description: "Build an UNSIGNED payable tx that wraps `amountWei` native ETH into WETH via the " +
+            "Universal Router WRAP_ETH command (works under UR-allowlisting wallet policies " +
+            "where a direct WETH.deposit() doesn't). `recipient` defaults to the tx sender — " +
+            "omit it unless the WETH should go elsewhere. Returns the tx plus unsigned rlp. " +
+            "Pass `sender` (the signing wallet) to eth_call-simulate before signing.",
+        inputSchema: {
+            chainId: z.number().int(),
+            amountWei: uintStringSchema,
+            recipient: addressSchema.optional(),
+            sender: addressSchema.optional(),
+            deadline: z.number().int().positive().optional(),
+            simulate: z.boolean().optional(),
+        },
+    }, async (args) => run("build_wrap", args, () => wrapOp({
+        chainId: args.chainId,
+        amountWei: BigInt(args.amountWei),
+        recipient: args.recipient,
+        sender: args.sender,
+        deadline: args.deadline,
+        simulate: args.simulate,
+    })));
+    server.registerTool("build_swap", {
+        title: "Build a WETH→token swap transaction (Universal Router)",
+        description: "Build an UNSIGNED tx that swaps `amountInWei` WETH for `tokenOut` (exact-in, " +
+            "single hop through the `fee` pool) via the Universal Router. With `wrapWei` " +
+            "(≥ amountInWei) the tx is payable and wraps that much native ETH first, swaps " +
+            "amountInWei of it, and sweeps the WETH remainder — use this when the wallet " +
+            "holds native ETH. Without wrapWei the wallet's WETH pays via Permit2 (needs a " +
+            "Permit2 approval). `recipient` defaults to the tx sender. Returns the tx plus " +
+            "unsigned rlp. Pass `sender` to eth_call-simulate before signing.",
+        inputSchema: {
+            chainId: z.number().int(),
+            amountInWei: uintStringSchema,
+            tokenOut: addressSchema,
+            fee: z.number().int(),
+            amountOutMin: uintStringSchema,
+            recipient: addressSchema.optional(),
+            wrapWei: uintStringSchema.optional(),
+            sender: addressSchema.optional(),
+            deadline: z.number().int().positive().optional(),
+            simulate: z.boolean().optional(),
+        },
+    }, async (args) => run("build_swap", args, () => swapOp({
+        chainId: args.chainId,
+        amountInWei: BigInt(args.amountInWei),
+        tokenOut: args.tokenOut,
+        fee: args.fee,
+        amountOutMin: BigInt(args.amountOutMin),
+        recipient: args.recipient,
+        wrapWei: args.wrapWei === undefined ? undefined : BigInt(args.wrapWei),
+        sender: args.sender,
+        deadline: args.deadline,
+        simulate: args.simulate,
+    })));
+    return server;
+}
+function jsonRpcError(res, status, code, message) {
+    res
+        .writeHead(status, { "content-type": "application/json" })
+        .end(JSON.stringify({ jsonrpc: "2.0", error: { code, message }, id: null }));
+}
+function readBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on("data", (chunk) => chunks.push(chunk));
+        req.on("end", () => resolve(Buffer.concat(chunks).toString("utf8")));
+        req.on("error", reject);
+    });
+}
+// One-glance label for a JSON-RPC payload, e.g. "initialize#1 (claude-code 2.1)"
+// or "tools/call#3" or "notifications/initialized".
+function describeRpc(body) {
+    const messages = Array.isArray(body) ? body : [body];
+    return messages
+        .map((msg) => {
+        if (!msg || typeof msg !== "object")
+            return "invalid";
+        const { method, id, params } = msg;
+        if (!method)
+            return `response#${String(id)}`;
+        let label = id === undefined ? method : `${method}#${String(id)}`;
+        if (method === "initialize" && params?.clientInfo?.name) {
+            label += ` (${params.clientInfo.name} ${params.clientInfo.version ?? "?"})`;
+        }
+        return label;
+    })
+        .join(",");
+}
+// Transport: HTTP (streamable) when MCP_HTTP_PORT is set — for running as a
+// docker-compose service a local agent connects to — otherwise stdio.
+//
+// HTTP runs in STATELESS mode: every tool here is pure request/response, so
+// each POST gets its own server + transport (sessionIdGenerator: undefined —
+// no Mcp-Session-Id issued or required). Any number of clients can connect,
+// and a client vanishing mid-session can't wedge the server. GET (standalone
+// SSE) and DELETE (session teardown) only make sense with sessions → 405.
+const httpPort = process.env.MCP_HTTP_PORT;
+if (httpPort) {
+    createServer((req, res) => {
+        void (async () => {
+            if (req.method !== "POST") {
+                res.setHeader("Allow", "POST");
+                jsonRpcError(res, 405, -32000, "Method Not Allowed: stateless server accepts POST only");
+                log(`HTTP 405 ${req.method} ${req.url}`);
+                return;
+            }
+            let rpcBody;
+            try {
+                rpcBody = JSON.parse(await readBody(req));
+            }
+            catch {
+                jsonRpcError(res, 400, -32700, "Parse error: request body is not valid JSON");
+                log("HTTP 400 POST — body is not valid JSON");
+                return;
+            }
+            const rpc = describeRpc(rpcBody);
+            const started = Date.now();
+            res.on("finish", () => log(`HTTP ${res.statusCode} ${rpc} ${Date.now() - started}ms`));
+            const server = buildServer();
+            const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
+            res.on("close", () => {
+                void transport.close();
+                void server.close();
+            });
+            try {
+                await server.connect(transport);
+                await transport.handleRequest(req, res, rpcBody);
+            }
+            catch (err) {
+                log(`HTTP request failed (${rpc}): ${err instanceof Error ? err.message : String(err)}`);
+                if (!res.headersSent) {
+                    jsonRpcError(res, 500, -32603, "Internal server error");
+                }
+            }
+        })();
+    }).listen(Number(httpPort), "0.0.0.0", () => {
+        log(`v${version} — streamable HTTP (stateless) listening on :${httpPort}/mcp`);
+    });
+}
+else {
+    const transport = new StdioServerTransport();
+    await buildServer().connect(transport);
+    log(`v${version} — stdio transport connected`);
+}
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"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"}

package/dist/operations.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Operation layer — the code path behind the MCP tools in `mcp.ts`, kept
+ * separate from transport so it stays unit-testable and ready to host a second
+ * (e.g. Uniswap v4) tool set. Each op builds an unsigned tx, optionally
+ * dry-runs it via `eth_call`, and returns a JSON-serializable payload. A failed
+ * simulation throws {@link SimulationError} so a caller can distinguish a
+ * reverted dry-run from a malformed request.
+ */
+import type { Address } from "viem";
+import { type PlanPositionParams, type PlanPositionResult, type PoolStateParams, type PoolStateResult, type SwapParams, type UnsignedTx, type WrapParams } from "./builder.js";
+/** Thrown when the opt-in `eth_call` dry-run reverts — never sign such a tx. */
+export declare class SimulationError extends Error {
+    constructor(message: string);
+}
+export interface TxResult {
+    tx: UnsignedTx;
+    /** Unsigned EIP-1559 serialization of `tx` (nonce/fees/gas zeroed). */
+    rlp: string;
+    simulated: boolean;
+    description: string;
+}
+export interface CollectArgs {
+    chainId: number;
+    positionId: bigint;
+    recipient: Address;
+    simulate?: boolean;
+}
+export declare function collectOp(args: CollectArgs): Promise<TxResult>;
+export interface CloseArgs {
+    chainId: number;
+    positionId: bigint;
+    recipient: Address;
+    burn?: boolean;
+    simulate?: boolean;
+}
+export interface CloseResult extends TxResult {
+    position: {
+        token0: Address;
+        token1: Address;
+        fee: number;
+        tickLower: number;
+        tickUpper: number;
+        liquidity: string;
+    };
+}
+export declare function closeOp(args: CloseArgs): Promise<CloseResult>;
+export interface MintArgs {
+    chainId: number;
+    token0: Address;
+    token1: Address;
+    fee: number;
+    tickLower: number;
+    tickUpper: number;
+    amount0Desired: bigint;
+    amount1Desired: bigint;
+    recipient: Address;
+    slippageBps?: number;
+    simulate?: boolean;
+}
+export declare function mintOp(args: MintArgs): Promise<TxResult>;
+export interface IncreaseArgs {
+    chainId: number;
+    positionId: bigint;
+    amount0Desired: bigint;
+    amount1Desired: bigint;
+    recipient: Address;
+    slippageBps?: number;
+    simulate?: boolean;
+}
+export declare function increaseOp(args: IncreaseArgs): Promise<TxResult>;
+export declare function planOp(args: PlanPositionParams): Promise<PlanPositionResult>;
+export declare function poolStateOp(args: PoolStateParams): Promise<PoolStateResult>;
+export interface WrapArgs extends WrapParams {
+    sender?: Address;
+    simulate?: boolean;
+}
+export declare function wrapOp(args: WrapArgs): Promise<TxResult>;
+export interface SwapArgs extends SwapParams {
+    sender?: Address;
+    simulate?: boolean;
+}
+export declare function swapOp(args: SwapArgs): Promise<TxResult>;

package/dist/operations.js

@@ -0,0 +1,114 @@
+import { buildCloseTx, buildCollectTx, buildIncreaseLiquidityTx, buildMintTx, buildSwapTx, buildWrapTx, getPoolState, planPosition, simulateTx, toUnsignedRlp, } from "./builder.js";
+/** Thrown when the opt-in `eth_call` dry-run reverts — never sign such a tx. */
+export class SimulationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "SimulationError";
+    }
+}
+async function maybeSimulate(chainId, tx, from, simulate) {
+    if (!simulate)
+        return false;
+    try {
+        await simulateTx(chainId, tx, from);
+    }
+    catch (err) {
+        throw new SimulationError(err instanceof Error ? err.message : String(err));
+    }
+    return true;
+}
+export async function collectOp(args) {
+    const tx = await buildCollectTx(args.chainId, args.positionId, args.recipient);
+    const simulated = await maybeSimulate(args.chainId, tx, args.recipient, args.simulate !== false);
+    return {
+        tx,
+        rlp: toUnsignedRlp(tx),
+        simulated,
+        description: `Collect fees from position #${args.positionId}`,
+    };
+}
+export async function closeOp(args) {
+    const { tx, position } = await buildCloseTx(args.chainId, args.positionId, args.recipient, args.burn ?? false);
+    const simulated = await maybeSimulate(args.chainId, tx, args.recipient, args.simulate !== false);
+    const action = position.liquidity > 0n
+        ? "Close position"
+        : "Collect remaining tokens from position";
+    const suffix = args.burn ? " + burn NFT" : "";
+    return {
+        tx,
+        rlp: toUnsignedRlp(tx),
+        simulated,
+        position: {
+            token0: position.token0,
+            token1: position.token1,
+            fee: position.fee,
+            tickLower: position.tickLower,
+            tickUpper: position.tickUpper,
+            liquidity: position.liquidity.toString(),
+        },
+        description: `${action} #${args.positionId}${suffix}`,
+    };
+}
+export async function mintOp(args) {
+    const tx = buildMintTx(args);
+    const simulated = await maybeSimulate(args.chainId, tx, args.recipient, args.simulate === true);
+    return {
+        tx,
+        rlp: toUnsignedRlp(tx),
+        simulated,
+        description: `Mint new position: ${args.token0}/${args.token1} fee=${args.fee} range=[${args.tickLower}, ${args.tickUpper}]`,
+    };
+}
+export async function increaseOp(args) {
+    const tx = buildIncreaseLiquidityTx(args);
+    const simulated = await maybeSimulate(args.chainId, tx, args.recipient, args.simulate === true);
+    return {
+        tx,
+        rlp: toUnsignedRlp(tx),
+        simulated,
+        description: `Increase liquidity of position #${args.positionId}`,
+    };
+}
+export async function planOp(args) {
+    return planPosition(args);
+}
+export async function poolStateOp(args) {
+    return getPoolState(args);
+}
+// Wrap/swap txs are payable and spend the sender's native ETH, so simulation
+// needs the actual signer as `from` — `sender` opts it in (unlike collect/
+// close, where `recipient` doubles as a plausible `from`).
+async function maybeSimulateAsSender(chainId, tx, sender, simulate) {
+    if (!sender) {
+        if (simulate === true) {
+            throw new Error("simulate: true requires `sender` (the wallet that will sign)");
+        }
+        return false;
+    }
+    return maybeSimulate(chainId, tx, sender, simulate !== false);
+}
+export async function wrapOp(args) {
+    const tx = buildWrapTx(args);
+    const simulated = await maybeSimulateAsSender(args.chainId, tx, args.sender, args.simulate);
+    return {
+        tx,
+        rlp: toUnsignedRlp(tx),
+        simulated,
+        description: `Wrap ${args.amountWei} wei native ETH to WETH via Universal Router`,
+    };
+}
+export async function swapOp(args) {
+    const tx = buildSwapTx(args);
+    const simulated = await maybeSimulateAsSender(args.chainId, tx, args.sender, args.simulate);
+    const swap = `swap ${args.amountInWei} wei WETH → ${args.tokenOut} (fee ${args.fee})`;
+    const description = args.wrapWei === undefined
+        ? `Universal Router: ${swap}`
+        : `Universal Router: wrap ${args.wrapWei} wei native ETH, ${swap}, sweep WETH remainder`;
+    return {
+        tx,
+        rlp: toUnsignedRlp(tx),
+        simulated,
+        description,
+    };
+}
+//# sourceMappingURL=operations.js.map

package/dist/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../src/operations.ts"],"names":[],"mappings":"AAUA,OAAO,EAQL,YAAY,EACZ,cAAc,EACd,wBAAwB,EACxB,WAAW,EACX,WAAW,EACX,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,aAAa,GACd,MAAM,cAAc,CAAC;AAEtB,gFAAgF;AAChF,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAUD,KAAK,UAAU,aAAa,CAC1B,OAAe,EACf,EAAc,EACd,IAAa,EACb,QAAiB;IAEjB,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5B,IAAI,CAAC;QACH,MAAM,UAAU,CAAC,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,eAAe,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AASD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAiB;IAC/C,MAAM,EAAE,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC/E,MAAM,SAAS,GAAG,MAAM,aAAa,CACnC,IAAI,CAAC,OAAO,EACZ,EAAE,EACF,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,QAAQ,KAAK,KAAK,CACxB,CAAC;IACF,OAAO;QACL,EAAE;QACF,GAAG,EAAE,aAAa,CAAC,EAAE,CAAC;QACtB,SAAS;QACT,WAAW,EAAE,+BAA+B,IAAI,CAAC,UAAU,EAAE;KAC9D,CAAC;AACJ,CAAC;AAqBD,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAe;IAC3C,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,MAAM,YAAY,CACzC,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,IAAI,IAAI,KAAK,CACnB,CAAC;IACF,MAAM,SAAS,GAAG,MAAM,aAAa,CACnC,IAAI,CAAC,OAAO,EACZ,EAAE,EACF,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,QAAQ,KAAK,KAAK,CACxB,CAAC;IAEF,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,GAAG,EAAE;QACpC,CAAC,CAAC,gBAAgB;QAClB,CAAC,CAAC,wCAAwC,CAAC;IAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IAE9C,OAAO;QACL,EAAE;QACF,GAAG,EAAE,aAAa,CAAC,EAAE,CAAC;QACtB,SAAS;QACT,QAAQ,EAAE;YACR,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,GAAG,EAAE,QAAQ,CAAC,GAAG;YACjB,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE;SACzC;QACD,WAAW,EAAE,GAAG,MAAM,KAAK,IAAI,CAAC,UAAU,GAAG,MAAM,EAAE;KACtD,CAAC;AACJ,CAAC;AAgBD,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAc;IACzC,MAAM,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,SAAS,GAAG,MAAM,aAAa,CACnC,IAAI,CAAC,OAAO,EACZ,EAAE,EACF,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,QAAQ,KAAK,IAAI,CACvB,CAAC;IACF,OAAO;QACL,EAAE;QACF,GAAG,EAAE,aAAa,CAAC,EAAE,CAAC;QACtB,SAAS;QACT,WAAW,EAAE,sBAAsB,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,QAAQ,IAAI,CAAC,GAAG,WAAW,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS,GAAG;KAC7H,CAAC;AACJ,CAAC;AAYD,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAkB;IACjD,MAAM,EAAE,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,MAAM,aAAa,CACnC,IAAI,CAAC,OAAO,EACZ,EAAE,EACF,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,QAAQ,KAAK,IAAI,CACvB,CAAC;IACF,OAAO;QACL,EAAE;QACF,GAAG,EAAE,aAAa,CAAC,EAAE,CAAC;QACtB,SAAS;QACT,WAAW,EAAE,mCAAmC,IAAI,CAAC,UAAU,EAAE;KAClE,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,IAAwB;IAExB,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAqB;IAErB,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,6EAA6E;AAC7E,2EAA2E;AAC3E,2DAA2D;AAC3D,KAAK,UAAU,qBAAqB,CAClC,OAAe,EACf,EAAc,EACd,MAA2B,EAC3B,QAA6B;IAE7B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;QAClF,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,aAAa,CAAC,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,KAAK,KAAK,CAAC,CAAC;AAChE,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAc;IACzC,MAAM,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,SAAS,GAAG,MAAM,qBAAqB,CAC3C,IAAI,CAAC,OAAO,EACZ,EAAE,EACF,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,QAAQ,CACd,CAAC;IACF,OAAO;QACL,EAAE;QACF,GAAG,EAAE,aAAa,CAAC,EAAE,CAAC;QACtB,SAAS;QACT,WAAW,EAAE,QAAQ,IAAI,CAAC,SAAS,8CAA8C;KAClF,CAAC;AACJ,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAc;IACzC,MAAM,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,SAAS,GAAG,MAAM,qBAAqB,CAC3C,IAAI,CAAC,OAAO,EACZ,EAAE,EACF,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,QAAQ,CACd,CAAC;IACF,MAAM,IAAI,GAAG,QAAQ,IAAI,CAAC,WAAW,eAAe,IAAI,CAAC,QAAQ,SAAS,IAAI,CAAC,GAAG,GAAG,CAAC;IACtF,MAAM,WAAW,GACf,IAAI,CAAC,OAAO,KAAK,SAAS;QACxB,CAAC,CAAC,qBAAqB,IAAI,EAAE;QAC7B,CAAC,CAAC,0BAA0B,IAAI,CAAC,OAAO,oBAAoB,IAAI,wBAAwB,CAAC;IAC7F,OAAO;QACL,EAAE;QACF,GAAG,EAAE,aAAa,CAAC,EAAE,CAAC;QACtB,SAAS;QACT,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist/ticks.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Pure Uniswap v3 tick math — no RPC, no I/O. Converts human-readable prices
+ * into the aligned ticks a position uses, and live pool readings into
+ * range suggestions and mint amounts.
+ *
+ * A pool price is `token1` per `token0` expressed in each token's *smallest*
+ * unit. A human price `P` ("how many whole token1 per whole token0") relates
+ * to the raw price by `raw = P * 10^(decimals1 - decimals0)`, and
+ * `tick = log(raw) / log(1.0001)`.
+ */
+export declare const MIN_TICK = -887272;
+export declare const MAX_TICK = 887272;
+/** Standard fee tier → tick spacing. */
+export declare const FEE_TO_TICK_SPACING: Record<number, number>;
+export declare function feeToTickSpacing(fee: number): number;
+/**
+ * Convert a human price (token1 per token0) to the (unaligned) tick.
+ * `price` must be > 0.
+ */
+export declare function priceToTick(price: number, decimals0: number, decimals1: number): number;
+/** Snap a tick to the nearest usable tick for `spacing`, clamped to bounds. */
+export declare function alignTick(tick: number, spacing: number): number;
+export interface TickRange {
+    tickLower: number;
+    tickUpper: number;
+    tickSpacing: number;
+}
+/**
+ * Convert a human price range to aligned [tickLower, tickUpper] for `fee`.
+ * Prices are reordered if given high→low, and the bounds are guaranteed to
+ * differ by at least one tick spacing.
+ */
+export declare function priceRangeToTicks(priceLower: number, priceUpper: number, fee: number, decimals0: number, decimals1: number): TickRange;
+/**
+ * Q64.96 sqrt price at a tick — bit-for-bit identical to the on-chain
+ * `TickMath.getSqrtRatioAtTick`, so amounts derived from it match what the
+ * pool computes.
+ */
+export declare function getSqrtRatioAtTick(tick: number): bigint;
+export interface SuggestedRange {
+    tickLower: number;
+    tickUpper: number;
+    /** Actual (post-rounding) range edges relative to spot, in percent. */
+    pctBelow: number;
+    pctAbove: number;
+}
+/**
+ * Ticks within ±`rangePct` of the spot tick, rounded INWARD to `tickSpacing`
+ * — outward rounding would exceed the caller's stated max width.
+ */
+export declare function suggestRangeTicks(tick: number, tickSpacing: number, rangePct: number): SuggestedRange;
+export interface MintAmounts {
+    amount0Desired: bigint;
+    amount1Desired: bigint;
+    /** Which balance caps the position's liquidity. */
+    limitingSide: "token0" | "token1";
+}
+/**
+ * The largest both-sided deposit the balances allow at the LIVE pool price:
+ * per-side liquidity `L0`/`L1` from the full balances, `L = min(L0, L1)`,
+ * then back out the exact amounts that liquidity consumes. Feeding these to
+ * `mint` matches the pool's own math, so slippage mins can stay tight.
+ *
+ * Throws when the spot price is outside [tickLower, tickUpper] — such a mint
+ * is single-sided and the caller should recompute the range instead.
+ */
+export declare function computeMintAmounts(sqrtPriceX96: bigint, tickLower: number, tickUpper: number, balance0: bigint, balance1: bigint): MintAmounts;
+/** Human price (token1 per token0) from a Q64.96 sqrt price. */
+export declare function sqrtPriceX96ToPrice(sqrtPriceX96: bigint, decimals0: number, decimals1: number): number;