@flaunch/sdk 0.4.1 → 0.4.2

package/dist/index.esm.js

@@ -6921,9 +6921,22 @@ const FlaunchPositionManagerAbi = [
     { stateMutability: "payable", type: "receive" },
 ];
 
+// List of public IPFS gateways to cycle through
+const IPFS_GATEWAYS = [
+    "https://gateway.pinata.cloud/ipfs/",
+    "https://ipfs.io/ipfs/",
+    "https://dweb.link/ipfs/",
+];
+// Counter to track the current gateway index
+let currentGatewayIndex = 0;
 const resolveIPFS = (value) => {
     if (value.startsWith("ipfs://")) {
-        return `https://gateway.pinata.cloud/ipfs/${value.slice(7)}`;
+        const cid = value.slice(7);
+        // Get the next gateway and increment the counter
+        const gateway = IPFS_GATEWAYS[currentGatewayIndex];
+        // Update the counter, cycling back to 0 when we reach the end
+        currentGatewayIndex = (currentGatewayIndex + 1) % IPFS_GATEWAYS.length;
+        return `${gateway}${cid}`;
     }
     return value;
 };
@@ -17558,6 +17571,7 @@ class ReadFlaunchSDK {
         this.TICK_SPACING = TICK_SPACING;
         this.chainId = chainId;
         this.drift = drift;
+        this.resolveIPFS = resolveIPFS;
         this.readPositionManager = new ReadFlaunchPositionManager(FlaunchPositionManagerAddress[this.chainId], drift);
         this.readPositionManagerV1_1 = new ReadFlaunchPositionManagerV1_1(FlaunchPositionManagerV1_1Address[this.chainId], drift);
         this.readPoolManager = new ReadPoolManager(PoolManagerAddress[this.chainId], drift);
@@ -17599,12 +17613,12 @@ class ReadFlaunchSDK {
         const symbol = await memecoin.symbol();
         const tokenURI = await memecoin.tokenURI();
         // get metadata from tokenURI
-        const metadata = (await axios.get(resolveIPFS(tokenURI))).data;
+        const metadata = (await axios.get(this.resolveIPFS(tokenURI))).data;
         return {
             name,
             symbol,
             description: metadata.description ?? "",
-            image: metadata.image ? resolveIPFS(metadata.image) : "",
+            image: metadata.image ? this.resolveIPFS(metadata.image) : "",
             external_link: metadata.websiteUrl ?? "",
             collaborators: metadata.collaborators ?? [],
             discordUrl: metadata.discordUrl ?? "",
@@ -17612,12 +17626,25 @@ class ReadFlaunchSDK {
             telegramUrl: metadata.telegramUrl ?? "",
         };
     }
+    /**
+     * Retrieves metadata for a given Flaunch coin using its token ID & Flaunch contract address
+     * @param flaunch - The address of the Flaunch contract
+     * @param tokenId - The token ID of the coin
+     * @returns The coin's metadata including name, symbol, description, and social links
+     */
     async getCoinMetadataFromTokenId(flaunch, tokenId) {
         const _flaunch = new ReadFlaunch(flaunch, this.drift);
         const coinAddress = await _flaunch.memecoin(tokenId);
         return this.getCoinMetadata(coinAddress);
     }
-    async getCoinMetadataFromTokenIds(params) {
+    /**
+     * Retrieves metadata for multiple Flaunch coins using their token IDs & Flaunch contract addresses
+     * @param params - An array of objects containing flaunch contract address and token ID
+     * @param batchSize - Optional, the number of ipfs requests to process in each batch
+     * @param batchDelay - Optional, the delay in milliseconds between batches
+     * @returns An array of objects containing coin address, name, symbol, description, and social links
+     */
+    async getCoinMetadataFromTokenIds(params, batchSize = 9, batchDelay = 500) {
         const multicall = new ReadMulticall(this.drift);
         // get coin addresses via multicall
         const coinAddresses_calldata = params.map((p) => this.readFlaunch.contract.encodeFunctionData("memecoin", {
@@ -17670,18 +17697,17 @@ class ReadFlaunchSDK {
             results.push({ name, symbol, tokenURI, coinAddress: coinAddresses[i] });
         }
         // Process IPFS requests in batches to avoid rate limiting
-        const batchSize = 3;
         const processedResults = [];
         for (let i = 0; i < results.length; i += batchSize) {
             const batch = results.slice(i, i + batchSize);
             const batchResults = await Promise.all(batch.map(async ({ name, symbol, tokenURI, coinAddress }) => {
-                const metadata = (await axios.get(resolveIPFS(tokenURI))).data;
+                const metadata = (await axios.get(this.resolveIPFS(tokenURI))).data;
                 return {
                     coinAddress,
                     name,
                     symbol,
                     description: metadata.description ?? "",
-                    image: metadata.image ? resolveIPFS(metadata.image) : "",
+                    image: metadata.image ? this.resolveIPFS(metadata.image) : "",
                     external_link: metadata.websiteUrl ?? "",
                     collaborators: metadata.collaborators ?? [],
                     discordUrl: metadata.discordUrl ?? "",
@@ -17692,7 +17718,7 @@ class ReadFlaunchSDK {
             processedResults.push(...batchResults);
             // Add a small delay between batches to avoid rate limiting
             if (i + batchSize < results.length) {
-                await new Promise((resolve) => setTimeout(resolve, 200));
+                await new Promise((resolve) => setTimeout(resolve, batchDelay));
             }
         }
         return processedResults;
@@ -18118,6 +18144,14 @@ class ReadFlaunchSDK {
     flETHIsCurrencyZero(coinAddress) {
         return coinAddress > FLETHAddress[this.chainId];
     }
+    /**
+     * Sets a custom IPFS resolver function
+     * @dev this is used to resolve IPFS hash to a gateway URL
+     * @param resolverFn - Custom function to resolve IPFS URIs
+     */
+    setIPFSResolver(resolverFn) {
+        this.resolveIPFS = resolverFn;
+    }
 }
 class ReadWriteFlaunchSDK extends ReadFlaunchSDK {
     constructor(chainId, drift = createDrift()) {