What's New in SwapDK v4

SwapDK v4 brings significant improvements to developer experience, runtime flexibility, and overall architecture. Here’s everything new and exciting in this major release.

🚀 Major Features

Runtime Configuration Updates

Game Changer

Update API keys, RPC URLs, and settings without recreating the SwapDK client. Perfect for production environments and dynamic configuration management.

import { SKConfig } from '@swapdk/sdk';


SKConfig.setRpcUrl(Chain.Ethereum, "https://rpc.example.com");
SKConfig.setApiKey("swapKit", "new-api-key");

Learn more →

Monolithic Package Structure

Breaking Change

Simplified package management with consolidated packages for better maintainability and smaller bundle sizes when using the full SDK.

import { createSwapKit, Chain } from '@swapdk/sdk';
import { ThorchainPlugin } from '@swapdk/plugins/thorchain';

Migration guide →

Enhanced Chain Support

New

Improved support for Solana with Jupiter API integration, dynamic Cosmos fees, full Ripple support, and OneKey wallet integration.

Solana: Real-time token metadata via Jupiter API
Cosmos: Automatic fee estimation
Ripple: Complete XRP toolbox implementation
OneKey: New wallet integration

Standardized Creation Helpers

Developer Experience

New createPlugin and createWallet helpers provide consistent interfaces for extending SwapDK functionality.

import { createPlugin } from '@swapdk/plugins';

export const MyPlugin = createPlugin({
  name: "myPlugin",
  methods: ({ getWallet }) => ({ customMethod })
});

🔄 Breaking Changes Summary

Package Structure

Individual packages consolidated into monolithic packages with submodule exports
All imports must be updated to new paths
See complete migration guide for details

Configuration System

Introduced centralized SKConfig system
Removed direct API/RPC parameters from constructors
Runtime configuration updates now possible

Plugin & Wallet Interfaces

New createPlugin and createWallet helpers required
Simplified parameter interfaces
Better type safety and consistency

⚡ Performance Improvements

Efficient Configuration Management

No more client recreation for configuration changes. Update settings on-the-fly without losing wallet connections or cached data.

Better Bundle Size Control

Use only what you need with the new modular structure. Import specific plugins and wallets for smaller production bundles.

Optimized Chain Operations

Improved toolbox initialization and better caching for frequently accessed chain operations.

🛠️ Developer Experience Enhancements

Simplified Client Creation

// @noErrorValidation

const client = SwapKit({
  apis: { [Chain.Ethereum]: customApi },
  rpcUrls: { [Chain.Ethereum]: "https://rpc.example.com" },
  config: { stagenet: false },
  plugins: { ...ThorchainPlugin },
  wallets: { ...keystoreWallet }
});


const client = createSwapKit({
  config: {
    rpcUrls: { [Chain.Ethereum]: "https://rpc.example.com" },
    apiKeys: { blockchair: "your-key" }
  },
  plugins: { ...ThorchainPlugin },
  wallets: { ...keystoreWallet }
});

Runtime Environment Switching

// @noErrorValidation

SKConfig.setEnv("isStagenet", true);
SKConfig.setRpcUrl(Chain.THORChain, "https://rpc.example.com");


const balance = await swapKit.getBalance(Chain.THORChain);

Enhanced Error Handling

Improved error messages with more context and better debugging information for faster issue resolution.

🌟 New Chain & Wallet Support

Enhanced Solana Integration

Jupiter API Integration: Real-time token metadata and routing
Improved Transaction Handling: Better fee estimation and confirmation
Phantom Wallet: Enhanced support with latest features

Complete Ripple (XRP) Support

Full XRP Toolbox: Complete implementation for XRP Ledger operations
Destination Tags: Proper handling of XRP memos and destination tags
Enhanced Validation: Better address and transaction validation

OneKey Wallet Integration

Multi-Chain Support: Hardware wallet support across all supported chains
Secure Operations: Hardware-level security for sensitive operations
User-Friendly Interface: Streamlined connection and transaction flow

Dynamic Cosmos Ecosystem

Auto Fee Estimation: Automatic fee calculation when not provided
Better Gas Management: Improved gas estimation across Cosmos chains
Enhanced IBC Support: Better Inter-Blockchain Communication handling

🔧 Configuration Flexibility

Individual Updates

// @noErrorValidation

SKConfig.setApiKey("swapKit", "premium-key");
SKConfig.setApiKey("blockchair", "enterprise-key");


SKConfig.setRpcUrl(Chain.Ethereum, "https://rpc.example.com");
SKConfig.setRpcUrl(Chain.Arbitrum, "https://rpc.example.com");

Bulk Configuration

// @noErrorValidation

SKConfig.set({
  rpcUrls: {
    [Chain.Ethereum]: "https://rpc.example.com",
    [Chain.Arbitrum]: "https://rpc.example.com"
  },
  apiKeys: {
    blockchair: "enterprise-key",
    swapKit: "premium-key"
  },
  envs: {
    isStagenet: false,
    isDev: false
  }
});

Environment-Specific Configurations

// @noErrorValidation

SKConfig.set({
  envs: { isDev: false, isStagenet: false },
  apiKeys: {
    swapKit: process.env.SWAPDK_PROD_KEY,
    blockchair: process.env.BLOCKCHAIR_PROD_KEY,
  },
});

SKConfig.set({
  envs: { isDev: true, isStagenet: true },
  apiKeys: {
    swapKit: process.env.SWAPDK_DEV_KEY,
    blockchair: process.env.BLOCKCHAIR_DEV_KEY,
  },
});

🚦 Migration Path

Ready to upgrade? Follow our comprehensive migration guide:

Review Breaking Changes - Understand what’s changed
Update Dependencies - Install v4 packages
Update Imports - Fix import paths
Refactor Configuration - Use SKConfig system
Test Integration - Verify everything works

💬 Community & Support

Migration Help

Need help migrating? Our community is here to help with specific migration challenges. Get Migration Support →

Bug Reports

Found an issue in v4? Report it on GitHub with detailed reproduction steps. Report Issues →

Feature Requests

Have ideas for v4 improvements? We’d love to hear your feedback and suggestions. Share Ideas →

Ready to get started with v4? Head over to our Getting Started guide to build your first v4 application, or check out the Migration guide if you’re upgrading from v3.