@cetusprotocol/aggregator-sdk 1.6.1 → 1.6.2

package/README.md

@@ -196,18 +196,18 @@ if (routerRes != null) {
 
 | Contract                  | Tag of Repo | Latest published at address                                        |
 | ------------------------- | ----------- | ------------------------------------------------------------------ |
-| CetusAggregatorV2         | mainnet     | 0x40e457bc65a398d2db7026881358fcb7cfa2f1bb052bca41f46c55a1103f2d6f |
+| CetusAggregatorV2         | mainnet     | 0x3a7fa58adcd7ff474ca0330c93068b139f5263c0cf9c64e702f5c4b17996ff10 |
 | CetusAggregatorV2ExtendV1 | mainnet     | 0x2edc22bf96c85482b2208624fa9339255d5055113c92fd6c33add48ce971b774 |
 | CetusAggregatorV2ExtendV2 | mainnet     | 0x2e227a3cbc6715518b18ed339d2f967153674b7b257da114ca62c72b2011258a |
 
 ## Example
 
 ```
-CetusAggregatorV2 = { git = "https://github.com/CetusProtocol/aggregator.git", subdir = "packages/cetus-aggregator-v2/mainnet", rev = "mainnet-v1.56.0", override = true }
+CetusAggregatorV2 = { git = "https://github.com/CetusProtocol/aggregator.git", subdir = "packages/cetus-aggregator-v2/mainnet", rev = "mainnet-v1.63.0", override = true }
 
-CetusAggregatorV2ExtendV1 = { git = "https://github.com/CetusProtocol/aggregator.git", subdir = "packages/cetus-aggregator-v2-extend-v1", rev = "mainnet-v1.56.0", override = true }
+CetusAggregatorV2ExtendV1 = { git = "https://github.com/CetusProtocol/aggregator.git", subdir = "packages/cetus-aggregator-v2-extend-v1", rev = "mainnet-v1.63.0", override = true }
 
-CetusAggregatorV2ExtendV2 = { git = "https://github.com/CetusProtocol/aggregator.git", subdir = "packages/cetus-aggregator-v2-extend-v2", rev = "mainnet-v1.56.0", override = true }
+CetusAggregatorV2ExtendV2 = { git = "https://github.com/CetusProtocol/aggregator.git", subdir = "packages/cetus-aggregator-v2-extend-v2", rev = "mainnet-v1.63.0", override = true }
 ```
 
 # Simple Aggregator Contract Interface
@@ -218,12 +218,12 @@ CetusAggregatorV2ExtendV2 = { git = "https://github.com/CetusProtocol/aggregator
 
 | Contract              | Tag of Repo | Latest published at address                                        |
 | --------------------- | ----------- | ------------------------------------------------------------------ |
-| CetusAggregatorSimple | mainnet     | 0x54394cb5bceb8073c60df0964b904a607c9974ef771d9e8b3f9c45b8ce075499 |
+| CetusAggregatorSimple | mainnet     | 0xf44ab76524a6b22a175968ae193a13f4905aea9b805afb6db51655b6b59db69e |
 
 ## Example
 
 ```
-CetusAggregatorSimple = { git = "https://github.com/CetusProtocol/aggregator.git", subdir = "packages/cetus-aggregator-v2/simple-mainnet", rev = "mainnet-v1.58.0", override = true }
+CetusAggregatorSimple = { git = "https://github.com/CetusProtocol/aggregator.git", subdir = "packages/cetus-aggregator-v2/simple-mainnet", rev = "mainnet-v1.63.0", override = true }
 ```
 
 ## Usage

package/dist/index.cjs

@@ -3416,7 +3416,7 @@ var AGGREGATOR_V3_CONFIG = {
 };
 
 // src/api.ts
-var SDK_VERSION = 1010601;
+var SDK_VERSION = 1010602;
 function parseRouterResponse(data, byAmountIn) {
   let packages = /* @__PURE__ */ new Map();
   if (data.packages) {
@@ -7822,20 +7822,56 @@ function transferOrDestroyCoin(params, txb) {
   });
 }
 var MAX_ARGUMENT_SIZE = 16 * 1024;
+var DEFAULT_HERMES_URL = "https://hermes.pyth.network";
+var DEFAULT_AVAILABILITY_TIMEOUT = 3e3;
+var DEFAULT_IS_AVAILABLE_STATUS = (status) => status >= 200 && status < 400;
 var PythAdapter = class {
   constructor(client, pythStateId, wormholeStateId, hermesUrls) {
     this.priceFeedObjectIdCache = /* @__PURE__ */ new Map();
     this.client = client;
     this.pythStateId = pythStateId;
     this.wormholeStateId = wormholeStateId;
-    const urls = [...hermesUrls];
-    if (!urls.includes("https://hermes.pyth.network")) {
-      urls.push("https://hermes.pyth.network");
+    const urls = Array.from(
+      new Set(hermesUrls.filter(Boolean).map(normalizeServiceUrl))
+    );
+    if (!urls.includes(DEFAULT_HERMES_URL)) {
+      urls.push(DEFAULT_HERMES_URL);
     }
+    this.hermesUrls = urls;
     this.hermesClients = urls.map(
       (url) => new hermesClient.HermesClient(url, { timeout: 3e3 })
     );
   }
+  getHermesUrls() {
+    return [...this.hermesUrls];
+  }
+  async checkHermesAvailability({
+    timeout = DEFAULT_AVAILABILITY_TIMEOUT,
+    isAvailableStatus = DEFAULT_IS_AVAILABLE_STATUS
+  } = {}) {
+    if (this.hermesUrls.length === 0) {
+      return {
+        checked: false,
+        availableUrls: [],
+        unavailableUrls: []
+      };
+    }
+    const results = await Promise.all(
+      this.hermesUrls.map(async (url) => ({
+        url,
+        available: await checkServiceUrl(url, timeout, isAvailableStatus)
+      }))
+    );
+    return {
+      checked: true,
+      availableUrls: results.filter((result) => result.available).map((result) => result.url),
+      unavailableUrls: results.filter((result) => !result.available).map((result) => result.url)
+    };
+  }
+  async isHermesAvailable(options) {
+    const snapshot = await this.checkHermesAvailability(options);
+    return snapshot.availableUrls.length > 0;
+  }
   async getPriceFeedsUpdateData(priceIDs) {
     let lastError = null;
     for (const hermes of this.hermesClients) {
@@ -8044,6 +8080,25 @@ var PythAdapter = class {
     return priceInfoObjects;
   }
 };
+async function checkServiceUrl(url, timeout, isAvailableStatus) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeout);
+  try {
+    const response = await fetch(url, {
+      method: "GET",
+      cache: "no-store",
+      signal: controller.signal
+    });
+    return isAvailableStatus(response.status);
+  } catch {
+    return false;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+function normalizeServiceUrl(url) {
+  return url.replace(/\/+$/, "");
+}
 
 // src/utils/uuid.ts
 function generateDowngradeUuid6() {
@@ -8948,6 +9003,12 @@ var ALL_DEXES = [
   MAGMAPROPAMM,
   HAEDALPROPAMM
 ];
+var PYTH_ORACLE_BASED_DEXES = [
+  HAEDALPMM,
+  METASTABLE,
+  STEAMM_OMM_V2,
+  HAEDALHMMV2
+];
 function getAllProviders() {
   return ALL_DEXES;
 }
@@ -9027,6 +9088,9 @@ var _AggregatorClient = class _AggregatorClient {
     this.apiKey = params.apiKey || "";
     this.partner = params.partner;
     this.cetusDlmmPartner = params.cetusDlmmPartner;
+    this.pythAvailabilityCheckInterval = validatePythAvailabilityCheckInterval(
+      params.pythAvailabilityCheckInterval
+    );
     if (params.overlayFeeRate) {
       if (params.overlayFeeRate > 0 && params.overlayFeeRate <= CLIENT_CONFIG.MAX_OVERLAY_FEE_RATE) {
         this.overlayFeeRate = params.overlayFeeRate * AGGREGATOR_V3_CONFIG.FEE_DENOMINATOR;
@@ -9069,23 +9133,74 @@ var _AggregatorClient = class _AggregatorClient {
     }
   }
   async findRouters(params) {
+    const {
+      params: routerParams,
+      providersExhausted
+    } = await this.filterProvidersByPythAvailability(params);
+    if (providersExhausted) {
+      return emptyRouterResult(routerParams.byAmountIn);
+    }
     return getRouterResult(
       this.endpoint,
       this.apiKey,
-      params,
+      routerParams,
       this.overlayFeeRate,
       this.overlayFeeReceiver
     );
   }
   async findMergeSwapRouters(params) {
+    const {
+      params: routerParams,
+      providersExhausted
+    } = await this.filterProvidersByPythAvailability(params);
+    if (providersExhausted) {
+      return emptyMergeSwapResult();
+    }
     return getMergeSwapResult(
       this.endpoint,
       this.apiKey,
-      params,
+      routerParams,
       this.overlayFeeRate,
       this.overlayFeeReceiver
     );
   }
+  async filterProvidersByPythAvailability(params) {
+    const interval = validatePythAvailabilityCheckInterval(
+      params.pythAvailabilityCheckInterval ?? this.pythAvailabilityCheckInterval
+    );
+    if (interval === void 0) {
+      return { params, providersExhausted: false };
+    }
+    const pythAvailable = await this.getPythAvailability(interval);
+    if (pythAvailable) {
+      return { params, providersExhausted: false };
+    }
+    const sourceProviders = params.providers && params.providers.length > 0 ? params.providers : ALL_DEXES;
+    const providers = sourceProviders.filter(
+      (provider) => !PYTH_ORACLE_BASED_DEXES.includes(provider)
+    );
+    return {
+      params: { ...params, providers },
+      providersExhausted: providers.length === 0
+    };
+  }
+  async getPythAvailability(interval) {
+    const now = Date.now();
+    if (this.pythAvailable !== void 0 && this.pythAvailabilityCheckedAt !== void 0 && now - this.pythAvailabilityCheckedAt < interval) {
+      return this.pythAvailable;
+    }
+    if (this.pythAvailabilityPromise) {
+      return this.pythAvailabilityPromise;
+    }
+    this.pythAvailabilityPromise = this.pythAdapter.isHermesAvailable().catch(() => false).then((available) => {
+      this.pythAvailable = available;
+      this.pythAvailabilityCheckedAt = Date.now();
+      return available;
+    }).finally(() => {
+      this.pythAvailabilityPromise = void 0;
+    });
+    return this.pythAvailabilityPromise;
+  }
   async executeFlexibleInputSwap(txb, inputCoin, routerData, expectedAmountOut, amountLimit, pythPriceIDs, partner, deepbookv3DeepFee, packages) {
   }
   newDexRouterV3(provider, pythPriceIDs, partner, cetusDlmmPartner) {
@@ -10047,6 +10162,35 @@ function generateUUID() {
     return v.toString(16);
   });
 }
+function validatePythAvailabilityCheckInterval(interval) {
+  if (interval === void 0) {
+    return void 0;
+  }
+  if (!Number.isFinite(interval) || interval < 0) {
+    throw new Error(
+      "pythAvailabilityCheckInterval must be a non-negative number"
+    );
+  }
+  return interval;
+}
+function emptyRouterResult(byAmountIn) {
+  return {
+    quoteID: "",
+    amountIn: ZERO,
+    amountOut: ZERO,
+    paths: [],
+    byAmountIn,
+    insufficientLiquidity: true,
+    deviationRatio: 0
+  };
+}
+function emptyMergeSwapResult() {
+  return {
+    quoteID: "",
+    totalAmountOut: ZERO,
+    allRoutes: []
+  };
+}
 function recordFirstCoinIndex(paths) {
   let newCoinRecord = /* @__PURE__ */ new Map();
   for (let i = 0; i < paths.length; i++) {
@@ -10186,6 +10330,7 @@ exports.PAY_MODULE = PAY_MODULE;
 exports.POOL_MODULT = POOL_MODULT;
 exports.PUBLISHED_ADDRESSES = PUBLISHED_ADDRESSES;
 exports.PYTH_CONFIG = PYTH_CONFIG;
+exports.PYTH_ORACLE_BASED_DEXES = PYTH_ORACLE_BASED_DEXES;
 exports.PYTH_PRELUDE_CALLS = PYTH_PRELUDE_CALLS;
 exports.REPAY_FLASH_SWAP_A2B_FUNC = REPAY_FLASH_SWAP_A2B_FUNC;
 exports.REPAY_FLASH_SWAP_B2A_FUNC = REPAY_FLASH_SWAP_B2A_FUNC;

package/dist/index.d.cts

@@ -15,6 +15,7 @@ interface FindRouterParams {
     splitFactor?: number;
     splitCount?: number;
     providers?: string[];
+    pythAvailabilityCheckInterval?: number;
     liquidityChanges?: PreSwapLpChangeParams[];
 }
 interface MergeSwapFromCoin {
@@ -26,6 +27,7 @@ interface MergeSwapParams {
     byAmountIn: boolean;
     depth?: number;
     providers?: string[];
+    pythAvailabilityCheckInterval?: number;
     froms: MergeSwapFromCoin[];
 }
 interface MergeSwapInputCoin {
@@ -277,9 +279,19 @@ interface PriceTableInfo {
     id: ObjectId;
     fieldType: string;
 }
+interface PythAvailabilitySnapshot {
+    checked: boolean;
+    availableUrls: string[];
+    unavailableUrls: string[];
+}
+interface PythAvailabilityOptions {
+    timeout?: number;
+    isAvailableStatus?: (status: number) => boolean;
+}
 declare class PythAdapter {
     private client;
     private hermesClients;
+    private hermesUrls;
     private pythStateId;
     private wormholeStateId;
     private pythPackageId;
@@ -288,6 +300,9 @@ declare class PythAdapter {
     private priceFeedObjectIdCache;
     private baseUpdateFee;
     constructor(client: SuiGrpcClient, pythStateId: ObjectId, wormholeStateId: ObjectId, hermesUrls: string[]);
+    getHermesUrls(): string[];
+    checkHermesAvailability({ timeout, isAvailableStatus, }?: PythAvailabilityOptions): Promise<PythAvailabilitySnapshot>;
+    isHermesAvailable(options?: PythAvailabilityOptions): Promise<boolean>;
     getPriceFeedsUpdateData(priceIDs: string[]): Promise<Buffer[]>;
     getBaseUpdateFee(): Promise<number>;
     getPackageId(objectId: ObjectId): Promise<string>;
@@ -340,6 +355,7 @@ declare const MAGMAPROPAMM = "MAGMAPROPAMM";
 declare const HAEDALPROPAMM = "HAEDALPROPAMM";
 declare const DEFAULT_ENDPOINT = "https://api-sui.cetus.zone/router_v3";
 declare const ALL_DEXES: string[];
+declare const PYTH_ORACLE_BASED_DEXES: string[];
 type BuildRouterSwapParamsV3 = {
     router: RouterDataV3;
     inputCoin: TransactionObjectArgument;
@@ -407,6 +423,7 @@ type AggregatorClientParams = {
     overlayFeeRate?: number;
     overlayFeeReceiver?: string;
     cetusDlmmPartner?: string;
+    pythAvailabilityCheckInterval?: number;
 };
 declare class AggregatorClient {
     endpoint: string;
@@ -419,6 +436,10 @@ declare class AggregatorClient {
     protected overlayFeeReceiver: string;
     protected partner?: string;
     protected cetusDlmmPartner?: string;
+    private pythAvailabilityCheckInterval?;
+    private pythAvailabilityCheckedAt?;
+    private pythAvailable?;
+    private pythAvailabilityPromise?;
     private static readonly CONFIG;
     constructor(params: AggregatorClientParams);
     deepbookv3DeepFeeType(): string;
@@ -426,6 +447,8 @@ declare class AggregatorClient {
     getOneCoinUsedToMerge(coinType: string): Promise<string | null>;
     findRouters(params: FindRouterParams): Promise<RouterDataV3 | null>;
     findMergeSwapRouters(params: MergeSwapParams): Promise<MergeSwapRouterData | null>;
+    private filterProvidersByPythAvailability;
+    private getPythAvailability;
     executeFlexibleInputSwap(txb: Transaction, inputCoin: TransactionObjectArgument, routerData: RouterDataV3, expectedAmountOut: string, amountLimit: string, pythPriceIDs: Map<string, string>, partner?: string, deepbookv3DeepFee?: TransactionObjectArgument, packages?: Map<string, string>): Promise<void>;
     newDexRouterV3(provider: string, pythPriceIDs: Map<string, string>, partner?: string, cetusDlmmPartner?: string): DexRouter;
     expectInputSwapV3(txb: Transaction, inputCoin: TransactionObjectArgument, routerData: RouterDataV3, expectAmountOut: string, amountOutLimit: string, pythPriceIDs: Map<string, string>, partner?: string, cetusDlmmPartner?: string): TransactionObjectArgument;
@@ -1176,4 +1199,4 @@ declare class CoinUtils {
     static calculateTotalBalance(coins: CoinAsset[]): bigint;
 }
 
-export { AFSUI, AFTERMATH, AFTERMATH_AMM, AFTERMATH_MODULE, AGGREGATOR, AGGREGATOR_V3_CONFIG, ALL_DEXES, ALPHAFI, AggregatorClient, type AggregatorClientParams, AggregatorConfig, AggregatorError, type AggregatorErrorCode, type AggregatorResponse, AggregatorServerErrorCode, BLUEFIN, BLUEMOVE, BOLT, type BigNumber, type BuildCoinResult, type BuildFastMergeSwapParams, type BuildFastRouterSwapParams, type BuildFastRouterSwapParamsV2, type BuildFastRouterSwapParamsV3, type BuildMergeSwapParams, type BuildRouterSwapParams, type BuildRouterSwapParamsV2, type BuildRouterSwapParamsV3, type BuildSponsoredTransactionParams, CETUS, CETUSDLMM, CETUS_DEX, CETUS_MODULE, CETUS_PUBLISHED_AT, CHECK_COINS_THRESHOLD_FUNC, CLIENT_CONFIG, CLOCK_ADDRESS, type CoinAsset, CoinInfoAddress, CoinStoreAddress, CoinUtils, type ComparisonResult, ConfigErrorCode, DEEPBOOKV2, DEEPBOOKV3, DEEPBOOK_CLOB_V2_MODULE, DEEPBOOK_CUSTODIAN_V2_MODULE, DEEPBOOK_DEX, DEEPBOOK_MODULE, DEEPBOOK_PACKAGE_ID, DEEPBOOK_PUBLISHED_AT, DEEPBOOK_V3_DEEP_FEE_TYPES, DEFAULT_AGG_V2_ENDPOINT, DEFAULT_AGG_V3_ENDPOINT, DEFAULT_ENDPOINT, DEFAULT_GAS_BUDGET_FOR_MERGE, DEFAULT_GAS_BUDGET_FOR_SPLIT, DEFAULT_GAS_BUDGET_FOR_STAKE, DEFAULT_GAS_BUDGET_FOR_TRANSFER, DEFAULT_GAS_BUDGET_FOR_TRANSFER_SUI, DEFAULT_NFT_TRANSFER_GAS_FEE, type DeepbookV3Config, type DeepbookV3ConfigResponse, type Dex, Env, type ExtendedDetails, FERRACLMM, FERRADLMM, FLOWXV2, FLOWXV3, FLOWX_AMM, FLOWX_AMM_MODULE, FULLSAIL, type FindRouterParams, FlashSwapA2BFunc, FlashSwapB2AFunc, FlashSwapFunc, FlashSwapWithPartnerA2BFunc, FlashSwapWithPartnerB2AFunc, FlashSwapWithPartnerFunc, type FlattenedPath, GAS_SYMBOL, GAS_TYPE_ARG, GAS_TYPE_ARG_LONG, type GasMetrics, type GetOrCreateAccountCapResult, HAEDAL, HAEDALHMMV2, HAEDALPMM, HAEDALPROPAMM, HAWAL, INTEGRATE, JOIN_FUNC, KRIYA, KRIYAV3, KRIYA_DEX, KRIYA_MODULE, MAGMA, MAGMAPROPAMM, MAINNET_AFTERMATH_INSURANCE_FUND_ID, MAINNET_AFTERMATH_PROTOCOL_FEE_VAULT_ID, MAINNET_AFTERMATH_REFERRAL_VAULT_ID, MAINNET_AFTERMATH_REGISTRY_ID, MAINNET_AFTERMATH_TREASURY_ID, MAINNET_CETUS_V3_PUBLISHED_AT, MAINNET_FLOWX_AMM_CONTAINER_ID, METASTABLE, MOMENTUM, type MergeRoute, type MergeSwapFromCoin, type MergeSwapInputCoin, type MergeSwapParams, type MergeSwapRouterData, type NFT, OBRIC, ONE, PACKAGE_NAMES, PAY_MODULE, POOL_MODULT, PUBLISHED_ADDRESSES, PYTH_CONFIG, PYTH_PRELUDE_CALLS, type Package, type Path, type PathV2, type PreSwapLpChangeParams, type ProcessedRouterData, type PythConfig, REPAY_FLASH_SWAP_A2B_FUNC, REPAY_FLASH_SWAP_B2A_FUNC, REPAY_FLASH_SWAP_WITH_PARTNER_A2B_FUNC, REPAY_FLASH_SWAP_WITH_PARTNER_B2A_FUNC, RepayFalshSwapFunc, RepayFlashSwapWithPartnerFunc, type Router, type RouterData, type RouterDataV2, type RouterDataV3, type RouterError, type RouterV2, SCALLOP, SEVENK, SPRINGSUI, STEAMM, STEAMM_OMM, STEAMM_OMM_V2, SUILEND, SUI_SYSTEM_STATE_OBJECT_ID, SWAP_A2B_FUNC, SWAP_B2A_FUNC, SWAP_GAS_BUDGET_TABLE, type SimulateTransactionResult, type SuiAddress, type SuiBasicTypes, type SuiInputTypes, type SuiMoveObject, type SuiObjectIdType, type SuiResource, type SuiStructTag, type SuiTxArg, SuiZeroCoinFn, type SwapGasAnalysis, type SwapInPoolsParams, type SwapInPoolsResultV3, TEN_POW_NINE, TESTNET_AFTERMATH_INSURANCE_FUND_ID, TESTNET_AFTERMATH_PROTOCOL_FEE_VAULT_ID, TESTNET_AFTERMATH_REFERRAL_VAULT_ID, TESTNET_AFTERMATH_REGISTRY_ID, TESTNET_AFTERMATH_TREASURY_ID, TESTNET_CETUS_V3_PUBLISHED_AT, TESTNET_FLOWX_AMM_CONTAINER_ID, TRANSFER_ACCOUNT_CAP, TRANSFER_OR_DESTORY_COIN_FUNC, TURBOS, TURBOS_DEX, TURBOS_MODULE, TURBOS_VERSIONED, TWO, TransactionErrorCode, TypesErrorCode, U128, U64_MAX, U64_MAX_BN, UTILS_MODULE, VOLO, ZERO, buildInputCoin, calculateGasEfficiency, calculatePriceImpact, checkInvalidSuiAddress, compareCoins, compareGasMetrics, completionCoin, composeType, createTarget, dealWithFastRouterSwapParamsForMsafe, estimateSwapGasBudget, exportToCSV, exportToJSON, extractAddressFromType, extractGasMetrics, extractStructTagFromType, extractTimestampFromDowngradeUuid6, fixSuiObjectId, formatGasMetrics, generateDowngradeUuid6, generateSimpleDowngradeUuid6, getAggregatorServerErrorMessage, getAggregatorV2Extend2PublishedAt, getAggregatorV2ExtendPublishedAt, getAggregatorV2PublishedAt, getAllProviders, getDeepbookV3Config, getDefaultSuiInputType, getMergeSwapResult, getOrCreateAccountCap, getProvidersExcluding, getProvidersIncluding, getRouterResult, hasPythPrelude, isSortedSymbols, isValidDowngradeUuid6, lookupGasBudget, mintZeroCoin, normalizeCoinType, parseAftermathFeeType, parseTurbosPoolFeeType, patchFixSuiObjectId, printTransaction, processEndpoint, processFlattenRoutes, restituteMsafeFastRouterSwapParams };
+export { AFSUI, AFTERMATH, AFTERMATH_AMM, AFTERMATH_MODULE, AGGREGATOR, AGGREGATOR_V3_CONFIG, ALL_DEXES, ALPHAFI, AggregatorClient, type AggregatorClientParams, AggregatorConfig, AggregatorError, type AggregatorErrorCode, type AggregatorResponse, AggregatorServerErrorCode, BLUEFIN, BLUEMOVE, BOLT, type BigNumber, type BuildCoinResult, type BuildFastMergeSwapParams, type BuildFastRouterSwapParams, type BuildFastRouterSwapParamsV2, type BuildFastRouterSwapParamsV3, type BuildMergeSwapParams, type BuildRouterSwapParams, type BuildRouterSwapParamsV2, type BuildRouterSwapParamsV3, type BuildSponsoredTransactionParams, CETUS, CETUSDLMM, CETUS_DEX, CETUS_MODULE, CETUS_PUBLISHED_AT, CHECK_COINS_THRESHOLD_FUNC, CLIENT_CONFIG, CLOCK_ADDRESS, type CoinAsset, CoinInfoAddress, CoinStoreAddress, CoinUtils, type ComparisonResult, ConfigErrorCode, DEEPBOOKV2, DEEPBOOKV3, DEEPBOOK_CLOB_V2_MODULE, DEEPBOOK_CUSTODIAN_V2_MODULE, DEEPBOOK_DEX, DEEPBOOK_MODULE, DEEPBOOK_PACKAGE_ID, DEEPBOOK_PUBLISHED_AT, DEEPBOOK_V3_DEEP_FEE_TYPES, DEFAULT_AGG_V2_ENDPOINT, DEFAULT_AGG_V3_ENDPOINT, DEFAULT_ENDPOINT, DEFAULT_GAS_BUDGET_FOR_MERGE, DEFAULT_GAS_BUDGET_FOR_SPLIT, DEFAULT_GAS_BUDGET_FOR_STAKE, DEFAULT_GAS_BUDGET_FOR_TRANSFER, DEFAULT_GAS_BUDGET_FOR_TRANSFER_SUI, DEFAULT_NFT_TRANSFER_GAS_FEE, type DeepbookV3Config, type DeepbookV3ConfigResponse, type Dex, Env, type ExtendedDetails, FERRACLMM, FERRADLMM, FLOWXV2, FLOWXV3, FLOWX_AMM, FLOWX_AMM_MODULE, FULLSAIL, type FindRouterParams, FlashSwapA2BFunc, FlashSwapB2AFunc, FlashSwapFunc, FlashSwapWithPartnerA2BFunc, FlashSwapWithPartnerB2AFunc, FlashSwapWithPartnerFunc, type FlattenedPath, GAS_SYMBOL, GAS_TYPE_ARG, GAS_TYPE_ARG_LONG, type GasMetrics, type GetOrCreateAccountCapResult, HAEDAL, HAEDALHMMV2, HAEDALPMM, HAEDALPROPAMM, HAWAL, INTEGRATE, JOIN_FUNC, KRIYA, KRIYAV3, KRIYA_DEX, KRIYA_MODULE, MAGMA, MAGMAPROPAMM, MAINNET_AFTERMATH_INSURANCE_FUND_ID, MAINNET_AFTERMATH_PROTOCOL_FEE_VAULT_ID, MAINNET_AFTERMATH_REFERRAL_VAULT_ID, MAINNET_AFTERMATH_REGISTRY_ID, MAINNET_AFTERMATH_TREASURY_ID, MAINNET_CETUS_V3_PUBLISHED_AT, MAINNET_FLOWX_AMM_CONTAINER_ID, METASTABLE, MOMENTUM, type MergeRoute, type MergeSwapFromCoin, type MergeSwapInputCoin, type MergeSwapParams, type MergeSwapRouterData, type NFT, OBRIC, ONE, PACKAGE_NAMES, PAY_MODULE, POOL_MODULT, PUBLISHED_ADDRESSES, PYTH_CONFIG, PYTH_ORACLE_BASED_DEXES, PYTH_PRELUDE_CALLS, type Package, type Path, type PathV2, type PreSwapLpChangeParams, type ProcessedRouterData, type PythConfig, REPAY_FLASH_SWAP_A2B_FUNC, REPAY_FLASH_SWAP_B2A_FUNC, REPAY_FLASH_SWAP_WITH_PARTNER_A2B_FUNC, REPAY_FLASH_SWAP_WITH_PARTNER_B2A_FUNC, RepayFalshSwapFunc, RepayFlashSwapWithPartnerFunc, type Router, type RouterData, type RouterDataV2, type RouterDataV3, type RouterError, type RouterV2, SCALLOP, SEVENK, SPRINGSUI, STEAMM, STEAMM_OMM, STEAMM_OMM_V2, SUILEND, SUI_SYSTEM_STATE_OBJECT_ID, SWAP_A2B_FUNC, SWAP_B2A_FUNC, SWAP_GAS_BUDGET_TABLE, type SimulateTransactionResult, type SuiAddress, type SuiBasicTypes, type SuiInputTypes, type SuiMoveObject, type SuiObjectIdType, type SuiResource, type SuiStructTag, type SuiTxArg, SuiZeroCoinFn, type SwapGasAnalysis, type SwapInPoolsParams, type SwapInPoolsResultV3, TEN_POW_NINE, TESTNET_AFTERMATH_INSURANCE_FUND_ID, TESTNET_AFTERMATH_PROTOCOL_FEE_VAULT_ID, TESTNET_AFTERMATH_REFERRAL_VAULT_ID, TESTNET_AFTERMATH_REGISTRY_ID, TESTNET_AFTERMATH_TREASURY_ID, TESTNET_CETUS_V3_PUBLISHED_AT, TESTNET_FLOWX_AMM_CONTAINER_ID, TRANSFER_ACCOUNT_CAP, TRANSFER_OR_DESTORY_COIN_FUNC, TURBOS, TURBOS_DEX, TURBOS_MODULE, TURBOS_VERSIONED, TWO, TransactionErrorCode, TypesErrorCode, U128, U64_MAX, U64_MAX_BN, UTILS_MODULE, VOLO, ZERO, buildInputCoin, calculateGasEfficiency, calculatePriceImpact, checkInvalidSuiAddress, compareCoins, compareGasMetrics, completionCoin, composeType, createTarget, dealWithFastRouterSwapParamsForMsafe, estimateSwapGasBudget, exportToCSV, exportToJSON, extractAddressFromType, extractGasMetrics, extractStructTagFromType, extractTimestampFromDowngradeUuid6, fixSuiObjectId, formatGasMetrics, generateDowngradeUuid6, generateSimpleDowngradeUuid6, getAggregatorServerErrorMessage, getAggregatorV2Extend2PublishedAt, getAggregatorV2ExtendPublishedAt, getAggregatorV2PublishedAt, getAllProviders, getDeepbookV3Config, getDefaultSuiInputType, getMergeSwapResult, getOrCreateAccountCap, getProvidersExcluding, getProvidersIncluding, getRouterResult, hasPythPrelude, isSortedSymbols, isValidDowngradeUuid6, lookupGasBudget, mintZeroCoin, normalizeCoinType, parseAftermathFeeType, parseTurbosPoolFeeType, patchFixSuiObjectId, printTransaction, processEndpoint, processFlattenRoutes, restituteMsafeFastRouterSwapParams };

package/dist/index.d.ts

@@ -15,6 +15,7 @@ interface FindRouterParams {
     splitFactor?: number;
     splitCount?: number;
     providers?: string[];
+    pythAvailabilityCheckInterval?: number;
     liquidityChanges?: PreSwapLpChangeParams[];
 }
 interface MergeSwapFromCoin {
@@ -26,6 +27,7 @@ interface MergeSwapParams {
     byAmountIn: boolean;
     depth?: number;
     providers?: string[];
+    pythAvailabilityCheckInterval?: number;
     froms: MergeSwapFromCoin[];
 }
 interface MergeSwapInputCoin {
@@ -277,9 +279,19 @@ interface PriceTableInfo {
     id: ObjectId;
     fieldType: string;
 }
+interface PythAvailabilitySnapshot {
+    checked: boolean;
+    availableUrls: string[];
+    unavailableUrls: string[];
+}
+interface PythAvailabilityOptions {
+    timeout?: number;
+    isAvailableStatus?: (status: number) => boolean;
+}
 declare class PythAdapter {
     private client;
     private hermesClients;
+    private hermesUrls;
     private pythStateId;
     private wormholeStateId;
     private pythPackageId;
@@ -288,6 +300,9 @@ declare class PythAdapter {
     private priceFeedObjectIdCache;
     private baseUpdateFee;
     constructor(client: SuiGrpcClient, pythStateId: ObjectId, wormholeStateId: ObjectId, hermesUrls: string[]);
+    getHermesUrls(): string[];
+    checkHermesAvailability({ timeout, isAvailableStatus, }?: PythAvailabilityOptions): Promise<PythAvailabilitySnapshot>;
+    isHermesAvailable(options?: PythAvailabilityOptions): Promise<boolean>;
     getPriceFeedsUpdateData(priceIDs: string[]): Promise<Buffer[]>;
     getBaseUpdateFee(): Promise<number>;
     getPackageId(objectId: ObjectId): Promise<string>;
@@ -340,6 +355,7 @@ declare const MAGMAPROPAMM = "MAGMAPROPAMM";
 declare const HAEDALPROPAMM = "HAEDALPROPAMM";
 declare const DEFAULT_ENDPOINT = "https://api-sui.cetus.zone/router_v3";
 declare const ALL_DEXES: string[];
+declare const PYTH_ORACLE_BASED_DEXES: string[];
 type BuildRouterSwapParamsV3 = {
     router: RouterDataV3;
     inputCoin: TransactionObjectArgument;
@@ -407,6 +423,7 @@ type AggregatorClientParams = {
     overlayFeeRate?: number;
     overlayFeeReceiver?: string;
     cetusDlmmPartner?: string;
+    pythAvailabilityCheckInterval?: number;
 };
 declare class AggregatorClient {
     endpoint: string;
@@ -419,6 +436,10 @@ declare class AggregatorClient {
     protected overlayFeeReceiver: string;
     protected partner?: string;
     protected cetusDlmmPartner?: string;
+    private pythAvailabilityCheckInterval?;
+    private pythAvailabilityCheckedAt?;
+    private pythAvailable?;
+    private pythAvailabilityPromise?;
     private static readonly CONFIG;
     constructor(params: AggregatorClientParams);
     deepbookv3DeepFeeType(): string;
@@ -426,6 +447,8 @@ declare class AggregatorClient {
     getOneCoinUsedToMerge(coinType: string): Promise<string | null>;
     findRouters(params: FindRouterParams): Promise<RouterDataV3 | null>;
     findMergeSwapRouters(params: MergeSwapParams): Promise<MergeSwapRouterData | null>;
+    private filterProvidersByPythAvailability;
+    private getPythAvailability;
     executeFlexibleInputSwap(txb: Transaction, inputCoin: TransactionObjectArgument, routerData: RouterDataV3, expectedAmountOut: string, amountLimit: string, pythPriceIDs: Map<string, string>, partner?: string, deepbookv3DeepFee?: TransactionObjectArgument, packages?: Map<string, string>): Promise<void>;
     newDexRouterV3(provider: string, pythPriceIDs: Map<string, string>, partner?: string, cetusDlmmPartner?: string): DexRouter;
     expectInputSwapV3(txb: Transaction, inputCoin: TransactionObjectArgument, routerData: RouterDataV3, expectAmountOut: string, amountOutLimit: string, pythPriceIDs: Map<string, string>, partner?: string, cetusDlmmPartner?: string): TransactionObjectArgument;
@@ -1176,4 +1199,4 @@ declare class CoinUtils {
     static calculateTotalBalance(coins: CoinAsset[]): bigint;
 }
 
-export { AFSUI, AFTERMATH, AFTERMATH_AMM, AFTERMATH_MODULE, AGGREGATOR, AGGREGATOR_V3_CONFIG, ALL_DEXES, ALPHAFI, AggregatorClient, type AggregatorClientParams, AggregatorConfig, AggregatorError, type AggregatorErrorCode, type AggregatorResponse, AggregatorServerErrorCode, BLUEFIN, BLUEMOVE, BOLT, type BigNumber, type BuildCoinResult, type BuildFastMergeSwapParams, type BuildFastRouterSwapParams, type BuildFastRouterSwapParamsV2, type BuildFastRouterSwapParamsV3, type BuildMergeSwapParams, type BuildRouterSwapParams, type BuildRouterSwapParamsV2, type BuildRouterSwapParamsV3, type BuildSponsoredTransactionParams, CETUS, CETUSDLMM, CETUS_DEX, CETUS_MODULE, CETUS_PUBLISHED_AT, CHECK_COINS_THRESHOLD_FUNC, CLIENT_CONFIG, CLOCK_ADDRESS, type CoinAsset, CoinInfoAddress, CoinStoreAddress, CoinUtils, type ComparisonResult, ConfigErrorCode, DEEPBOOKV2, DEEPBOOKV3, DEEPBOOK_CLOB_V2_MODULE, DEEPBOOK_CUSTODIAN_V2_MODULE, DEEPBOOK_DEX, DEEPBOOK_MODULE, DEEPBOOK_PACKAGE_ID, DEEPBOOK_PUBLISHED_AT, DEEPBOOK_V3_DEEP_FEE_TYPES, DEFAULT_AGG_V2_ENDPOINT, DEFAULT_AGG_V3_ENDPOINT, DEFAULT_ENDPOINT, DEFAULT_GAS_BUDGET_FOR_MERGE, DEFAULT_GAS_BUDGET_FOR_SPLIT, DEFAULT_GAS_BUDGET_FOR_STAKE, DEFAULT_GAS_BUDGET_FOR_TRANSFER, DEFAULT_GAS_BUDGET_FOR_TRANSFER_SUI, DEFAULT_NFT_TRANSFER_GAS_FEE, type DeepbookV3Config, type DeepbookV3ConfigResponse, type Dex, Env, type ExtendedDetails, FERRACLMM, FERRADLMM, FLOWXV2, FLOWXV3, FLOWX_AMM, FLOWX_AMM_MODULE, FULLSAIL, type FindRouterParams, FlashSwapA2BFunc, FlashSwapB2AFunc, FlashSwapFunc, FlashSwapWithPartnerA2BFunc, FlashSwapWithPartnerB2AFunc, FlashSwapWithPartnerFunc, type FlattenedPath, GAS_SYMBOL, GAS_TYPE_ARG, GAS_TYPE_ARG_LONG, type GasMetrics, type GetOrCreateAccountCapResult, HAEDAL, HAEDALHMMV2, HAEDALPMM, HAEDALPROPAMM, HAWAL, INTEGRATE, JOIN_FUNC, KRIYA, KRIYAV3, KRIYA_DEX, KRIYA_MODULE, MAGMA, MAGMAPROPAMM, MAINNET_AFTERMATH_INSURANCE_FUND_ID, MAINNET_AFTERMATH_PROTOCOL_FEE_VAULT_ID, MAINNET_AFTERMATH_REFERRAL_VAULT_ID, MAINNET_AFTERMATH_REGISTRY_ID, MAINNET_AFTERMATH_TREASURY_ID, MAINNET_CETUS_V3_PUBLISHED_AT, MAINNET_FLOWX_AMM_CONTAINER_ID, METASTABLE, MOMENTUM, type MergeRoute, type MergeSwapFromCoin, type MergeSwapInputCoin, type MergeSwapParams, type MergeSwapRouterData, type NFT, OBRIC, ONE, PACKAGE_NAMES, PAY_MODULE, POOL_MODULT, PUBLISHED_ADDRESSES, PYTH_CONFIG, PYTH_PRELUDE_CALLS, type Package, type Path, type PathV2, type PreSwapLpChangeParams, type ProcessedRouterData, type PythConfig, REPAY_FLASH_SWAP_A2B_FUNC, REPAY_FLASH_SWAP_B2A_FUNC, REPAY_FLASH_SWAP_WITH_PARTNER_A2B_FUNC, REPAY_FLASH_SWAP_WITH_PARTNER_B2A_FUNC, RepayFalshSwapFunc, RepayFlashSwapWithPartnerFunc, type Router, type RouterData, type RouterDataV2, type RouterDataV3, type RouterError, type RouterV2, SCALLOP, SEVENK, SPRINGSUI, STEAMM, STEAMM_OMM, STEAMM_OMM_V2, SUILEND, SUI_SYSTEM_STATE_OBJECT_ID, SWAP_A2B_FUNC, SWAP_B2A_FUNC, SWAP_GAS_BUDGET_TABLE, type SimulateTransactionResult, type SuiAddress, type SuiBasicTypes, type SuiInputTypes, type SuiMoveObject, type SuiObjectIdType, type SuiResource, type SuiStructTag, type SuiTxArg, SuiZeroCoinFn, type SwapGasAnalysis, type SwapInPoolsParams, type SwapInPoolsResultV3, TEN_POW_NINE, TESTNET_AFTERMATH_INSURANCE_FUND_ID, TESTNET_AFTERMATH_PROTOCOL_FEE_VAULT_ID, TESTNET_AFTERMATH_REFERRAL_VAULT_ID, TESTNET_AFTERMATH_REGISTRY_ID, TESTNET_AFTERMATH_TREASURY_ID, TESTNET_CETUS_V3_PUBLISHED_AT, TESTNET_FLOWX_AMM_CONTAINER_ID, TRANSFER_ACCOUNT_CAP, TRANSFER_OR_DESTORY_COIN_FUNC, TURBOS, TURBOS_DEX, TURBOS_MODULE, TURBOS_VERSIONED, TWO, TransactionErrorCode, TypesErrorCode, U128, U64_MAX, U64_MAX_BN, UTILS_MODULE, VOLO, ZERO, buildInputCoin, calculateGasEfficiency, calculatePriceImpact, checkInvalidSuiAddress, compareCoins, compareGasMetrics, completionCoin, composeType, createTarget, dealWithFastRouterSwapParamsForMsafe, estimateSwapGasBudget, exportToCSV, exportToJSON, extractAddressFromType, extractGasMetrics, extractStructTagFromType, extractTimestampFromDowngradeUuid6, fixSuiObjectId, formatGasMetrics, generateDowngradeUuid6, generateSimpleDowngradeUuid6, getAggregatorServerErrorMessage, getAggregatorV2Extend2PublishedAt, getAggregatorV2ExtendPublishedAt, getAggregatorV2PublishedAt, getAllProviders, getDeepbookV3Config, getDefaultSuiInputType, getMergeSwapResult, getOrCreateAccountCap, getProvidersExcluding, getProvidersIncluding, getRouterResult, hasPythPrelude, isSortedSymbols, isValidDowngradeUuid6, lookupGasBudget, mintZeroCoin, normalizeCoinType, parseAftermathFeeType, parseTurbosPoolFeeType, patchFixSuiObjectId, printTransaction, processEndpoint, processFlattenRoutes, restituteMsafeFastRouterSwapParams };
+export { AFSUI, AFTERMATH, AFTERMATH_AMM, AFTERMATH_MODULE, AGGREGATOR, AGGREGATOR_V3_CONFIG, ALL_DEXES, ALPHAFI, AggregatorClient, type AggregatorClientParams, AggregatorConfig, AggregatorError, type AggregatorErrorCode, type AggregatorResponse, AggregatorServerErrorCode, BLUEFIN, BLUEMOVE, BOLT, type BigNumber, type BuildCoinResult, type BuildFastMergeSwapParams, type BuildFastRouterSwapParams, type BuildFastRouterSwapParamsV2, type BuildFastRouterSwapParamsV3, type BuildMergeSwapParams, type BuildRouterSwapParams, type BuildRouterSwapParamsV2, type BuildRouterSwapParamsV3, type BuildSponsoredTransactionParams, CETUS, CETUSDLMM, CETUS_DEX, CETUS_MODULE, CETUS_PUBLISHED_AT, CHECK_COINS_THRESHOLD_FUNC, CLIENT_CONFIG, CLOCK_ADDRESS, type CoinAsset, CoinInfoAddress, CoinStoreAddress, CoinUtils, type ComparisonResult, ConfigErrorCode, DEEPBOOKV2, DEEPBOOKV3, DEEPBOOK_CLOB_V2_MODULE, DEEPBOOK_CUSTODIAN_V2_MODULE, DEEPBOOK_DEX, DEEPBOOK_MODULE, DEEPBOOK_PACKAGE_ID, DEEPBOOK_PUBLISHED_AT, DEEPBOOK_V3_DEEP_FEE_TYPES, DEFAULT_AGG_V2_ENDPOINT, DEFAULT_AGG_V3_ENDPOINT, DEFAULT_ENDPOINT, DEFAULT_GAS_BUDGET_FOR_MERGE, DEFAULT_GAS_BUDGET_FOR_SPLIT, DEFAULT_GAS_BUDGET_FOR_STAKE, DEFAULT_GAS_BUDGET_FOR_TRANSFER, DEFAULT_GAS_BUDGET_FOR_TRANSFER_SUI, DEFAULT_NFT_TRANSFER_GAS_FEE, type DeepbookV3Config, type DeepbookV3ConfigResponse, type Dex, Env, type ExtendedDetails, FERRACLMM, FERRADLMM, FLOWXV2, FLOWXV3, FLOWX_AMM, FLOWX_AMM_MODULE, FULLSAIL, type FindRouterParams, FlashSwapA2BFunc, FlashSwapB2AFunc, FlashSwapFunc, FlashSwapWithPartnerA2BFunc, FlashSwapWithPartnerB2AFunc, FlashSwapWithPartnerFunc, type FlattenedPath, GAS_SYMBOL, GAS_TYPE_ARG, GAS_TYPE_ARG_LONG, type GasMetrics, type GetOrCreateAccountCapResult, HAEDAL, HAEDALHMMV2, HAEDALPMM, HAEDALPROPAMM, HAWAL, INTEGRATE, JOIN_FUNC, KRIYA, KRIYAV3, KRIYA_DEX, KRIYA_MODULE, MAGMA, MAGMAPROPAMM, MAINNET_AFTERMATH_INSURANCE_FUND_ID, MAINNET_AFTERMATH_PROTOCOL_FEE_VAULT_ID, MAINNET_AFTERMATH_REFERRAL_VAULT_ID, MAINNET_AFTERMATH_REGISTRY_ID, MAINNET_AFTERMATH_TREASURY_ID, MAINNET_CETUS_V3_PUBLISHED_AT, MAINNET_FLOWX_AMM_CONTAINER_ID, METASTABLE, MOMENTUM, type MergeRoute, type MergeSwapFromCoin, type MergeSwapInputCoin, type MergeSwapParams, type MergeSwapRouterData, type NFT, OBRIC, ONE, PACKAGE_NAMES, PAY_MODULE, POOL_MODULT, PUBLISHED_ADDRESSES, PYTH_CONFIG, PYTH_ORACLE_BASED_DEXES, PYTH_PRELUDE_CALLS, type Package, type Path, type PathV2, type PreSwapLpChangeParams, type ProcessedRouterData, type PythConfig, REPAY_FLASH_SWAP_A2B_FUNC, REPAY_FLASH_SWAP_B2A_FUNC, REPAY_FLASH_SWAP_WITH_PARTNER_A2B_FUNC, REPAY_FLASH_SWAP_WITH_PARTNER_B2A_FUNC, RepayFalshSwapFunc, RepayFlashSwapWithPartnerFunc, type Router, type RouterData, type RouterDataV2, type RouterDataV3, type RouterError, type RouterV2, SCALLOP, SEVENK, SPRINGSUI, STEAMM, STEAMM_OMM, STEAMM_OMM_V2, SUILEND, SUI_SYSTEM_STATE_OBJECT_ID, SWAP_A2B_FUNC, SWAP_B2A_FUNC, SWAP_GAS_BUDGET_TABLE, type SimulateTransactionResult, type SuiAddress, type SuiBasicTypes, type SuiInputTypes, type SuiMoveObject, type SuiObjectIdType, type SuiResource, type SuiStructTag, type SuiTxArg, SuiZeroCoinFn, type SwapGasAnalysis, type SwapInPoolsParams, type SwapInPoolsResultV3, TEN_POW_NINE, TESTNET_AFTERMATH_INSURANCE_FUND_ID, TESTNET_AFTERMATH_PROTOCOL_FEE_VAULT_ID, TESTNET_AFTERMATH_REFERRAL_VAULT_ID, TESTNET_AFTERMATH_REGISTRY_ID, TESTNET_AFTERMATH_TREASURY_ID, TESTNET_CETUS_V3_PUBLISHED_AT, TESTNET_FLOWX_AMM_CONTAINER_ID, TRANSFER_ACCOUNT_CAP, TRANSFER_OR_DESTORY_COIN_FUNC, TURBOS, TURBOS_DEX, TURBOS_MODULE, TURBOS_VERSIONED, TWO, TransactionErrorCode, TypesErrorCode, U128, U64_MAX, U64_MAX_BN, UTILS_MODULE, VOLO, ZERO, buildInputCoin, calculateGasEfficiency, calculatePriceImpact, checkInvalidSuiAddress, compareCoins, compareGasMetrics, completionCoin, composeType, createTarget, dealWithFastRouterSwapParamsForMsafe, estimateSwapGasBudget, exportToCSV, exportToJSON, extractAddressFromType, extractGasMetrics, extractStructTagFromType, extractTimestampFromDowngradeUuid6, fixSuiObjectId, formatGasMetrics, generateDowngradeUuid6, generateSimpleDowngradeUuid6, getAggregatorServerErrorMessage, getAggregatorV2Extend2PublishedAt, getAggregatorV2ExtendPublishedAt, getAggregatorV2PublishedAt, getAllProviders, getDeepbookV3Config, getDefaultSuiInputType, getMergeSwapResult, getOrCreateAccountCap, getProvidersExcluding, getProvidersIncluding, getRouterResult, hasPythPrelude, isSortedSymbols, isValidDowngradeUuid6, lookupGasBudget, mintZeroCoin, normalizeCoinType, parseAftermathFeeType, parseTurbosPoolFeeType, patchFixSuiObjectId, printTransaction, processEndpoint, processFlattenRoutes, restituteMsafeFastRouterSwapParams };

package/dist/index.js

@@ -3410,7 +3410,7 @@ var AGGREGATOR_V3_CONFIG = {
 };
 
 // src/api.ts
-var SDK_VERSION = 1010601;
+var SDK_VERSION = 1010602;
 function parseRouterResponse(data, byAmountIn) {
   let packages = /* @__PURE__ */ new Map();
   if (data.packages) {
@@ -7816,20 +7816,56 @@ function transferOrDestroyCoin(params, txb) {
   });
 }
 var MAX_ARGUMENT_SIZE = 16 * 1024;
+var DEFAULT_HERMES_URL = "https://hermes.pyth.network";
+var DEFAULT_AVAILABILITY_TIMEOUT = 3e3;
+var DEFAULT_IS_AVAILABLE_STATUS = (status) => status >= 200 && status < 400;
 var PythAdapter = class {
   constructor(client, pythStateId, wormholeStateId, hermesUrls) {
     this.priceFeedObjectIdCache = /* @__PURE__ */ new Map();
     this.client = client;
     this.pythStateId = pythStateId;
     this.wormholeStateId = wormholeStateId;
-    const urls = [...hermesUrls];
-    if (!urls.includes("https://hermes.pyth.network")) {
-      urls.push("https://hermes.pyth.network");
+    const urls = Array.from(
+      new Set(hermesUrls.filter(Boolean).map(normalizeServiceUrl))
+    );
+    if (!urls.includes(DEFAULT_HERMES_URL)) {
+      urls.push(DEFAULT_HERMES_URL);
     }
+    this.hermesUrls = urls;
     this.hermesClients = urls.map(
       (url) => new HermesClient(url, { timeout: 3e3 })
     );
   }
+  getHermesUrls() {
+    return [...this.hermesUrls];
+  }
+  async checkHermesAvailability({
+    timeout = DEFAULT_AVAILABILITY_TIMEOUT,
+    isAvailableStatus = DEFAULT_IS_AVAILABLE_STATUS
+  } = {}) {
+    if (this.hermesUrls.length === 0) {
+      return {
+        checked: false,
+        availableUrls: [],
+        unavailableUrls: []
+      };
+    }
+    const results = await Promise.all(
+      this.hermesUrls.map(async (url) => ({
+        url,
+        available: await checkServiceUrl(url, timeout, isAvailableStatus)
+      }))
+    );
+    return {
+      checked: true,
+      availableUrls: results.filter((result) => result.available).map((result) => result.url),
+      unavailableUrls: results.filter((result) => !result.available).map((result) => result.url)
+    };
+  }
+  async isHermesAvailable(options) {
+    const snapshot = await this.checkHermesAvailability(options);
+    return snapshot.availableUrls.length > 0;
+  }
   async getPriceFeedsUpdateData(priceIDs) {
     let lastError = null;
     for (const hermes of this.hermesClients) {
@@ -8038,6 +8074,25 @@ var PythAdapter = class {
     return priceInfoObjects;
   }
 };
+async function checkServiceUrl(url, timeout, isAvailableStatus) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeout);
+  try {
+    const response = await fetch(url, {
+      method: "GET",
+      cache: "no-store",
+      signal: controller.signal
+    });
+    return isAvailableStatus(response.status);
+  } catch {
+    return false;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+function normalizeServiceUrl(url) {
+  return url.replace(/\/+$/, "");
+}
 
 // src/utils/uuid.ts
 function generateDowngradeUuid6() {
@@ -8942,6 +8997,12 @@ var ALL_DEXES = [
   MAGMAPROPAMM,
   HAEDALPROPAMM
 ];
+var PYTH_ORACLE_BASED_DEXES = [
+  HAEDALPMM,
+  METASTABLE,
+  STEAMM_OMM_V2,
+  HAEDALHMMV2
+];
 function getAllProviders() {
   return ALL_DEXES;
 }
@@ -9021,6 +9082,9 @@ var _AggregatorClient = class _AggregatorClient {
     this.apiKey = params.apiKey || "";
     this.partner = params.partner;
     this.cetusDlmmPartner = params.cetusDlmmPartner;
+    this.pythAvailabilityCheckInterval = validatePythAvailabilityCheckInterval(
+      params.pythAvailabilityCheckInterval
+    );
     if (params.overlayFeeRate) {
       if (params.overlayFeeRate > 0 && params.overlayFeeRate <= CLIENT_CONFIG.MAX_OVERLAY_FEE_RATE) {
         this.overlayFeeRate = params.overlayFeeRate * AGGREGATOR_V3_CONFIG.FEE_DENOMINATOR;
@@ -9063,23 +9127,74 @@ var _AggregatorClient = class _AggregatorClient {
     }
   }
   async findRouters(params) {
+    const {
+      params: routerParams,
+      providersExhausted
+    } = await this.filterProvidersByPythAvailability(params);
+    if (providersExhausted) {
+      return emptyRouterResult(routerParams.byAmountIn);
+    }
     return getRouterResult(
       this.endpoint,
       this.apiKey,
-      params,
+      routerParams,
       this.overlayFeeRate,
       this.overlayFeeReceiver
     );
   }
   async findMergeSwapRouters(params) {
+    const {
+      params: routerParams,
+      providersExhausted
+    } = await this.filterProvidersByPythAvailability(params);
+    if (providersExhausted) {
+      return emptyMergeSwapResult();
+    }
     return getMergeSwapResult(
       this.endpoint,
       this.apiKey,
-      params,
+      routerParams,
       this.overlayFeeRate,
       this.overlayFeeReceiver
     );
   }
+  async filterProvidersByPythAvailability(params) {
+    const interval = validatePythAvailabilityCheckInterval(
+      params.pythAvailabilityCheckInterval ?? this.pythAvailabilityCheckInterval
+    );
+    if (interval === void 0) {
+      return { params, providersExhausted: false };
+    }
+    const pythAvailable = await this.getPythAvailability(interval);
+    if (pythAvailable) {
+      return { params, providersExhausted: false };
+    }
+    const sourceProviders = params.providers && params.providers.length > 0 ? params.providers : ALL_DEXES;
+    const providers = sourceProviders.filter(
+      (provider) => !PYTH_ORACLE_BASED_DEXES.includes(provider)
+    );
+    return {
+      params: { ...params, providers },
+      providersExhausted: providers.length === 0
+    };
+  }
+  async getPythAvailability(interval) {
+    const now = Date.now();
+    if (this.pythAvailable !== void 0 && this.pythAvailabilityCheckedAt !== void 0 && now - this.pythAvailabilityCheckedAt < interval) {
+      return this.pythAvailable;
+    }
+    if (this.pythAvailabilityPromise) {
+      return this.pythAvailabilityPromise;
+    }
+    this.pythAvailabilityPromise = this.pythAdapter.isHermesAvailable().catch(() => false).then((available) => {
+      this.pythAvailable = available;
+      this.pythAvailabilityCheckedAt = Date.now();
+      return available;
+    }).finally(() => {
+      this.pythAvailabilityPromise = void 0;
+    });
+    return this.pythAvailabilityPromise;
+  }
   async executeFlexibleInputSwap(txb, inputCoin, routerData, expectedAmountOut, amountLimit, pythPriceIDs, partner, deepbookv3DeepFee, packages) {
   }
   newDexRouterV3(provider, pythPriceIDs, partner, cetusDlmmPartner) {
@@ -10041,6 +10156,35 @@ function generateUUID() {
     return v.toString(16);
   });
 }
+function validatePythAvailabilityCheckInterval(interval) {
+  if (interval === void 0) {
+    return void 0;
+  }
+  if (!Number.isFinite(interval) || interval < 0) {
+    throw new Error(
+      "pythAvailabilityCheckInterval must be a non-negative number"
+    );
+  }
+  return interval;
+}
+function emptyRouterResult(byAmountIn) {
+  return {
+    quoteID: "",
+    amountIn: ZERO,
+    amountOut: ZERO,
+    paths: [],
+    byAmountIn,
+    insufficientLiquidity: true,
+    deviationRatio: 0
+  };
+}
+function emptyMergeSwapResult() {
+  return {
+    quoteID: "",
+    totalAmountOut: ZERO,
+    allRoutes: []
+  };
+}
 function recordFirstCoinIndex(paths) {
   let newCoinRecord = /* @__PURE__ */ new Map();
   for (let i = 0; i < paths.length; i++) {
@@ -10089,4 +10233,4 @@ decimal.js/decimal.mjs:
    *)
 */
 
-export { AFSUI, AFTERMATH, AFTERMATH_AMM, AFTERMATH_MODULE, AGGREGATOR, AGGREGATOR_V3_CONFIG, ALL_DEXES, ALPHAFI, AggregatorClient, AggregatorConfig, AggregatorError, AggregatorServerErrorCode, BLUEFIN, BLUEMOVE, BOLT, CETUS, CETUSDLMM, CETUS_DEX, CETUS_MODULE, CETUS_PUBLISHED_AT, CHECK_COINS_THRESHOLD_FUNC, CLIENT_CONFIG, CLOCK_ADDRESS, CoinInfoAddress, CoinStoreAddress, CoinUtils, ConfigErrorCode, DEEPBOOKV2, DEEPBOOKV3, DEEPBOOK_CLOB_V2_MODULE, DEEPBOOK_CUSTODIAN_V2_MODULE, DEEPBOOK_DEX, DEEPBOOK_MODULE, DEEPBOOK_PACKAGE_ID, DEEPBOOK_PUBLISHED_AT, DEEPBOOK_V3_DEEP_FEE_TYPES, DEFAULT_AGG_V2_ENDPOINT, DEFAULT_AGG_V3_ENDPOINT, DEFAULT_ENDPOINT, DEFAULT_GAS_BUDGET_FOR_MERGE, DEFAULT_GAS_BUDGET_FOR_SPLIT, DEFAULT_GAS_BUDGET_FOR_STAKE, DEFAULT_GAS_BUDGET_FOR_TRANSFER, DEFAULT_GAS_BUDGET_FOR_TRANSFER_SUI, DEFAULT_NFT_TRANSFER_GAS_FEE, Env, FERRACLMM, FERRADLMM, FLOWXV2, FLOWXV3, FLOWX_AMM, FLOWX_AMM_MODULE, FULLSAIL, FlashSwapA2BFunc, FlashSwapB2AFunc, FlashSwapFunc, FlashSwapWithPartnerA2BFunc, FlashSwapWithPartnerB2AFunc, FlashSwapWithPartnerFunc, GAS_SYMBOL, GAS_TYPE_ARG, GAS_TYPE_ARG_LONG, HAEDAL, HAEDALHMMV2, HAEDALPMM, HAEDALPROPAMM, HAWAL, INTEGRATE, JOIN_FUNC, KRIYA, KRIYAV3, KRIYA_DEX, KRIYA_MODULE, MAGMA, MAGMAPROPAMM, MAINNET_AFTERMATH_INSURANCE_FUND_ID, MAINNET_AFTERMATH_PROTOCOL_FEE_VAULT_ID, MAINNET_AFTERMATH_REFERRAL_VAULT_ID, MAINNET_AFTERMATH_REGISTRY_ID, MAINNET_AFTERMATH_TREASURY_ID, MAINNET_CETUS_V3_PUBLISHED_AT, MAINNET_FLOWX_AMM_CONTAINER_ID, METASTABLE, MOMENTUM, OBRIC, ONE, PACKAGE_NAMES, PAY_MODULE, POOL_MODULT, PUBLISHED_ADDRESSES, PYTH_CONFIG, PYTH_PRELUDE_CALLS, REPAY_FLASH_SWAP_A2B_FUNC, REPAY_FLASH_SWAP_B2A_FUNC, REPAY_FLASH_SWAP_WITH_PARTNER_A2B_FUNC, REPAY_FLASH_SWAP_WITH_PARTNER_B2A_FUNC, RepayFalshSwapFunc, RepayFlashSwapWithPartnerFunc, SCALLOP, SEVENK, SPRINGSUI, STEAMM, STEAMM_OMM, STEAMM_OMM_V2, SUILEND, SUI_SYSTEM_STATE_OBJECT_ID, SWAP_A2B_FUNC, SWAP_B2A_FUNC, SWAP_GAS_BUDGET_TABLE, SuiZeroCoinFn, TEN_POW_NINE, TESTNET_AFTERMATH_INSURANCE_FUND_ID, TESTNET_AFTERMATH_PROTOCOL_FEE_VAULT_ID, TESTNET_AFTERMATH_REFERRAL_VAULT_ID, TESTNET_AFTERMATH_REGISTRY_ID, TESTNET_AFTERMATH_TREASURY_ID, TESTNET_CETUS_V3_PUBLISHED_AT, TESTNET_FLOWX_AMM_CONTAINER_ID, TRANSFER_ACCOUNT_CAP, TRANSFER_OR_DESTORY_COIN_FUNC, TURBOS, TURBOS_DEX, TURBOS_MODULE, TURBOS_VERSIONED, TWO, TransactionErrorCode, TypesErrorCode, U128, U64_MAX, U64_MAX_BN, UTILS_MODULE, VOLO, ZERO, buildInputCoin, calculateGasEfficiency, calculatePriceImpact, checkInvalidSuiAddress, compareCoins, compareGasMetrics, completionCoin, composeType, createTarget, dealWithFastRouterSwapParamsForMsafe, estimateSwapGasBudget, exportToCSV, exportToJSON, extractAddressFromType, extractGasMetrics, extractStructTagFromType, extractTimestampFromDowngradeUuid6, fixSuiObjectId, formatGasMetrics, generateDowngradeUuid6, generateSimpleDowngradeUuid6, getAggregatorServerErrorMessage, getAggregatorV2Extend2PublishedAt, getAggregatorV2ExtendPublishedAt, getAggregatorV2PublishedAt, getAllProviders, getDeepbookV3Config, getDefaultSuiInputType, getMergeSwapResult, getOrCreateAccountCap, getProvidersExcluding, getProvidersIncluding, getRouterResult, hasPythPrelude, isSortedSymbols, isValidDowngradeUuid6, lookupGasBudget, mintZeroCoin, normalizeCoinType, parseAftermathFeeType, parseTurbosPoolFeeType, patchFixSuiObjectId, printTransaction, processEndpoint, processFlattenRoutes, restituteMsafeFastRouterSwapParams };
+export { AFSUI, AFTERMATH, AFTERMATH_AMM, AFTERMATH_MODULE, AGGREGATOR, AGGREGATOR_V3_CONFIG, ALL_DEXES, ALPHAFI, AggregatorClient, AggregatorConfig, AggregatorError, AggregatorServerErrorCode, BLUEFIN, BLUEMOVE, BOLT, CETUS, CETUSDLMM, CETUS_DEX, CETUS_MODULE, CETUS_PUBLISHED_AT, CHECK_COINS_THRESHOLD_FUNC, CLIENT_CONFIG, CLOCK_ADDRESS, CoinInfoAddress, CoinStoreAddress, CoinUtils, ConfigErrorCode, DEEPBOOKV2, DEEPBOOKV3, DEEPBOOK_CLOB_V2_MODULE, DEEPBOOK_CUSTODIAN_V2_MODULE, DEEPBOOK_DEX, DEEPBOOK_MODULE, DEEPBOOK_PACKAGE_ID, DEEPBOOK_PUBLISHED_AT, DEEPBOOK_V3_DEEP_FEE_TYPES, DEFAULT_AGG_V2_ENDPOINT, DEFAULT_AGG_V3_ENDPOINT, DEFAULT_ENDPOINT, DEFAULT_GAS_BUDGET_FOR_MERGE, DEFAULT_GAS_BUDGET_FOR_SPLIT, DEFAULT_GAS_BUDGET_FOR_STAKE, DEFAULT_GAS_BUDGET_FOR_TRANSFER, DEFAULT_GAS_BUDGET_FOR_TRANSFER_SUI, DEFAULT_NFT_TRANSFER_GAS_FEE, Env, FERRACLMM, FERRADLMM, FLOWXV2, FLOWXV3, FLOWX_AMM, FLOWX_AMM_MODULE, FULLSAIL, FlashSwapA2BFunc, FlashSwapB2AFunc, FlashSwapFunc, FlashSwapWithPartnerA2BFunc, FlashSwapWithPartnerB2AFunc, FlashSwapWithPartnerFunc, GAS_SYMBOL, GAS_TYPE_ARG, GAS_TYPE_ARG_LONG, HAEDAL, HAEDALHMMV2, HAEDALPMM, HAEDALPROPAMM, HAWAL, INTEGRATE, JOIN_FUNC, KRIYA, KRIYAV3, KRIYA_DEX, KRIYA_MODULE, MAGMA, MAGMAPROPAMM, MAINNET_AFTERMATH_INSURANCE_FUND_ID, MAINNET_AFTERMATH_PROTOCOL_FEE_VAULT_ID, MAINNET_AFTERMATH_REFERRAL_VAULT_ID, MAINNET_AFTERMATH_REGISTRY_ID, MAINNET_AFTERMATH_TREASURY_ID, MAINNET_CETUS_V3_PUBLISHED_AT, MAINNET_FLOWX_AMM_CONTAINER_ID, METASTABLE, MOMENTUM, OBRIC, ONE, PACKAGE_NAMES, PAY_MODULE, POOL_MODULT, PUBLISHED_ADDRESSES, PYTH_CONFIG, PYTH_ORACLE_BASED_DEXES, PYTH_PRELUDE_CALLS, REPAY_FLASH_SWAP_A2B_FUNC, REPAY_FLASH_SWAP_B2A_FUNC, REPAY_FLASH_SWAP_WITH_PARTNER_A2B_FUNC, REPAY_FLASH_SWAP_WITH_PARTNER_B2A_FUNC, RepayFalshSwapFunc, RepayFlashSwapWithPartnerFunc, SCALLOP, SEVENK, SPRINGSUI, STEAMM, STEAMM_OMM, STEAMM_OMM_V2, SUILEND, SUI_SYSTEM_STATE_OBJECT_ID, SWAP_A2B_FUNC, SWAP_B2A_FUNC, SWAP_GAS_BUDGET_TABLE, SuiZeroCoinFn, TEN_POW_NINE, TESTNET_AFTERMATH_INSURANCE_FUND_ID, TESTNET_AFTERMATH_PROTOCOL_FEE_VAULT_ID, TESTNET_AFTERMATH_REFERRAL_VAULT_ID, TESTNET_AFTERMATH_REGISTRY_ID, TESTNET_AFTERMATH_TREASURY_ID, TESTNET_CETUS_V3_PUBLISHED_AT, TESTNET_FLOWX_AMM_CONTAINER_ID, TRANSFER_ACCOUNT_CAP, TRANSFER_OR_DESTORY_COIN_FUNC, TURBOS, TURBOS_DEX, TURBOS_MODULE, TURBOS_VERSIONED, TWO, TransactionErrorCode, TypesErrorCode, U128, U64_MAX, U64_MAX_BN, UTILS_MODULE, VOLO, ZERO, buildInputCoin, calculateGasEfficiency, calculatePriceImpact, checkInvalidSuiAddress, compareCoins, compareGasMetrics, completionCoin, composeType, createTarget, dealWithFastRouterSwapParamsForMsafe, estimateSwapGasBudget, exportToCSV, exportToJSON, extractAddressFromType, extractGasMetrics, extractStructTagFromType, extractTimestampFromDowngradeUuid6, fixSuiObjectId, formatGasMetrics, generateDowngradeUuid6, generateSimpleDowngradeUuid6, getAggregatorServerErrorMessage, getAggregatorV2Extend2PublishedAt, getAggregatorV2ExtendPublishedAt, getAggregatorV2PublishedAt, getAllProviders, getDeepbookV3Config, getDefaultSuiInputType, getMergeSwapResult, getOrCreateAccountCap, getProvidersExcluding, getProvidersIncluding, getRouterResult, hasPythPrelude, isSortedSymbols, isValidDowngradeUuid6, lookupGasBudget, mintZeroCoin, normalizeCoinType, parseAftermathFeeType, parseTurbosPoolFeeType, patchFixSuiObjectId, printTransaction, processEndpoint, processFlattenRoutes, restituteMsafeFastRouterSwapParams };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cetusprotocol/aggregator-sdk",
-  "version": "1.6.1",
+  "version": "1.6.2",
   "type": "module",
   "sideEffects": false,
   "main": "dist/index.js",