ProjectOpenSea / opensea-js / 18540449053

push

github

feat: v8 - bulk order improvements, partial failure handling, and API simplification (#1786)

* feat: add bulk order creation with rate limiting and remove Dutch auction support

This commit introduces efficient bulk order creation methods and removes deprecated Dutch auction functionality.

## New Features
- Add `createBulkListings()` method for creating multiple listings with a single signature
- Add `createBulkOffers()` method for creating multiple offers with a single signature
- Implement rate limiting utilities with automatic retry on 429/599 errors
- Add exponential backoff and retry-after header support
- Add sequential execution helper for rate-limited operations

## Breaking Changes
- Remove Dutch auction support (endAmount/endPrice parameters)
- Remove English auction validation (already unsupported by OpenSea)
- Update `_getPriceParameters()` to no longer accept or return endAmount/endPrice
- Update `createListing()` and related methods to remove endAmount parameter

## Other Changes
- Replace hardcoded DEFAULT_SEAPORT_ADDRESS with SDK's configured Seaport contract address for proper multi-chain support
- Add comprehensive documentation for bulk order methods in advanced-use-cases.md
- Add cross-references to bulk methods in getting-started.md
- Add rate limiting tests with full coverage
- Remove Dutch auction tests
- Remove English auction tests (deprecated feature)
- Bump version to 7.5.0 (minor)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* refactor: centralize rate limiting in API client for DRY code

All OpenSea API calls now automatically include rate limit handling with exponential backoff. This eliminates code duplication and ensures consistent rate limit behavior across all API operations.

## Changes
- Wrapped API.get() and API.post() methods with executeWithRateLimit()
- Simplified bulk order submission to use simple loops (rate limiting now handled automatical... (continued)

423 of 613 branches covered (69.0%)

Branch coverage included in aggregate %.

615 of 643 new or added lines in 18 files covered. (95.65%)

3531 of 3943 relevant lines covered (89.55%)

4.47 hits per line