v11.4.7

What's Changed

• OAuth browser and device flows now request Zitadel's role-specific scopes, keeping issued tokens limited to the OpenSea permissions the client requested.
• Explicit empty scope lists are rejected locally instead of being sent to the authorization server, where they could expand to every role on the account.

Full Changelog: ProjectOpenSea/opensea-devtools@sdk-v11.4.5...sdk-v11.4.7

v11.4.5

What's Changed

• Expose where OpenSea OAuth scopes came from, either the authorization-server response or the access-token claim. This supports clearer CLI diagnostics without using decoded JWT claims for authorization.

Full Changelog: ProjectOpenSea/opensea-devtools@sdk-v11.4.4...sdk-v11.4.5

v11.4.4

What's Changed

• Use the current OpenSea API endpoint for SIWX wallet-link nonces.
• Allow wallet-link requests to include the OpenSea API key alongside the scoped Bearer token.
• Keep the legacy authBaseUrl option deprecated but source-compatible.

Full Changelog: ProjectOpenSea/opensea-devtools@sdk-v11.4.3...sdk-v11.4.4

v11.4.3

What's Changed

• Keep the default SDK test suite offline by isolating live API and RPC checks in the integration suite.
• Require complete OAuth wallet sessions and retain the existing refresh token when a rotation response omits a replacement.
• Preserve case-sensitive wallet addresses in OAuth session storage.

Full Changelog: ProjectOpenSea/opensea-devtools@sdk-v11.4.1...sdk-v11.4.3

v11.4.1

What's Changed

• Recover OpenSea OAuth scopes from the access JWT when the token endpoint omits its optional scope field.
• Filter and order reported scopes through the generated OpenAPI scope catalog.

Full Changelog: ProjectOpenSea/opensea-devtools@sdk-v11.4.0...sdk-v11.4.1

v11.4.0

What's changed

• Added typed api.walletAuth helpers for all 29 scoped wallet operations.
• Added SIWX wallet-link helpers for nonce, message, and link flows.
• Aligned wallet-auth scope metadata with production OpenAPI.
• Added Seaport support for Robinhood chain.

Full changelog: ProjectOpenSea/opensea-devtools@sdk-v11.3.0...sdk-v11.4.0

v11.3.0

What's Changed

SIWX Wallet-Link Support

• Add public SIWX wallet-link support for agents: export nonce generation, message signing, and wallet-link verification helpers for integrating keyless wallet-link flows in autonomous agent environments.

Robinhood Seaport Support

• Enable Seaport support for Robinhood chain (4663). Canonical Seaport 1.6 is now configured for Robinhood with WETH 0x0bd7d308f8e1639fab988df18a8011f41eacad73 for offers and native ETH for listings.

Bug Fixes

• Fix parseUnits to correctly handle string inputs with scientific notation (e.g., "1e-8", "1E6"). Previously only number-type values were normalized, causing SyntaxError for string scientific notation. Fixes #1978.

Full Changelog: v11.2.0...v11.3.0

v11.2.0

What's Changed

• feat: SIWE authentication helpers: OpenSeaAuth class with authenticate, getValidToken, and revoke, plus authToken and authBaseUrl options in OpenSeaAPIConfig for wallet-authenticated endpoints (#415)
• feat: OpenSeaOAuth OAuth 2.1 helper (authorization-code + PKCE, device authorization grant, refresh, and revoke) for keyless login, with a decodeJwtPayload utility (#475)
• feat: wallet trading P&L methods on OpenSeaAPI: getWalletPnl, getWalletClosedPositions, and getWalletTokenTransfers (#468)
• feat: scope constants OPENSEA_SCOPES, OpenSeaScope, and ALL_SCOPES, derived from the OpenAPI spec's AuthScope schema with compile-time assertions that fail the build on drift
• feat: add Chain.Robinhood (#483)
• fix: add the missing Soneium and AnimeChain payment-token mappings. Solana and Hyperliquid now fail fast with clear unsupported-chain errors instead of crashing (#482)
• fix: validate amount before calling parseUnits in _getPriceParameters, so a missing amount raises the intended validation error (#485)
• fix: reject cancelOrders batches that mix protocol addresses instead of silently cancelling only one protocol's orders (#485)
• chore: add chain-helper drift guards. The payment-token switches are exhaustively type-checked, and a runtime test covers every Chain value (#482, #485)

Community Contributions

• Soneium/AnimeChain payment-token gap, and the earlier Solana/Hyperliquid report that prompted the new drift guards: thanks @Sertug17 (#1977, #1975, #1973)
• Validate amount before parseUnits: thanks @Sertug17 (#1974)
• Reject mixed-protocol cancelOrders batches: thanks @Nexory (#1976)

Full Changelog: ProjectOpenSea/opensea-devtools@sdk-v11.1.1...sdk-v11.2.0

v11.1.1

What's Changed

• fix: correct GetSwapQuoteArgs to match the swap quote endpoint. getSwapQuote now takes { fromChain, fromAddress, toChain, toAddress, quantity, address, slippage?, recipient? }, matching GET /api/v2/swap/quote. The previous { tokenIn, tokenOut, amount, chain } shape did not map to the endpoint's query params. (#364)

Full Changelog: ProjectOpenSea/opensea-devtools@sdk-v11.1.0...sdk-v11.1.1

v11.1.0

What's Changed

Expose the two new token endpoints from @opensea/api-types 0.4.3.

• OpenSeaAPI.getTokenHolders(chain, address, args?) → TokenHoldersResponse — paginated holders (limit, cursor, sortBy: "QUANTITY", sortDirection) plus aggregate distribution health (STRONG | HEALTHY | CONCERNING | BAD).
• OpenSeaAPI.getTokenLiquidityPools(chain, address, args?) → TokenLiquidityPoolsResponse — pool type, USD reserves, bonding-curve progress, graduation flag.
• New type exports: TokenHoldersResponse, TokenHoldersArgs, TokenLiquidityPoolsResponse, TokenLiquidityPoolsArgs.
• New path helpers in apiPaths.ts: getTokenHoldersPath, getTokenLiquidityPoolsPath.

Also bumps @opensea/api-types dependency to 0.4.3 (transitively brings in agent_binding, twitter_follower_count, and the new schema exports — see api-types-v0.4.3 release notes for details).

Full Changelog: ProjectOpenSea/opensea-devtools@sdk-v11.0.0...sdk-v11.1.0