web3bio-profile-kit 0.2.5 → 0.2.8

package/dist/types/platform.cjs

@@ -7,8 +7,6 @@
  */
 exports.Platform = void 0;
 (function (Platform) {
-    Platform["ailayer"] = "ailayer";
-    Platform["alienx"] = "alienx";
     Platform["aptos"] = "aptos";
     Platform["arbitrum"] = "arbitrum";
     Platform["basenames"] = "basenames";
@@ -23,8 +21,6 @@ exports.Platform = void 0;
     Platform["clusters"] = "clusters";
     Platform["coinbase"] = "coinbase";
     Platform["coingecko"] = "coingecko";
-    Platform["cosmos"] = "cosmos";
-    Platform["cyberconnect"] = "cyberconnect";
     Platform["deepdao"] = "deepdao";
     Platform["degenscore"] = "degenscore";
     Platform["dentity"] = "dentity";
@@ -33,7 +29,6 @@ exports.Platform = void 0;
     Platform["dotbit"] = "dotbit";
     Platform["dns"] = "dns";
     Platform["ecp"] = "ecp";
-    Platform["edgeless"] = "edgeless";
     Platform["efp"] = "efp";
     Platform["ens"] = "ens";
     Platform["ethereum"] = "ethereum";
@@ -55,18 +50,13 @@ exports.Platform = void 0;
     Platform["interface"] = "interface";
     Platform["keybase"] = "keybase";
     Platform["lens"] = "lens";
-    Platform["lightlink"] = "lightlink";
     Platform["linkedin"] = "linkedin";
     Platform["linea"] = "linea";
     Platform["lobsters"] = "lobsters";
-    Platform["manta"] = "manta";
     Platform["matters"] = "matters";
     Platform["medium"] = "medium";
-    Platform["merlin"] = "merlin";
     Platform["minds"] = "minds";
-    Platform["mint"] = "mint";
     Platform["mirror"] = "mirror";
-    Platform["mode"] = "mode";
     Platform["mstdnjp"] = "mstdnjp";
     Platform["near"] = "near";
     Platform["nextid"] = "nextid";
@@ -88,13 +78,11 @@ exports.Platform = void 0;
     Platform["space_id"] = "space_id";
     Platform["stacks"] = "stacks";
     Platform["substack"] = "substack";
-    Platform["taiko"] = "taiko";
     Platform["talent"] = "talentprotocol";
     Platform["tally"] = "tally";
     Platform["telegram"] = "telegram";
     Platform["threads"] = "threads";
     Platform["tiktok"] = "tiktok";
-    Platform["tomo"] = "tomo";
     Platform["ton"] = "ton";
     Platform["tron"] = "tron";
     Platform["twitter"] = "twitter";
@@ -109,8 +97,6 @@ exports.Platform = void 0;
     Platform["world_id"] = "world_id";
     Platform["xmtp"] = "xmtp";
     Platform["youtube"] = "youtube";
-    Platform["zeta"] = "zeta";
-    Platform["zkfair"] = "zkfair";
     Platform["zkme"] = "zkme";
     Platform["zora"] = "zora";
 })(exports.Platform || (exports.Platform = {}));

package/dist/types/platform.d.ts

@@ -4,8 +4,6 @@
  * @public
  */
 export declare enum Platform {
-    ailayer = "ailayer",
-    alienx = "alienx",
     aptos = "aptos",
     arbitrum = "arbitrum",
     basenames = "basenames",
@@ -20,8 +18,6 @@ export declare enum Platform {
     clusters = "clusters",
     coinbase = "coinbase",
     coingecko = "coingecko",
-    cosmos = "cosmos",
-    cyberconnect = "cyberconnect",
     deepdao = "deepdao",
     degenscore = "degenscore",
     dentity = "dentity",
@@ -30,7 +26,6 @@ export declare enum Platform {
     dotbit = "dotbit",
     dns = "dns",
     ecp = "ecp",
-    edgeless = "edgeless",
     efp = "efp",
     ens = "ens",
     ethereum = "ethereum",
@@ -52,18 +47,13 @@ export declare enum Platform {
     interface = "interface",
     keybase = "keybase",
     lens = "lens",
-    lightlink = "lightlink",
     linkedin = "linkedin",
     linea = "linea",
     lobsters = "lobsters",
-    manta = "manta",
     matters = "matters",
     medium = "medium",
-    merlin = "merlin",
     minds = "minds",
-    mint = "mint",
     mirror = "mirror",
-    mode = "mode",
     mstdnjp = "mstdnjp",
     near = "near",
     nextid = "nextid",
@@ -85,13 +75,11 @@ export declare enum Platform {
     space_id = "space_id",
     stacks = "stacks",
     substack = "substack",
-    taiko = "taiko",
     talent = "talentprotocol",
     tally = "tally",
     telegram = "telegram",
     threads = "threads",
     tiktok = "tiktok",
-    tomo = "tomo",
     ton = "ton",
     tron = "tron",
     twitter = "twitter",
@@ -106,8 +94,6 @@ export declare enum Platform {
     world_id = "world_id",
     xmtp = "xmtp",
     youtube = "youtube",
-    zeta = "zeta",
-    zkfair = "zkfair",
     zkme = "zkme",
     zora = "zora"
 }

package/dist/types/platform.js

@@ -5,8 +5,6 @@
  */
 var Platform;
 (function (Platform) {
-    Platform["ailayer"] = "ailayer";
-    Platform["alienx"] = "alienx";
     Platform["aptos"] = "aptos";
     Platform["arbitrum"] = "arbitrum";
     Platform["basenames"] = "basenames";
@@ -21,8 +19,6 @@ var Platform;
     Platform["clusters"] = "clusters";
     Platform["coinbase"] = "coinbase";
     Platform["coingecko"] = "coingecko";
-    Platform["cosmos"] = "cosmos";
-    Platform["cyberconnect"] = "cyberconnect";
     Platform["deepdao"] = "deepdao";
     Platform["degenscore"] = "degenscore";
     Platform["dentity"] = "dentity";
@@ -31,7 +27,6 @@ var Platform;
     Platform["dotbit"] = "dotbit";
     Platform["dns"] = "dns";
     Platform["ecp"] = "ecp";
-    Platform["edgeless"] = "edgeless";
     Platform["efp"] = "efp";
     Platform["ens"] = "ens";
     Platform["ethereum"] = "ethereum";
@@ -53,18 +48,13 @@ var Platform;
     Platform["interface"] = "interface";
     Platform["keybase"] = "keybase";
     Platform["lens"] = "lens";
-    Platform["lightlink"] = "lightlink";
     Platform["linkedin"] = "linkedin";
     Platform["linea"] = "linea";
     Platform["lobsters"] = "lobsters";
-    Platform["manta"] = "manta";
     Platform["matters"] = "matters";
     Platform["medium"] = "medium";
-    Platform["merlin"] = "merlin";
     Platform["minds"] = "minds";
-    Platform["mint"] = "mint";
     Platform["mirror"] = "mirror";
-    Platform["mode"] = "mode";
     Platform["mstdnjp"] = "mstdnjp";
     Platform["near"] = "near";
     Platform["nextid"] = "nextid";
@@ -86,13 +76,11 @@ var Platform;
     Platform["space_id"] = "space_id";
     Platform["stacks"] = "stacks";
     Platform["substack"] = "substack";
-    Platform["taiko"] = "taiko";
     Platform["talent"] = "talentprotocol";
     Platform["tally"] = "tally";
     Platform["telegram"] = "telegram";
     Platform["threads"] = "threads";
     Platform["tiktok"] = "tiktok";
-    Platform["tomo"] = "tomo";
     Platform["ton"] = "ton";
     Platform["tron"] = "tron";
     Platform["twitter"] = "twitter";
@@ -107,8 +95,6 @@ var Platform;
     Platform["world_id"] = "world_id";
     Platform["xmtp"] = "xmtp";
     Platform["youtube"] = "youtube";
-    Platform["zeta"] = "zeta";
-    Platform["zkfair"] = "zkfair";
     Platform["zkme"] = "zkme";
     Platform["zora"] = "zora";
 })(Platform || (Platform = {}));

package/dist/types/source.cjs

@@ -29,16 +29,19 @@ exports.Source = void 0;
     Source["keybase"] = "keybase";
     Source["lens"] = "lens";
     Source["linea"] = "linea";
+    Source["magiceden"] = "magiceden";
     Source["metopia"] = "metopia";
     Source["mirror"] = "mirror";
     Source["nextid"] = "nextid";
     Source["nftd"] = "nftd";
     Source["nostr"] = "nostr";
     Source["opensea"] = "opensea";
+    Source["opinion"] = "opinion";
     Source["paragraph"] = "paragraph";
     Source["particle"] = "particle";
     Source["polymarket"] = "polymarket";
     Source["ppl"] = "ppl";
+    Source["predictfun"] = "predictfun";
     Source["privy"] = "privy";
     Source["questn"] = "questn";
     Source["rarible"] = "rarible";

package/dist/types/source.d.ts

@@ -26,16 +26,19 @@ export declare enum Source {
     keybase = "keybase",
     lens = "lens",
     linea = "linea",
+    magiceden = "magiceden",
     metopia = "metopia",
     mirror = "mirror",
     nextid = "nextid",
     nftd = "nftd",
     nostr = "nostr",
     opensea = "opensea",
+    opinion = "opinion",
     paragraph = "paragraph",
     particle = "particle",
     polymarket = "polymarket",
     ppl = "ppl",
+    predictfun = "predictfun",
     privy = "privy",
     questn = "questn",
     rarible = "rarible",

package/dist/types/source.js

@@ -27,16 +27,19 @@ var Source;
     Source["keybase"] = "keybase";
     Source["lens"] = "lens";
     Source["linea"] = "linea";
+    Source["magiceden"] = "magiceden";
     Source["metopia"] = "metopia";
     Source["mirror"] = "mirror";
     Source["nextid"] = "nextid";
     Source["nftd"] = "nftd";
     Source["nostr"] = "nostr";
     Source["opensea"] = "opensea";
+    Source["opinion"] = "opinion";
     Source["paragraph"] = "paragraph";
     Source["particle"] = "particle";
     Source["polymarket"] = "polymarket";
     Source["ppl"] = "ppl";
+    Source["predictfun"] = "predictfun";
     Source["privy"] = "privy";
     Source["questn"] = "questn";
     Source["rarible"] = "rarible";

package/dist/utils/helpers.cjs

@@ -10,6 +10,29 @@ var platform$1 = require('./platform.cjs');
 var regex = require('./regex.cjs');
 
 const PROFILE_API_ENDPOINT = "https://api.web3.bio";
+const FARCASTER_SUFFIXES = [".farcaster", ".fcast.id", ".farcaster.eth"];
+const CHAIN_ALIASES = [".base", ".linea"];
+const hasAnySuffix = (value, suffixes) => suffixes.some((suffix) => value.endsWith(suffix));
+const getSuffixAfterLastDot = (value) => {
+    const lastDotIndex = value.lastIndexOf(".");
+    return lastDotIndex === -1 ? null : value.slice(lastDotIndex + 1);
+};
+const removeWeb2PlatformSuffix = (value) => {
+    const suffix = getSuffixAfterLastDot(value);
+    if (!suffix || !platform$1.isWeb2Platform(suffix))
+        return value;
+    return value.slice(0, -(suffix.length + 1));
+};
+const normalizeChainAliasToEth = (value) => {
+    const [name, ...rest] = value.split(".");
+    const chain = rest[rest.length - 1];
+    return `${name}.${chain}.eth`;
+};
+const withPlatformEthSuffix = (value, shortSuffix, fullSuffix) => {
+    if (value.endsWith(fullSuffix))
+        return value;
+    return value.endsWith(shortSuffix) ? `${value}.eth` : `${value}${fullSuffix}`;
+};
 /**
  * Resolves an identity string to a platform and identifier
  * @param input The identity to resolve
@@ -50,24 +73,14 @@ const prettify = (input) => {
         return "";
     if (input.startsWith("farcaster,#"))
         return input.replace(/^(farcaster),/, "");
-    if (input.endsWith(".farcaster") ||
-        input.endsWith(".fcast.id") ||
-        input.endsWith(".farcaster.eth")) {
+    if (hasAnySuffix(input, FARCASTER_SUFFIXES)) {
         return input.replace(/(\.farcaster|\.fcast\.id|\.farcaster\.eth)$/, "");
     }
-    if (input.endsWith(".base") || input.endsWith(".linea")) {
-        const parts = input.split(".");
-        return `${parts[0]}.${parts[parts.length - 1]}.eth`;
-    }
-    // for all web2 platform prettify format as "identity.platform"
-    const lastDotIndex = input.lastIndexOf(".");
-    if (lastDotIndex !== -1) {
-        const suffix = input.slice(lastDotIndex + 1);
-        if (platform$1.isWeb2Platform(suffix)) {
-            return input.slice(0, lastDotIndex);
-        }
+    if (hasAnySuffix(input, CHAIN_ALIASES)) {
+        return normalizeChainAliasToEth(input);
     }
-    return input;
+    // For all web2 platforms prettify format as "identity.platform".
+    return removeWeb2PlatformSuffix(input);
 };
 /**
  * Fufill and standardize identity format
@@ -77,25 +90,15 @@ const uglify = (input, platform$1) => {
         return "";
     switch (platform$1) {
         case platform.Platform.farcaster:
-            return input.endsWith(".farcaster") ||
-                input.endsWith(".fcast.id") ||
-                input.endsWith(".farcaster.eth")
+            return hasAnySuffix(input, FARCASTER_SUFFIXES)
                 ? input
                 : `${input}.farcaster`;
         case platform.Platform.lens:
             return input.endsWith(".lens") ? input : `${input}.lens`;
         case platform.Platform.basenames:
-            return input.endsWith(".base.eth")
-                ? input
-                : input.endsWith(".base")
-                    ? `${input}.eth`
-                    : `${input}.base.eth`;
+            return withPlatformEthSuffix(input, ".base", ".base.eth");
         case platform.Platform.linea:
-            return input.endsWith(".linea.eth")
-                ? input
-                : input.endsWith(".linea")
-                    ? `${input}.eth`
-                    : `${input}.linea.eth`;
+            return withPlatformEthSuffix(input, ".linea", ".linea.eth");
         default:
             return input;
     }
@@ -128,9 +131,7 @@ const SUPPORTED_PLATFORMS = new Set([
  * Check if the platform is supported for API queries
  */
 const isSupportedPlatform = (platform) => {
-    if (!platform)
-        return false;
-    return SUPPORTED_PLATFORMS.has(platform);
+    return !!platform && SUPPORTED_PLATFORMS.has(platform);
 };
 const platformMap = new Map([
     [regex.REGEX.BASENAMES, platform.Platform.basenames],
@@ -155,19 +156,16 @@ const platformMap = new Map([
  * Detect platform from identity string based on regex patterns
  */
 const detectPlatform = (term) => {
-    if (/\.(farcaster\.eth|farcaster|fcast\.id)$/.test(term))
+    if (hasAnySuffix(term, FARCASTER_SUFFIXES))
         return platform.Platform.farcaster;
-    for (const [regex, Platform] of platformMap) {
+    for (const [regex, platform] of platformMap) {
         if (regex.test(term)) {
-            return Platform;
+            return platform;
         }
     }
-    const lastDotIndex = term.lastIndexOf(".");
-    if (lastDotIndex !== -1) {
-        const suffix = term.slice(lastDotIndex + 1);
-        if (platform$1.PLATFORM_DATA.has(suffix))
-            return suffix;
-    }
+    const suffix = getSuffixAfterLastDot(term);
+    if (suffix && platform$1.PLATFORM_DATA.has(suffix))
+        return suffix;
     return term.includes(".") ? platform.Platform.ens : platform.Platform.farcaster;
 };
 /**
@@ -189,9 +187,7 @@ const getApiKey = (userProvidedKey) => {
  * @returns True if addresses match (ignoring case), false otherwise
  */
 const isSameAddress = (address, otherAddress) => {
-    if (!address || !otherAddress)
-        return false;
-    return address.toLowerCase() === otherAddress.toLowerCase();
+    return !!address && !!otherAddress && address.toLowerCase() === otherAddress.toLowerCase();
 };
 const web3AddressRegexes = [
     regex.REGEX.ETH_ADDRESS,
@@ -234,7 +230,7 @@ const isValidEthereumAddress = (address) => {
  * @returns True if the string is a valid Solana address, false otherwise
  */
 const isValidSolanaAddress = (address) => {
-    return regex.REGEX.SOLANA_ADDRESS.test(address);
+    return !!address && regex.REGEX.SOLANA_ADDRESS.test(address);
 };
 /**
  * Converts an identity string to a JSON object with platform and identity
@@ -250,7 +246,11 @@ const idToJson = (input) => {
     const id = resolveIdentity(input);
     if (!id)
         return null;
-    const [_platform, _identity] = id.split(",");
+    const separatorIndex = id.indexOf(",");
+    if (separatorIndex === -1)
+        return null;
+    const _platform = id.slice(0, separatorIndex);
+    const _identity = id.slice(separatorIndex + 1);
     return {
         platform: _platform,
         identity: _identity,

package/dist/utils/helpers.js

@@ -4,10 +4,33 @@ import '../types/hook.js';
 import '../types/source.js';
 import '../types/cointype.js';
 import '../types/credential.js';
-import { isWeb2Platform, PLATFORM_DATA } from './platform.js';
+import { PLATFORM_DATA, isWeb2Platform } from './platform.js';
 import { REGEX } from './regex.js';
 
 const PROFILE_API_ENDPOINT = "https://api.web3.bio";
+const FARCASTER_SUFFIXES = [".farcaster", ".fcast.id", ".farcaster.eth"];
+const CHAIN_ALIASES = [".base", ".linea"];
+const hasAnySuffix = (value, suffixes) => suffixes.some((suffix) => value.endsWith(suffix));
+const getSuffixAfterLastDot = (value) => {
+    const lastDotIndex = value.lastIndexOf(".");
+    return lastDotIndex === -1 ? null : value.slice(lastDotIndex + 1);
+};
+const removeWeb2PlatformSuffix = (value) => {
+    const suffix = getSuffixAfterLastDot(value);
+    if (!suffix || !isWeb2Platform(suffix))
+        return value;
+    return value.slice(0, -(suffix.length + 1));
+};
+const normalizeChainAliasToEth = (value) => {
+    const [name, ...rest] = value.split(".");
+    const chain = rest[rest.length - 1];
+    return `${name}.${chain}.eth`;
+};
+const withPlatformEthSuffix = (value, shortSuffix, fullSuffix) => {
+    if (value.endsWith(fullSuffix))
+        return value;
+    return value.endsWith(shortSuffix) ? `${value}.eth` : `${value}${fullSuffix}`;
+};
 /**
  * Resolves an identity string to a platform and identifier
  * @param input The identity to resolve
@@ -48,24 +71,14 @@ const prettify = (input) => {
         return "";
     if (input.startsWith("farcaster,#"))
         return input.replace(/^(farcaster),/, "");
-    if (input.endsWith(".farcaster") ||
-        input.endsWith(".fcast.id") ||
-        input.endsWith(".farcaster.eth")) {
+    if (hasAnySuffix(input, FARCASTER_SUFFIXES)) {
         return input.replace(/(\.farcaster|\.fcast\.id|\.farcaster\.eth)$/, "");
     }
-    if (input.endsWith(".base") || input.endsWith(".linea")) {
-        const parts = input.split(".");
-        return `${parts[0]}.${parts[parts.length - 1]}.eth`;
-    }
-    // for all web2 platform prettify format as "identity.platform"
-    const lastDotIndex = input.lastIndexOf(".");
-    if (lastDotIndex !== -1) {
-        const suffix = input.slice(lastDotIndex + 1);
-        if (isWeb2Platform(suffix)) {
-            return input.slice(0, lastDotIndex);
-        }
+    if (hasAnySuffix(input, CHAIN_ALIASES)) {
+        return normalizeChainAliasToEth(input);
     }
-    return input;
+    // For all web2 platforms prettify format as "identity.platform".
+    return removeWeb2PlatformSuffix(input);
 };
 /**
  * Fufill and standardize identity format
@@ -75,25 +88,15 @@ const uglify = (input, platform) => {
         return "";
     switch (platform) {
         case Platform.farcaster:
-            return input.endsWith(".farcaster") ||
-                input.endsWith(".fcast.id") ||
-                input.endsWith(".farcaster.eth")
+            return hasAnySuffix(input, FARCASTER_SUFFIXES)
                 ? input
                 : `${input}.farcaster`;
         case Platform.lens:
             return input.endsWith(".lens") ? input : `${input}.lens`;
         case Platform.basenames:
-            return input.endsWith(".base.eth")
-                ? input
-                : input.endsWith(".base")
-                    ? `${input}.eth`
-                    : `${input}.base.eth`;
+            return withPlatformEthSuffix(input, ".base", ".base.eth");
         case Platform.linea:
-            return input.endsWith(".linea.eth")
-                ? input
-                : input.endsWith(".linea")
-                    ? `${input}.eth`
-                    : `${input}.linea.eth`;
+            return withPlatformEthSuffix(input, ".linea", ".linea.eth");
         default:
             return input;
     }
@@ -126,9 +129,7 @@ const SUPPORTED_PLATFORMS = new Set([
  * Check if the platform is supported for API queries
  */
 const isSupportedPlatform = (platform) => {
-    if (!platform)
-        return false;
-    return SUPPORTED_PLATFORMS.has(platform);
+    return !!platform && SUPPORTED_PLATFORMS.has(platform);
 };
 const platformMap = new Map([
     [REGEX.BASENAMES, Platform.basenames],
@@ -153,19 +154,16 @@ const platformMap = new Map([
  * Detect platform from identity string based on regex patterns
  */
 const detectPlatform = (term) => {
-    if (/\.(farcaster\.eth|farcaster|fcast\.id)$/.test(term))
+    if (hasAnySuffix(term, FARCASTER_SUFFIXES))
         return Platform.farcaster;
-    for (const [regex, Platform] of platformMap) {
+    for (const [regex, platform] of platformMap) {
         if (regex.test(term)) {
-            return Platform;
+            return platform;
         }
     }
-    const lastDotIndex = term.lastIndexOf(".");
-    if (lastDotIndex !== -1) {
-        const suffix = term.slice(lastDotIndex + 1);
-        if (PLATFORM_DATA.has(suffix))
-            return suffix;
-    }
+    const suffix = getSuffixAfterLastDot(term);
+    if (suffix && PLATFORM_DATA.has(suffix))
+        return suffix;
     return term.includes(".") ? Platform.ens : Platform.farcaster;
 };
 /**
@@ -187,9 +185,7 @@ const getApiKey = (userProvidedKey) => {
  * @returns True if addresses match (ignoring case), false otherwise
  */
 const isSameAddress = (address, otherAddress) => {
-    if (!address || !otherAddress)
-        return false;
-    return address.toLowerCase() === otherAddress.toLowerCase();
+    return !!address && !!otherAddress && address.toLowerCase() === otherAddress.toLowerCase();
 };
 const web3AddressRegexes = [
     REGEX.ETH_ADDRESS,
@@ -232,7 +228,7 @@ const isValidEthereumAddress = (address) => {
  * @returns True if the string is a valid Solana address, false otherwise
  */
 const isValidSolanaAddress = (address) => {
-    return REGEX.SOLANA_ADDRESS.test(address);
+    return !!address && REGEX.SOLANA_ADDRESS.test(address);
 };
 /**
  * Converts an identity string to a JSON object with platform and identity
@@ -248,7 +244,11 @@ const idToJson = (input) => {
     const id = resolveIdentity(input);
     if (!id)
         return null;
-    const [_platform, _identity] = id.split(",");
+    const separatorIndex = id.indexOf(",");
+    if (separatorIndex === -1)
+        return null;
+    const _platform = id.slice(0, separatorIndex);
+    const _identity = id.slice(separatorIndex + 1);
     return {
         platform: _platform,
         identity: _identity,

package/dist/utils/ipfs.cjs

@@ -9,35 +9,43 @@ const MATCH_IPFS_CID_RE = new RegExp(IPFS_CID_PATTERN);
 const MATCH_IPFS_CID_AT_STARTS_RE = new RegExp(`^https://(?:${IPFS_CID_PATTERN})`);
 const MATCH_IPFS_CID_AND_PATHNAME_RE = new RegExp(`(?:${IPFS_CID_PATTERN})(?:/.*)?`);
 const CORS_HOST_RE = new RegExp(`^(?:${CORS_HOST}|${CF_IPFS_HOST})\\??`);
+const tryDecodeURIComponent = (value) => {
+    try {
+        return decodeURIComponent(value);
+    }
+    catch (_a) {
+        return value;
+    }
+};
 const resolveIPFS_CID = (str) => { var _a; return (_a = str.match(MATCH_IPFS_CID_RE)) === null || _a === void 0 ? void 0 : _a[0]; };
 const isIPFS = (str) => MATCH_IPFS_CID_RE.test(str);
 function resolveIPFS_URL(cidOrURL) {
     if (!cidOrURL)
         return cidOrURL;
-    // Normalize input by trimming and decoding
+    // Normalize input by trimming and decoding.
     const queryIndex = cidOrURL.indexOf("?");
-    let normalizedURL = decodeURIComponent(queryIndex !== -1 ? cidOrURL.slice(0, queryIndex) : cidOrURL);
-    // Handle CORS proxies first
+    let normalizedURL = tryDecodeURIComponent(queryIndex !== -1 ? cidOrURL.slice(0, queryIndex) : cidOrURL);
+    // Handle CORS proxies first.
     if (normalizedURL.startsWith(CORS_HOST) ||
         normalizedURL.startsWith(CF_IPFS_HOST)) {
         normalizedURL = normalizedURL.replace(CORS_HOST_RE, "");
-        // Continue processing the URL without the proxy prefix
+        // Continue processing the URL without the proxy prefix.
     }
-    // Handle ipfs.io URLs
-    if (normalizedURL.startsWith("https://ipfs.io")) {
+    // Handle ipfs.io URLs.
+    if (normalizedURL.startsWith(IPFS_GATEWAY_HOST)) {
         const dataMatch = normalizedURL.match(MATCH_IPFS_DATA_RE);
         if (dataMatch === null || dataMatch === void 0 ? void 0 : dataMatch[1]) {
-            return decodeURIComponent(dataMatch[1]);
+            return tryDecodeURIComponent(dataMatch[1]);
         }
         return normalizedURL;
     }
-    // Handle ipfs protocol and CIDs
+    // Handle ipfs protocol and CIDs.
     if (normalizedURL.includes("ipfs:") || isIPFS(normalizedURL)) {
-        // Convert ipfs:// protocol to CID format
+        // Convert ipfs:// protocol to CID format.
         if (normalizedURL.startsWith("ipfs://")) {
             normalizedURL = normalizedURL.slice(7);
         }
-        // Handle URLs that start with a CID
+        // Handle URLs that start with a CID.
         if (MATCH_IPFS_CID_AT_STARTS_RE.test(normalizedURL)) {
             try {
                 const url = new URL(normalizedURL);
@@ -51,7 +59,7 @@ function resolveIPFS_URL(cidOrURL) {
                 console.debug("Failed to parse URL with CID", { normalizedURL, error });
             }
         }
-        // Handle bare CIDs or CIDs with paths
+        // Handle bare CIDs or CIDs with paths.
         const pathMatch = normalizedURL.match(MATCH_IPFS_CID_AND_PATHNAME_RE);
         if (pathMatch === null || pathMatch === void 0 ? void 0 : pathMatch[0]) {
             return `${IPFS_GATEWAY_HOST}/ipfs/${pathMatch[0]}`;