@continuumdao/ctm-mpc-defi 0.2.19 → 0.2.22

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

@@ -1,7 +1,7 @@
-import { b as KeyGenSubsetForPermit, e as ProtocolModule } from '../../../types-BfjWdw1j.js';
+import { b as KeyGenSubsetForPermit, e as ProtocolModule } from '../../../types-PZrvtjv8.js';
 import { Address, createPublicClient, TransactionReceipt } from 'viem';
 import { NodeReadAuth } from '@continuumdao/continuum-node-sdk';
-import { E as EvmChainDetail } from '../../../types-DUeNJLr9.js';
+import { E as EvmChainDetail } from '../../../types-RZWOTm8c.js';
 
 /** Canonical Uniswap token-allowance contract on most EVM chains. */
 declare const PERMIT2_ADDRESS: Address;
@@ -660,6 +660,183 @@ declare function swapExactInput(args: SwapExactInputArgs & {
     messageToSign: string;
 }>;
 
+/** Node env var for The Graph decentralized gateway (optional but recommended for OHLCV). */
+declare const THE_GRAPH_API_KEY_ENV = "THE_GRAPH_API_KEY";
+declare const THE_GRAPH_API_KEY_SIGNUP_URL = "https://thegraph.com/studio/apikeys/";
+declare const THE_GRAPH_API_KEY_DOCS_URL = "https://thegraph.com/docs/en/subgraphs/querying/managing-api-keys/";
+declare function isTheGraphRateLimitOrAuthError(message: string): boolean;
+/** Brief hint for UI / MCP tool errors (no secret values). */
+declare function theGraphApiKeyVariablesHint(): string;
+declare function theGraphRateLimitErrorMessage(baseError: string): string;
+
+/** @deprecated Import from `./theGraphApiKey.js` */
+
+/**
+ * Public Uniswap V4 subgraph deployment IDs on The Graph.
+ * Quality/freshness varies by deployment; Uniswap production UI uses private indexers.
+ * @see https://github.com/Uniswap/v4-subgraph/issues/41
+ */
+declare const UNISWAP_V4_SUBGRAPH_ID_BY_CHAIN_ID: Readonly<Record<number, string>>;
+type UniswapV4SubgraphPoolHourRow = {
+    periodStartUnix: number;
+    open: string;
+    high: string;
+    low: string;
+    close: string;
+    volumeUSD: string;
+};
+type UniswapV4SubgraphPoolDayRow = {
+    date: number;
+    open: string;
+    high: string;
+    low: string;
+    close: string;
+    volumeUSD: string;
+};
+type UniswapV4SubgraphSwapRow = {
+    timestamp: string;
+    amountUSD: string;
+    token0Price?: string;
+    sqrtPriceX96?: string;
+};
+type UniswapV4SubgraphPoolMeta = {
+    id: string;
+    token0?: {
+        symbol?: string;
+    };
+    token1?: {
+        symbol?: string;
+    };
+};
+declare function uniswapV4SubgraphIdForChain(chainId: number): string | undefined;
+declare function uniswapV4SubgraphSupportedChainIds(): number[];
+declare function uniswapV4SubgraphUrlForChain(chainId: number, apiKey?: string): string;
+declare function resolveTheGraphApiKey(override?: string): string | undefined;
+declare function fetchUniswapV4PoolHourDatas(args: {
+    chainId: number;
+    poolReference: string;
+    fromSec: number;
+    toSec: number;
+    maxPages?: number;
+}): Promise<{
+    rows: UniswapV4SubgraphPoolHourRow[];
+    truncated: boolean;
+}>;
+declare function fetchUniswapV4PoolDayDatas(args: {
+    chainId: number;
+    poolReference: string;
+    fromSec: number;
+    toSec: number;
+    maxPages?: number;
+}): Promise<{
+    rows: UniswapV4SubgraphPoolDayRow[];
+    truncated: boolean;
+}>;
+declare function fetchUniswapV4Swaps(args: {
+    chainId: number;
+    poolReference: string;
+    fromSec: number;
+    toSec: number;
+    maxPages?: number;
+}): Promise<{
+    rows: UniswapV4SubgraphSwapRow[];
+    truncated: boolean;
+}>;
+declare function fetchUniswapV4PoolMeta(args: {
+    chainId: number;
+    poolReference: string;
+}): Promise<UniswapV4SubgraphPoolMeta | null>;
+
+declare const UNISWAP_V4_OHLCV_INTERVALS: readonly ["1m", "5m", "15m", "30m", "1h", "2h", "4h", "6h", "8h", "12h", "1d", "2d", "3d", "1w", "1M"];
+type UniswapV4OhlcvInterval = (typeof UNISWAP_V4_OHLCV_INTERVALS)[number];
+type UniswapV4OhlcvDataTier = {
+    kind: 'subgraph_native';
+    entity: 'hourly' | 'daily';
+    bucketSec: number;
+    interval: UniswapV4OhlcvInterval;
+} | {
+    kind: 'subgraph_aggregate';
+    baseEntity: 'hourly' | 'daily';
+    bucketSec: number;
+    interval: UniswapV4OhlcvInterval;
+} | {
+    kind: 'swaps';
+    bucketSec: number;
+    interval: UniswapV4OhlcvInterval;
+};
+declare function assertUniswapV4OhlcvInterval(interval: string): UniswapV4OhlcvInterval;
+declare function uniswapV4OhlcvIntervalToBucketSec(interval: UniswapV4OhlcvInterval): number;
+declare function resolveUniswapV4OhlcvDataTier(intervalRaw: string): UniswapV4OhlcvDataTier;
+
+type UniswapV4OhlcvCandleRow = {
+    timestampMs: number;
+    open: string;
+    high: string;
+    low: string;
+    close: string;
+    volume?: string;
+};
+declare function bucketUniswapV4SwapsIntoCandles(args: {
+    swaps: UniswapV4SubgraphSwapRow[];
+    bucketSec: number;
+}): UniswapV4OhlcvCandleRow[];
+
+type UniswapV4OhlcvQuoteToken = 'token0' | 'token1';
+type UniswapV4OhlcvFetchResult = {
+    symbol: string;
+    timeframe: UniswapV4OhlcvInterval;
+    chainId: number;
+    poolReference: string;
+    dataSource: 'subgraph_native' | 'subgraph_aggregate' | 'swaps';
+    baseSubgraphEntity?: 'hourly' | 'daily';
+    priceQuote: 'token0PerToken1' | 'token1PerToken0';
+    startTimeMs?: number;
+    endTimeMs?: number;
+    candleCount: number;
+    candles: UniswapV4OhlcvCandleRow[];
+    fetchedAtMs: number;
+    warnings?: string[];
+};
+type ResolvedPool = {
+    poolReference: string;
+    pairLabel: string;
+    token0Symbol?: string;
+    token1Symbol?: string;
+};
+declare function aggregateOhlcvCandles(bars: UniswapV4OhlcvCandleRow[], bucketSec: number): UniswapV4OhlcvCandleRow[];
+declare function resolveUniswapV4OhlcvPool(args: {
+    chainId: number | string;
+    poolPreset?: string;
+    poolReference?: string;
+    existingPool?: {
+        token0Address: string;
+        token1Address: string;
+        poolReference?: string;
+        fee?: number;
+        tickSpacing?: number;
+        hooks?: string;
+    };
+}): Promise<ResolvedPool>;
+declare function uniswapV4FetchOhlcv(args: {
+    chainId: number | string;
+    interval?: string;
+    poolPreset?: string;
+    poolReference?: string;
+    existingPool?: {
+        token0Address: string;
+        token1Address: string;
+        poolReference?: string;
+        fee?: number;
+        tickSpacing?: number;
+        hooks?: string;
+    };
+    quoteToken?: UniswapV4OhlcvQuoteToken;
+    lookbackDays?: number;
+    lookbackHours?: number;
+    startTimeMs?: number;
+    endTimeMs?: number;
+}): Promise<UniswapV4OhlcvFetchResult>;
+
 declare const UNISWAP_V4_PROTOCOL_ID = "uniswap-v4";
 declare const uniswapV4ProtocolModule: ProtocolModule;
 
@@ -682,4 +859,4 @@ declare const uniswapV4: {
     isChainSupported: typeof isUniswapV4ChainSupported;
 };
 
-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_POOL_LOOKUP_HINT, 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 UniswapV4PoolKeyInput, type UniswapV4PositionRow, type UniswapV4PositionScanProgress, type UniswapV4RegistryErc721Row, type UniswapV4SessionPayload, type UniswapV4StandardLpPoolRow, applySlippagePercentToApproveWei, buildEvmMultisignBodyUniswapV4CollectFeesBatch, buildEvmMultisignBodyUniswapV4DecreaseLiquidityBatch, buildEvmMultisignBodyUniswapV4IncreaseLiquidityBatch, buildEvmMultisignBodyUniswapV4MintLiquidityBatch, buildEvmMultisignBodyUniswapV4SkipPermit2Batch, buildUniswapQuoteRequestBody, buildUniswapV4PurposePrefill, computeUniswapV4PoolReference, computeUniswapV4Session, createSwap, errorMessageFromUniswapJsonBody, extractUniswapLpTokenAmounts, extractUniswapLpTransaction, fetchEthereumAddressForKeyGen, formatUniswapAmountFieldFromWei, formatUniswapLpAmountHuman, formatUniswapPercentForUi, formatUniswapQuoteForDisplay, formatUniswapV4PositionNotFoundError, getClassicQuoteFromStoredUniswapResponse, getUniswapUniversalRouterSpenderOrThrow, getUniswapV4PositionManagerDeployBlock, getUniswapV4PositionManagerOrThrow, isEthGetLogsBlockRangeTooLargeError, isNativeUniswapLpTokenAddress, isUniswapFullQuoteResponseNativeIn, isUniswapTokenInAddressNative, isUniswapV4ChainSupported, isUniswapV4LiquidityEvmSignRequest, isUniswapV4SwapEvmSignRequest, listUniswapV4PositionsForWallet, listUniswapV4StandardLpPools, messageFromUniswapHttpResponseBody, parseUniswapChainId, parseUniswapLpApiSnapshot, parseUniswapQuoteClassicInOut, parseUniswapQuoteSlippageInfo, parseUniswapV4ScanFromDateYmd, quoteSwap, readUniswapV4PositionInfoRaw, resolveBlockAtOrAfterUnixTime, resolveRouterSwapGasUnitsFromSignRequest, resolveUniswapV4LpExistingPoolFromKey, resolveUniswapV4LpPoolPreset, resolveUniswapV4PositionScanFromDate, sortUniswapV4PoolCurrencies, swapExactInput, swapFromQuote, swapTransactionDeadlineUnixFromExpiryMinutes, tryGetUniswapV4PositionManager, uniswapCreateSwap, uniswapLpClaimFees, uniswapLpCreatePosition, uniswapLpDecreasePosition, uniswapLpIncreasePosition, uniswapLpTxFieldForAction, uniswapQuoteToJsonQuoteOneLine, uniswapTradeQuote, uniswapV4, uniswapV4ListPositionsForMcp, uniswapV4ListPositionsFromRegistryForMcp, uniswapV4ListPositionsRegistryMcpPlaceholder, uniswapV4ListStandardLpPools, uniswapV4PositionMintedTokenIdsFromReceipt, uniswapV4ProtocolModule, uniswapV4RegisterPositionFromMintTxPlaceholder, uniswapV4RegisterPositionNftPlaceholder };
+export { MAX_UINT160, MAX_UINT48, PERMIT2_ADDRESS, type SwapExactInputArgs, THE_GRAPH_API_KEY_DOCS_URL, THE_GRAPH_API_KEY_ENV, THE_GRAPH_API_KEY_SIGNUP_URL, 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_POOL_LOOKUP_HINT, UNISWAP_V4_LP_POSITION_REGISTRY_HINT, UNISWAP_V4_LP_WETH_DEPOSIT_FALLBACK, UNISWAP_V4_OHLCV_INTERVALS, UNISWAP_V4_PROTOCOL_ID, UNISWAP_V4_SUBGRAPH_ID_BY_CHAIN_ID, type UniswapLpAction, type UniswapLpExistingPool, type UniswapLpIndependentToken, type UniswapLpNewPool, type UniswapLpPriceBounds, type UniswapLpProtocol, type UniswapLpTickBounds, type UniswapLpTokenAmount, type UniswapLpTransactionRequest, type UniswapQuoteTradeType, type UniswapTradeQuoteParams, type UniswapV4OhlcvCandleRow, type UniswapV4OhlcvDataTier, type UniswapV4OhlcvFetchResult, type UniswapV4OhlcvInterval, type UniswapV4OhlcvQuoteToken, type UniswapV4PoolKeyInput, type UniswapV4PositionRow, type UniswapV4PositionScanProgress, type UniswapV4RegistryErc721Row, type UniswapV4SessionPayload, type UniswapV4StandardLpPoolRow, type UniswapV4SubgraphPoolDayRow, type UniswapV4SubgraphPoolHourRow, type UniswapV4SubgraphPoolMeta, type UniswapV4SubgraphSwapRow, aggregateOhlcvCandles, applySlippagePercentToApproveWei, assertUniswapV4OhlcvInterval, bucketUniswapV4SwapsIntoCandles, buildEvmMultisignBodyUniswapV4CollectFeesBatch, buildEvmMultisignBodyUniswapV4DecreaseLiquidityBatch, buildEvmMultisignBodyUniswapV4IncreaseLiquidityBatch, buildEvmMultisignBodyUniswapV4MintLiquidityBatch, buildEvmMultisignBodyUniswapV4SkipPermit2Batch, buildUniswapQuoteRequestBody, buildUniswapV4PurposePrefill, computeUniswapV4PoolReference, computeUniswapV4Session, createSwap, errorMessageFromUniswapJsonBody, extractUniswapLpTokenAmounts, extractUniswapLpTransaction, fetchEthereumAddressForKeyGen, fetchUniswapV4PoolDayDatas, fetchUniswapV4PoolHourDatas, fetchUniswapV4PoolMeta, fetchUniswapV4Swaps, formatUniswapAmountFieldFromWei, formatUniswapLpAmountHuman, formatUniswapPercentForUi, formatUniswapQuoteForDisplay, formatUniswapV4PositionNotFoundError, getClassicQuoteFromStoredUniswapResponse, getUniswapUniversalRouterSpenderOrThrow, getUniswapV4PositionManagerDeployBlock, getUniswapV4PositionManagerOrThrow, isEthGetLogsBlockRangeTooLargeError, isNativeUniswapLpTokenAddress, isTheGraphRateLimitOrAuthError, isUniswapFullQuoteResponseNativeIn, isUniswapTokenInAddressNative, isUniswapV4ChainSupported, isUniswapV4LiquidityEvmSignRequest, isUniswapV4SwapEvmSignRequest, listUniswapV4PositionsForWallet, listUniswapV4StandardLpPools, messageFromUniswapHttpResponseBody, parseUniswapChainId, parseUniswapLpApiSnapshot, parseUniswapQuoteClassicInOut, parseUniswapQuoteSlippageInfo, parseUniswapV4ScanFromDateYmd, quoteSwap, readUniswapV4PositionInfoRaw, resolveBlockAtOrAfterUnixTime, resolveRouterSwapGasUnitsFromSignRequest, resolveTheGraphApiKey, resolveUniswapV4LpExistingPoolFromKey, resolveUniswapV4LpPoolPreset, resolveUniswapV4OhlcvDataTier, resolveUniswapV4OhlcvPool, resolveUniswapV4PositionScanFromDate, sortUniswapV4PoolCurrencies, swapExactInput, swapFromQuote, swapTransactionDeadlineUnixFromExpiryMinutes, theGraphApiKeyVariablesHint, theGraphRateLimitErrorMessage, tryGetUniswapV4PositionManager, uniswapCreateSwap, uniswapLpClaimFees, uniswapLpCreatePosition, uniswapLpDecreasePosition, uniswapLpIncreasePosition, uniswapLpTxFieldForAction, uniswapQuoteToJsonQuoteOneLine, uniswapTradeQuote, uniswapV4, uniswapV4FetchOhlcv, uniswapV4ListPositionsForMcp, uniswapV4ListPositionsFromRegistryForMcp, uniswapV4ListPositionsRegistryMcpPlaceholder, uniswapV4ListStandardLpPools, uniswapV4OhlcvIntervalToBucketSec, uniswapV4PositionMintedTokenIdsFromReceipt, uniswapV4ProtocolModule, uniswapV4RegisterPositionFromMintTxPlaceholder, uniswapV4RegisterPositionNftPlaceholder, uniswapV4SubgraphIdForChain, uniswapV4SubgraphSupportedChainIds, uniswapV4SubgraphUrlForChain };