Release v0.8.6

Origin-SHA: 49f6b1ccdea412dd451b3ecdb71446338fc13e0e

Author: ryanio

CHANGELOG.md

@@ -1,5 +1,12 @@
 # @opensea/api-types
 
+## 0.8.6
+
+### Patch Changes
+
+- 954d547: Add typed account agent status fields and helpers to mark or clear registered
+  agent wallets from the SDK and CLI.
+
 ## 0.8.5
 
 ### Patch Changes

opensea-api.json

@@ -260,6 +260,78 @@
         "x-opensea-auth-scopes": ["write:drops"]
       }
     },
+    "/api/v2/accounts/wallets/{wallet}/agent": {
+      "put": {
+        "tags": ["Account Endpoints"],
+        "summary": "Mark a registered wallet as an agent wallet",
+        "operationId": "mark_wallet_as_agent",
+        "parameters": [
+          {
+            "name": "wallet",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/WalletAgentStatusResponse"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "ApiKeyAuth": [],
+            "WalletAuth": ["write:wallets"]
+          }
+        ],
+        "x-opensea-auth-required": true,
+        "x-opensea-auth-scopes": ["write:wallets"]
+      },
+      "delete": {
+        "tags": ["Account Endpoints"],
+        "summary": "Remove a registered wallet's agent designation",
+        "operationId": "remove_wallet_agent_designation",
+        "parameters": [
+          {
+            "name": "wallet",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/WalletAgentStatusResponse"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "ApiKeyAuth": [],
+            "WalletAuth": ["write:wallets"]
+          }
+        ],
+        "x-opensea-auth-required": true,
+        "x-opensea-auth-scopes": ["write:wallets"]
+      }
+    },
     "/api/v2/watchlist": {
       "post": {
         "tags": ["Account Endpoints"],
@@ -8668,6 +8740,18 @@
         },
         "required": ["media_token", "name"]
       },
+      "WalletAgentStatusResponse": {
+        "type": "object",
+        "properties": {
+          "address": {
+            "type": "string"
+          },
+          "is_agent": {
+            "type": "boolean"
+          }
+        },
+        "required": ["address", "is_agent"]
+      },
       "WatchlistRequest": {
         "type": "object",
         "description": "Request body for managing a watchlist entry",
@@ -16385,6 +16469,10 @@
           "is_verified": {
             "type": "boolean"
           },
+          "is_agent": {
+            "type": "boolean",
+            "description": "Whether the account owner has designated at least one registered wallet as an agent wallet. This is self-declared and is not OpenSea verification."
+          },
           "follower_count": {
             "type": "integer",
             "format": "int64"
@@ -16424,6 +16512,7 @@
           "bio",
           "follower_count",
           "following_count",
+          "is_agent",
           "is_verified",
           "joined_date",
           "social_media_accounts"
@@ -17530,7 +17619,11 @@
             "/api/v2/profile/shelves",
             "/api/v2/profile/shelves/{shelf_id}"
           ],
-          ["/api/v2/accounts/wallets/siwx", "/api/v2/accounts/wallets/{wallet}"]
+          [
+            "/api/v2/accounts/wallets/siwx",
+            "/api/v2/accounts/wallets/{wallet}",
+            "/api/v2/accounts/wallets/{wallet}/agent"
+          ]
         ],
         "x-enum-mcp-tools": [
           ["check_drop_eligibility"],

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opensea/api-types",
-  "version": "0.8.5",
+  "version": "0.8.6",
   "description": "Auto-generated TypeScript types from the OpenSea API OpenAPI spec",
   "license": "MIT",
   "author": "OpenSea Developers",

src/auth-scopes-generated.ts

@@ -103,7 +103,7 @@ export const AUTH_SCOPES = [
     displayName: "Manage linked wallets",
     description: "Link and unlink wallets for the authenticated account",
     group: "write",
-    endpoints: ["/api/v2/accounts/wallets/siwx","/api/v2/accounts/wallets/{wallet}"],
+    endpoints: ["/api/v2/accounts/wallets/siwx","/api/v2/accounts/wallets/{wallet}","/api/v2/accounts/wallets/{wallet}/agent"],
     mcpTools: ["manage_wallets"],
   },
 ] as const satisfies readonly {

src/generated.ts

@@ -28,6 +28,24 @@ export interface paths {
         patch: operations["update_drop_item"];
         trace?: never;
     };
+    "/api/v2/accounts/wallets/{wallet}/agent": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /** Mark a registered wallet as an agent wallet */
+        put: operations["mark_wallet_as_agent"];
+        post?: never;
+        /** Remove a registered wallet's agent designation */
+        delete: operations["remove_wallet_agent_designation"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v2/watchlist": {
         parameters: {
             query?: never;
@@ -2447,6 +2465,10 @@ export interface components {
             /** @description Item traits */
             traits?: components["schemas"]["SelfMintDropItemTraitRequest"][];
         };
+        WalletAgentStatusResponse: {
+            address: string;
+            is_agent: boolean;
+        };
         /** @description Request body for managing a watchlist entry */
         WatchlistRequest: {
             /**
@@ -5807,6 +5829,8 @@ export interface components {
             display_name?: string;
             ens_name?: string;
             is_verified: boolean;
+            /** @description Whether the account owner has designated at least one registered wallet as an agent wallet. This is self-declared and is not OpenSea verification. */
+            is_agent: boolean;
             /** Format: int64 */
             follower_count: number;
             /** Format: int64 */
@@ -6541,6 +6565,50 @@ export interface operations {
             500: components["responses"]["InternalError"];
         };
     };
+    mark_wallet_as_agent: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                wallet: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WalletAgentStatusResponse"];
+                };
+            };
+        };
+    };
+    remove_wallet_agent_designation: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                wallet: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WalletAgentStatusResponse"];
+                };
+            };
+        };
+    };
     add_watchlist_entry: {
         parameters: {
             query?: never;

src/schemas-generated.ts

@@ -322,6 +322,7 @@ export type ValidateMetadataAttribute = Schemas["ValidateMetadataAttribute"]
 export type ValidateMetadataDetails = Schemas["ValidateMetadataDetails"]
 export type ValidateMetadataResponse = Schemas["ValidateMetadataResponse"]
 export type VideoMediaRequest = Schemas["VideoMediaRequest"]
+export type WalletAgentStatusResponse = Schemas["WalletAgentStatusResponse"]
 export type WalletLinkResponse = Schemas["WalletLinkResponse"]
 export type WalletPnlResponse = Schemas["WalletPnlResponse"]
 export type WalletUnlinkResponse = Schemas["WalletUnlinkResponse"]

test/smoke.test.ts

@@ -26,6 +26,7 @@ import type {
   Schemas,
   TokenActivityStatsResponse,
   TokenActivityWindowStatsResponse,
+  WalletAgentStatusResponse,
 } from "../src/index.js"
 import { AUTH_SCOPES } from "../src/index.js"
 
@@ -67,6 +68,7 @@ describe("@opensea/api-types smoke tests", () => {
     type _contract = Contract
     type _tokenActivityStats = TokenActivityStatsResponse
     type _tokenActivityWindowStats = TokenActivityWindowStatsResponse
+    type _walletAgentStatus = WalletAgentStatusResponse
     expect(true).toBe(true)
   })