Release v10.5.0

Origin-SHA: 177a890fa9ab1976057dbe4c712f5179411215db

Author: ryanio

CHANGELOG.md

@@ -1,5 +1,28 @@
 # @opensea/sdk
 
+## 10.5.0
+
+### Minor Changes
+
+- 051b558: Surface 22 new endpoints added in `@opensea/api-types` 0.4.0 as SDK methods and CLI commands.
+
+  **`@opensea/sdk`** — new methods on `OpenSeaAPI` (and the underlying domain clients):
+
+  - `getTokensBatch`, `getNFTsBatch`, `getCollectionsBatch` — batch lookups
+  - `createListingActions` — ordered approval + Seaport-sign actions for new listings
+  - `deployDropContract`, `getDeployContractReceipt` — drop contract deployment
+  - `transferAssets` — build transactions to transfer NFTs or tokens
+  - `getCollectionOfferAggregates`, `getCollectionHolders`, `getCollectionFloorPrices` — collection analytics
+  - `getTokenPriceHistory`, `getTokenOhlcv`, `getTokenActivity` — token analytics
+  - `getNFTOwners`, `getNFTAnalytics` — NFT analytics
+  - `getPortfolioStats`, `getPortfolioHistory`, `getProfileOffers`, `getProfileOffersReceived`, `getProfileListings`, `getProfileFavorites`, `getProfileCollections` — account profile
+
+  New internal `AssetsAPI` client; new request/response types re-exported through `@opensea/sdk` (from `@opensea/api-types`).
+
+  **`@opensea/cli`** — new commands on the existing `accounts`, `collections`, `nfts`, `tokens`, `listings`, `drops` subcommands, plus a new `assets transfer` subcommand. SDK class methods mirroring the same surface added to `OpenSeaCLI`.
+
+  No removed endpoints; pure additive release.
+
 ## 10.4.0
 
 ### Minor Changes

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opensea/sdk",
-  "version": "10.4.0",
+  "version": "10.5.0",
   "description": "TypeScript SDK for the OpenSea marketplace helps developers build new experiences using NFTs, tokens, and our marketplace data",
   "license": "MIT",
   "author": "OpenSea Developers",
@@ -45,7 +45,7 @@
   "types": "lib/index.d.ts",
   "dependencies": {
     "@noble/hashes": "^2.0.1",
-    "@opensea/api-types": "^0.3.0",
+    "@opensea/api-types": "^0.4.0",
     "@opensea/seaport-js": "^4.1.1",
     "ethers": "^6.16.0"
   },

src/api/accounts.ts

@@ -4,15 +4,36 @@ import {
   getAccountPath,
   getAccountTokensPath,
   getPaymentTokenPath,
+  getPortfolioHistoryPath,
+  getPortfolioStatsPath,
+  getProfileCollectionsPath,
+  getProfileFavoritesPath,
+  getProfileListingsPath,
+  getProfileOffersPath,
+  getProfileOffersReceivedPath,
   getResolveAccountPath,
 } from "./apiPaths"
 import type { Fetcher } from "./fetcher"
 import type {
   GetAccountTokensArgs,
   GetAccountTokensResponse,
+  PortfolioArgs,
+  PortfolioHistoryResponse,
+  PortfolioStatsResponse,
+  ProfileCollectionsArgs,
+  ProfileCollectionsResponse,
+  ProfileFavoritesArgs,
+  ProfileFavoritesResponse,
+  ProfileListingsResponse,
+  ProfileOffersResponse,
+  ProfileOrdersArgs,
   ResolveAccountResponse,
 } from "./types"
 
+function joinArray(value: string[] | undefined): string | undefined {
+  return value && value.length > 0 ? value.join(",") : undefined
+}
+
 /**
  * Account and payment token related API operations
  */
@@ -66,4 +87,113 @@ export class AccountsAPI {
     )
     return response
   }
+
+  /**
+   * Get portfolio stats (net worth, P&L) for an account.
+   */
+  async getPortfolioStats(
+    address: string,
+    args?: PortfolioArgs,
+  ): Promise<PortfolioStatsResponse> {
+    return this.fetcher.get<PortfolioStatsResponse>(
+      getPortfolioStatsPath(address),
+      args,
+    )
+  }
+
+  /**
+   * Get portfolio net-worth history for an account.
+   */
+  async getPortfolioHistory(
+    address: string,
+    args?: PortfolioArgs,
+  ): Promise<PortfolioHistoryResponse> {
+    return this.fetcher.get<PortfolioHistoryResponse>(
+      getPortfolioHistoryPath(address),
+      args,
+    )
+  }
+
+  /**
+   * Get offers received by an account, scoped by collection/chain.
+   */
+  async getProfileOffersReceived(
+    address: string,
+    args?: ProfileOrdersArgs,
+  ): Promise<ProfileOffersResponse> {
+    return this.fetcher.get<ProfileOffersResponse>(
+      getProfileOffersReceivedPath(address),
+      {
+        ...args,
+        collection_slugs: joinArray(args?.collection_slugs),
+        chains: joinArray(args?.chains),
+      },
+    )
+  }
+
+  /**
+   * Get active offers made by an account.
+   */
+  async getProfileOffers(
+    address: string,
+    args?: ProfileOrdersArgs,
+  ): Promise<ProfileOffersResponse> {
+    return this.fetcher.get<ProfileOffersResponse>(
+      getProfileOffersPath(address),
+      {
+        ...args,
+        collection_slugs: joinArray(args?.collection_slugs),
+        chains: joinArray(args?.chains),
+      },
+    )
+  }
+
+  /**
+   * Get active listings for an account.
+   */
+  async getProfileListings(
+    address: string,
+    args?: ProfileOrdersArgs,
+  ): Promise<ProfileListingsResponse> {
+    return this.fetcher.get<ProfileListingsResponse>(
+      getProfileListingsPath(address),
+      {
+        ...args,
+        collection_slugs: joinArray(args?.collection_slugs),
+        chains: joinArray(args?.chains),
+      },
+    )
+  }
+
+  /**
+   * Get items favorited by an account.
+   */
+  async getProfileFavorites(
+    address: string,
+    args?: ProfileFavoritesArgs,
+  ): Promise<ProfileFavoritesResponse> {
+    return this.fetcher.get<ProfileFavoritesResponse>(
+      getProfileFavoritesPath(address),
+      {
+        ...args,
+        chains: joinArray(args?.chains),
+      },
+    )
+  }
+
+  /**
+   * Get collections owned by an account.
+   */
+  async getProfileCollections(
+    address: string,
+    args?: ProfileCollectionsArgs,
+  ): Promise<ProfileCollectionsResponse> {
+    return this.fetcher.get<ProfileCollectionsResponse>(
+      getProfileCollectionsPath(address),
+      {
+        ...args,
+        chains: joinArray(args?.chains),
+      },
+    )
+  }
 }