Wallet Modules Overview
Explore WDK wallet modules for building self-custodial wallets across supported chains.
The Wallet Development Kit (WDK) provides a set of modules that support multiple blockchain networks. All modules share a common interface, ensuring consistent behavior across different blockchain implementations.
Shared Fee Limits
Wallet modules can expose fee caps through their configuration objects. Use the chain-specific docs for exact units and supported operations.
| Option | Applies to | Description |
|---|---|---|
transferMaxFee | transfer() | Caps token transfer fees in the module's base fee unit. |
transactionMaxFee | sendTransaction() and signTransaction() | Caps native transaction send/sign flows separately from token transfers when the module supports that base wallet option. |
Supported Networks
This package works with multiple blockchain networks through wallet registration.
Bitcoin Mainnet
Ethereum, Sepolia Testnet, L2s, etc.
Tron Mainnet
TON Mainnet
Solana Mainnet
Spark Mainnet
Classic Wallet Modules
Standard wallet implementations that use native blockchain tokens for transaction fees:
| Module | Blockchain | Status | Documentation |
|---|---|---|---|
@tetherto/wdk-wallet-evm | EVM | ✅ Ready | Documentation |
@tetherto/wdk-wallet-ton | TON | ✅ Ready | Documentation |
@tetherto/wdk-wallet-btc | Bitcoin | ✅ Ready | Documentation |
@tetherto/wdk-wallet-spark | Spark | ✅ Ready | Documentation |
@tetherto/wdk-wallet-tron | TRON | ✅ Ready | Documentation |
@tetherto/wdk-wallet-solana | Solana | ✅ Ready | Documentation |
@tetherto/wdk-wallet-ark | Ark | In progress | - |
Account Abstraction Wallet Modules
Wallet implementations that support Account Abstraction for gasless transactions using paymaster tokens like USD₮:
| Module | Blockchain | Status | Documentation |
|---|---|---|---|
@tetherto/wdk-wallet-evm-erc4337 | EVM | ✅ Ready | Documentation |
@tetherto/wdk-wallet-evm-7702-gasless | EVM | ✅ Ready | Documentation |
@tetherto/wdk-wallet-ton-gasless | TON | ✅ Ready | Documentation |
@tetherto/wdk-wallet-tron-gasfree | TRON | ✅ Ready | Documentation |
@tetherto/wdk-wallet-solana-jupiterz | Solana | In progress | - |
Community Wallet Modules
Wallet modules developed by the community. See the Community Modules page for more details.
Community modules are developed and maintained independently. Use your own judgment and proceed at your own risk.
| Module | Blockchain | Description | Repository |
|---|---|---|---|
@utexo/wdk-wallet-rgb | Bitcoin (RGB) | RGB protocol wallet integration for Bitcoin-based smart contracts | GitHub |
Next Steps
To get started with WDK modules, follow these steps:
- Get up and running quickly with our Quickstart Guide
- Choose the modules that best fit your needs from the tables above
- Check specific documentation for modules you wish to use
You can also:
- Learn about key concepts like Account Abstraction and other important definitions
- Use one of our ready-to-use examples to be production ready