January 20th, 2026

Marketplace SDK v2.0.0

Trails integration, modern type system update, and new hooks and utilities.

Trails Integration

  • Default Trails checkout mode for seamless, cross-chain, 1-click purchases with any token, any wallet.

Complete Headless Mode

  • All modals now export context hooks & types for fully custom UI implementations.

Modern Type System

  • Full BigInt support and viem-compatible types for token IDs, amounts, addresses, and hex values.

Enhanced Error Handling

  • Modals now have built-in error boundaries with retry options.

New Hooks & Utilities

  • useERC721Owner – fetch ERC721 token owners processProperties / processAttributes – normalize NFT metadata

Breaking changes

  • tokenId, amount, quantity β†’ now BigInt

  • Address β†’ now viem Address type

  • onSuccess / onError callbacks removed from modal hooks (handled internally now)

  • Activities APIs (useListCollectionActivities, useListCollectibleActivities) removed