Sync from opensea-devtools

Author: ryanio

src/sdk.ts

@@ -4,9 +4,11 @@ import type {
   Account,
   AccountResolveResponse,
   AssetEvent,
+  AssetMetadataResponse,
   Chain,
   ChainListResponse,
   Collection,
+  CollectionDetailedResponse,
   CollectionOrderBy,
   CollectionPaginatedResponse,
   CollectionStats,
@@ -284,6 +286,24 @@ class NFTsAPI {
       params,
     )
   }
+
+  async getCollection(
+    chain: Chain,
+    address: string,
+    identifier: string,
+  ): Promise<CollectionDetailedResponse> {
+    return this.client.get(
+      `/api/v2/chain/${chain}/contract/${address}/nfts/${identifier}/collection`,
+    )
+  }
+
+  async getMetadata(
+    chain: Chain,
+    address: string,
+    tokenId: string,
+  ): Promise<AssetMetadataResponse> {
+    return this.client.get(`/api/v2/metadata/${chain}/${address}/${tokenId}`)
+  }
 }
 
 class ListingsAPI {

src/types/api.ts

@@ -66,6 +66,7 @@ export type DropPaginatedResponse = Schemas["DropPaginatedResponse"]
 export type DropMintRequest = Schemas["DropMintRequest"]
 export type DropMintResponse = Schemas["DropMintResponse"]
 export type AccountResolveResponse = Schemas["AccountResolveResponse"]
+export type AssetMetadataResponse = Schemas["AssetMetadataResponse"]
 
 // ── CLI-specific types (not from API spec) ──────────────────────────
 

test/sdk.test.ts

@@ -216,6 +216,25 @@ describe("OpenSeaCLI", () => {
         "/api/v2/chain/ethereum/contract/0xabc",
       )
     })
+
+    it("getCollection calls correct endpoint", async () => {
+      mockGet.mockResolvedValue({
+        name: "Art Blocks",
+        collection: "art-blocks",
+      })
+      const result = await sdk.nfts.getCollection("ethereum", "0xabc", "42")
+      expect(mockGet).toHaveBeenCalledWith(
+        "/api/v2/chain/ethereum/contract/0xabc/nfts/42/collection",
+      )
+      expect(result.name).toBe("Art Blocks")
+    })
+
+    it("getMetadata calls correct endpoint", async () => {
+      mockGet.mockResolvedValue({ name: "Cool NFT", traits: [] })
+      const result = await sdk.nfts.getMetadata("ethereum", "0xabc", "1")
+      expect(mockGet).toHaveBeenCalledWith("/api/v2/metadata/ethereum/0xabc/1")
+      expect(result.name).toBe("Cool NFT")
+    })
   })
 
   describe("listings", () => {