Release v2.11.2

Origin-SHA: 6e70c083664cd32ba233423dda3c02071b7fdffb

### Patch Changes

- e83546e: Docs: the README search examples use `opensea search <query> --types collection` and `client.search.query(...)`, the syntax the CLI and SDK accept.
- 6b30bd0: `opensea drops deploy` validates `--drop-type` and `--token-type` against the values the API accepts before sending a request, and `--send` refuses a contract-creation deploy (`erc721_standard`, which has no `to` address) with a clear message instead of sending it.
- Updated dependencies [e83546e]
- Updated dependencies [e83546e]
- Updated dependencies [86b3bcd]
- Updated dependencies [6b30bd0]
  - @opensea/api-types@0.16.0
  - @opensea/sdk@12.11.3

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

Author: 3 people

CHANGELOG.md

@@ -1,5 +1,18 @@
 # @opensea/cli
 
+## 2.11.2
+
+### Patch Changes
+
+- e83546e: Docs: the README search examples use `opensea search <query> --types collection` and `client.search.query(...)`, the syntax the CLI and SDK accept.
+- 6b30bd0: `opensea drops deploy` validates `--drop-type` and `--token-type` against the values the API accepts before sending a request, and `--send` refuses a contract-creation deploy (`erc721_standard`, which has no `to` address) with a clear message instead of sending it.
+- Updated dependencies [e83546e]
+- Updated dependencies [e83546e]
+- Updated dependencies [86b3bcd]
+- Updated dependencies [6b30bd0]
+  - @opensea/api-types@0.16.0
+  - @opensea/sdk@12.11.3
+
 ## 2.11.1
 
 ### Patch Changes

README.md

@@ -96,7 +96,7 @@ opensea nfts list-by-collection mfers --limit 5
 opensea listings best mfers --limit 5
 
 # Search across OpenSea
-opensea search collections "cool cats"
+opensea search "cool cats" --types collection
 
 # Get trending tokens
 opensea tokens trending --limit 5
@@ -160,7 +160,10 @@ const activity = await client.tokens.activityStats(
   "0x4200000000000000000000000000000000000006",
   { windows: ["1h", "24h"] },
 )
-const results = await client.search.collections("mfers", { limit: 5 })
+const results = await client.search.query("mfers", {
+  assetTypes: ["collection"],
+  limit: 5,
+})
 const declared = await client.agent.declare()
 const { relationships } = await client.agent.list()
 

docs/cli-reference.md

@@ -243,7 +243,9 @@ opensea drops deploy-receipt <chain> <tx-hash> [--wait] [--interval <seconds>] [
 `deploy` prints a ready-to-sign deploy transaction. `--chain` is required and
 never defaults to `ethereum`. With `--send` it signs and sends the transaction
 with the configured EVM wallet, which must be the `--sender` address, and
-prints the hash and chain. Pass both to `deploy-receipt` next.
+prints the hash and chain. Pass both to `deploy-receipt` next. `--send` cannot
+send an `erc721_standard` deploy, a contract-creation transaction with a null
+`to`; print it without `--send` and broadcast it from your own wallet.
 
 `deploy-receipt --wait` polls every `--interval` seconds (default 5) until the
 receipt has a `collection_slug` or its status is `failed`, for at most

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@opensea/cli",
-  "version": "2.11.1",
+  "version": "2.11.2",
   "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.15.1",
-    "@opensea/sdk": "^12.11.2",
+    "@opensea/api-types": "^0.16.0",
+    "@opensea/sdk": "^12.11.3",
     "@opensea/wallet-adapters": "^1.2.1",
     "commander": "^14.0.3",
     "zod": "^4.3.6"

package.json

@@ -168,6 +168,29 @@ async function readListedFile(file: ListedMediaFile): Promise<Buffer> {
   }
 }
 
+const DROP_TYPES = [
+  "seadrop_v1_erc721",
+  "seadrop_v2_erc1155_self_mint",
+] as const satisfies readonly DropDeployRequest["drop_type"][]
+const TOKEN_TYPES = [
+  "erc721_clone",
+  "erc721_standard",
+  "erc1155_clone",
+] as const satisfies readonly DropDeployRequest["token_type"][]
+
+function parseChoice<T extends string>(
+  value: string,
+  flag: string,
+  choices: readonly T[],
+): T {
+  if (!choices.includes(value as T)) {
+    throw new Error(
+      `Invalid value for ${flag}: "${value}". Expected one of: ${choices.join(", ")}.`,
+    )
+  }
+  return value as T
+}
+
 // Validated before any request, so a bad flag never starts a workflow or a
 // poll.
 function parseWaitOptions(options: { interval: string; waitTimeout: string }): {
@@ -473,8 +496,12 @@ export function dropsCommand(
           chain,
           contract_name: options.name,
           contract_symbol: options.symbol,
-          drop_type: options.dropType,
-          token_type: options.tokenType,
+          drop_type: parseChoice(options.dropType, "--drop-type", DROP_TYPES),
+          token_type: parseChoice(
+            options.tokenType,
+            "--token-type",
+            TOKEN_TYPES,
+          ),
           sender: options.sender,
         }
         if (!options.send) {

src/commands/drops.ts

@@ -606,7 +606,13 @@ export class DropsAPI {
         `Wallet ${address} is not the deploy sender ${sender}. The deploy was built for ${sender}; send it from that wallet, or request a new deploy with the wallet's address as sender.`,
       )
     }
-    return sendDropTransaction(evmWallet, tx, callbacks)
+    const { to } = tx
+    if (to === null) {
+      throw new Error(
+        "This deploy is a contract-creation transaction with no `to` address, which the wallet adapters cannot send yet. Run without --send and broadcast it with no `to` from your own wallet, or deploy with token_type erc721_clone.",
+      )
+    }
+    return sendDropTransaction(evmWallet, { ...tx, to }, callbacks)
   }
 
   /**

src/sdk.ts

@@ -622,6 +622,32 @@ describe("dropsCommand", () => {
       expect(wallet.sendTransaction).not.toHaveBeenCalled()
     })
 
+    it("deploy --send refuses a contract-creation transaction with no to", async () => {
+      vi.spyOn(console, "error").mockImplementation(() => {})
+      ctx.mockClient.post.mockResolvedValue({ ...deployTx, to: null })
+      const wallet = evmWallet(OWNER)
+      walletMock.createWalletFromEnv.mockReturnValue(wallet)
+
+      const cmd = dropsCommand(ctx.getClient, ctx.getFormat)
+      await expect(
+        cmd.parseAsync([...deployArgs, "--send"], { from: "user" }),
+      ).rejects.toThrow("contract-creation transaction with no `to` address")
+
+      expect(wallet.sendTransaction).not.toHaveBeenCalled()
+    })
+
+    it("deploy rejects an unknown --drop-type before any request", async () => {
+      const args = [...deployArgs]
+      args[args.indexOf("--drop-type") + 1] = "seadrop_v9"
+
+      const cmd = dropsCommand(ctx.getClient, ctx.getFormat)
+      await expect(cmd.parseAsync(args, { from: "user" })).rejects.toThrow(
+        'Invalid value for --drop-type: "seadrop_v9"',
+      )
+
+      expect(ctx.mockClient.post).not.toHaveBeenCalled()
+    })
+
     it("deploy --send rejects a Solana wallet before building the transaction", async () => {
       const stderr = vi.spyOn(console, "error").mockImplementation(() => {})
       vi.spyOn(process, "exit").mockImplementation(() => {