Legacy SDK migration guide

Migrate from the (legacy) Doppler v3 or v4 SDK to the latest

Migration Guide

This guide helps you migrate from doppler-v3-sdk or doppler-v4-sdk to the unified @whetstone-research/doppler-sdk using the builder pattern.

Overview of Changes

The new SDK consolidates both V3 and V4 functionality into a single package with clearer terminology:

  • V3 → Static Auctions: Fixed price range liquidity bootstrapping

  • V4 → Dynamic Auctions: Gradual Dutch auctions with Uniswap V4 hooks

  • Unified API: Single SDK instance handles both auction types

  • Improved Types: Discriminated unions for type-safe configurations

  • viem Integration: Replaced ethers.js with viem for better performance

Installation

Remove the old packages and install the new unified SDK:

# Remove old packages
npm uninstall @doppler/v3-sdk @doppler/v4-sdk ethers

# Install new packages
npm install @whetstone-research/doppler-sdk viem

Initialization Changes

Before (V3 SDK)

Before (V4 SDK)

After (Unified SDK)

Creating Auctions

Static Auctions (Previously V3)

Before

After (Builder pattern)

Dynamic Auctions (Previously V4)

Before

After (Builder pattern)

Interacting with Auctions

Before (Both SDKs)

After (Unified SDK)

Token Interactions

Before

After (Unified SDK)

Quoter Changes

Before

After

Last updated