@tetherto/wdk

Note: This package is currently in beta. Please test thoroughly in development environments before using in production.

A flexible manager for orchestrating WDK wallet and protocol modules through a single interface. This package lets you register blockchain-specific wallet managers, derive accounts, and coordinate multi-chain wallet flows from one WDK instance.

About WDK

This module is part of the WDK (Wallet Development Kit) project, which empowers developers to build secure, non-custodial wallets with unified blockchain access, stateless architecture, and complete user control.

For detailed documentation about the complete WDK ecosystem, visit docs.wdk.tether.io.

Installation

npm install @tetherto/wdk

Quick Start

import WDK from '@tetherto/wdk'
import WalletManagerSolana from '@tetherto/wdk-wallet-solana'
import WalletManagerTon from '@tetherto/wdk-wallet-ton'
import WalletManagerTron from '@tetherto/wdk-wallet-tron'

const seedPhrase = 'abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about'

const wdk = new WDK(seedPhrase)
  .registerWallet('solana', WalletManagerSolana, {
    rpcUrl: 'https://api.devnet.solana.com',
    commitment: 'confirmed',
  })
  .registerWallet('ton', WalletManagerTon, {
    tonClient: { url: 'https://testnet.toncenter.com/api/v2/jsonRPC' },
  })
  .registerWallet('tron', WalletManagerTron, {
    provider: 'https://api.shasta.trongrid.io',
  })

const account = await wdk.getAccount('solana', 0)
const address = await account.getAddress()
console.log('Address:', address)

wdk.dispose()

Key Capabilities

• Wallet Registration: Register multiple blockchain wallet managers through one WDK instance
• Unified Account Access: Retrieve accounts by chain, index, or derivation path through a consistent API
• Multi-Chain Operations: Coordinate balances, fee lookups, and transaction flows across registered chains
• Protocol Registration Support: Attach swap, bridge, lending, and fiat protocols to registered blockchains
• Middleware Hooks: Intercept account derivation with custom middleware
• Seed Utilities: Generate and validate BIP-39 seed phrases
• Selective Disposal: Dispose specific registered wallets or clear the full WDK instance

Compatibility

• WDK Wallet Modules including EVM, Solana, TON, TRON, and Bitcoin integrations
• Protocol Modules registered through the WDK interface
• Node.js and ESM-based applications that coordinate multiple wallet modules in one runtime

Documentation

Topic	Description	Link
Overview	Module overview and feature summary	WDK Core Overview
Usage	End-to-end integration walkthrough	WDK Core Usage
Configuration	Wallet registration and manager configuration	WDK Core Configuration
API Reference	Complete class and type reference	WDK Core API Reference

Examples

Example	Description
Getting Started	Generate a seed phrase, validate it, and create a WDK instance
Register Wallets	Register Solana, TON, and TRON wallet managers in one WDK instance
Manage Accounts	Retrieve accounts by index and path and inspect multi-chain balances
Send Transactions	Quote and optionally send native transactions across multiple chains
Middleware	Register middleware and inspect account access hooks
Error Handling	Handle missing registrations and dispose selected wallets safely

For detailed walkthroughs, see the Usage Guide. See all runnable examples in the wdk-examples repository.

Community

Join the WDK Discord to connect with other developers.

Support

For support, please open an issue on GitHub or reach out via email.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.