Getting Started

This guide explains how to install the @tetherto/wdk-wallet-evm package and create a new wallet instance.

1. Installation

Prerequisites

Before you begin, ensure you have the following installed:

Node.js: version 18 or higher.
npm: usually comes with Node.js.

Install Package

Install @tetherto/wdk-wallet-evm

npm install @tetherto/wdk-wallet-evm

2. Create a Wallet

Import the module and create a WalletManagerEvm instance with a BIP-39 seed phrase and an RPC provider.

Create EVM Wallet

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

const seedPhrase = 'your twelve word seed phrase here'

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

Secure the Seed Phrase: You must securely store this seed phrase immediately. If it is lost, the user will permanently lose access to their funds.

You can also pass an EIP-1193 provider (e.g., from a browser wallet) instead of an RPC URL:

Use EIP-1193 Provider

const wallet = new WalletManagerEvm(seedPhrase, {
  provider: window.ethereum,
  transferMaxFee: 100000000000000
})

3. Get Your First Account

Retrieve an account from the wallet and inspect its address.

Get Account

const account = await wallet.getAccount(0)
const address = await account.getAddress()
console.log('Wallet address:', address)

const readOnlyAccount = await account.toReadOnlyAccount()

RPC Providers: The examples use public RPC endpoints for demonstration. We do not endorse any specific provider.

Testnets: You can find public RPCs for Ethereum and other EVM chains on Chainlist.
Mainnet: For production environments, we recommend using reliable, paid RPC providers to ensure stability.

To use test/mock tokens instead of real funds, see the configuration section.

Next Steps

With your wallet ready, learn how to manage multiple accounts.