@cfxjs/sirius-next-common 0.2.24 → 0.2.25

package/dist/components/TransactionTrace/index.js

@@ -1,56 +1,56 @@
 import {
   TreeTraceTable
-} from "../../chunk-A46LVI25.js";
+} from "../../chunk-NG6K2B3F.js";
 import {
   TraceDetail
-} from "../../chunk-7RLNWQIR.js";
-import "../../chunk-6C5NQACS.js";
-import "../../chunk-7WDLTRBN.js";
+} from "../../chunk-ZTGRS6WM.js";
+import "../../chunk-6PDWJNOG.js";
+import "../../chunk-SWH3CIYY.js";
 import "../../chunk-UM5J477V.js";
 import "../../chunk-XZ7IV2FF.js";
-import "../../chunk-VD73ULXJ.js";
-import "../../chunk-SIZYE6WH.js";
+import "../../chunk-RIWM6DB5.js";
+import "../../chunk-UAUOFPHA.js";
 import "../../chunk-NWVSTRCG.js";
-import "../../chunk-ASS6TOFE.js";
-import "../../chunk-HCEXWKMZ.js";
-import "../../chunk-OT252GGM.js";
+import "../../chunk-D6FWT557.js";
+import "../../chunk-NRHFGPN6.js";
+import "../../chunk-FUZVMDLY.js";
 import "../../chunk-OYESIV3F.js";
-import "../../chunk-DASMAZXS.js";
-import "../../chunk-MWSXXVVL.js";
-import "../../chunk-EHRGH3HS.js";
-import "../../chunk-VEK5DLFI.js";
-import "../../chunk-FGPRA3A4.js";
-import "../../chunk-4BS66NNM.js";
+import "../../chunk-2UN57Q5P.js";
+import "../../chunk-2PGGAIEP.js";
+import "../../chunk-UQQJ37UO.js";
+import "../../chunk-C2BON7HP.js";
+import "../../chunk-NQFK4HOS.js";
+import "../../chunk-UDR62T6C.js";
 import "../../chunk-FYLAXC3R.js";
 import "../../chunk-XI5WO2NW.js";
 import "../../chunk-5AM5HM3B.js";
-import "../../chunk-UVRMLFMC.js";
+import "../../chunk-75SROBSE.js";
 import "../../chunk-XBEBAU77.js";
 import "../../chunk-Y7OVL5US.js";
 import "../../chunk-O6NJ56NA.js";
 import "../../chunk-XCKMXAL2.js";
 import "../../chunk-2Y57U43P.js";
 import "../../chunk-TGK5LP2H.js";
-import "../../chunk-C6GUZVQ2.js";
+import "../../chunk-BHL6OY3L.js";
 import "../../chunk-6SXAFSBF.js";
 import "../../chunk-JIRLY7OG.js";
 import "../../chunk-4B6ASBYQ.js";
-import "../../chunk-OFAM2QTT.js";
+import "../../chunk-2PQY4AOY.js";
 import "../../chunk-5TGK2EA2.js";
 import "../../chunk-ADNS57X5.js";
-import "../../chunk-R62HRSIY.js";
-import "../../chunk-O6BP54O6.js";
-import "../../chunk-OTSNM4CR.js";
+import "../../chunk-2KOLEWOS.js";
+import "../../chunk-DWU7DZBU.js";
+import "../../chunk-RDIVTGYB.js";
 import "../../chunk-MWAD4CIG.js";
-import "../../chunk-MQY7EQPG.js";
-import "../../chunk-4B7BV62E.js";
+import "../../chunk-IUL5FJSO.js";
+import "../../chunk-442632G5.js";
 import "../../chunk-TOKKKTFG.js";
-import "../../chunk-J536GL5G.js";
+import "../../chunk-MBRAYFD4.js";
 import "../../chunk-BMO4IZHV.js";
 import "../../chunk-LRCAKRPK.js";
-import "../../chunk-SNUPCZY7.js";
+import "../../chunk-XASQUPYS.js";
 import "../../chunk-WIB76E7O.js";
-import "../../chunk-E7FB4S3X.js";
+import "../../chunk-7R6SGHOG.js";
 import "../../chunk-J2I22Q2M.js";
 import "../../chunk-YEINMVAR.js";
 import "../../chunk-DQGLZCIG.js";

package/dist/utils/address.js

@@ -23,9 +23,9 @@ import {
   isSimplyZeroAddress,
   isSpecialAddress,
   isZeroAddress
-} from "../chunk-MQY7EQPG.js";
+} from "../chunk-IUL5FJSO.js";
 import "../chunk-WIB76E7O.js";
-import "../chunk-E7FB4S3X.js";
+import "../chunk-7R6SGHOG.js";
 import "../chunk-J2I22Q2M.js";
 import "../chunk-YEINMVAR.js";
 import "../chunk-DQGLZCIG.js";

package/dist/utils/contractManagerTool.js

@@ -1,8 +1,8 @@
 import {
   parseString
-} from "../chunk-SNUPCZY7.js";
+} from "../chunk-XASQUPYS.js";
 import "../chunk-WIB76E7O.js";
-import "../chunk-E7FB4S3X.js";
+import "../chunk-7R6SGHOG.js";
 import "../chunk-J2I22Q2M.js";
 import "../chunk-YEINMVAR.js";
 import "../chunk-DQGLZCIG.js";

package/dist/utils/hooks/useAddressLabel.js

@@ -1,9 +1,9 @@
 import {
   useAddressLabel
-} from "../../chunk-VEK5DLFI.js";
-import "../../chunk-MQY7EQPG.js";
+} from "../../chunk-C2BON7HP.js";
+import "../../chunk-IUL5FJSO.js";
 import "../../chunk-WIB76E7O.js";
-import "../../chunk-E7FB4S3X.js";
+import "../../chunk-7R6SGHOG.js";
 import "../../chunk-J2I22Q2M.js";
 import "../../chunk-YEINMVAR.js";
 import "../../chunk-DQGLZCIG.js";

package/dist/utils/hooks/useAddressNameMap.js

@@ -1,8 +1,8 @@
 import {
   transformNameMapKeysToLowerCase,
   useAddressNameMap
-} from "../../chunk-4BS66NNM.js";
-import "../../chunk-E7FB4S3X.js";
+} from "../../chunk-UDR62T6C.js";
+import "../../chunk-7R6SGHOG.js";
 import "../../chunk-J2I22Q2M.js";
 import "../../chunk-YEINMVAR.js";
 import "../../chunk-DQGLZCIG.js";

package/dist/utils/hooks/useAutoSetHolderFilterParams.js

@@ -3,9 +3,9 @@ import {
 } from "../../chunk-CPSXYQJ7.js";
 import {
   isAddressEqual
-} from "../../chunk-MQY7EQPG.js";
+} from "../../chunk-IUL5FJSO.js";
 import "../../chunk-WIB76E7O.js";
-import "../../chunk-E7FB4S3X.js";
+import "../../chunk-7R6SGHOG.js";
 import "../../chunk-J2I22Q2M.js";
 import "../../chunk-YEINMVAR.js";
 import "../../chunk-DQGLZCIG.js";

package/dist/utils/hooks/useContractDetail.js

@@ -1,7 +1,7 @@
 import {
   useContractDetail
-} from "../../chunk-OFAM2QTT.js";
-import "../../chunk-E7FB4S3X.js";
+} from "../../chunk-2PQY4AOY.js";
+import "../../chunk-7R6SGHOG.js";
 import "../../chunk-J2I22Q2M.js";
 import "../../chunk-YEINMVAR.js";
 import "../../chunk-DQGLZCIG.js";

package/dist/utils/hooks/useDecodeFunctionData.js

@@ -1,14 +1,14 @@
 import {
   useDecodeFunctionData
-} from "../../chunk-6C5NQACS.js";
-import "../../chunk-7WDLTRBN.js";
+} from "../../chunk-6PDWJNOG.js";
+import "../../chunk-SWH3CIYY.js";
 import "../../chunk-6SXAFSBF.js";
 import "../../chunk-JIRLY7OG.js";
 import "../../chunk-4B6ASBYQ.js";
-import "../../chunk-OFAM2QTT.js";
-import "../../chunk-SNUPCZY7.js";
+import "../../chunk-2PQY4AOY.js";
+import "../../chunk-XASQUPYS.js";
 import "../../chunk-WIB76E7O.js";
-import "../../chunk-E7FB4S3X.js";
+import "../../chunk-7R6SGHOG.js";
 import "../../chunk-J2I22Q2M.js";
 import "../../chunk-YEINMVAR.js";
 import "../../chunk-DQGLZCIG.js";

package/dist/utils/hooks/useDecodeFunctionError.js

@@ -1,14 +1,14 @@
 import {
   useDecodeFunctionError
-} from "../../chunk-C6GUZVQ2.js";
+} from "../../chunk-BHL6OY3L.js";
 import "../../chunk-6SXAFSBF.js";
 import "../../chunk-JIRLY7OG.js";
 import "../../chunk-4B6ASBYQ.js";
-import "../../chunk-OFAM2QTT.js";
+import "../../chunk-2PQY4AOY.js";
 import "../../chunk-5TGK2EA2.js";
 import "../../chunk-ADNS57X5.js";
 import "../../chunk-WIB76E7O.js";
-import "../../chunk-E7FB4S3X.js";
+import "../../chunk-7R6SGHOG.js";
 import "../../chunk-J2I22Q2M.js";
 import "../../chunk-YEINMVAR.js";
 import "../../chunk-DQGLZCIG.js";

package/dist/utils/hooks/useENS.js

@@ -1,9 +1,9 @@
 import {
   useENS
-} from "../../chunk-O6BP54O6.js";
-import "../../chunk-MQY7EQPG.js";
+} from "../../chunk-DWU7DZBU.js";
+import "../../chunk-IUL5FJSO.js";
 import "../../chunk-WIB76E7O.js";
-import "../../chunk-E7FB4S3X.js";
+import "../../chunk-7R6SGHOG.js";
 import "../../chunk-J2I22Q2M.js";
 import "../../chunk-YEINMVAR.js";
 import "../../chunk-DQGLZCIG.js";

package/dist/utils/hooks/useEnhanceDataWithNameMap.js

@@ -1,8 +1,8 @@
 import {
   transformNameMapKeysToLowerCase,
   useAddressNameMap
-} from "../../chunk-4BS66NNM.js";
-import "../../chunk-E7FB4S3X.js";
+} from "../../chunk-UDR62T6C.js";
+import "../../chunk-7R6SGHOG.js";
 import "../../chunk-J2I22Q2M.js";
 import "../../chunk-YEINMVAR.js";
 import "../../chunk-DQGLZCIG.js";

package/dist/utils/hooks/useMethodAbi.js

@@ -1,7 +1,7 @@
 import {
   useMethodAbi
-} from "../../chunk-7WDLTRBN.js";
-import "../../chunk-E7FB4S3X.js";
+} from "../../chunk-SWH3CIYY.js";
+import "../../chunk-7R6SGHOG.js";
 import "../../chunk-J2I22Q2M.js";
 import "../../chunk-YEINMVAR.js";
 import "../../chunk-DQGLZCIG.js";

package/dist/utils/hooks/useTableData.js

@@ -3,7 +3,7 @@ import {
 } from "../../chunk-CPSXYQJ7.js";
 import {
   fetchWithPrefix
-} from "../../chunk-E7FB4S3X.js";
+} from "../../chunk-7R6SGHOG.js";
 import "../../chunk-J2I22Q2M.js";
 import "../../chunk-YEINMVAR.js";
 import "../../chunk-DQGLZCIG.js";

package/dist/utils/hooks/useTxTrace.js

@@ -1,13 +1,13 @@
 import {
   formatAddress
-} from "../../chunk-MQY7EQPG.js";
+} from "../../chunk-IUL5FJSO.js";
 import {
   formatABI
-} from "../../chunk-SNUPCZY7.js";
+} from "../../chunk-XASQUPYS.js";
 import "../../chunk-WIB76E7O.js";
 import {
   fetchWithPrefix
-} from "../../chunk-E7FB4S3X.js";
+} from "../../chunk-7R6SGHOG.js";
 import {
   publishRequestError
 } from "../../chunk-J2I22Q2M.js";

package/dist/utils/index.js

@@ -53,9 +53,9 @@ import {
   transferToLowerCase,
   validURL,
   viewJson
-} from "../chunk-SNUPCZY7.js";
+} from "../chunk-XASQUPYS.js";
 import "../chunk-WIB76E7O.js";
-import "../chunk-E7FB4S3X.js";
+import "../chunk-7R6SGHOG.js";
 import "../chunk-J2I22Q2M.js";
 import "../chunk-YEINMVAR.js";
 import "../chunk-DQGLZCIG.js";

package/dist/utils/ipfsGateway.d.ts

@@ -0,0 +1,52 @@
+declare const IPFS_GATEWAY_LIST_URL = "https://raw.githubusercontent.com/ipfs/public-gateway-checker/refs/heads/main/gateways.json";
+declare const IPFS_GATEWAY_SAMPLE_CID = "bafybeifx7yeb55armcsxwwitkymga5xf53dxiarykms3ygqic223w5sk3m";
+type IPFSGatewayDetectCode = 'OK' | 'NOT_OK';
+interface IPFSGatewayDetectResult {
+    code: IPFSGatewayDetectCode;
+    message: string;
+    data: {
+        gateway: string;
+        host: string;
+        url: string;
+        time?: number;
+        status?: number;
+        contentType?: string | null;
+    };
+}
+interface FetchIPFSGatewayListOptions {
+    fetcher?: typeof globalThis.fetch;
+    listUrl?: string;
+    timeout?: number;
+    useCache?: boolean;
+}
+interface DetectIPFSGatewayOptions {
+    fetcher?: typeof globalThis.fetch;
+    cid?: string;
+    timeout?: number;
+    useDetectCache?: boolean;
+}
+interface DetectIPFSGatewaysOptions extends DetectIPFSGatewayOptions {
+    gateways?: string[];
+    listUrl?: string;
+    pageSize?: number;
+    useCache?: boolean;
+}
+interface DetectIPFSGatewaysResult {
+    fastest?: string;
+    results: IPFSGatewayDetectResult[];
+    availableGateways: IPFSGatewayDetectResult[];
+}
+declare const IPFS_GATEWAY_GLOBAL_CACHE_KEY = "__SIRIUS_NEXT_IPFS_GATEWAY_CACHE__";
+declare const IPFS_GATEWAY_LIST_STORAGE_PREFIX = "sirius-next:ipfs-gateway:list:";
+declare const IPFS_GATEWAY_DETECT_STORAGE_PREFIX = "sirius-next:ipfs-gateway:detect:";
+declare const IPFS_GATEWAY_RELOAD_CLEANED_KEY = "sirius-next:ipfs-gateway:reload-cleaned";
+declare const clearIPFSGatewayListCache: () => void;
+declare const clearIPFSGatewayDetectCache: () => void;
+declare const normalizeIPFSGateway: (gateway: string) => string | undefined;
+declare const hostFromIPFSGateway: (gateway: string) => string;
+declare const tmplFromIPFSGateway: (userGateway: string, gatewayList: string[]) => string | undefined;
+declare const fetchIPFSGatewayList: (options?: FetchIPFSGatewayListOptions) => Promise<string[]>;
+declare const detectIPFSGateway: (gateway: string, { fetcher, cid, timeout, useDetectCache, }?: DetectIPFSGatewayOptions) => Promise<IPFSGatewayDetectResult>;
+declare const detectIPFSGateways: ({ gateways, pageSize, fetcher, cid, timeout, listUrl, useCache, }?: DetectIPFSGatewaysOptions) => Promise<DetectIPFSGatewaysResult>;
+
+export { DetectIPFSGatewayOptions, DetectIPFSGatewaysOptions, DetectIPFSGatewaysResult, FetchIPFSGatewayListOptions, IPFSGatewayDetectCode, IPFSGatewayDetectResult, IPFS_GATEWAY_DETECT_STORAGE_PREFIX, IPFS_GATEWAY_GLOBAL_CACHE_KEY, IPFS_GATEWAY_LIST_STORAGE_PREFIX, IPFS_GATEWAY_LIST_URL, IPFS_GATEWAY_RELOAD_CLEANED_KEY, IPFS_GATEWAY_SAMPLE_CID, clearIPFSGatewayDetectCache, clearIPFSGatewayListCache, detectIPFSGateway, detectIPFSGateways, fetchIPFSGatewayList, hostFromIPFSGateway, normalizeIPFSGateway, tmplFromIPFSGateway };

package/dist/utils/ipfsGateway.js

@@ -0,0 +1,350 @@
+import "../chunk-WQG2LZMB.js";
+
+// src/utils/ipfsGateway.ts
+var IPFS_GATEWAY_LIST_URL = "https://raw.githubusercontent.com/ipfs/public-gateway-checker/refs/heads/main/gateways.json";
+var IPFS_GATEWAY_SAMPLE_CID = "bafybeifx7yeb55armcsxwwitkymga5xf53dxiarykms3ygqic223w5sk3m";
+var DEFAULT_TIMEOUT = 3e3;
+var DEFAULT_PAGE_SIZE = 5;
+var IPFS_GATEWAY_GLOBAL_CACHE_KEY = "__SIRIUS_NEXT_IPFS_GATEWAY_CACHE__";
+var IPFS_GATEWAY_LIST_STORAGE_PREFIX = "sirius-next:ipfs-gateway:list:";
+var IPFS_GATEWAY_DETECT_STORAGE_PREFIX = "sirius-next:ipfs-gateway:detect:";
+var IPFS_GATEWAY_RELOAD_CLEANED_KEY = "sirius-next:ipfs-gateway:reload-cleaned";
+var getIPFSGatewayCache = () => {
+  clearSessionCacheOnReload();
+  const globalObject = globalThis;
+  globalObject[IPFS_GATEWAY_GLOBAL_CACHE_KEY] ?? (globalObject[IPFS_GATEWAY_GLOBAL_CACHE_KEY] = {
+    gatewayListPromiseMap: /* @__PURE__ */ new Map(),
+    gatewayDetectPromiseMap: /* @__PURE__ */ new Map()
+  });
+  return globalObject[IPFS_GATEWAY_GLOBAL_CACHE_KEY];
+};
+var clearIPFSGatewayListCache = () => {
+  getIPFSGatewayCache().gatewayListPromiseMap.clear();
+  clearSessionListCache();
+};
+var clearIPFSGatewayDetectCache = () => {
+  getIPFSGatewayCache().gatewayDetectPromiseMap.clear();
+  clearSessionDetectCache();
+};
+var normalizeIPFSGateway = (gateway) => {
+  if (!gateway || typeof gateway !== "string") {
+    return void 0;
+  }
+  const target = gateway.trim();
+  if (!target) {
+    return void 0;
+  }
+  return target.endsWith("/") ? target.slice(0, -1) : target;
+};
+var hostFromIPFSGateway = (gateway) => {
+  try {
+    return new URL(gateway).host;
+  } catch (_) {
+    const parts = gateway.split("://");
+    const urlExcludeProtocol = (parts.length > 1 ? parts[1] : parts[0]) ?? "";
+    return urlExcludeProtocol.split("/")[0] ?? "";
+  }
+};
+var tmplFromIPFSGateway = (userGateway, gatewayList) => {
+  const target = normalizeIPFSGateway(userGateway);
+  if (!target) {
+    return void 0;
+  }
+  return new Set(gatewayList.map((gateway) => normalizeIPFSGateway(gateway))).has(
+    target
+  ) ? target : void 0;
+};
+var requestWithTimeout = async (url, fetcher, timeout) => {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeout);
+  try {
+    return await fetcher(url, { signal: controller.signal });
+  } finally {
+    clearTimeout(timer);
+  }
+};
+var getSessionStorage = () => {
+  try {
+    return globalThis.sessionStorage;
+  } catch (_) {
+    return void 0;
+  }
+};
+var getNavigationType = () => {
+  const navigationEntry = globalThis.performance?.getEntriesByType?.(
+    "navigation"
+  )?.[0];
+  if (navigationEntry?.type) {
+    return navigationEntry.type;
+  }
+  return globalThis.performance?.navigation?.type === 1 ? "reload" : void 0;
+};
+var clearSessionCacheOnReload = () => {
+  const globalObject = globalThis;
+  if (globalObject[IPFS_GATEWAY_RELOAD_CLEANED_KEY]) {
+    return;
+  }
+  globalObject[IPFS_GATEWAY_RELOAD_CLEANED_KEY] = true;
+  if (getNavigationType() === "reload") {
+    clearSessionListCache();
+    clearSessionDetectCache();
+  }
+};
+var clearSessionCacheByPrefix = (prefix) => {
+  const storage = getSessionStorage();
+  if (!storage) {
+    return;
+  }
+  try {
+    const keys = Array.from({ length: storage.length }).map((_, index) => storage.key(index)).filter((key) => Boolean(key?.startsWith(prefix)));
+    keys.forEach((key) => storage.removeItem(key));
+  } catch (_) {
+  }
+};
+var clearSessionListCache = () => {
+  clearSessionCacheByPrefix(IPFS_GATEWAY_LIST_STORAGE_PREFIX);
+};
+var clearSessionDetectCache = () => {
+  clearSessionCacheByPrefix(IPFS_GATEWAY_DETECT_STORAGE_PREFIX);
+};
+var getSessionListCache = (listUrl) => {
+  const storage = getSessionStorage();
+  if (!storage) {
+    return void 0;
+  }
+  try {
+    const item = storage.getItem(
+      `${IPFS_GATEWAY_LIST_STORAGE_PREFIX}${listUrl}`
+    );
+    if (!item) {
+      return void 0;
+    }
+    const data = JSON.parse(item);
+    return Array.isArray(data) && data.every((gateway) => typeof gateway === "string") ? data : void 0;
+  } catch (_) {
+    return void 0;
+  }
+};
+var setSessionListCache = (listUrl, gatewayList) => {
+  const storage = getSessionStorage();
+  if (!storage) {
+    return;
+  }
+  try {
+    storage.setItem(
+      `${IPFS_GATEWAY_LIST_STORAGE_PREFIX}${listUrl}`,
+      JSON.stringify(gatewayList)
+    );
+  } catch (_) {
+  }
+};
+var getSessionDetectCache = (cacheKey) => {
+  const storage = getSessionStorage();
+  if (!storage) {
+    return void 0;
+  }
+  try {
+    const item = storage.getItem(
+      `${IPFS_GATEWAY_DETECT_STORAGE_PREFIX}${cacheKey}`
+    );
+    if (!item) {
+      return void 0;
+    }
+    const result = JSON.parse(item);
+    return result?.data?.url === cacheKey ? result : void 0;
+  } catch (_) {
+    return void 0;
+  }
+};
+var setSessionDetectCache = (cacheKey, result) => {
+  const storage = getSessionStorage();
+  if (!storage) {
+    return;
+  }
+  try {
+    storage.setItem(
+      `${IPFS_GATEWAY_DETECT_STORAGE_PREFIX}${cacheKey}`,
+      JSON.stringify(result)
+    );
+  } catch (_) {
+  }
+};
+var fetchIPFSGatewayListWithoutCache = async ({
+  fetcher = globalThis.fetch,
+  listUrl = IPFS_GATEWAY_LIST_URL,
+  timeout = DEFAULT_TIMEOUT
+} = {}) => {
+  const response = await requestWithTimeout(listUrl, fetcher, timeout);
+  if (!response.ok) {
+    return [];
+  }
+  const data = await response.json();
+  if (!Array.isArray(data)) {
+    return [];
+  }
+  return data.map((gateway) => normalizeIPFSGateway(gateway)).filter((gateway) => Boolean(gateway));
+};
+var fetchIPFSGatewayList = (options = {}) => {
+  const listUrl = options.listUrl ?? IPFS_GATEWAY_LIST_URL;
+  if (options.useCache === false) {
+    return fetchIPFSGatewayListWithoutCache({ ...options, listUrl });
+  }
+  const { gatewayListPromiseMap } = getIPFSGatewayCache();
+  let gatewayListPromise = gatewayListPromiseMap.get(listUrl);
+  if (!gatewayListPromise) {
+    const storedGatewayList = getSessionListCache(listUrl);
+    if (storedGatewayList) {
+      gatewayListPromise = Promise.resolve(storedGatewayList);
+      gatewayListPromiseMap.set(listUrl, gatewayListPromise);
+      return gatewayListPromise;
+    }
+    gatewayListPromise = fetchIPFSGatewayListWithoutCache({
+      ...options,
+      listUrl
+    }).then((gatewayList) => {
+      setSessionListCache(listUrl, gatewayList);
+      return gatewayList;
+    }).catch((error) => {
+      gatewayListPromiseMap.delete(listUrl);
+      throw error;
+    });
+    gatewayListPromiseMap.set(listUrl, gatewayListPromise);
+  }
+  return gatewayListPromise;
+};
+var detectIPFSGateway = async (gateway, {
+  fetcher = globalThis.fetch,
+  cid = IPFS_GATEWAY_SAMPLE_CID,
+  timeout = DEFAULT_TIMEOUT,
+  useDetectCache = true
+} = {}) => {
+  const normalizedGateway = normalizeIPFSGateway(gateway) ?? gateway;
+  const host = hostFromIPFSGateway(normalizedGateway);
+  const url = `${normalizedGateway}/ipfs/${cid}`;
+  const cacheKey = url;
+  if (useDetectCache) {
+    const { gatewayDetectPromiseMap } = getIPFSGatewayCache();
+    const cachedResult = gatewayDetectPromiseMap.get(cacheKey);
+    if (cachedResult) {
+      return cachedResult;
+    }
+    const storedResult = getSessionDetectCache(cacheKey);
+    if (storedResult) {
+      const storedPromise = Promise.resolve(storedResult);
+      gatewayDetectPromiseMap.set(cacheKey, storedPromise);
+      return storedPromise;
+    }
+  }
+  const detectPromise = detectIPFSGatewayWithoutCache({
+    fetcher,
+    timeout,
+    normalizedGateway,
+    host,
+    url
+  }).then((result) => {
+    if (useDetectCache) {
+      setSessionDetectCache(cacheKey, result);
+    }
+    return result;
+  });
+  if (useDetectCache) {
+    const { gatewayDetectPromiseMap } = getIPFSGatewayCache();
+    gatewayDetectPromiseMap.set(cacheKey, detectPromise);
+  }
+  return detectPromise;
+};
+var detectIPFSGatewayWithoutCache = async ({
+  fetcher,
+  timeout,
+  normalizedGateway,
+  host,
+  url
+}) => {
+  const startedAt = Date.now();
+  const baseResult = {
+    data: {
+      gateway: normalizedGateway,
+      host,
+      url
+    }
+  };
+  try {
+    const response = await requestWithTimeout(url, fetcher, timeout);
+    const time = Date.now() - startedAt;
+    const contentType = response.headers.get("content-type");
+    const result = {
+      data: {
+        ...baseResult.data,
+        time,
+        status: response.status,
+        contentType
+      }
+    };
+    if (response.ok && contentType?.startsWith("text/plain")) {
+      return {
+        ...result,
+        code: "OK",
+        message: "success"
+      };
+    }
+    return {
+      ...result,
+      code: "NOT_OK",
+      message: "fetch fail"
+    };
+  } catch (_) {
+    return {
+      ...baseResult,
+      code: "NOT_OK",
+      message: "fetch fail"
+    };
+  }
+};
+var detectIPFSGateways = async ({
+  gateways,
+  pageSize = DEFAULT_PAGE_SIZE,
+  fetcher = globalThis.fetch,
+  cid = IPFS_GATEWAY_SAMPLE_CID,
+  timeout = DEFAULT_TIMEOUT,
+  listUrl = IPFS_GATEWAY_LIST_URL,
+  useCache = true
+} = {}) => {
+  const gatewayList = gateways ?? await fetchIPFSGatewayList({ fetcher, listUrl, timeout, useCache });
+  const results = [];
+  const normalizedGatewayList = gatewayList.map((gateway) => normalizeIPFSGateway(gateway)).filter((gateway) => Boolean(gateway));
+  const safePageSize = Number.isFinite(pageSize) && pageSize > 0 ? Math.max(1, Math.floor(pageSize)) : DEFAULT_PAGE_SIZE;
+  for (let skip = 0; skip < normalizedGatewayList.length; skip += safePageSize) {
+    const taskArray = normalizedGatewayList.slice(skip, skip + safePageSize).map(
+      (gateway) => detectIPFSGateway(gateway, {
+        fetcher,
+        cid,
+        timeout,
+        useDetectCache: useCache
+      })
+    );
+    results.push(...await Promise.all(taskArray));
+  }
+  const availableGateways = results.filter((result) => result.code === "OK" && result.data.time !== void 0).sort((a, b) => Number(a.data.time) - Number(b.data.time));
+  return {
+    fastest: availableGateways[0]?.data.gateway,
+    results,
+    availableGateways
+  };
+};
+export {
+  IPFS_GATEWAY_DETECT_STORAGE_PREFIX,
+  IPFS_GATEWAY_GLOBAL_CACHE_KEY,
+  IPFS_GATEWAY_LIST_STORAGE_PREFIX,
+  IPFS_GATEWAY_LIST_URL,
+  IPFS_GATEWAY_RELOAD_CLEANED_KEY,
+  IPFS_GATEWAY_SAMPLE_CID,
+  clearIPFSGatewayDetectCache,
+  clearIPFSGatewayListCache,
+  detectIPFSGateway,
+  detectIPFSGateways,
+  fetchIPFSGatewayList,
+  hostFromIPFSGateway,
+  normalizeIPFSGateway,
+  tmplFromIPFSGateway
+};
+//# sourceMappingURL=ipfsGateway.js.map