Extend WDK

Building Blocks

Discover and install building blocks to extend your WDK integration.

wdk-wallet-evm | WDK by Tether

Back to Building Block Browser

wdk-wallet-evm

Official

@tetherto/wdk-wallet-evm

v1.0.0-beta.15
Apache-2.0
30,332 downloads

Ethereum

Ethereum and EVM-compatible chains wallet

wdk
wallet
bip-32
ethereum

Open in Playground

npm GitHub Docs

README

View on GitHub

@tetherto/wdk-wallet-evm

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

A simple and secure package to manage BIP-44 wallets for EVM-compatible blockchains. This package provides a clean API for creating, managing, and interacting with Ethereum-compatible wallets using BIP-39 seed phrases and EVM-specific derivation paths.

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

To install the @tetherto/wdk-wallet-evm package, follow these instructions:

You can install it using npm:

🚀 Quick Start

Importing from `@tetherto/wdk-wallet-evm`

Create a Wallet Manager (seed-based)

Single Account (no manager): Private key

Single Account (no manager): Seed + path

Managing Multiple Accounts (seed-based manager)

Checking Balances

Owned Account

For accounts where you have the seed phrase and full access:

Read-Only Account

For addresses where you don't have the seed phrase:

Sending Transactions

Send native tokens and estimate fees using WalletAccountEvm. Supports EIP-1559 and auto-populates gas/fee fields where possible.

Token Transfers

Transfer ERC20 tokens and estimate fees using WalletAccountEvm. Uses standard ERC20 transfer function.

Token Approvals

Approve a spender for a specific amount (uses ERC20 approve):

Message Signing and Verification

Sign messages using WalletAccountEvm and verify signatures using WalletAccountReadOnlyEvm.

Fee Management

Retrieve current fee rates using WalletManagerEvm. Supports EIP-1559 fee model.

Memory Management

Clear sensitive data from memory using dispose methods in WalletAccountEvm and WalletManagerEvm.

🔐 Signers

Signers provide the cryptographic primitives for accounts. There are two signer implementations:

SeedSignerEvm (root + child): Derives accounts from a BIP-39 seed using the BIP-44 Ethereum path. Can act as a root (for WalletManagerEvm) and derive children (for WalletAccountEvm).
PrivateKeySignerEvm (child only): Wraps a raw private key in a memory-safe buffer. Cannot derive. Use directly with WalletAccountEvm. Not supported by WalletManagerEvm.

Examples:

Key Capabilities

BIP-39 Seed Phrase Support: Generate and validate mnemonic seed phrases
BIP-44 Derivation Paths: Standard Ethereum derivation (m/44'/60')
Multi-Account Management: Derive multiple accounts from a single seed phrase
EIP-1559 Transaction Support: Modern fee estimation and transaction sending
ERC-20 Token Support: Query balances and transfer tokens
Message Signing: Sign and verify messages (EIP-191 and EIP-712)
Fee Estimation: Real-time network fee rates with normal/fast tiers
Secure Memory Disposal: Clear private keys from memory when done
Signer Submodule: Create your own signer from ISignerEvm, support for Seed and Private key signers
EIP-7702 Delegation: Delegate EOAs to smart contracts, sign authorizations, and send type 4 transactions

Compatibility

Ethereum Mainnet and testnets (Sepolia)
Layer 2 Networks: Arbitrum, Optimism, Base
Other EVM Chains: Polygon, Avalanche C-Chain, and any EVM-compatible chain

Documentation

Topic	Description	Link
Overview	Module overview and feature summary	Wallet EVM Overview
Usage	End-to-end integration walkthrough	Wallet EVM Usage
Configuration	Provider, fees, and network configuration	Wallet EVM Configuration
API Reference	Complete class and type reference	Wallet EVM API Reference

Examples

Example	Description
Create Wallet	Initialize a wallet manager and derive accounts from a seed phrase
Manage Accounts	Work with multiple accounts and custom derivation paths
Check Balances	Query native token and ERC-20 balances for owned accounts
Read-Only Account	Monitor balances for any address without a private key
Send Transaction	Estimate fees and send native token transactions (EIP-1559 + legacy)
Token Transfer	Transfer ERC-20 tokens and estimate transfer fees

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.

Loading README…

Recent updates

View all

v1.0.0-beta.15PatchJuly 3, 2026

What's Changed

EVM: Split signer from account by @claudiovb in https://github.com/tetherto/wdk-wallet-evm/pull/40
Ledger Integration for wdk-wallet-evm by @claudiovb in https://github.com/tetherto/wdk-wallet-evm/pull/87
bump ethers to v6.17.0 by @quocle108 in https://github.com/tetherto/wdk-wallet-evm/pull/90
fix(types): widen constructor to accept ISigner (parent's contract) by @AlonzoRicardo in https://github.com/tetherto/wdk-wallet-evm/pull/88
feat(account): add seed + path constructor overload to WalletAccountEvm and remove fromSeed by @claudiovb in

README

View on GitHub

@tetherto/wdk-wallet-evm

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

About WDK

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

⬇️ Installation

To install the @tetherto/wdk-wallet-evm package, follow these instructions:

You can install it using npm:

🚀 Quick Start

Importing from `@tetherto/wdk-wallet-evm`

Create a Wallet Manager (seed-based)

Single Account (no manager): Private key

Single Account (no manager): Seed + path

Managing Multiple Accounts (seed-based manager)

Checking Balances

Owned Account

For accounts where you have the seed phrase and full access:

Read-Only Account

For addresses where you don't have the seed phrase:

Sending Transactions

Send native tokens and estimate fees using WalletAccountEvm. Supports EIP-1559 and auto-populates gas/fee fields where possible.

Token Transfers

Transfer ERC20 tokens and estimate fees using WalletAccountEvm. Uses standard ERC20 transfer function.

Token Approvals

Approve a spender for a specific amount (uses ERC20 approve):

Message Signing and Verification

Sign messages using WalletAccountEvm and verify signatures using WalletAccountReadOnlyEvm.

Fee Management

Retrieve current fee rates using WalletManagerEvm. Supports EIP-1559 fee model.

Memory Management

Clear sensitive data from memory using dispose methods in WalletAccountEvm and WalletManagerEvm.

🔐 Signers

Signers provide the cryptographic primitives for accounts. There are two signer implementations:

SeedSignerEvm (root + child): Derives accounts from a BIP-39 seed using the BIP-44 Ethereum path. Can act as a root (for WalletManagerEvm) and derive children (for WalletAccountEvm).
PrivateKeySignerEvm (child only): Wraps a raw private key in a memory-safe buffer. Cannot derive. Use directly with WalletAccountEvm. Not supported by WalletManagerEvm.

Examples:

Key Capabilities

BIP-39 Seed Phrase Support: Generate and validate mnemonic seed phrases
BIP-44 Derivation Paths: Standard Ethereum derivation (m/44'/60')
Multi-Account Management: Derive multiple accounts from a single seed phrase
EIP-1559 Transaction Support: Modern fee estimation and transaction sending
ERC-20 Token Support: Query balances and transfer tokens
Message Signing: Sign and verify messages (EIP-191 and EIP-712)
Fee Estimation: Real-time network fee rates with normal/fast tiers
Secure Memory Disposal: Clear private keys from memory when done
Signer Submodule: Create your own signer from ISignerEvm, support for Seed and Private key signers
EIP-7702 Delegation: Delegate EOAs to smart contracts, sign authorizations, and send type 4 transactions

Compatibility

Ethereum Mainnet and testnets (Sepolia)
Layer 2 Networks: Arbitrum, Optimism, Base
Other EVM Chains: Polygon, Avalanche C-Chain, and any EVM-compatible chain

Documentation

Topic	Description	Link
Overview	Module overview and feature summary	Wallet EVM Overview
Usage	End-to-end integration walkthrough	Wallet EVM Usage
Configuration	Provider, fees, and network configuration	Wallet EVM Configuration
API Reference	Complete class and type reference	Wallet EVM API Reference

Examples

Example	Description
Create Wallet	Initialize a wallet manager and derive accounts from a seed phrase
Manage Accounts	Work with multiple accounts and custom derivation paths
Check Balances	Query native token and ERC-20 balances for owned accounts
Read-Only Account	Monitor balances for any address without a private key
Send Transaction	Estimate fees and send native token transactions (EIP-1559 + legacy)
Token Transfer	Transfer ERC-20 tokens and estimate transfer fees

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.

import WalletManagerEvm, {
  WalletAccountEvm,
  WalletAccountReadOnlyEvm,
} from '@tetherto/wdk-wallet-evm'

// Signers are exported under the /signers subpath
import {
  SeedSignerEvm,
  PrivateKeySignerEvm,
} from '@tetherto/wdk-wallet-evm/signers'

import WalletManagerEvm from '@tetherto/wdk-wallet-evm'
import { SeedSignerEvm } from '@tetherto/wdk-wallet-evm/signers'

// Use a BIP-39 seed phrase (replace with your own secure phrase)
const seedPhrase =
  'test only example nut use this real life secret phrase must random'

// Create a root signer from the seed phrase
const root = new SeedSignerEvm(seedPhrase)

// Create wallet manager with provider config (provider is required for chain ops)
const wallet = new WalletManagerEvm(root, {
  // Option 1: Using RPC URL
  provider: 'https://sepolia.drpc.org', // any EVM RPC
  transferMaxFee: 100000000000000n, // Optional: max fee in wei (BigInt)
})

// OR

// Option 2: Using EIP-1193 provider (e.g., from browser wallet)
const wallet2 = new WalletManagerEvm(root, {
  provider: window.ethereum, // EIP-1193 provider
  transferMaxFee: 100000000000000n, // Optional
})

// Get a full access account
const account0 = await wallet.getAccount(0)

// Convert to a read-only account
const readOnlyAccount = await account0.toReadOnlyAccount()

import { WalletAccountEvm } from '@tetherto/wdk-wallet-evm'
import { PrivateKeySignerEvm } from '@tetherto/wdk-wallet-evm/signers'

// From a raw private key (hex string or bytes)
const pkSigner = new PrivateKeySignerEvm('0x0123...abcd')
const pkAccount = new WalletAccountEvm(pkSigner, {
  provider: 'https://eth-mainnet.g.alchemy.com/v2/your-api-key',
})

import { WalletAccountEvm } from '@tetherto/wdk-wallet-evm'

// From a BIP-39 seed phrase (or seed bytes) and a BIP-44 derivation path
const account = new WalletAccountEvm(mnemonic, "0'/0/0", {
  provider: 'https://eth-mainnet.g.alchemy.com/v2/your-api-key',
})

import WalletManagerEvm from '@tetherto/wdk-wallet-evm'
import { SeedSignerEvm } from '@tetherto/wdk-wallet-evm/signers'

const root = new SeedSignerEvm(mnemonic)
const wallet = new WalletManagerEvm(root, {
  provider: 'https://eth-mainnet.g.alchemy.com/v2/your-api-key',
})

// Get the first account (index 0)
const account = await wallet.getAccount(0) // m/44'/60'/0'/0/0
const address = await account.getAddress() // 0x...
console.log('Account 0 address:', address)

// Get the second account (index 1)
const account1 = await wallet.getAccount(1) // m/44'/60'/0'/0/1
const address1 = await account1.getAddress() // 0x...
console.log('Account 1 address:', address1)

// Get account by custom derivation path
// Full path will be m/44'/60'/0'/0/5
const customAccount = await wallet.getAccountByPath('0\'/0/5')
const customAddress = await customAccount.getAddress()
console.log('Custom account address:', customAddress)

// Note: All addresses are checksummed Ethereum addresses (0x...)
// All accounts inherit the provider configuration from the wallet manager

// Assume wallet and account are already created
// Get native token balance (in wei)
const balance = await account.getBalance()
console.log('Native balance:', balance, 'wei') // 1 ETH = 1000000000000000000 wei

// Get ERC20 token balance
const tokenContract = '0x...' // ERC20 contract address
const tokenBalance = await account.getTokenBalance(tokenContract)
console.log('Token balance:', tokenBalance)

// Note: Provider is required for balance checks
// Make sure wallet was created with a provider configuration

import { WalletAccountReadOnlyEvm } from '@tetherto/wdk-wallet-evm'

// Create a read-only account
const readOnlyAccount = new WalletAccountReadOnlyEvm('0x...', {
  // Ethereum address
  provider: 'https://sepolia.drpc.org', // Required for balance checks
})

// Check native token balance
const balance = await readOnlyAccount.getBalance()
console.log('Native balance:', balance, 'wei')

// Check ERC20 token balance using contract
const tokenBalance = await readOnlyAccount.getTokenBalance('0x...') // ERC20 contract address
console.log('Token balance:', tokenBalance)

// Note: ERC20 balance checks use the standard balanceOf(address) function
// Make sure the contract address is correct and implements the ERC20 standard

// Send native tokens
// Modern EIP-1559 style transaction (recommended)
const result = await account.sendTransaction({
  to: '0x...', // Recipient address
  value: 1000000000000000000n, // 1 ETH in wei
  maxFeePerGas: 30000000000n, // Optional: max fee per gas (in wei)
  maxPriorityFeePerGas: 2000000000n, // Optional: max priority fee per gas (in wei)
})
console.log('Transaction hash:', result.hash)
console.log('Transaction fee:', result.fee, 'wei')

// OR Legacy style transaction
const legacyResult = await account.sendTransaction({
  to: '0x...',
  value: 1000000000000000000n,
  gasPrice: 20000000000n, // Optional: legacy gas price (in wei)
  gasLimit: 21000, // Optional: gas limit
})

// Get transaction fee estimate
const quote = await account.quoteSendTransaction({
  to: '0x...',
  value: 1000000000000000000n,
})
console.log('Estimated fee:', quote.fee, 'wei')

// Transfer ERC20 tokens
const transferResult = await account.transfer({
  token: '0x...', // ERC20 contract address
  recipient: '0x...', // Recipient's address
  amount: 1000000n, // Amount in token's base units (use BigInt for large numbers)
})
console.log('Transfer hash:', transferResult.hash)
console.log('Transfer fee:', transferResult.fee, 'wei')

// Quote token transfer fee
const transferQuote = await account.quoteTransfer({
  token: '0x...', // ERC20 contract address
  recipient: '0x...', // Recipient's address
  amount: 1000000n, // Amount in token's base units
})
console.log('Transfer fee estimate:', transferQuote.fee, 'wei')

const approval = await account.approve({
  token: '0x...', // ERC20 contract
  spender: '0x...', // Spender address
  amount: 1000000n, // Allowance amount in base units
})
console.log('Approval tx hash:', approval.hash)

// Sign a message
const message = 'Hello, Ethereum!'
const signature = await account.sign(message)
console.log('Signature:', signature)

// Verify a signature (can use read-only account)
const isValid = await readOnlyAccount.verify(message, signature)
console.log('Signature valid:', isValid)

// Get current fee rates
const feeRates = await wallet.getFeeRates()
console.log('Normal fee rate:', feeRates.normal, 'wei') // 1.1x base fee
console.log('Fast fee rate:', feeRates.fast, 'wei') // 2.0x base fee

// Root + manager (seed)
import WalletManagerEvm from '@tetherto/wdk-wallet-evm'
import { SeedSignerEvm } from '@tetherto/wdk-wallet-evm/signers'
const root = new SeedSignerEvm(mnemonic)
const wallet = new WalletManagerEvm(root, { provider: 'https://...' })
const account0 = await wallet.getAccount(0)

// Single account from a private key
import { WalletAccountEvm } from '@tetherto/wdk-wallet-evm'
import { PrivateKeySignerEvm } from '@tetherto/wdk-wallet-evm/signers'
const signer = new PrivateKeySignerEvm('0x0123...')
const account = new WalletAccountEvm(signer, { provider: 'https://...' })

Building Blocks

wdk-wallet-evm

README

@tetherto/wdk-wallet-evm

About WDK

⬇️ Installation

🚀 Quick Start

Importing from @tetherto/wdk-wallet-evm

Create a Wallet Manager (seed-based)

Single Account (no manager): Private key

Single Account (no manager): Seed + path

Managing Multiple Accounts (seed-based manager)

Checking Balances

Owned Account

Read-Only Account

Sending Transactions

Token Transfers

Token Approvals

Message Signing and Verification

Fee Management

Memory Management

🔐 Signers

Key Capabilities

Compatibility

Documentation

Examples

Community

Support

Contributing

License

Recent updates

What's Changed

Related Building Blocks

wdk-wallet-evm-erc4337

wdk-wallet-btc

wdk-wallet-solana

README

@tetherto/wdk-wallet-evm

About WDK

⬇️ Installation

🚀 Quick Start

Importing from @tetherto/wdk-wallet-evm

Create a Wallet Manager (seed-based)

Single Account (no manager): Private key

Single Account (no manager): Seed + path

Managing Multiple Accounts (seed-based manager)

Checking Balances

Owned Account

Read-Only Account

Sending Transactions

Token Transfers

Token Approvals

Message Signing and Verification

Fee Management

Memory Management

🔐 Signers

Key Capabilities

Compatibility

Documentation

Examples

Community

Support

Contributing

License

Importing from `@tetherto/wdk-wallet-evm`

Importing from `@tetherto/wdk-wallet-evm`