feat: add getNFTContractInfo

packages/assets-controllers/src/NftController.test.ts

@@ -4901,4 +4901,47 @@ describe('NftController', () => {
 
     expect(updateNftMetadataSpy).not.toHaveBeenCalled();
   });
+
+  describe('getNFTContractInfo', () => {
+    it('fetches NFT collections metadata successfully', async () => {
+      const contractAddresses = [
+        '0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB',
+        '0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB',
+      ];
+      const collections = [
+        {
+          id: contractAddresses[0],
+          name: 'CryptoPunks',
+          slug: 'cryptopunks',
+          symbol: 'PUNK',
+          imageUrl: 'url',
+        },
+        {
+          id: contractAddresses[1],
+          name: 'Kudos',
+          slug: 'kudos',
+          symbol: 'KUDOS',
+          imageUrl: 'url',
+        },
+      ];
+      nock(NFT_API_BASE_URL)
+        .get(
+          `/collections?chainId=0x1&contract=${contractAddresses[0]}&contract=${contractAddresses[1]}`,
+        )
+        .reply(200, {
+          collections,
+        });
+
+      const { nftController } = setupController();
+
+      const response = await nftController.getNFTContractInfo(
+        contractAddresses,
+        ChainId.mainnet,
+      );
+
+      expect(response).toStrictEqual({
+        collections,
+      });
+    });
+  });
 });

packages/assets-controllers/src/NftController.ts

@@ -496,6 +496,12 @@ export class NftController extends BaseController<
     });
   }
 
+  #getNftCollectionApi(): string {
+    // False negative.
+    // eslint-disable-next-line @typescript-eslint/restrict-template-expressions
+    return `${NFT_API_BASE_URL}/collections`;
+  }
+
   /**
    * Request individual NFT information from NFT API.
    *
@@ -1973,6 +1979,34 @@ export class NftController extends BaseController<
     return true;
   }
 
+  /**
+   * Fetches NFT Collection Metadata from the NFT API.
+   *
+   * @param contractAddresses - The contract addresses of the NFTs.
+   * @param chainId - The chain ID of the network where the NFT is located.
+   * @returns NFT collections metadata.
+   */
+  async getNFTContractInfo(
+    contractAddresses: string[],
+    chainId: Hex,
+  ): Promise<{
+    collections: Collection[];
+  }> {
+    const url = new URL(this.#getNftCollectionApi());
+
+    url.searchParams.append('chainId', chainId);
+
+    for (const address of contractAddresses) {
+      url.searchParams.append('contract', address);
+    }
+
+    return await handleFetch(url, {
+      headers: {
+        Version: NFT_API_VERSION,
+      },
+    });
+  }
+
   async _requestApproval(suggestedNftMeta: SuggestedNftMeta) {
     return this.messagingSystem.call(
       'ApprovalController:addRequest',