@continuumdao/ctm-mpc-defi 0.2.2 → 0.2.4

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

@@ -1,5 +1,5 @@
 import { b as KeyGenSubsetForPermit, e as ProtocolModule } from '../../../types-BfjWdw1j.js';
-import { Address } from 'viem';
+import { Address, createPublicClient, TransactionReceipt } from 'viem';
 import { NodeReadAuth } from '@continuumdao/continuum-node-sdk';
 import { E as EvmChainDetail } from '../../../types-DUeNJLr9.js';
 
@@ -11,9 +11,26 @@ 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";
+/** Alternate LP API host (integration guide); trade-api `/v1/lp/*` is primary. */
+declare const UNISWAP_LP_API_BASE_DEFAULT = "https://api.uniswap.org";
 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;
+declare const UNISWAP_LP_DEFAULT_EXPIRY_MINUTES = 30;
+declare const UNISWAP_LP_DEFAULT_DEADLINE_SEC_OFFSET: number;
+declare const UNISWAP_LP_DEFAULT_SLIPPAGE_PERCENT = 0.5;
+declare function getUniswapV4PositionManagerOrThrow(chainId: number): Address;
+declare function tryGetUniswapV4PositionManager(chainId: number): Address | null;
+/** Default `eth_getLogs` span — many free RPCs cap at 250 blocks (e.g. Nodies). */
+declare const UNISWAP_V4_LP_LOG_CHUNK_SIZE_DEFAULT = 200n;
+declare const UNISWAP_V4_LP_LOG_CHUNK_SIZE_MIN = 10n;
+declare function getUniswapV4PositionManagerDeployBlock(chainId: number): bigint | undefined;
+declare const UNISWAP_V4_LP_MINT_DEFAULT_GAS_UNITS = 1800000n;
+declare const UNISWAP_V4_LP_INCREASE_DEFAULT_GAS_UNITS = 1500000n;
+declare const UNISWAP_V4_LP_DECREASE_DEFAULT_GAS_UNITS = 1200000n;
+declare const UNISWAP_V4_LP_COLLECT_DEFAULT_GAS_UNITS = 900000n;
+declare const UNISWAP_V4_LP_ERC20_APPROVE_FALLBACK = 100000n;
+declare const UNISWAP_V4_LP_WETH_DEPOSIT_FALLBACK = 120000n;
 
 /** POST /v1/quote `type` (same as `uniswap_trade_quote.py` `--type`). */
 type UniswapQuoteTradeType = 'EXACT_INPUT' | 'EXACT_OUTPUT';
@@ -211,7 +228,7 @@ declare function uniswapCreateSwap(args: {
      */
     swapTransactionDeadlineUnix?: number;
 }): Promise<CreateSwapResponse>;
-type ChainRow = {
+type ChainRow$1 = {
     legacy?: boolean;
     gasLimit?: number;
     gasMultiplier?: number;
@@ -229,7 +246,7 @@ type UniswapV4SkipPermit2BatchArg = {
     keyGen: KeyGenSubsetForPermit;
     chainId: number;
     rpcUrl: string;
-    chainDetail: ChainRow;
+    chainDetail: ChainRow$1;
     useCustomGas: boolean;
     customGasChainDetails?: Record<string, unknown> | null;
     /** `0x0` = native (ETH) in; otherwise ERC-20. */
@@ -263,6 +280,280 @@ declare function buildEvmMultisignBodyUniswapV4SkipPermit2Batch(args: UniswapV4S
     messageToSign: string;
 }>;
 
+type UniswapLpProtocol = 'V4';
+type UniswapLpTransactionRequest = {
+    to: string;
+    from?: string;
+    data: string;
+    value: string;
+    chainId?: number;
+    gasLimit?: string;
+    gasPrice?: string;
+    maxFeePerGas?: string;
+    maxPriorityFeePerGas?: string;
+};
+type UniswapLpTokenAmount = {
+    tokenAddress: string;
+    amount: string;
+};
+type UniswapLpExistingPool = {
+    token0Address: string;
+    token1Address: string;
+    /** V4 pool id (bytes32 hex); V3 pool contract address. */
+    poolReference: string;
+};
+type UniswapLpNewPool = {
+    token0Address: string;
+    token1Address: string;
+    fee: number;
+    tickSpacing: number;
+    hooks?: string;
+    initialPrice: string;
+};
+type UniswapLpIndependentToken = {
+    tokenAddress: string;
+    amount: string;
+};
+type UniswapLpPriceBounds = {
+    minPrice: string;
+    maxPrice: string;
+};
+type UniswapLpTickBounds = {
+    tickLower: number;
+    tickUpper: number;
+};
+declare function extractUniswapLpTransaction(response: Record<string, unknown>, field: 'create' | 'increase' | 'decrease' | 'claim'): UniswapLpTransactionRequest;
+declare function extractUniswapLpTokenAmounts(response: Record<string, unknown>): {
+    token0?: UniswapLpTokenAmount;
+    token1?: UniswapLpTokenAmount;
+};
+declare function uniswapLpCreatePosition(args: {
+    uniswapApiKey: string;
+    walletAddress: string;
+    chainId: number;
+    existingPool?: UniswapLpExistingPool;
+    newPool?: UniswapLpNewPool;
+    independentToken: UniswapLpIndependentToken;
+    priceBounds?: UniswapLpPriceBounds;
+    tickBounds?: UniswapLpTickBounds;
+    slippageTolerance?: number;
+    deadline?: number;
+    simulateTransaction?: boolean;
+    batchPermitData?: Record<string, unknown>;
+    signature?: string;
+    baseUrl?: string;
+    fetchImpl?: typeof fetch;
+    useServerProxy?: boolean;
+}): Promise<Record<string, unknown>>;
+declare function uniswapLpIncreasePosition(args: {
+    uniswapApiKey: string;
+    walletAddress: string;
+    chainId: number;
+    token0Address: string;
+    token1Address: string;
+    nftTokenId: string | number;
+    independentToken: UniswapLpIndependentToken;
+    slippageTolerance?: number;
+    deadline?: number;
+    simulateTransaction?: boolean;
+    v4BatchPermitData?: Record<string, unknown>;
+    signature?: string;
+    baseUrl?: string;
+    fetchImpl?: typeof fetch;
+    useServerProxy?: boolean;
+}): Promise<Record<string, unknown>>;
+declare function uniswapLpDecreasePosition(args: {
+    uniswapApiKey: string;
+    walletAddress: string;
+    chainId: number;
+    token0Address: string;
+    token1Address: string;
+    nftTokenId: string | number;
+    liquidityPercentageToDecrease: number;
+    slippageTolerance?: number;
+    deadline?: number;
+    simulateTransaction?: boolean;
+    baseUrl?: string;
+    fetchImpl?: typeof fetch;
+    useServerProxy?: boolean;
+}): Promise<Record<string, unknown>>;
+declare function uniswapLpClaimFees(args: {
+    uniswapApiKey: string;
+    walletAddress: string;
+    chainId: number;
+    tokenId: string | number;
+    simulateTransaction?: boolean;
+    baseUrl?: string;
+    fetchImpl?: typeof fetch;
+    useServerProxy?: boolean;
+}): Promise<Record<string, unknown>>;
+
+type UniswapLpAction = 'mint' | 'increase' | 'decrease' | 'collect';
+declare function uniswapLpTxFieldForAction(action: UniswapLpAction): 'create' | 'increase' | 'decrease' | 'claim';
+declare function parseUniswapLpApiSnapshot(args: {
+    action: UniswapLpAction;
+    lpResponse: Record<string, unknown>;
+}): {
+    transaction: UniswapLpTransactionRequest;
+    token0?: UniswapLpTokenAmount;
+    token1?: UniswapLpTokenAmount;
+    tickLower?: number;
+    tickUpper?: number;
+    minPrice?: string;
+    maxPrice?: string;
+};
+declare function formatUniswapLpAmountHuman(amountWei: string, decimals: number): string;
+
+type ChainRow = {
+    legacy?: boolean;
+    gasLimit?: number;
+    gasMultiplier?: number;
+    gasPrice?: number;
+    baseFee?: number;
+    priorityFee?: number;
+    baseFeeMultiplier?: number;
+};
+declare function isUniswapV4LiquidityEvmSignRequest(detail: Record<string, unknown> | null | undefined, batchIndex?: number): boolean;
+type LiquidityMultisignCommon = {
+    keyGen: KeyGenSubsetForPermit;
+    chainId: number;
+    rpcUrl: string;
+    chainDetail: ChainRow;
+    useCustomGas: boolean;
+    customGasChainDetails?: Record<string, unknown> | null;
+    executorAddress: Address;
+    purposeText: string;
+    lpResponse: Record<string, unknown>;
+    action: UniswapLpAction;
+    /** Wrapped native token when pool uses native ETH as currency0/1. */
+    nativeWrapped?: Address;
+    nftTokenId?: string | number;
+    poolReference?: string;
+};
+declare function buildEvmMultisignBodyUniswapV4MintLiquidityBatch(args: Omit<LiquidityMultisignCommon, 'action' | 'nftTokenId'> & {
+    poolReference?: string;
+}): Promise<{
+    bodyForSign: Record<string, unknown>;
+    messageToSign: string;
+}>;
+declare function buildEvmMultisignBodyUniswapV4IncreaseLiquidityBatch(args: Omit<LiquidityMultisignCommon, 'action'> & {
+    nftTokenId: string | number;
+}): Promise<{
+    bodyForSign: Record<string, unknown>;
+    messageToSign: string;
+}>;
+declare function buildEvmMultisignBodyUniswapV4DecreaseLiquidityBatch(args: Omit<LiquidityMultisignCommon, 'action'> & {
+    nftTokenId: string | number;
+}): Promise<{
+    bodyForSign: Record<string, unknown>;
+    messageToSign: string;
+}>;
+declare function buildEvmMultisignBodyUniswapV4CollectFeesBatch(args: Omit<LiquidityMultisignCommon, 'action'> & {
+    nftTokenId: string | number;
+}): Promise<{
+    bodyForSign: Record<string, unknown>;
+    messageToSign: string;
+}>;
+
+type UniswapV4PositionRow = {
+    tokenId: string;
+    positionManager: Address;
+    owner: Address;
+    name?: string;
+    symbol?: string;
+};
+/** Shown when LP tools cannot resolve a position NFT from the node token registry. */
+declare const UNISWAP_V4_LP_POSITION_REGISTRY_HINT: string;
+declare function formatUniswapV4PositionNotFoundError(args: {
+    tokenId: string;
+    chainId: number | string;
+}): string;
+/** Minted position NFT ids from a successful Position Manager mint receipt. */
+declare function uniswapV4PositionMintedTokenIdsFromReceipt(receipt: TransactionReceipt, positionManager: Address, owner: Address): bigint[];
+type UniswapV4RegistryErc721Row = {
+    contractAddress: string;
+    tokenId: string;
+    name?: string;
+    symbol?: string;
+};
+/** List positions from saved ERC721 tokens (Position Manager contract on this chain). */
+declare function uniswapV4ListPositionsFromRegistryForMcp(args: {
+    chainId: number | string;
+    walletAddress: Address | string;
+    erc721Tokens: UniswapV4RegistryErc721Row[];
+    positionManagerAddress?: Address | string;
+}): {
+    positions: UniswapV4PositionRow[];
+    source: 'token_registry';
+};
+type UniswapV4PositionScanProgress = {
+    latestBlock: string;
+    scanFromBlock: string;
+    scanningFromBlock: string;
+    scanningToBlock: string;
+    foundCount: number;
+    targetCount: number;
+};
+/** True when the RPC rejects `eth_getLogs` because the block span is too large. */
+declare function isEthGetLogsBlockRangeTooLargeError(err: unknown): boolean;
+/** Parse `YYYY-MM-DD` as UTC midnight. */
+declare function parseUniswapV4ScanFromDateYmd(fromDate: string): number;
+/** Smallest block whose timestamp is >= `unixTime` (binary search). */
+declare function resolveBlockAtOrAfterUnixTime(client: ReturnType<typeof createPublicClient>, unixTime: number, bounds: {
+    minBlock: bigint;
+    maxBlock: bigint;
+}): Promise<bigint>;
+/** Map a calendar date to the first block to scan from (never before Position Manager deploy). */
+declare function resolveUniswapV4PositionScanFromDate(args: {
+    chainId: number;
+    rpcUrl: string;
+    fromDate: string;
+}): Promise<bigint>;
+/**
+ * List v4 position NFT tokenIds owned by `walletAddress` via Position Manager Transfer logs.
+ * Uses small `eth_getLogs` chunks (default 200 blocks) and scans backward so wallets with
+ * few positions finish without walking full chain history.
+ */
+declare function listUniswapV4PositionsForWallet(args: {
+    chainId: number;
+    rpcUrl: string;
+    walletAddress: Address | string;
+    positionManagerAddress?: Address | string;
+    fromBlock?: bigint;
+    maxBlocksToScan?: bigint;
+    chunkSize?: bigint;
+    onProgress?: (progress: UniswapV4PositionScanProgress) => void;
+    signal?: AbortSignal;
+}): Promise<UniswapV4PositionRow[]>;
+declare function readUniswapV4PositionInfoRaw(args: {
+    chainId: number;
+    rpcUrl: string;
+    tokenId: string | number;
+    positionManagerAddress?: Address | string;
+}): Promise<{
+    info: bigint;
+    positionManager: Address;
+}>;
+/** MCP handler for `ctm_uniswap_v4_lp_list_positions`. */
+declare function uniswapV4ListPositionsForMcp(args: {
+    chainId: number | string;
+    rpcUrl: string;
+    walletAddress: string;
+    positionManagerAddress?: string;
+    fromBlock?: string | number;
+    onProgress?: (progress: UniswapV4PositionScanProgress) => void;
+    signal?: AbortSignal;
+}): Promise<{
+    positions: UniswapV4PositionRow[];
+}>;
+/** Stub — continuum-node-sdk MCP server lists positions from token registry. */
+declare function uniswapV4ListPositionsRegistryMcpPlaceholder(): never;
+/** Stub — continuum-node-sdk MCP server implements registration (management POST). */
+declare function uniswapV4RegisterPositionNftPlaceholder(): never;
+/** Stub — continuum-node-sdk MCP server implements registration from mint receipt. */
+declare function uniswapV4RegisterPositionFromMintTxPlaceholder(): never;
+declare function isNativeUniswapLpTokenAddress(token: string): boolean;
+
 type UniswapV4SessionPayload = {
     chainId: number;
     rpcUrl: string;
@@ -317,7 +608,16 @@ declare const uniswapV4: {
     swapFromQuote: typeof swapFromQuote;
     buildSwapMultisignBody: typeof buildEvmMultisignBodyUniswapV4SkipPermit2Batch;
     quote: typeof uniswapTradeQuote;
+    createLiquidityPosition: typeof uniswapLpCreatePosition;
+    increaseLiquidityPosition: typeof uniswapLpIncreasePosition;
+    decreaseLiquidityPosition: typeof uniswapLpDecreasePosition;
+    claimLiquidityFees: typeof uniswapLpClaimFees;
+    buildMintLiquidityMultisignBody: typeof buildEvmMultisignBodyUniswapV4MintLiquidityBatch;
+    buildIncreaseLiquidityMultisignBody: typeof buildEvmMultisignBodyUniswapV4IncreaseLiquidityBatch;
+    buildDecreaseLiquidityMultisignBody: typeof buildEvmMultisignBodyUniswapV4DecreaseLiquidityBatch;
+    buildCollectFeesMultisignBody: typeof buildEvmMultisignBodyUniswapV4CollectFeesBatch;
+    listPositions: typeof listUniswapV4PositionsForWallet;
     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 };
+export { MAX_UINT160, MAX_UINT48, PERMIT2_ADDRESS, type SwapExactInputArgs, UNISWAP_LP_API_BASE_DEFAULT, UNISWAP_LP_DEFAULT_DEADLINE_SEC_OFFSET, UNISWAP_LP_DEFAULT_EXPIRY_MINUTES, UNISWAP_LP_DEFAULT_SLIPPAGE_PERCENT, 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_LP_COLLECT_DEFAULT_GAS_UNITS, UNISWAP_V4_LP_DECREASE_DEFAULT_GAS_UNITS, UNISWAP_V4_LP_ERC20_APPROVE_FALLBACK, UNISWAP_V4_LP_INCREASE_DEFAULT_GAS_UNITS, UNISWAP_V4_LP_LOG_CHUNK_SIZE_DEFAULT, UNISWAP_V4_LP_LOG_CHUNK_SIZE_MIN, UNISWAP_V4_LP_MINT_DEFAULT_GAS_UNITS, UNISWAP_V4_LP_POSITION_REGISTRY_HINT, UNISWAP_V4_LP_WETH_DEPOSIT_FALLBACK, UNISWAP_V4_PROTOCOL_ID, type UniswapLpAction, type UniswapLpExistingPool, type UniswapLpIndependentToken, type UniswapLpNewPool, type UniswapLpPriceBounds, type UniswapLpProtocol, type UniswapLpTickBounds, type UniswapLpTokenAmount, type UniswapLpTransactionRequest, type UniswapQuoteTradeType, type UniswapTradeQuoteParams, type UniswapV4PositionRow, type UniswapV4PositionScanProgress, type UniswapV4RegistryErc721Row, type UniswapV4SessionPayload, applySlippagePercentToApproveWei, buildEvmMultisignBodyUniswapV4CollectFeesBatch, buildEvmMultisignBodyUniswapV4DecreaseLiquidityBatch, buildEvmMultisignBodyUniswapV4IncreaseLiquidityBatch, buildEvmMultisignBodyUniswapV4MintLiquidityBatch, buildEvmMultisignBodyUniswapV4SkipPermit2Batch, buildUniswapQuoteRequestBody, buildUniswapV4PurposePrefill, computeUniswapV4Session, createSwap, errorMessageFromUniswapJsonBody, extractUniswapLpTokenAmounts, extractUniswapLpTransaction, fetchEthereumAddressForKeyGen, formatUniswapAmountFieldFromWei, formatUniswapLpAmountHuman, formatUniswapPercentForUi, formatUniswapQuoteForDisplay, formatUniswapV4PositionNotFoundError, getClassicQuoteFromStoredUniswapResponse, getUniswapUniversalRouterSpenderOrThrow, getUniswapV4PositionManagerDeployBlock, getUniswapV4PositionManagerOrThrow, isEthGetLogsBlockRangeTooLargeError, isNativeUniswapLpTokenAddress, isUniswapFullQuoteResponseNativeIn, isUniswapTokenInAddressNative, isUniswapV4ChainSupported, isUniswapV4LiquidityEvmSignRequest, isUniswapV4SwapEvmSignRequest, listUniswapV4PositionsForWallet, messageFromUniswapHttpResponseBody, parseUniswapChainId, parseUniswapLpApiSnapshot, parseUniswapQuoteClassicInOut, parseUniswapQuoteSlippageInfo, parseUniswapV4ScanFromDateYmd, quoteSwap, readUniswapV4PositionInfoRaw, resolveBlockAtOrAfterUnixTime, resolveRouterSwapGasUnitsFromSignRequest, resolveUniswapV4PositionScanFromDate, swapExactInput, swapFromQuote, swapTransactionDeadlineUnixFromExpiryMinutes, tryGetUniswapV4PositionManager, uniswapCreateSwap, uniswapLpClaimFees, uniswapLpCreatePosition, uniswapLpDecreasePosition, uniswapLpIncreasePosition, uniswapLpTxFieldForAction, uniswapQuoteToJsonQuoteOneLine, uniswapTradeQuote, uniswapV4, uniswapV4ListPositionsForMcp, uniswapV4ListPositionsFromRegistryForMcp, uniswapV4ListPositionsRegistryMcpPlaceholder, uniswapV4PositionMintedTokenIdsFromReceipt, uniswapV4ProtocolModule, uniswapV4RegisterPositionFromMintTxPlaceholder, uniswapV4RegisterPositionNftPlaceholder };