API Reference

Complete API documentation for @tetherto/wdk-wallet-evm

Table of Contents

Class	Description	Methods
WalletManagerEvm	Main class for managing EVM wallets. Extends WalletManager from @tetherto/wdk-wallet.	Constructor, Methods
WalletAccountEvm	Individual EVM wallet account implementation. Extends WalletAccountReadOnlyEvm and implements IWalletAccount from @tetherto/wdk-wallet.	Constructor, Methods, Properties
WalletAccountReadOnlyEvm	Read-only EVM wallet account. Extends WalletAccountReadOnly from @tetherto/wdk-wallet.	Constructor, Methods

WalletManagerEvm

The main class for managing EVM wallets. Extends WalletManager from @tetherto/wdk-wallet.

Constructor

new WalletManagerEvm(seed, config?)

Parameters:

• seed (string | Uint8Array): BIP-39 mnemonic seed phrase or seed bytes

• config (object, optional): Configuration object

  • provider (string | Eip1193Provider, optional): RPC endpoint URL or EIP-1193 provider instance

  • transferMaxFee (number | bigint, optional): Maximum fee amount for transfer operations (in wei)

Example:

const wallet = new WalletManagerEvm(seedPhrase, {
  provider: 'https://rpc.mevblocker.io/fast',
  transferMaxFee: 100000000000000 // Maximum fee in wei
})

Methods

Method	Description	Returns	Throws
getRandomSeedPhrase(wordCount?)	(static) Returns a random BIP-39 seed phrase	string	-
isValidSeedPhrase(seedPhrase)	(static) Checks if a seed phrase is valid	boolean	-
getAccount(index?)	Returns a wallet account at the specified index	Promise<WalletAccountEvm>	-
getAccountByPath(path)	Returns a wallet account at the specified BIP-44 derivation path	Promise<WalletAccountEvm>	-
getFeeRates()	Returns current fee rates for transactions	Promise<{normal: bigint, fast: bigint}>	If no provider is set
dispose()	Disposes all wallet accounts, clearing private keys from memory	void	-

Properties

Property	Type	Description
seed	Uint8Array	The wallet's seed bytes

getRandomSeedPhrase(wordCount?) (static)

Returns a random BIP-39 seed phrase.

Parameters:

• wordCount (12 | 24, optional): The number of words in the seed phrase (default: 12)

Returns: string - The seed phrase

Example:

const seedPhrase = WalletManagerEvm.getRandomSeedPhrase()
console.log('Seed phrase:', seedPhrase) // 12 words

const longSeedPhrase = WalletManagerEvm.getRandomSeedPhrase(24)
console.log('Long seed phrase:', longSeedPhrase) // 24 words

isValidSeedPhrase(seedPhrase) (static)

Checks if a seed phrase is valid.

Parameters:

• seedPhrase (string): The seed phrase to validate

Returns: boolean - True if the seed phrase is valid

Example:

const isValid = WalletManagerEvm.isValidSeedPhrase('abandon abandon abandon ...')
console.log('Valid:', isValid)

getAccount(index?)

Returns a wallet account at the specified index following BIP-44 standard.

Parameters:

• index (number, optional): The index of the account to get (default: 0)

Returns: Promise<WalletAccountEvm> - The wallet account

Example:

// Get first account (index 0)
const account = await wallet.getAccount(0)

// Get second account (index 1) 
const account1 = await wallet.getAccount(1)

// Get first account (default)
const defaultAccount = await wallet.getAccount()

getAccountByPath(path)

Returns a wallet account at the specified BIP-44 derivation path.

Parameters:

• path (string): The derivation path (e.g., "0'/0/0")

Returns: Promise<WalletAccountEvm> - The wallet account

Example:

// Full path: m/44'/60'/0'/0/1
const account = await wallet.getAccountByPath("0'/0/1")

// Custom path: m/44'/60'/0'/0/5
const customAccount = await wallet.getAccountByPath("0'/0/5")

getFeeRates()

Returns current fee rates based on network conditions with predefined multipliers.

Returns: Promise<{normal: bigint, fast: bigint}> - Fee rates in wei

• normal: Base fee × 1.1 (10% above base)

• fast: Base fee × 2.0 (100% above base)

Throws: Error if no provider is configured

Example:

const feeRates = await wallet.getFeeRates()
console.log('Normal fee rate:', feeRates.normal, 'wei')
console.log('Fast fee rate:', feeRates.fast, 'wei')

// Use in transaction
const result = await account.sendTransaction({
  to: '0x...',
  value: 1000000000000000000n,
  maxFeePerGas: feeRates.fast
})

dispose()

Disposes all wallet accounts, clearing private keys from memory.

Example:

// Clean up when done
wallet.dispose()

WalletAccountEvm

Represents an individual wallet account. Extends WalletAccountReadOnlyEvm and implements IWalletAccount from @tetherto/wdk-wallet.

Constructor

new WalletAccountEvm(seed, path, config?)

Parameters:

• seed (string | Uint8Array): BIP-39 mnemonic seed phrase or seed bytes

• path (string): BIP-44 derivation path (e.g., "0'/0/0")

• config (object, optional): Configuration object

  • provider (string | Eip1193Provider, optional): RPC endpoint URL or EIP-1193 provider instance

  • transferMaxFee (number | bigint, optional): Maximum fee amount for transfer operations (in wei)

Throws:

• Error if seed phrase is invalid (BIP-39 validation fails)

Example:

const account = new WalletAccountEvm(seedPhrase, "0'/0/0", {
  provider: 'https://rpc.mevblocker.io/fast',
  transferMaxFee: 100000000000000
})

Methods

Method	Description	Returns	Throws
getAddress()	Returns the account's address	Promise<string>	-
sign(message)	Signs a message using the account's private key	Promise<string>	-
signTypedData(typedData)	Signs typed data according to EIP-712	Promise<string>	-
verify(message, signature)	Verifies a message signature	Promise<boolean>	-
verifyTypedData(typedData, signature)	Verifies a typed data signature (EIP-712)	Promise<boolean>	-
sendTransaction(tx)	Sends an EVM transaction	Promise<{hash: string, fee: bigint}>	If no provider
quoteSendTransaction(tx)	Estimates the fee for an EVM transaction	Promise<{fee: bigint}>	If no provider
transfer(options)	Transfers ERC20 tokens to another address	Promise<{hash: string, fee: bigint}>	If no provider or fee exceeds max
quoteTransfer(options)	Estimates the fee for an ERC20 transfer	Promise<{fee: bigint}>	If no provider
getBalance()	Returns the native token balance (in wei)	Promise<bigint>	If no provider
getTokenBalance(tokenAddress)	Returns the balance of a specific ERC20 token	Promise<bigint>	If no provider
getTokenBalances(tokenAddresses)	Returns balances for multiple ERC20 tokens	Promise<Record<string, bigint>>	If no provider
approve(options)	Approves a spender to spend tokens	Promise<{hash: string, fee: bigint}>	If no provider
getAllowance(token, spender)	Returns current allowance for a spender	Promise<bigint>	If no provider
getTransactionReceipt(hash)	Returns a transaction's receipt	Promise<EvmTransactionReceipt | null>	If no provider
toReadOnlyAccount()	Returns a read-only copy of the account	Promise<WalletAccountReadOnlyEvm>	-
dispose()	Disposes the wallet account, clearing private keys from memory	void	-

getAddress()

Returns the account's Ethereum address.

Returns: Promise<string> - Checksummed Ethereum address

Example:

const address = await account.getAddress()
console.log('Account address:', address) // 0x...

sign(message)

Signs a message using the account's private key.

Parameters:

• message (string): The message to sign

Returns: Promise<string> - The message signature

Example:

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

signTypedData(typedData)

Signs typed data according to EIP-712.

Parameters:

• typedData (TypedData): The typed data to sign

  • domain (TypedDataDomain): The domain separator (name, version, chainId, verifyingContract)

  • types (Record<string, TypedDataField[]>): The type definitions

  • message (Record<string, unknown>): The message data

Returns: Promise<string> - The typed data signature

Example:

const typedData = {
  domain: {
    name: 'MyDApp',
    version: '1',
    chainId: 1,
    verifyingContract: '0xCcCCccccCCCCcCCCCCCcCcCccCcCCCcCcccccccC'
  },
  types: {
    Mail: [
      { name: 'from', type: 'address' },
      { name: 'to', type: 'address' },
      { name: 'contents', type: 'string' }
    ]
  },
  message: {
    from: '0xAlice...',
    to: '0xBob...',
    contents: 'Hello Bob!'
  }
}
const signature = await account.signTypedData(typedData)
console.log('EIP-712 Signature:', signature)

verify(message, signature)

Verifies a message signature against the account's address.

Parameters:

• message (string): The original message

• signature (string): The signature to verify

Returns: Promise<boolean> - True if signature is valid

Example:

const message = 'Hello, Ethereum!'
const signature = await account.sign(message)
const isValid = await account.verify(message, signature)
console.log('Signature valid:', isValid) // true

verifyTypedData(typedData, signature)

Verifies a typed data signature according to EIP-712.

Parameters:

• typedData (TypedData): The typed data that was signed

• signature (string): The signature to verify

Returns: Promise<boolean> - True if signature is valid

Example:

const isValid = await account.verifyTypedData(typedData, signature)
console.log('Typed data signature valid:', isValid) // true

sendTransaction(tx)

Sends an EVM transaction and returns the result with hash and fee.

Parameters:

• tx (EvmTransaction): The transaction object

  • to (string): Recipient address

  • value (number | bigint): Amount in wei

  • data (string, optional): Transaction data in hex format

  • gasLimit (number | bigint, optional): Maximum gas units

  • gasPrice (number | bigint, optional): Legacy gas price in wei

  • maxFeePerGas (number | bigint, optional): EIP-1559 max fee per gas in wei

  • maxPriorityFeePerGas (number | bigint, optional): EIP-1559 max priority fee per gas in wei

Returns: Promise<{hash: string, fee: bigint}> - Transaction result

Throws: Error if no provider is configured

Example:

// EIP-1559 transaction
const result = await account.sendTransaction({
  to: '0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6',
  value: 1000000000000000000, // 1 ETH in wei
  maxFeePerGas: 30000000000,
  maxPriorityFeePerGas: 2000000000
})

// Legacy transaction
const legacyResult = await account.sendTransaction({
  to: '0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6',
  value: 1000000000000000000,
  gasPrice: 20000000000,
  gasLimit: 21000
})

console.log('Transaction hash:', result.hash)
console.log('Transaction fee:', result.fee, 'wei')

quoteSendTransaction(tx)

Estimates the fee for an EVM transaction without sending it.

Parameters:

• tx (EvmTransaction): The transaction object (same format as sendTransaction)

Returns: Promise<{fee: bigint}> - Fee estimate in wei

Throws: Error if no provider is configured

Example:

const quote = await account.quoteSendTransaction({
  to: '0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6',
  value: 1000000000000000000
})
console.log('Estimated fee:', quote.fee, 'wei')

transfer(options)

Transfers ERC20 tokens to another address using the standard transfer function.

Parameters:

• options (TransferOptions): Transfer options

  • token (string): Token contract address

  • recipient (string): Recipient address

  • amount (number | bigint): Amount in token base units

Returns: Promise<{hash: string, fee: bigint}> - Transfer result

Throws:

• Error if no provider is configured

• Error if fee exceeds transferMaxFee (if configured)

Example:

const result = await account.transfer({
  token: '0xdAC17F958D2ee523a2206206994597C13D831ec7', // USDT
  recipient: '0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6',
  amount: 1000000 // 1 USDT (6 decimals)
})
console.log('Transfer hash:', result.hash)
console.log('Transfer fee:', result.fee, 'wei')

quoteTransfer(options)

Estimates the fee for an ERC20 token transfer.

Parameters:

• options (TransferOptions): Transfer options (same as transfer)

Returns: Promise<{fee: bigint}> - Fee estimate in wei

Throws: Error if no provider is configured

Example:

const quote = await account.quoteTransfer({
  token: '0xdAC17F958D2ee523a2206206994597C13D831ec7',
  recipient: '0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6',
  amount: 1000000
})
console.log('Transfer fee estimate:', quote.fee, 'wei')

getBalance()

Returns the native token balance (ETH, MATIC, BNB, etc.).

Returns: Promise<bigint> - Balance in wei

Throws: Error if no provider is configured

Example:

const balance = await account.getBalance()
console.log('Balance:', balance, 'wei')
console.log('Balance in ETH:', balance / 1000000000000000000)

getTokenBalance(tokenAddress)

Returns the balance of a specific ERC20 token using the balanceOf function.

Parameters:

• tokenAddress (string): The ERC20 token contract address

Returns: Promise<bigint> - Token balance in base units

Throws: Error if no provider is configured

Example:

// Get USDT balance
const usdtBalance = await account.getTokenBalance('0xdAC17F958D2ee523a2206206994597C13D831ec7')
console.log('USDT balance:', usdtBalance) // In 6 decimal places
console.log('USDT balance formatted:', usdtBalance / 1000000, 'USDT')

getTokenBalances(tokenAddresses)

Returns balances for multiple ERC20 tokens in one call.

Parameters:

• tokenAddresses (string[]): List of ERC20 token contract addresses

Returns: Promise<Record<string, bigint>> - Object mapping each token address to its balance in base units

Throws: Error if no provider is configured

Example:

const balances = await account.getTokenBalances([
  '0xdAC17F958D2ee523a2206206994597C13D831ec7', // USDT
  '0x68749665FF8D2d112Fa859AA293F07A622782F38'  // XAUT
])

console.log('USDT:', balances['0xdAC17F958D2ee523a2206206994597C13D831ec7'])
console.log('XAUT:', balances['0x68749665FF8D2d112Fa859AA293F07A622782F38'])

approve(options)

Approves a specific amount of tokens to a spender.

Parameters:

• options (ApproveOptions): Approve options

  • token (string): Token contract address

  • spender (string): Spender address

  • amount (number | bigint): Amount to approve

Returns: Promise<{hash: string, fee: bigint}> - Transaction result

Throws:

• Error if no provider is configured

• Error if trying to re-approve USDT on Ethereum without resetting to 0 first

Example:

const result = await account.approve({
  token: '0xdAC17F958D2ee523a2206206994597C13D831ec7', // USDT
  spender: '0xSpenderAddress...',
  amount: 1000000n
})
console.log('Approve hash:', result.hash)

getAllowance(token, spender)

Returns the current token allowance for the given spender.

Parameters:

• token (string): ERC20 token contract address

• spender (string): The spender's address

Returns: Promise<bigint> - The current allowance

Throws: Error if no provider is configured

Example:

const allowance = await account.getAllowance(
  '0xdAC17F958D2ee523a2206206994597C13D831ec7',
  '0xSpenderContract...'
)
console.log('Current allowance:', allowance)

getTransactionReceipt(hash)

Returns a transaction receipt by hash.

Parameters:

• hash (string): The transaction hash

Returns: Promise<EvmTransactionReceipt | null> - Transaction receipt or null if not mined

Throws: Error if no provider is configured

Example:

const receipt = await account.getTransactionReceipt('0x...')
if (receipt) {
  console.log('Confirmed in block:', receipt.blockNumber)
  console.log('Status:', receipt.status) // 1 = success, 0 = failed
}

toReadOnlyAccount()

Creates a read-only copy of the account with the same configuration.

Returns: Promise<WalletAccountReadOnlyEvm> - Read-only account instance

Example:

const readOnlyAccount = await account.toReadOnlyAccount()

// Can check balances but cannot send transactions
const balance = await readOnlyAccount.getBalance()
// readOnlyAccount.sendTransaction() // Would throw error

dispose()

Disposes the wallet account, erasing the private key from memory.

Example:

// Clean up when done
account.dispose()

Properties

Property	Type	Description
index	number	The derivation path's index of this account
path	string	The full BIP-44 derivation path of this account
keyPair	{privateKey: Uint8Array | null, publicKey: Uint8Array}	The account's key pair (⚠️ Contains sensitive data)
address	string	The account's Ethereum address (inherited from WalletAccountReadOnlyEvm)

Example:

console.log('Account index:', account.index) // 0, 1, 2, etc.
console.log('Account path:', account.path) // m/44'/60'/0'/0/0

// ⚠️ SENSITIVE: Handle with care
const { privateKey, publicKey } = account.keyPair
console.log('Public key length:', publicKey.length) // 65 bytes
console.log('Private key length:', privateKey.length) // 32 bytes

⚠️ Security Note: The keyPair property contains sensitive cryptographic material. Never log, display, or expose the private key.

WalletAccountReadOnlyEvm

Represents a read-only wallet account that can query balances and estimate fees but cannot send transactions.

Constructor

new WalletAccountReadOnlyEvm(address, config?)

Parameters:

• address (string): The account's Ethereum address

• config (Omit<EvmWalletConfig, 'transferMaxFee'>, optional): Configuration object (same as EvmWalletConfig but without transferMaxFee, since read-only accounts cannot send transactions)

  • provider (string | Eip1193Provider, optional): RPC endpoint URL or EIP-1193 provider instance

Example:

const readOnlyAccount = new WalletAccountReadOnlyEvm('0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6', {
  provider: 'https://rpc.mevblocker.io/fast'
})

Properties

Property	Type	Description
address	string	The account's Ethereum address

Methods

Method	Description	Returns	Throws
getAddress()	Returns the account's address	Promise<string>	-
getBalance()	Returns the native token balance (in wei)	Promise<bigint>	If no provider
getTokenBalance(tokenAddress)	Returns the balance of a specific ERC20 token	Promise<bigint>	If no provider
getTokenBalances(tokenAddresses)	Returns balances for multiple ERC20 tokens	Promise<Record<string, bigint>>	If no provider
quoteSendTransaction(tx)	Estimates the fee for an EVM transaction	Promise<{fee: bigint}>	If no provider
quoteTransfer(options)	Estimates the fee for an ERC20 transfer	Promise<{fee: bigint}>	If no provider
verify(message, signature)	Verifies a message signature	Promise<boolean>	-
verifyTypedData(typedData, signature)	Verifies a typed data signature (EIP-712)	Promise<boolean>	-
getTransactionReceipt(hash)	Returns a transaction's receipt	Promise<EvmTransactionReceipt | null>	If no provider
getAllowance(token, spender)	Returns current allowance for a spender	Promise<bigint>	If no provider

getAddress()

Returns the account's Ethereum address.

Returns: Promise<string> - Checksummed Ethereum address

Example:

const address = await readOnlyAccount.getAddress()
console.log('Account address:', address) // 0x...

getBalance()

Returns the account's native token balance.

Returns: Promise<bigint> - Balance in wei

Throws: Error if no provider is configured

Example:

const balance = await readOnlyAccount.getBalance()
console.log('Balance:', balance, 'wei')

getTokenBalance(tokenAddress)

Returns the balance of a specific ERC20 token.

Parameters:

• tokenAddress (string): The ERC20 token contract address

Returns: Promise<bigint> - Token balance in base units

Throws: Error if no provider is configured

Example:

const tokenBalance = await readOnlyAccount.getTokenBalance('0xdAC17F958D2ee523a2206206994597C13D831ec7')
console.log('USDT balance:', tokenBalance)

getTokenBalances(tokenAddresses)

Returns balances for multiple ERC20 tokens.

Parameters:

• tokenAddresses (string[]): List of ERC20 token contract addresses

Returns: Promise<Record<string, bigint>> - Object mapping each token address to its balance in base units

Throws: Error if no provider is configured

Example:

const balances = await readOnlyAccount.getTokenBalances([
  '0xdAC17F958D2ee523a2206206994597C13D831ec7', // USDT
  '0x68749665FF8D2d112Fa859AA293F07A622782F38'  // XAUT
])
console.log('Balances:', balances)

quoteSendTransaction(tx)

Estimates the fee for an EVM transaction.

Parameters:

• tx (EvmTransaction): The transaction object

Returns: Promise<{fee: bigint}> - Fee estimate in wei

Throws: Error if no provider is configured

Example:

const quote = await readOnlyAccount.quoteSendTransaction({
  to: '0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6',
  value: 1000000000000000000
})
console.log('Estimated fee:', quote.fee, 'wei')

quoteTransfer(options)

Estimates the fee for an ERC20 token transfer.

Parameters:

• options (TransferOptions): Transfer options

Returns: Promise<{fee: bigint}> - Fee estimate in wei

Throws: Error if no provider is configured

Example:

const quote = await readOnlyAccount.quoteTransfer({
  token: '0xdAC17F958D2ee523a2206206994597C13D831ec7',
  recipient: '0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6',
  amount: 1000000
})
console.log('Transfer fee estimate:', quote.fee, 'wei')

verify(message, signature)

Verifies a message signature against the account's address.

Parameters:

• message (string): The original message

• signature (string): The signature to verify

Returns: Promise<boolean> - True if signature is valid

Example:

const message = 'Hello, Ethereum!'
const signature = await account.sign(message)

const readOnlyAccount = new WalletAccountReadOnlyEvm('0x...', { provider: '...' })
const isValid = await readOnlyAccount.verify(message, signature)
console.log('Signature valid:', isValid) // true

verifyTypedData(typedData, signature)

Verifies a typed data signature according to EIP-712.

Parameters:

• typedData (TypedData): The typed data that was signed

• signature (string): The signature to verify

Returns: Promise<boolean> - True if signature is valid

Example:

const isValid = await readOnlyAccount.verifyTypedData(typedData, signature)
console.log('Typed data signature valid:', isValid) // true

getTransactionReceipt(hash)

Returns a transaction's receipt if it has been mined.

Parameters:

• hash (string): The transaction hash

Returns: Promise<EvmTransactionReceipt | null> - Transaction receipt or null if not yet mined

Throws: Error if no provider is configured

Example:

const receipt = await readOnlyAccount.getTransactionReceipt('0x...')
if (receipt) {
  console.log('Transaction confirmed in block:', receipt.blockNumber)
  console.log('Gas used:', receipt.gasUsed)
  console.log('Status:', receipt.status) // 1 = success, 0 = failed
} else {
  console.log('Transaction not yet mined')
}

getAllowance(token, spender)

Returns the current allowance for the given token and spender.

Parameters:

• token (string): The token's address

• spender (string): The spender's address

Returns: Promise<bigint> - The allowance

Example:

const allowance = await readOnlyAccount.getAllowance(
  '0xdAC17F958D2ee523a2206206994597C13D831ec7',
  '0xSpenderAddress...'
)
console.log('Allowance:', allowance)

Types

EvmTransaction

interface EvmTransaction {
  to: string;                               // The transaction's recipient address
  value: number | bigint;                    // The amount of ethers to send (in wei)
  data?: string;                             // The transaction's data in hex format (optional)
  gasLimit?: number | bigint;                // Maximum amount of gas this transaction can use (optional)
  gasPrice?: number | bigint;                // Legacy gas price in wei (optional)
  maxFeePerGas?: number | bigint;            // EIP-1559 max fee per gas in wei (optional)
  maxPriorityFeePerGas?: number | bigint;    // EIP-1559 priority fee in wei (optional)
}

TransferOptions

interface TransferOptions {
  token: string;                     // ERC20 token contract address
  recipient: string;                 // Recipient's Ethereum address
  amount: number | bigint;           // Amount in token's base units
}

TransactionResult

interface TransactionResult {
  hash: string;                      // Transaction hash
  fee: bigint;                       // Transaction fee paid in wei
}

TransferResult

interface TransferResult {
  hash: string;                      // Transfer transaction hash
  fee: bigint;                       // Transfer fee paid in wei
}

FeeRates

interface FeeRates {
  normal: bigint;                    // Normal priority fee rate (base fee × 1.1)
  fast: bigint;                      // Fast priority fee rate (base fee × 2.0)
}

KeyPair

interface KeyPair {
  privateKey: Uint8Array | null;     // Private key as Uint8Array (32 bytes, null after dispose)
  publicKey: Uint8Array;             // Public key as Uint8Array (65 bytes)
}

TypedData

interface TypedData {
  domain: TypedDataDomain;                           // The domain separator
  types: Record<string, TypedDataField[]>;           // The type definitions
  message: Record<string, unknown>;                  // The message data
}

TypedDataDomain

interface TypedDataDomain {
  name?: string;                     // The domain name (e.g., the DApp name)
  version?: string;                  // The domain version
  chainId?: number | bigint;         // The chain ID
  verifyingContract?: string;        // The verifying contract address
  salt?: string;                     // An optional salt
}

TypedDataField

interface TypedDataField {
  name: string;                      // The field name
  type: string;                      // The field type (e.g., 'address', 'uint256', 'string')
}

EvmWalletConfig

interface EvmWalletConfig {
  provider?: string | Eip1193Provider;  // RPC URL or EIP-1193 provider instance
  transferMaxFee?: number | bigint;     // Maximum fee for transfers in wei
}

ApproveOptions

interface ApproveOptions {
  token: string;                         // ERC20 token contract address
  spender: string;                       // Address allowed to spend tokens
  amount: number | bigint;               // Amount to approve in base units
}

EvmTransactionReceipt

interface EvmTransactionReceipt {
  to: string;                        // Recipient address
  from: string;                      // Sender address
  contractAddress: string | null;    // Contract address if contract creation
  transactionIndex: number;          // Transaction index in block
  gasUsed: bigint;                   // Gas actually used
  logsBloom: string;                 // Bloom filter for logs
  blockHash: string;                 // Block hash containing transaction
  transactionHash: string;           // Transaction hash
  logs: Array<Log>;                  // Event logs
  blockNumber: number;               // Block number
  confirmations: number;             // Number of confirmations
  cumulativeGasUsed: bigint;         // Cumulative gas used in block
  effectiveGasPrice: bigint;         // Effective gas price paid
  status: number;                    // Transaction status (1 = success, 0 = failed)
  type: number;                      // Transaction type (0 = legacy, 2 = EIP-1559)
}

Node.js Quickstart

Get started with WDK in a Node.js environment

React Native Quickstart

Build mobile wallets with React Native Expo

WDK EVM Wallet Usage

Get started with WDK's EVM Wallet Usage

WDK EVM Wallet Configuration

Get started with WDK's EVM Wallet Configuration

---

Need Help?

Discord Community

Connect with developers, ask questions, share your projects

Join Community

GitHub Issues

Report bugs, request features, and get technical help

Open an Issue

Email Contact

For sensitive or private matters, contact our team directly

Send an email