@continuumdao/ctm-mpc-defi 0.1.3

package/dist/protocols/evm/uniswap-v4/index.d.cts

@@ -0,0 +1,323 @@
+import { d as ProtocolModule } from '../../../types-Ce2qNHai.cjs';
+import { Address } from 'viem';
+import { N as NodeReadAuth } from '../../../nodeRead-BnmSaMGO.cjs';
+import { K as KeyGenSubsetForPermit } from '../../../keygen-CfNp8yKJ.cjs';
+import { E as EvmChainDetail } from '../../../types-B8idm_gu.cjs';
+
+/** Canonical Uniswap token-allowance contract on most EVM chains. */
+declare const PERMIT2_ADDRESS: Address;
+declare function isUniswapV4ChainSupported(chainId: string | number | bigint | null | undefined): boolean;
+declare function getUniswapUniversalRouterSpenderOrThrow(chainId: number): Address;
+declare const MAX_UINT160: bigint;
+declare const MAX_UINT48: bigint;
+declare const UNISWAP_UNIVERSAL_ROUTER_DEFAULT_GAS_UNITS = 1500000n;
+declare const UNISWAP_TRADE_BASE_DEFAULT = "https://trade-api.gateway.uniswap.org/v1";
+declare const UNISWAP_UNIVERSAL_ROUTER_VERSION_DEFAULT = "2.0";
+declare const UNISWAP_SWAP_DEFAULT_EXPIRY_MINUTES = 30;
+declare const UNISWAP_SWAP_DEFAULT_DEADLINE_SEC_OFFSET: number;
+
+/** POST /v1/quote `type` (same as `uniswap_trade_quote.py` `--type`). */
+type UniswapQuoteTradeType = 'EXACT_INPUT' | 'EXACT_OUTPUT';
+/** Parse chain id like Python: decimal or 0x hex. */
+declare function parseUniswapChainId(value: string | number): number;
+/** `tokenIn` is the EVM address `0x0` used by the Trade API for the chain’s native (gas) token. */
+declare function isUniswapTokenInAddressNative(tokenIn: string | undefined | null): boolean;
+/** `fullQuote` / stored quote response: top-level or nested has `quote.input` with a native or ERC-20 address. */
+declare function isUniswapFullQuoteResponseNativeIn(stored: Record<string, unknown> | null | undefined): boolean;
+/**
+ * GET /getKeyGenResultById and return `ethereumaddress` (swapper), same as
+ * `uniswap_mpc_helpers.resolve_owner_from_keygen` in mpc-config.
+ */
+declare function fetchEthereumAddressForKeyGen(managementNodeUrl: string, keyGenId: string, readAuth?: NodeReadAuth, init?: RequestInit): Promise<string>;
+interface UniswapTradeQuoteParams {
+    amount: string;
+    tokenIn: string;
+    tokenOut: string;
+    uniswapApiKey: string;
+    /**
+     * KeyGen id — used to resolve `swapper` from GET /getKeyGenResultById unless `swapper` is set.
+     * Required unless `swapper` is set.
+     */
+    keyGen?: string;
+    type: UniswapQuoteTradeType;
+    /**
+     * Slippage as percent, e.g. `0.5` for 0.5%. If omitted, the body uses
+     * `autoSlippage: "DEFAULT"` (same as the Python script when `--slippage` is not set).
+     */
+    slippage?: number | string;
+    /**
+     * Chain id for the input side (`tokenInChainId` in the HTTP body; Python `--chain-id`).
+     * You may set **`chainId` or `tokenInChainId`** (same meaning); if both are set, `chainId` wins.
+     * Same-chain quote: set one chain here and omit `tokenOutChainId` (or set both to the same id).
+     */
+    chainId?: string | number;
+    /**
+     * Same as `chainId` (input chain). If `chainId` is omitted, this must be set.
+     */
+    tokenInChainId?: string | number;
+    /**
+     * Output chain id; defaults to the input chain when omitted (Python: empty `--token-out-chain-id`).
+     */
+    tokenOutChainId?: string | number;
+    /**
+     * When `true`, sends `x-permit2-disabled: true` (Uniswap’s header for classic ERC-20 allowance; no permitData in the response).
+     * Omit or set `false` for the default Trade API routing (default).
+     */
+    permit2Disabled?: boolean;
+    /**
+     * MPC wallet (swapper) address. If omitted, `managementNodeUrl` is used with `keyGen`
+     * to call GET /getKeyGenResultById.
+     */
+    swapper?: `0x${string}` | string;
+    /**
+     * Management node base URL (MPC), required when `swapper` is not provided.
+     */
+    managementNodeUrl?: string;
+    /** For Browser HTTPS: Bearer on GET to /getKeyGenResultById. */
+    nodeReadAuth?: NodeReadAuth;
+    /** Trade API base without `/quote` (default: Uniswap gateway v1). */
+    baseUrl?: string;
+    /** `x-universal-router-version` (default `2.0`, aligned with Python / v4). */
+    universalRouterVersion?: string;
+    signal?: AbortSignal;
+    /** Override for tests. */
+    fetchImpl?: typeof fetch;
+}
+declare function buildUniswapQuoteRequestBody(args: Pick<UniswapTradeQuoteParams, 'type' | 'amount' | 'tokenIn' | 'tokenOut' | 'slippage' | 'chainId' | 'tokenInChainId' | 'tokenOutChainId'> & {
+    swapper: string;
+}): Record<string, unknown>;
+/**
+ * Pull a user-facing string from Uniswap / generic JSON error bodies.
+ */
+declare function errorMessageFromUniswapJsonBody(value: unknown): string | null;
+/**
+ * User-facing string from an HTTP body: JSON `message` / `error` / `detail` first,
+ * else a short plain-text / HTML page title, not the raw document (avoids huge HTML in UI).
+ */
+declare function messageFromUniswapHttpResponseBody(text: string, status: number, statusText?: string): string;
+/**
+ * `POST` Uniswap Trade API `/v1/quote` — TypeScript version of
+ * `mpc-config/recipes/uniswapV4/uniswap_trade_quote.py` (core HTTP call + KeyGen → swapper).
+ *
+ * CORS: calling the Trade API from a browser may be blocked. Prefer a server / route
+ * handler, or use this in Node. KeyGen resolution uses a GET to your management node
+ * and follows the same read-auth pattern as the app.
+ */
+declare function uniswapTradeQuote(args: UniswapTradeQuoteParams): Promise<Record<string, unknown>>;
+/**
+ * Single-line JSON for mpc-config `uniswap_trade_swap.py --quote-json` (compact quote body).
+ */
+declare function uniswapQuoteToJsonQuoteOneLine(quote: Record<string, unknown>): string;
+/**
+ * `quote.input.amount` / `quote.output.amount` as bigints, if present (classic response).
+ */
+declare function parseUniswapQuoteClassicInOut(res: Record<string, unknown>): {
+    inputWei: bigint;
+    outputWei: bigint;
+} | null;
+/**
+ * Fields from Uniswap Trade API `200` `quote` (e.g. {@link https://api-docs.uniswap.org/api-reference/swapping/quote} `ClassicQuote`):
+ * - `slippage` — slippage tolerance (percent) used for the quote
+ * - `priceImpact` — “impact the trade has on the market price of the pool, between 0-100 percent”
+ */
+declare function parseUniswapQuoteSlippageInfo(res: Record<string, unknown>): {
+    slippageTolerancePercent: number | null;
+    priceImpactPercent: number | null;
+};
+/** Compact percent for UI (e.g. 0.5, 1.2345). */
+declare function formatUniswapPercentForUi(n: number): string;
+/** Human string for a modal amount field, trimmed of trailing fraction zeros. */
+declare function formatUniswapAmountFieldFromWei(wei: bigint, decimals: number): string;
+/**
+ * One-line prefill for multi-sign "purpose" (user may append context below in the same field).
+ */
+declare function buildUniswapV4PurposePrefill(args: {
+    tradeType: UniswapQuoteTradeType;
+    tokenInSymbol: string;
+    tokenOutSymbol: string;
+    tokenInDecimals: number;
+    tokenOutDecimals: number;
+    amountInput: string;
+    quote: Record<string, unknown> | null;
+    slippageInput: string;
+    chainName: string;
+    chainId: number;
+}): string;
+/**
+ * Human-readable lines from a Trade API `/quote` 200 JSON body.
+ * Classic quotes expose `quote.input` / `quote.output` with `amount` (base units as string).
+ */
+declare function formatUniswapQuoteForDisplay(res: Record<string, unknown>, args: {
+    tradeType: UniswapQuoteTradeType;
+    tokenInDecimals: number;
+    tokenOutDecimals: number;
+    tokenInSymbol: string;
+    tokenOutSymbol: string;
+}): {
+    title: string;
+    lines: string[];
+    rawJson: string;
+};
+
+/**
+ * When `batchIndex` is set, allow per-item `batchMeta[i].evm` when present; else top-level `evm` in ExtraJSON.
+ */
+declare function isUniswapV4SwapEvmSignRequest(detail: Record<string, unknown> | null | undefined, batchIndex?: number): boolean;
+/**
+ * Gas units for Get Sig without `eth_estimateGas` (same calldata often reverts on estimate).
+ * Order: proposal row[i] (or [0] / single `txParams`) / ExtraJSON uniswapV4 (audit, quote).
+ * Pass `batchIndex` when the sign request is a multi-tx batch.
+ */
+declare function resolveRouterSwapGasUnitsFromSignRequest(detail: Record<string, unknown> | null | undefined, batchIndex?: number): bigint | null;
+
+/** `deadline` = `now` + `expiryMinutes * 60` (seconds). */
+declare function swapTransactionDeadlineUnixFromExpiryMinutes(expiryMinutes: number, nowSec?: number): number;
+/** The stored `uniswapTradeQuote` is the full `POST /quote` JSON; `/swap` wants the **inner** classic quote. */
+declare function getClassicQuoteFromStoredUniswapResponse(stored: Record<string, unknown> | null | undefined): unknown;
+type TransactionRequest = {
+    to: string;
+    from?: string;
+    data: string;
+    value: string;
+    /** Trade API or eth-style field name */
+    gasLimit?: string;
+    gas?: string;
+    chainId?: number;
+};
+type CreateSwapResponse = {
+    requestId?: string;
+    swap: TransactionRequest;
+    gasFee?: string;
+};
+/**
+ * `POST /v1/swap` — builds swap calldata (Universal Router) from a quote fetched with classic-allowance header `x-permit2-disabled: true`.
+ * @see https://api-docs.uniswap.org/api-reference/swapping/swap
+ */
+declare function uniswapCreateSwap(args: {
+    uniswapApiKey: string;
+    baseUrl?: string;
+    /** Full `POST /quote` JSON (must include classic `quote`). */
+    fullQuoteFromPermit: Record<string, unknown>;
+    universalRouterVersion?: string;
+    fetchImpl?: typeof fetch;
+    /**
+     * In the browser, direct `POST` to `trade-api.gateway.uniswap.org` is blocked by CORS.
+     * When true (default in browser), the request goes to same-origin `POST /api/uniswap/swap` which proxies server-side. Set `false` to force a direct call (e.g. tests, Node scripts).
+     */
+    useServerProxy?: boolean;
+    /**
+     * Universal Router swap deadline (unix seconds). Defaults to now + {@link UNISWAP_SWAP_DEFAULT_DEADLINE_SEC_OFFSET}.
+     * Omitting this caused short API defaults and `TransactionDeadlinePassed` after MPC delay.
+     */
+    swapTransactionDeadlineUnix?: number;
+}): Promise<CreateSwapResponse>;
+type ChainRow = {
+    legacy?: boolean;
+    gasLimit?: number;
+    gasMultiplier?: number;
+    gasPrice?: number;
+    baseFee?: number;
+    priorityFee?: number;
+    baseFeeMultiplier?: number;
+};
+/**
+ * Apply UI slippage % on top of the base approve amount (EXACT_OUTPUT only at call sites; basis points, ceil wei).
+ * Example: 0.5% → multiply by 1.005 (10050/10000). `undefined` / non‑positive leaves `baseWei` unchanged.
+ */
+declare function applySlippagePercentToApproveWei(baseWei: bigint, slippagePercent: number | undefined): bigint;
+type UniswapV4SkipPermit2BatchArg = {
+    keyGen: KeyGenSubsetForPermit;
+    chainId: number;
+    rpcUrl: string;
+    chainDetail: ChainRow;
+    useCustomGas: boolean;
+    customGasChainDetails?: Record<string, unknown> | null;
+    /** `0x0` = native (ETH) in; otherwise ERC-20. */
+    tokenIn: Address;
+    executorAddress: Address;
+    swap: TransactionRequest;
+    createSwapResponse: {
+        requestId?: string;
+        gasFee?: string;
+        swap: TransactionRequest;
+    };
+    fullQuoteSnapshot: Record<string, unknown>;
+    purposeText: string;
+    swapDeadlineUnix: number;
+    slippagePercent?: number;
+};
+/**
+ * **Classic ERC-20 allowance** batch (on-chain approvals only), two shapes:
+ *
+ * - **`swap.to` == inner `router` (calldata arg)** — Universal Router is the tx target; tokens move via the **allowance hub**:
+ *   `ERC20→hub`, hub `approve(router)`, swap (3 txs).
+ *
+ * - **`swap.to` ≠ inner `router`** — Trade uses a **dispatcher** that calls `ERC20.transferFrom` with **`msg.sender` = `swap.to`**.
+ *   Approving only the hub is insufficient (`cast run` shows `transfer amount exceeds allowance`). Path:
+ *   `ERC20.approve(swap.to)`, swap (2 txs).
+ *
+ * Approved amount: `max(quote.input, calldata amount)`; with **EXACT_OUTPUT** trades, multiply by `(1 + slippage%)` from the quote modal (input can grow vs the quoted figure).
+ */
+declare function buildEvmMultisignBodyUniswapV4SkipPermit2Batch(args: UniswapV4SkipPermit2BatchArg): Promise<{
+    bodyForSign: Record<string, unknown>;
+    messageToSign: string;
+}>;
+
+type UniswapV4SessionPayload = {
+    chainId: number;
+    rpcUrl: string;
+    chainSupported: boolean;
+    universalRouter?: string;
+};
+declare function computeUniswapV4Session(args: {
+    assetsChainId: string | number;
+    rpcUrl: string | undefined;
+    protocolEnabled: boolean;
+}): UniswapV4SessionPayload;
+
+type SwapExactInputArgs = {
+    keyGen: KeyGenSubsetForPermit;
+    purposeText: string;
+    chainId: number;
+    rpcUrl: string;
+    executorAddress: Address;
+    chainDetail: EvmChainDetail;
+    useCustomGas: boolean;
+    customGasChainDetails?: Record<string, unknown> | null;
+    tokenIn: Address;
+    uniswapApiKey: string;
+    fullQuote: Record<string, unknown>;
+    slippagePercent?: number;
+    swapTransactionDeadlineUnix?: number;
+    baseUrl?: string;
+};
+/** Quote then build swap multisign body for EXACT_INPUT (caller must have fetched quote first for EXACT_OUTPUT). */
+declare function swapFromQuote(args: SwapExactInputArgs & {
+    swap: Awaited<ReturnType<typeof uniswapCreateSwap>>;
+}): Promise<{
+    bodyForSign: Record<string, unknown>;
+    messageToSign: string;
+}>;
+declare function quoteSwap(args: Parameters<typeof uniswapTradeQuote>[0]): Promise<Record<string, unknown>>;
+declare function createSwap(args: Parameters<typeof uniswapCreateSwap>[0]): Promise<Awaited<ReturnType<typeof uniswapCreateSwap>>>;
+declare function swapExactInput(args: SwapExactInputArgs & {
+    tradeType?: UniswapQuoteTradeType;
+}): Promise<{
+    bodyForSign: Record<string, unknown>;
+    messageToSign: string;
+}>;
+
+declare const UNISWAP_V4_PROTOCOL_ID = "uniswap-v4";
+declare const uniswapV4ProtocolModule: ProtocolModule;
+
+declare const uniswapV4: {
+    quoteSwap: typeof quoteSwap;
+    createSwap: typeof createSwap;
+    swapExactInput: typeof swapExactInput;
+    swapFromQuote: typeof swapFromQuote;
+    buildSwapMultisignBody: typeof buildEvmMultisignBodyUniswapV4SkipPermit2Batch;
+    quote: typeof uniswapTradeQuote;
+    isChainSupported: typeof isUniswapV4ChainSupported;
+};
+
+export { MAX_UINT160, MAX_UINT48, PERMIT2_ADDRESS, type SwapExactInputArgs, UNISWAP_SWAP_DEFAULT_DEADLINE_SEC_OFFSET, UNISWAP_SWAP_DEFAULT_EXPIRY_MINUTES, UNISWAP_TRADE_BASE_DEFAULT, UNISWAP_UNIVERSAL_ROUTER_DEFAULT_GAS_UNITS, UNISWAP_UNIVERSAL_ROUTER_VERSION_DEFAULT, UNISWAP_V4_PROTOCOL_ID, type UniswapQuoteTradeType, type UniswapTradeQuoteParams, type UniswapV4SessionPayload, applySlippagePercentToApproveWei, buildEvmMultisignBodyUniswapV4SkipPermit2Batch, buildUniswapQuoteRequestBody, buildUniswapV4PurposePrefill, computeUniswapV4Session, createSwap, errorMessageFromUniswapJsonBody, fetchEthereumAddressForKeyGen, formatUniswapAmountFieldFromWei, formatUniswapPercentForUi, formatUniswapQuoteForDisplay, getClassicQuoteFromStoredUniswapResponse, getUniswapUniversalRouterSpenderOrThrow, isUniswapFullQuoteResponseNativeIn, isUniswapTokenInAddressNative, isUniswapV4ChainSupported, isUniswapV4SwapEvmSignRequest, messageFromUniswapHttpResponseBody, parseUniswapChainId, parseUniswapQuoteClassicInOut, parseUniswapQuoteSlippageInfo, quoteSwap, resolveRouterSwapGasUnitsFromSignRequest, swapExactInput, swapFromQuote, swapTransactionDeadlineUnixFromExpiryMinutes, uniswapCreateSwap, uniswapQuoteToJsonQuoteOneLine, uniswapTradeQuote, uniswapV4, uniswapV4ProtocolModule };

package/dist/protocols/evm/uniswap-v4/index.d.ts

@@ -0,0 +1,323 @@
+import { d as ProtocolModule } from '../../../types-Ce2qNHai.js';
+import { Address } from 'viem';
+import { N as NodeReadAuth } from '../../../nodeRead-BnmSaMGO.js';
+import { K as KeyGenSubsetForPermit } from '../../../keygen-DsINazx8.js';
+import { E as EvmChainDetail } from '../../../types-5u863Fd9.js';
+
+/** Canonical Uniswap token-allowance contract on most EVM chains. */
+declare const PERMIT2_ADDRESS: Address;
+declare function isUniswapV4ChainSupported(chainId: string | number | bigint | null | undefined): boolean;
+declare function getUniswapUniversalRouterSpenderOrThrow(chainId: number): Address;
+declare const MAX_UINT160: bigint;
+declare const MAX_UINT48: bigint;
+declare const UNISWAP_UNIVERSAL_ROUTER_DEFAULT_GAS_UNITS = 1500000n;
+declare const UNISWAP_TRADE_BASE_DEFAULT = "https://trade-api.gateway.uniswap.org/v1";
+declare const UNISWAP_UNIVERSAL_ROUTER_VERSION_DEFAULT = "2.0";
+declare const UNISWAP_SWAP_DEFAULT_EXPIRY_MINUTES = 30;
+declare const UNISWAP_SWAP_DEFAULT_DEADLINE_SEC_OFFSET: number;
+
+/** POST /v1/quote `type` (same as `uniswap_trade_quote.py` `--type`). */
+type UniswapQuoteTradeType = 'EXACT_INPUT' | 'EXACT_OUTPUT';
+/** Parse chain id like Python: decimal or 0x hex. */
+declare function parseUniswapChainId(value: string | number): number;
+/** `tokenIn` is the EVM address `0x0` used by the Trade API for the chain’s native (gas) token. */
+declare function isUniswapTokenInAddressNative(tokenIn: string | undefined | null): boolean;
+/** `fullQuote` / stored quote response: top-level or nested has `quote.input` with a native or ERC-20 address. */
+declare function isUniswapFullQuoteResponseNativeIn(stored: Record<string, unknown> | null | undefined): boolean;
+/**
+ * GET /getKeyGenResultById and return `ethereumaddress` (swapper), same as
+ * `uniswap_mpc_helpers.resolve_owner_from_keygen` in mpc-config.
+ */
+declare function fetchEthereumAddressForKeyGen(managementNodeUrl: string, keyGenId: string, readAuth?: NodeReadAuth, init?: RequestInit): Promise<string>;
+interface UniswapTradeQuoteParams {
+    amount: string;
+    tokenIn: string;
+    tokenOut: string;
+    uniswapApiKey: string;
+    /**
+     * KeyGen id — used to resolve `swapper` from GET /getKeyGenResultById unless `swapper` is set.
+     * Required unless `swapper` is set.
+     */
+    keyGen?: string;
+    type: UniswapQuoteTradeType;
+    /**
+     * Slippage as percent, e.g. `0.5` for 0.5%. If omitted, the body uses
+     * `autoSlippage: "DEFAULT"` (same as the Python script when `--slippage` is not set).
+     */
+    slippage?: number | string;
+    /**
+     * Chain id for the input side (`tokenInChainId` in the HTTP body; Python `--chain-id`).
+     * You may set **`chainId` or `tokenInChainId`** (same meaning); if both are set, `chainId` wins.
+     * Same-chain quote: set one chain here and omit `tokenOutChainId` (or set both to the same id).
+     */
+    chainId?: string | number;
+    /**
+     * Same as `chainId` (input chain). If `chainId` is omitted, this must be set.
+     */
+    tokenInChainId?: string | number;
+    /**
+     * Output chain id; defaults to the input chain when omitted (Python: empty `--token-out-chain-id`).
+     */
+    tokenOutChainId?: string | number;
+    /**
+     * When `true`, sends `x-permit2-disabled: true` (Uniswap’s header for classic ERC-20 allowance; no permitData in the response).
+     * Omit or set `false` for the default Trade API routing (default).
+     */
+    permit2Disabled?: boolean;
+    /**
+     * MPC wallet (swapper) address. If omitted, `managementNodeUrl` is used with `keyGen`
+     * to call GET /getKeyGenResultById.
+     */
+    swapper?: `0x${string}` | string;
+    /**
+     * Management node base URL (MPC), required when `swapper` is not provided.
+     */
+    managementNodeUrl?: string;
+    /** For Browser HTTPS: Bearer on GET to /getKeyGenResultById. */
+    nodeReadAuth?: NodeReadAuth;
+    /** Trade API base without `/quote` (default: Uniswap gateway v1). */
+    baseUrl?: string;
+    /** `x-universal-router-version` (default `2.0`, aligned with Python / v4). */
+    universalRouterVersion?: string;
+    signal?: AbortSignal;
+    /** Override for tests. */
+    fetchImpl?: typeof fetch;
+}
+declare function buildUniswapQuoteRequestBody(args: Pick<UniswapTradeQuoteParams, 'type' | 'amount' | 'tokenIn' | 'tokenOut' | 'slippage' | 'chainId' | 'tokenInChainId' | 'tokenOutChainId'> & {
+    swapper: string;
+}): Record<string, unknown>;
+/**
+ * Pull a user-facing string from Uniswap / generic JSON error bodies.
+ */
+declare function errorMessageFromUniswapJsonBody(value: unknown): string | null;
+/**
+ * User-facing string from an HTTP body: JSON `message` / `error` / `detail` first,
+ * else a short plain-text / HTML page title, not the raw document (avoids huge HTML in UI).
+ */
+declare function messageFromUniswapHttpResponseBody(text: string, status: number, statusText?: string): string;
+/**
+ * `POST` Uniswap Trade API `/v1/quote` — TypeScript version of
+ * `mpc-config/recipes/uniswapV4/uniswap_trade_quote.py` (core HTTP call + KeyGen → swapper).
+ *
+ * CORS: calling the Trade API from a browser may be blocked. Prefer a server / route
+ * handler, or use this in Node. KeyGen resolution uses a GET to your management node
+ * and follows the same read-auth pattern as the app.
+ */
+declare function uniswapTradeQuote(args: UniswapTradeQuoteParams): Promise<Record<string, unknown>>;
+/**
+ * Single-line JSON for mpc-config `uniswap_trade_swap.py --quote-json` (compact quote body).
+ */
+declare function uniswapQuoteToJsonQuoteOneLine(quote: Record<string, unknown>): string;
+/**
+ * `quote.input.amount` / `quote.output.amount` as bigints, if present (classic response).
+ */
+declare function parseUniswapQuoteClassicInOut(res: Record<string, unknown>): {
+    inputWei: bigint;
+    outputWei: bigint;
+} | null;
+/**
+ * Fields from Uniswap Trade API `200` `quote` (e.g. {@link https://api-docs.uniswap.org/api-reference/swapping/quote} `ClassicQuote`):
+ * - `slippage` — slippage tolerance (percent) used for the quote
+ * - `priceImpact` — “impact the trade has on the market price of the pool, between 0-100 percent”
+ */
+declare function parseUniswapQuoteSlippageInfo(res: Record<string, unknown>): {
+    slippageTolerancePercent: number | null;
+    priceImpactPercent: number | null;
+};
+/** Compact percent for UI (e.g. 0.5, 1.2345). */
+declare function formatUniswapPercentForUi(n: number): string;
+/** Human string for a modal amount field, trimmed of trailing fraction zeros. */
+declare function formatUniswapAmountFieldFromWei(wei: bigint, decimals: number): string;
+/**
+ * One-line prefill for multi-sign "purpose" (user may append context below in the same field).
+ */
+declare function buildUniswapV4PurposePrefill(args: {
+    tradeType: UniswapQuoteTradeType;
+    tokenInSymbol: string;
+    tokenOutSymbol: string;
+    tokenInDecimals: number;
+    tokenOutDecimals: number;
+    amountInput: string;
+    quote: Record<string, unknown> | null;
+    slippageInput: string;
+    chainName: string;
+    chainId: number;
+}): string;
+/**
+ * Human-readable lines from a Trade API `/quote` 200 JSON body.
+ * Classic quotes expose `quote.input` / `quote.output` with `amount` (base units as string).
+ */
+declare function formatUniswapQuoteForDisplay(res: Record<string, unknown>, args: {
+    tradeType: UniswapQuoteTradeType;
+    tokenInDecimals: number;
+    tokenOutDecimals: number;
+    tokenInSymbol: string;
+    tokenOutSymbol: string;
+}): {
+    title: string;
+    lines: string[];
+    rawJson: string;
+};
+
+/**
+ * When `batchIndex` is set, allow per-item `batchMeta[i].evm` when present; else top-level `evm` in ExtraJSON.
+ */
+declare function isUniswapV4SwapEvmSignRequest(detail: Record<string, unknown> | null | undefined, batchIndex?: number): boolean;
+/**
+ * Gas units for Get Sig without `eth_estimateGas` (same calldata often reverts on estimate).
+ * Order: proposal row[i] (or [0] / single `txParams`) / ExtraJSON uniswapV4 (audit, quote).
+ * Pass `batchIndex` when the sign request is a multi-tx batch.
+ */
+declare function resolveRouterSwapGasUnitsFromSignRequest(detail: Record<string, unknown> | null | undefined, batchIndex?: number): bigint | null;
+
+/** `deadline` = `now` + `expiryMinutes * 60` (seconds). */
+declare function swapTransactionDeadlineUnixFromExpiryMinutes(expiryMinutes: number, nowSec?: number): number;
+/** The stored `uniswapTradeQuote` is the full `POST /quote` JSON; `/swap` wants the **inner** classic quote. */
+declare function getClassicQuoteFromStoredUniswapResponse(stored: Record<string, unknown> | null | undefined): unknown;
+type TransactionRequest = {
+    to: string;
+    from?: string;
+    data: string;
+    value: string;
+    /** Trade API or eth-style field name */
+    gasLimit?: string;
+    gas?: string;
+    chainId?: number;
+};
+type CreateSwapResponse = {
+    requestId?: string;
+    swap: TransactionRequest;
+    gasFee?: string;
+};
+/**
+ * `POST /v1/swap` — builds swap calldata (Universal Router) from a quote fetched with classic-allowance header `x-permit2-disabled: true`.
+ * @see https://api-docs.uniswap.org/api-reference/swapping/swap
+ */
+declare function uniswapCreateSwap(args: {
+    uniswapApiKey: string;
+    baseUrl?: string;
+    /** Full `POST /quote` JSON (must include classic `quote`). */
+    fullQuoteFromPermit: Record<string, unknown>;
+    universalRouterVersion?: string;
+    fetchImpl?: typeof fetch;
+    /**
+     * In the browser, direct `POST` to `trade-api.gateway.uniswap.org` is blocked by CORS.
+     * When true (default in browser), the request goes to same-origin `POST /api/uniswap/swap` which proxies server-side. Set `false` to force a direct call (e.g. tests, Node scripts).
+     */
+    useServerProxy?: boolean;
+    /**
+     * Universal Router swap deadline (unix seconds). Defaults to now + {@link UNISWAP_SWAP_DEFAULT_DEADLINE_SEC_OFFSET}.
+     * Omitting this caused short API defaults and `TransactionDeadlinePassed` after MPC delay.
+     */
+    swapTransactionDeadlineUnix?: number;
+}): Promise<CreateSwapResponse>;
+type ChainRow = {
+    legacy?: boolean;
+    gasLimit?: number;
+    gasMultiplier?: number;
+    gasPrice?: number;
+    baseFee?: number;
+    priorityFee?: number;
+    baseFeeMultiplier?: number;
+};
+/**
+ * Apply UI slippage % on top of the base approve amount (EXACT_OUTPUT only at call sites; basis points, ceil wei).
+ * Example: 0.5% → multiply by 1.005 (10050/10000). `undefined` / non‑positive leaves `baseWei` unchanged.
+ */
+declare function applySlippagePercentToApproveWei(baseWei: bigint, slippagePercent: number | undefined): bigint;
+type UniswapV4SkipPermit2BatchArg = {
+    keyGen: KeyGenSubsetForPermit;
+    chainId: number;
+    rpcUrl: string;
+    chainDetail: ChainRow;
+    useCustomGas: boolean;
+    customGasChainDetails?: Record<string, unknown> | null;
+    /** `0x0` = native (ETH) in; otherwise ERC-20. */
+    tokenIn: Address;
+    executorAddress: Address;
+    swap: TransactionRequest;
+    createSwapResponse: {
+        requestId?: string;
+        gasFee?: string;
+        swap: TransactionRequest;
+    };
+    fullQuoteSnapshot: Record<string, unknown>;
+    purposeText: string;
+    swapDeadlineUnix: number;
+    slippagePercent?: number;
+};
+/**
+ * **Classic ERC-20 allowance** batch (on-chain approvals only), two shapes:
+ *
+ * - **`swap.to` == inner `router` (calldata arg)** — Universal Router is the tx target; tokens move via the **allowance hub**:
+ *   `ERC20→hub`, hub `approve(router)`, swap (3 txs).
+ *
+ * - **`swap.to` ≠ inner `router`** — Trade uses a **dispatcher** that calls `ERC20.transferFrom` with **`msg.sender` = `swap.to`**.
+ *   Approving only the hub is insufficient (`cast run` shows `transfer amount exceeds allowance`). Path:
+ *   `ERC20.approve(swap.to)`, swap (2 txs).
+ *
+ * Approved amount: `max(quote.input, calldata amount)`; with **EXACT_OUTPUT** trades, multiply by `(1 + slippage%)` from the quote modal (input can grow vs the quoted figure).
+ */
+declare function buildEvmMultisignBodyUniswapV4SkipPermit2Batch(args: UniswapV4SkipPermit2BatchArg): Promise<{
+    bodyForSign: Record<string, unknown>;
+    messageToSign: string;
+}>;
+
+type UniswapV4SessionPayload = {
+    chainId: number;
+    rpcUrl: string;
+    chainSupported: boolean;
+    universalRouter?: string;
+};
+declare function computeUniswapV4Session(args: {
+    assetsChainId: string | number;
+    rpcUrl: string | undefined;
+    protocolEnabled: boolean;
+}): UniswapV4SessionPayload;
+
+type SwapExactInputArgs = {
+    keyGen: KeyGenSubsetForPermit;
+    purposeText: string;
+    chainId: number;
+    rpcUrl: string;
+    executorAddress: Address;
+    chainDetail: EvmChainDetail;
+    useCustomGas: boolean;
+    customGasChainDetails?: Record<string, unknown> | null;
+    tokenIn: Address;
+    uniswapApiKey: string;
+    fullQuote: Record<string, unknown>;
+    slippagePercent?: number;
+    swapTransactionDeadlineUnix?: number;
+    baseUrl?: string;
+};
+/** Quote then build swap multisign body for EXACT_INPUT (caller must have fetched quote first for EXACT_OUTPUT). */
+declare function swapFromQuote(args: SwapExactInputArgs & {
+    swap: Awaited<ReturnType<typeof uniswapCreateSwap>>;
+}): Promise<{
+    bodyForSign: Record<string, unknown>;
+    messageToSign: string;
+}>;
+declare function quoteSwap(args: Parameters<typeof uniswapTradeQuote>[0]): Promise<Record<string, unknown>>;
+declare function createSwap(args: Parameters<typeof uniswapCreateSwap>[0]): Promise<Awaited<ReturnType<typeof uniswapCreateSwap>>>;
+declare function swapExactInput(args: SwapExactInputArgs & {
+    tradeType?: UniswapQuoteTradeType;
+}): Promise<{
+    bodyForSign: Record<string, unknown>;
+    messageToSign: string;
+}>;
+
+declare const UNISWAP_V4_PROTOCOL_ID = "uniswap-v4";
+declare const uniswapV4ProtocolModule: ProtocolModule;
+
+declare const uniswapV4: {
+    quoteSwap: typeof quoteSwap;
+    createSwap: typeof createSwap;
+    swapExactInput: typeof swapExactInput;
+    swapFromQuote: typeof swapFromQuote;
+    buildSwapMultisignBody: typeof buildEvmMultisignBodyUniswapV4SkipPermit2Batch;
+    quote: typeof uniswapTradeQuote;
+    isChainSupported: typeof isUniswapV4ChainSupported;
+};
+
+export { MAX_UINT160, MAX_UINT48, PERMIT2_ADDRESS, type SwapExactInputArgs, UNISWAP_SWAP_DEFAULT_DEADLINE_SEC_OFFSET, UNISWAP_SWAP_DEFAULT_EXPIRY_MINUTES, UNISWAP_TRADE_BASE_DEFAULT, UNISWAP_UNIVERSAL_ROUTER_DEFAULT_GAS_UNITS, UNISWAP_UNIVERSAL_ROUTER_VERSION_DEFAULT, UNISWAP_V4_PROTOCOL_ID, type UniswapQuoteTradeType, type UniswapTradeQuoteParams, type UniswapV4SessionPayload, applySlippagePercentToApproveWei, buildEvmMultisignBodyUniswapV4SkipPermit2Batch, buildUniswapQuoteRequestBody, buildUniswapV4PurposePrefill, computeUniswapV4Session, createSwap, errorMessageFromUniswapJsonBody, fetchEthereumAddressForKeyGen, formatUniswapAmountFieldFromWei, formatUniswapPercentForUi, formatUniswapQuoteForDisplay, getClassicQuoteFromStoredUniswapResponse, getUniswapUniversalRouterSpenderOrThrow, isUniswapFullQuoteResponseNativeIn, isUniswapTokenInAddressNative, isUniswapV4ChainSupported, isUniswapV4SwapEvmSignRequest, messageFromUniswapHttpResponseBody, parseUniswapChainId, parseUniswapQuoteClassicInOut, parseUniswapQuoteSlippageInfo, quoteSwap, resolveRouterSwapGasUnitsFromSignRequest, swapExactInput, swapFromQuote, swapTransactionDeadlineUnixFromExpiryMinutes, uniswapCreateSwap, uniswapQuoteToJsonQuoteOneLine, uniswapTradeQuote, uniswapV4, uniswapV4ProtocolModule };