Release v1.16.0

ryanio · ryanio · commit 364c2e4333e9 · 2026-07-22T18:13:22.000Z
Origin-SHA: ce934c6cff606d354494c7ba1ecf95ac58ff3b17
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,17 @@
 # @opensea/cli
 
+## 1.16.0
+
+### Minor Changes
+
+- cba26dd: Add typed SDK and CLI support for building cross-chain drop mint transactions and polling the returned receipt request.
+
+### Patch Changes
+
+- Updated dependencies [cba26dd]
+  - @opensea/api-types@0.8.4
+  - @opensea/sdk@11.6.0
+
 ## 1.15.1
 
 ### Patch Changes
diff --git a/README.md b/README.md
@@ -102,6 +102,8 @@ opensea --format table collections stats mfers
 | `nfts` | Get, list, refresh metadata, and contract details for NFTs |
 | `listings` | Get all, best, or best-for-nft listings |
 | `offers` | Get all, collection, best-for-nft, and trait offers |
+| `drops` | Query drops and build same-chain or cross-chain mint transactions |
+| `transactions` | Poll transaction and cross-chain receipt status |
 | `events` | List marketplace events (sales, transfers, mints, etc.) |
 | `search` | Search collections, NFTs, tokens, and accounts |
 | `tokens` | Get trending tokens, top tokens, and token details |
diff --git a/biome.json b/biome.json
@@ -10,6 +10,7 @@
       "**/*.ts",
       "**/*.js",
       "**/*.json",
+      "!packages/tool-registry/lib",
       "!**/.claude",
       "!**/typechain",
       "!lib",
diff --git a/docs/cli-reference.md b/docs/cli-reference.md
@@ -81,6 +81,25 @@ opensea offers best-for-nft <collection> <token-id>
 opensea offers traits <collection> --type <type> --value <value> [--limit <n>] [--next <cursor>]
 ```
 
+## Drops
+
+```bash
+opensea drops list [--type <type>] [--chains <chains>] [--limit <n>] [--next <cursor>]
+opensea drops get <slug>
+opensea drops mint <slug> --minter <address> [--quantity <n>]
+opensea drops cross-chain-mint <slug> --payer <address> --minter <address> --payment-chain <chain> --payment-token <address> [--quantity <n>]
+```
+
+Cross-chain minting returns ordered transactions plus `receipt_request`.
+Submit the transactions in order, save `receipt_request` unchanged to a JSON
+file, and poll it with the transactions command until the status is terminal.
+
+## Transactions
+
+```bash
+opensea transactions receipt --request <receipt-request.json>
+```
+
 ## Events
 
 ```bash
diff --git a/docs/examples.md b/docs/examples.md
@@ -69,6 +69,23 @@ opensea offers best-for-nft tiny-dinos-eth 1
 opensea offers traits tiny-dinos-eth --type background --value blue --limit 2
 ```
 
+## Cross-chain minting
+
+```bash
+# Build ordered transactions that pay with native currency on Base and mint
+# the drop NFT on its destination chain.
+opensea drops cross-chain-mint pyro-on-ape \
+  --payer 0x1111111111111111111111111111111111111111 \
+  --minter 0x1111111111111111111111111111111111111111 \
+  --payment-chain base \
+  --payment-token 0x0000000000000000000000000000000000000000 \
+  --quantity 1
+
+# After submitting every returned transaction, copy receipt_request from the
+# response into receipt-request.json and poll until SUCCESS or FAILED.
+opensea transactions receipt --request receipt-request.json
+```
+
 ## Events
 
 ```bash
diff --git a/docs/sdk.md b/docs/sdk.md
@@ -86,6 +86,23 @@ const { offers, next } = await client.offers.traits("mfers", {
 })
 ```
 
+## Drops and cross-chain minting
+
+```typescript
+const mint = await client.drops.crossChainMint("pyro-on-ape", {
+  payer: "0x1111111111111111111111111111111111111111",
+  minter: "0x1111111111111111111111111111111111111111",
+  quantity: 1,
+  payment: {
+    chain: "base",
+    token_address: "0x0000000000000000000000000000000000000000",
+  },
+})
+
+// Submit mint.transactions in order, then poll the exact returned request.
+const receipt = await client.transactions.receipt(mint.receipt_request)
+```
+
 ## Events
 
 ```typescript
diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@opensea/cli",
-  "version": "1.15.1",
+  "version": "1.16.0",
   "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.3",
-    "@opensea/sdk": "^11.5.1",
+    "@opensea/api-types": "^0.8.4",
+    "@opensea/sdk": "^11.6.0",
     "@opensea/wallet-adapters": "^0.3.3",
     "commander": "^14.0.3",
     "zod": "^4.3.6"
diff --git a/src/commands/drops.ts b/src/commands/drops.ts
@@ -9,6 +9,8 @@ import {
 } from "../parse.js"
 import type {
   Chain,
+  CrossChainDropMintRequest,
+  CrossChainDropMintResponse,
   DropDeployRequest,
   DropDeployResponse,
   DropEligibilityResponse,
@@ -107,6 +109,47 @@ export function dropsCommand(
       },
     )
 
+  cmd
+    .command("cross-chain-mint")
+    .description("Build transactions to pay on one chain and mint on another")
+    .argument("<slug>", "Collection slug")
+    .requiredOption("--payer <address>", "Wallet that signs and pays")
+    .requiredOption("--minter <address>", "Wallet that receives the NFT")
+    .requiredOption("--payment-chain <chain>", "Chain used for payment")
+    .requiredOption(
+      "--payment-token <address>",
+      "Payment token contract or the null address for native currency",
+    )
+    .option("--quantity <n>", "Number of tokens to mint", "1")
+    .action(
+      async (
+        slug: string,
+        options: {
+          payer: string
+          minter: string
+          paymentChain: string
+          paymentToken: string
+          quantity: string
+        },
+      ) => {
+        const client = getClient()
+        const request: CrossChainDropMintRequest = {
+          payer: options.payer,
+          minter: options.minter,
+          quantity: parseIntOption(options.quantity, "--quantity"),
+          payment: {
+            chain: options.paymentChain,
+            token_address: options.paymentToken,
+          },
+        }
+        const result = await client.post<CrossChainDropMintResponse>(
+          `/api/v2/drops/${slug}/cross_chain_mint`,
+          request,
+        )
+        console.log(formatOutput(result, getFormat()))
+      },
+    )
+
   cmd
     .command("deploy")
     .description("Build a deploy-contract transaction for a new drop")
diff --git a/src/commands/transactions.ts b/src/commands/transactions.ts
@@ -20,7 +20,7 @@ export function transactionsCommand(
     .command("receipt")
     .description(
       "Fetch transaction status. Works for listing fulfillments, " +
-        "cross-chain buys, sweeps, offer fulfillments, and token swaps.",
+        "cross-chain buys and mints, sweeps, offer fulfillments, and token swaps.",
     )
     .requiredOption(
       "--request <file>",
diff --git a/src/sdk.ts b/src/sdk.ts
@@ -22,6 +22,8 @@ import type {
   Contract,
   CreateListingActionsRequest,
   CreateListingActionsResponse,
+  CrossChainDropMintRequest,
+  CrossChainDropMintResponse,
   CrossChainFulfillmentResponse,
   DropDeployReceiptResponse,
   DropDeployRequest,
@@ -307,6 +309,18 @@ class DropsAPI {
     })
   }
 
+  /**
+   * Build ordered transactions for paying on one chain and minting on
+   * another. Submit them in order, then poll `transactions.receipt` with the
+   * returned `receipt_request` until the status is terminal.
+   */
+  async crossChainMint(
+    slug: string,
+    request: CrossChainDropMintRequest,
+  ): Promise<CrossChainDropMintResponse> {
+    return this.client.post(`/api/v2/drops/${slug}/cross_chain_mint`, request)
+  }
+
   async deploy(request: DropDeployRequest): Promise<DropDeployResponse> {
     return this.client.post("/api/v2/drops/deploy", request)
   }
@@ -1108,8 +1122,8 @@ export class TransactionsAPI {
 
   /**
    * Fetch the receipt/status for a submitted transaction. Works for all
-   * transaction types: listing fulfillments, cross-chain buys, sweeps, offer
-   * fulfillments, and token swaps.
+   * transaction types: listing fulfillments, cross-chain buys and mints, sweeps,
+   * offer fulfillments, and token swaps.
    */
   async receipt(
     request: TransactionReceiptRequest,
diff --git a/src/types/api.ts b/src/types/api.ts
@@ -64,6 +64,8 @@ export type DropStageResponse = Schemas["DropStageResponse"]
 export type DropPaginatedResponse = Schemas["DropPaginatedResponse"]
 export type DropMintRequest = Schemas["DropMintRequest"]
 export type DropMintResponse = Schemas["DropMintResponse"]
+export type CrossChainDropMintRequest = Schemas["CrossChainDropMintRequest"]
+export type CrossChainDropMintResponse = Schemas["CrossChainDropMintResponse"]
 export type DropEligibilityResponse = Schemas["DropEligibilityResponse"]
 export type DropDeployRequest = Schemas["DropDeployRequest"]
 export type DropDeployResponse = Schemas["DropDeployResponse"]
diff --git a/test/commands/drops.test.ts b/test/commands/drops.test.ts
@@ -31,6 +31,7 @@ describe("dropsCommand", () => {
     expect(subcommands).toContain("get")
     expect(subcommands).toContain("eligibility")
     expect(subcommands).toContain("mint")
+    expect(subcommands).toContain("cross-chain-mint")
   })
 
   it("list subcommand passes options", async () => {
@@ -132,6 +133,48 @@ describe("dropsCommand", () => {
     )
   })
 
+  it("cross-chain-mint posts payer, minter, quantity, and payment asset", async () => {
+    ctx.mockClient.post.mockResolvedValue({
+      transactions: [],
+      receipt_request: {
+        swap_quote: { from_assets: [] },
+        relay_request_id: "0xrequest",
+      },
+    })
+
+    const cmd = dropsCommand(ctx.getClient, ctx.getFormat)
+    await cmd.parseAsync(
+      [
+        "cross-chain-mint",
+        "pyro-on-ape",
+        "--payer",
+        "0x1111111111111111111111111111111111111111",
+        "--minter",
+        "0x2222222222222222222222222222222222222222",
+        "--payment-chain",
+        "base",
+        "--payment-token",
+        "0x0000000000000000000000000000000000000000",
+        "--quantity",
+        "2",
+      ],
+      { from: "user" },
+    )
+
+    expect(ctx.mockClient.post).toHaveBeenCalledWith(
+      "/api/v2/drops/pyro-on-ape/cross_chain_mint",
+      {
+        payer: "0x1111111111111111111111111111111111111111",
+        minter: "0x2222222222222222222222222222222222222222",
+        quantity: 2,
+        payment: {
+          chain: "base",
+          token_address: "0x0000000000000000000000000000000000000000",
+        },
+      },
+    )
+  })
+
   it("save-edits posts the request body", async () => {
     ctx.mockClient.post.mockResolvedValue({ success: true })
     const body = { stages: [] }
diff --git a/test/sdk.test.ts b/test/sdk.test.ts
@@ -164,6 +164,26 @@ describe("OpenSeaCLI", () => {
         quantity: 2,
       })
     })
+
+    it("crossChainMint calls correct endpoint", async () => {
+      mockPost.mockResolvedValue({ transactions: [], receipt_request: {} })
+      const request = {
+        payer: "0xpayer",
+        minter: "0xminter",
+        quantity: 1,
+        payment: {
+          chain: "base",
+          token_address: "0x0000000000000000000000000000000000000000",
+        },
+      }
+
+      await sdk.drops.crossChainMint("pyro-on-ape", request)
+
+      expect(mockPost).toHaveBeenCalledWith(
+        "/api/v2/drops/pyro-on-ape/cross_chain_mint",
+        request,
+      )
+    })
   })
 
   describe("nfts", () => {

Original file line number	Diff line number	Diff line change
`@@ -20,7 +20,7 @@ export function transactionsCommand(`
`20`	`20`	`.command("receipt")`
`21`	`21`	`.description(`
`22`	`22`	`"Fetch transaction status. Works for listing fulfillments, " +`
`23`		`- "cross-chain buys, sweeps, offer fulfillments, and token swaps.",`
	`23`	`+ "cross-chain buys and mints, sweeps, offer fulfillments, and token swaps.",`
`24`	`24`	`)`
`25`	`25`	`.requiredOption(`
`26`	`26`	`"--request <file>",`