Release v1.15.1

Origin-SHA: e0b3752f15ed091ffbccb8c51a6174c211d8a14d

Author: ryanio

CHANGELOG.md

@@ -1,5 +1,14 @@
 # @opensea/cli
 
+## 1.15.1
+
+### Patch Changes
+
+- 99a5a9e: Add CLI commands for the remaining public scoped-token endpoints: social follow/watch and relationship/followers/following, watchlist add/remove and token/perpetual watchlist reads, order cancellation, wallet unlink, profile writes (settings, username, image upload, NFT PFP set/clear, shelves), drop editing (edits, allowlist, prereveal/self-mint items, item media), and collection editing (modify, metadata, visibility, image upload).
+- Updated dependencies [8df1f43]
+- Updated dependencies [14fcba5]
+  - @opensea/sdk@11.5.1
+
 ## 1.15.0
 
 ### Minor Changes

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@opensea/cli",
-  "version": "1.15.0",
+  "version": "1.15.1",
   "type": "module",
   "description": "OpenSea CLI - Query the OpenSea API from the command line or programmatically",
   "main": "dist/index.js",
@@ -23,8 +23,8 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@opensea/api-types": "^0.8.2",
-    "@opensea/sdk": "^11.5.0",
+    "@opensea/api-types": "^0.8.3",
+    "@opensea/sdk": "^11.5.1",
     "@opensea/wallet-adapters": "^0.3.3",
     "commander": "^14.0.3",
     "zod": "^4.3.6"

package.json

@@ -15,6 +15,8 @@ import {
   loginCommand,
   nftsCommand,
   offersCommand,
+  ordersCommand,
+  profileCommand,
   searchCommand,
   swapsCommand,
   tokenGroupsCommand,
@@ -144,15 +146,18 @@ program.addCommand(dropsCommand(getClient, getFormat))
 program.addCommand(nftsCommand(getClient, getFormat))
 program.addCommand(listingsCommand(getClient, getFormat))
 program.addCommand(offersCommand(getClient, getFormat))
+program.addCommand(ordersCommand(getClient, getFormat))
 program.addCommand(eventsCommand(getClient, getFormat))
 program.addCommand(accountsCommand(getClient, getFormat))
+program.addCommand(profileCommand(getClient, getFormat))
 program.addCommand(tokensCommand(getClient, getFormat))
 program.addCommand(tokenGroupsCommand(getClient, getFormat))
 program.addCommand(
   authCommand(
     () => program.opts<{ baseUrl?: string }>().baseUrl,
     getFormat,
     () => program.opts<{ authBaseUrl?: string }>().authBaseUrl,
+    getClient,
   ),
 )
 program.addCommand(

src/cli.ts

@@ -1,9 +1,17 @@
 import { Command } from "commander"
 import type { OpenSeaClient } from "../client.js"
 import type { OutputFormat } from "../output.js"
-import { outputGet } from "../output.js"
-import { addPaginationOptions, parseIntOption } from "../parse.js"
-import type { TokenBalanceSortBy } from "../types/index.js"
+import { formatOutput, outputGet } from "../output.js"
+import {
+  addPaginationOptions,
+  parseIntOption,
+  readJsonBodyOption,
+} from "../parse.js"
+import type {
+  FavoriteResponse,
+  TokenBalanceSortBy,
+  WatchlistRequest,
+} from "../types/index.js"
 
 export function accountsCommand(
   getClient: () => OpenSeaClient,
@@ -373,5 +381,186 @@ export function accountsCommand(
     },
   )
 
+  cmd
+    .command("relationship")
+    .description(
+      "Get the authenticated wallet's follow/watch relationship with an account (wallet auth required)",
+    )
+    .argument("<address_or_username>", "Wallet address or OpenSea username")
+    .action(async (addressOrUsername: string) => {
+      const client = getClient()
+      await outputGet(
+        client,
+        getFormat(),
+        `/api/v2/accounts/${addressOrUsername}/relationship`,
+      )
+    })
+
+  addPaginationOptions(
+    cmd
+      .command("followers")
+      .description("List an account's followers")
+      .argument("<address_or_username>", "Wallet address or OpenSea username"),
+  ).action(
+    async (
+      addressOrUsername: string,
+      options: { limit: string; next?: string },
+    ) => {
+      const client = getClient()
+      await outputGet(
+        client,
+        getFormat(),
+        `/api/v2/accounts/${addressOrUsername}/followers`,
+        {
+          limit: parseIntOption(options.limit, "--limit"),
+          cursor: options.next,
+        },
+      )
+    },
+  )
+
+  addPaginationOptions(
+    cmd
+      .command("following")
+      .description("List the accounts an account is following")
+      .argument("<address_or_username>", "Wallet address or OpenSea username"),
+  ).action(
+    async (
+      addressOrUsername: string,
+      options: { limit: string; next?: string },
+    ) => {
+      const client = getClient()
+      await outputGet(
+        client,
+        getFormat(),
+        `/api/v2/accounts/${addressOrUsername}/following`,
+        {
+          limit: parseIntOption(options.limit, "--limit"),
+          cursor: options.next,
+        },
+      )
+    },
+  )
+
+  cmd
+    .command("follow")
+    .description("Follow an account as the authenticated wallet")
+    .argument("<address_or_username>", "Wallet address or OpenSea username")
+    .action(async (addressOrUsername: string) => {
+      const client = getClient()
+      const result = await client.post(
+        `/api/v2/accounts/${addressOrUsername}/follow`,
+      )
+      console.log(formatOutput(result, getFormat()))
+    })
+
+  cmd
+    .command("unfollow")
+    .description("Unfollow an account as the authenticated wallet")
+    .argument("<address_or_username>", "Wallet address or OpenSea username")
+    .action(async (addressOrUsername: string) => {
+      const client = getClient()
+      const result = await client.delete(
+        `/api/v2/accounts/${addressOrUsername}/follow`,
+      )
+      console.log(formatOutput(result, getFormat()))
+    })
+
+  cmd
+    .command("watch")
+    .description("Watch an account as the authenticated wallet")
+    .argument("<address_or_username>", "Wallet address or OpenSea username")
+    .action(async (addressOrUsername: string) => {
+      const client = getClient()
+      const result = await client.post(
+        `/api/v2/accounts/${addressOrUsername}/watch`,
+      )
+      console.log(formatOutput(result, getFormat()))
+    })
+
+  cmd
+    .command("unwatch")
+    .description("Unwatch an account as the authenticated wallet")
+    .argument("<address_or_username>", "Wallet address or OpenSea username")
+    .action(async (addressOrUsername: string) => {
+      const client = getClient()
+      const result = await client.delete(
+        `/api/v2/accounts/${addressOrUsername}/watch`,
+      )
+      console.log(formatOutput(result, getFormat()))
+    })
+
+  cmd
+    .command("token-watchlist")
+    .description(
+      "Get the authenticated wallet's token watchlist (wallet auth required)",
+    )
+    .argument("<address>", "Wallet address")
+    .action(async (address: string) => {
+      const client = getClient()
+      await outputGet(
+        client,
+        getFormat(),
+        `/api/v2/account/${address}/token_watchlist`,
+      )
+    })
+
+  cmd
+    .command("perpetual-watchlist")
+    .description(
+      "Get the authenticated wallet's perpetual watchlist (wallet auth required)",
+    )
+    .argument("<address>", "Wallet address")
+    .action(async (address: string) => {
+      const client = getClient()
+      await outputGet(
+        client,
+        getFormat(),
+        `/api/v2/account/${address}/perpetual_watchlist`,
+      )
+    })
+
+  cmd
+    .command("watchlist-add")
+    .description(
+      "Add an item, collection, or token to the authenticated wallet's watchlist",
+    )
+    .requiredOption(
+      "--body <path>",
+      "Path to JSON file with the WatchlistRequest body",
+    )
+    .action(async (options: { body: string }) => {
+      const client = getClient()
+      const request = readJsonBodyOption<WatchlistRequest>(
+        options.body,
+        "--body",
+      )
+      const result = await client.post<FavoriteResponse>(
+        "/api/v2/watchlist",
+        request,
+      )
+      console.log(formatOutput(result, getFormat()))
+    })
+
+  cmd
+    .command("watchlist-remove")
+    .description("Remove an entry from the authenticated wallet's watchlist")
+    .requiredOption(
+      "--body <path>",
+      "Path to JSON file with the WatchlistRequest body",
+    )
+    .action(async (options: { body: string }) => {
+      const client = getClient()
+      const request = readJsonBodyOption<WatchlistRequest>(
+        options.body,
+        "--body",
+      )
+      const result = await client.delete<FavoriteResponse>(
+        "/api/v2/watchlist",
+        request,
+      )
+      console.log(formatOutput(result, getFormat()))
+    })
+
   return cmd
 }

src/commands/accounts.ts

@@ -26,8 +26,10 @@ import {
   removeToken,
   saveToken,
 } from "../auth/store.js"
+import type { OpenSeaClient } from "../client.js"
 import type { OutputFormat } from "../output.js"
 import { formatOutput } from "../output.js"
+import type { WalletUnlinkResponse } from "../types/index.js"
 
 const DEFAULT_BASE_URL = "https://api.opensea.io"
 
@@ -41,6 +43,7 @@ export function authCommand(
   getBaseUrl: () => string | undefined,
   getFormat: () => OutputFormat,
   getAuthBaseUrl?: () => string | undefined,
+  getClient?: () => OpenSeaClient,
 ): Command {
   const cmd = new Command("auth").description(
     "Authentication and token management",
@@ -251,6 +254,23 @@ export function authCommand(
       },
     )
 
+  cmd
+    .command("unlink-wallet")
+    .description(
+      "Unlink a wallet from the authenticated account (requires write:wallets)",
+    )
+    .argument("<wallet>", "Wallet address to unlink")
+    .action(async (wallet: string) => {
+      if (!getClient) {
+        throw new Error("unlink-wallet is not available in this context")
+      }
+      const client = getClient()
+      const result = await client.delete<WalletUnlinkResponse>(
+        `/api/v2/accounts/wallets/${wallet}`,
+      )
+      console.log(formatOutput(result, getFormat()))
+    })
+
   // --- status ---
   cmd
     .command("status")