Release v11.4.0

Origin-SHA: f6f7bb6935b34b86858e8a800e61e4a225ee7bcc

Author: ryanio

CHANGELOG.md

@@ -1,5 +1,21 @@
 # @opensea/sdk
 
+## 11.4.0
+
+### Minor Changes
+
+- df2b152: Add SIWX wallet-link helpers for nonce, message, and link flows.
+- 4bef9a5: Add typed `api.walletAuth` helpers for all 29 scoped wallet operations.
+
+### Patch Changes
+
+- 2459068: Align wallet-auth scope metadata with the production OpenAPI specification.
+- 0df96eb: Enable Seaport support for Robinhood chain. Canonical Seaport 1.6 is deployed on Robinhood (chain id 4663) and configured in the marketplace backend, so the payment-token helpers no longer throw for it: offers use WETH `0x0bd7d308f8e1639fab988df18a8011f41eacad73`, listings use native ETH, and the chain uses the same default conduit as Abstract, HyperEVM, and Monad.
+- Updated dependencies [df2b152]
+- Updated dependencies [2459068]
+- Updated dependencies [4bef9a5]
+  - @opensea/api-types@0.8.0
+
 ## 11.3.0
 
 ### Minor Changes

README.md

@@ -39,6 +39,29 @@ curl -s -X POST https://api.opensea.io/api/v2/auth/keys | jq -r '.api_key'
 
 Happy seafaring!
 
+### Wallet-authenticated API helpers
+
+Pass an exchanged scoped JWT as `authToken`, then use the generated
+`walletAuth` helpers. Server-side allowlist and scope enforcement still apply.
+
+```typescript
+import { OpenSeaAPI } from "@opensea/sdk"
+
+const api = new OpenSeaAPI({
+  apiKey: process.env.OPENSEA_API_KEY,
+  authToken: process.env.OPENSEA_AUTH_TOKEN,
+})
+
+const favorites = await api.walletAuth.getFavorites("0xYOUR_WALLET", {
+  limit: 10,
+})
+await api.walletAuth.updateProfileSettings({ bio: "Building with OpenSea" })
+```
+
+The helper request and response types are generated from the deployed OpenAPI
+operations. Drops, collections, profile shelves, favorites/watchlists, order
+cancellation, and wallet link/unlink are covered.
+
 ## Quick Start
 
 ### With ethers.js

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opensea/sdk",
-  "version": "11.3.0",
+  "version": "11.4.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.7.0",
+    "@opensea/api-types": "^0.8.0",
     "@opensea/seaport-js": "^4.1.1",
     "ethers": "^6.16.0"
   },

src/api/api.ts

@@ -24,7 +24,7 @@ import { ChainsAPI } from "./chains"
 import { CollectionsAPI } from "./collections"
 import { DropsAPI } from "./drops"
 import { EventsAPI } from "./events"
-import type { PostOptions } from "./fetcher"
+import type { HttpMethod, PostOptions } from "./fetcher"
 import { ListingsAPI } from "./listings"
 import { NFTsAPI } from "./nfts"
 import { OffersAPI } from "./offers"
@@ -134,6 +134,7 @@ import {
   type WalletPnlResponse,
   type WalletTokenTransfersArgs,
 } from "./types"
+import { WalletAuthAPI } from "./walletAuth"
 
 /**
  * The API class for the OpenSea SDK.
@@ -171,6 +172,8 @@ export class OpenSeaAPI {
   private dropsAPI: DropsAPI
   private transactionsAPI: TransactionsAPI
   private assetsAPI: AssetsAPI
+  /** Wallet-authenticated scoped REST helpers. */
+  public readonly walletAuth: WalletAuthAPI
 
   /**
    * Create an instance of the OpenSeaAPI
@@ -195,6 +198,7 @@ export class OpenSeaAPI {
     const fetcher = {
       get: this.get.bind(this),
       post: this.post.bind(this),
+      request: this.request.bind(this),
     }
 
     // Initialize specialized API clients
@@ -211,6 +215,7 @@ export class OpenSeaAPI {
     this.dropsAPI = new DropsAPI(fetcher)
     this.transactionsAPI = new TransactionsAPI(fetcher)
     this.assetsAPI = new AssetsAPI(fetcher)
+    this.walletAuth = new WalletAuthAPI(fetcher)
   }
 
   /**
@@ -1338,7 +1343,7 @@ export class OpenSeaAPI {
         const url = qs
           ? `${this.apiBaseUrl}${apiPath}?${qs}`
           : `${this.apiBaseUrl}${apiPath}`
-        const raw = await this._fetch(url, undefined, undefined, options)
+        const raw = await this._fetch(url, "GET", undefined, undefined, options)
         return camelizeKeysDeep(raw) as Camelize<T>
       },
       { logger: this.logger },
@@ -1361,6 +1366,17 @@ export class OpenSeaAPI {
     body?: object,
     headers?: object,
     options?: PostOptions,
+  ): Promise<Camelize<T>> {
+    return this.request("POST", apiPath, body, headers, options)
+  }
+
+  /** Send a typed JSON request to a write endpoint. */
+  public async request<T>(
+    method: HttpMethod,
+    apiPath: string,
+    body?: object,
+    headers?: object,
+    options?: PostOptions,
   ): Promise<Camelize<T>> {
     return executeWithRateLimit(
       async () => {
@@ -1372,7 +1388,7 @@ export class OpenSeaAPI {
         const shouldSnakeize = options?.snakeizeBody !== false
         const wireBody =
           body == null || !shouldSnakeize ? body : snakeizeKeysDeep(body)
-        const raw = await this._fetch(url, headers, wireBody, options)
+        const raw = await this._fetch(url, method, headers, wireBody, options)
         return camelizeKeysDeep(raw) as Camelize<T>
       },
       { logger: this.logger },
@@ -1400,14 +1416,14 @@ export class OpenSeaAPI {
   /**
    * Fetch from an API Endpoint, sending auth token in headers
    * @param url The URL to fetch
+   * @param method HTTP method to use.
    * @param headers Additional headers to send with the request
-   * @param body Optional body to send. HTTP method is inferred: POST if body is
-   *             provided (non-nullish), GET otherwise. This covers all OpenSea API
-   *             endpoints which only use GET and POST.
+   * @param body Optional JSON body to send.
    * @param options Request options like timeout and abort signal
    */
   private async _fetch(
     url: string,
+    method: "GET" | HttpMethod,
     headers?: object,
     body?: object,
     options?: RequestOptions,
@@ -1426,7 +1442,7 @@ export class OpenSeaAPI {
     delete sanitizedHeaders.Authorization
     this.logger(
       `Sending request: ${url} ${JSON.stringify({
-        method: body != null ? "POST" : "GET",
+        method,
         headers: sanitizedHeaders,
         body: body != null ? JSON.stringify(body, null, 2) : undefined,
       })}`,
@@ -1460,7 +1476,7 @@ export class OpenSeaAPI {
 
     try {
       const response = await fetch(url, {
-        method: body != null ? "POST" : "GET",
+        method,
         headers: mergedHeaders,
         body: body != null ? JSON.stringify(body) : undefined,
         signal,
@@ -1497,7 +1513,14 @@ export class OpenSeaAPI {
           `Server Error (${response.status}): ${response.statusText}`,
         )
       }
-      return response.json()
+      if (
+        response.status === 204 ||
+        response.headers.get("content-length") === "0"
+      ) {
+        return undefined
+      }
+      const text = await response.text()
+      return text.length > 0 ? JSON.parse(text) : undefined
     } finally {
       if (timeoutId !== undefined) {
         clearTimeout(timeoutId)

src/api/fetcher.ts

@@ -25,6 +25,8 @@ export interface PostOptions extends RequestOptions {
   snakeizeBody?: boolean
 }
 
+export type HttpMethod = "POST" | "PUT" | "PATCH" | "DELETE"
+
 /**
  * Fetcher context interface for making HTTP requests to the OpenSea API.
  * This interface abstracts the HTTP methods used by specialized API clients.
@@ -64,3 +66,14 @@ export interface Fetcher {
     options?: PostOptions,
   ): Promise<Camelize<T>>
 }
+
+/** Fetcher used by scoped wallet helpers that need every write verb. */
+export interface WalletAuthFetcher extends Fetcher {
+  request<T>(
+    method: HttpMethod,
+    apiPath: string,
+    body?: object,
+    headers?: object,
+    options?: PostOptions,
+  ): Promise<Camelize<T>>
+}

src/api/index.ts

@@ -1,2 +1,3 @@
 export * from "./api"
 export * from "./fetcher"
+export * from "./walletAuth"