Skip to main content
Version 4.0.0 brings improvements to use-wallet while maintaining the core architecture from v3:
  • Updated to support algosdk v3
  • Enhanced network configuration capabilities
  • Reorganized framework adapter APIs for better separation of concerns
This guide will walk you through the changes needed to upgrade from v3.x. Most applications will require only minor updates to network configuration and imports.

​
Upgrading dependencies

1

Update use-wallet package

Update your use-wallet package to version 4.0.0 or later.
npm upgrade @txnlab/use-wallet@^4.0.0
# if using React adapter
npm upgrade @txnlab/use-wallet-react@^4.0.0
# if using Vue adapter
npm upgrade @txnlab/use-wallet-vue@^4.0.0
# if using Solid adapter
npm upgrade @txnlab/use-wallet-solid@^4.0.0
# if using Svelte adapter
npm upgrade @txnlab/use-wallet-svelte@^4.0.0
2

Update algosdk

Update algosdk to version 3.0.0 or later.
npm upgrade algosdk@^3.0.0

​
Support for algosdk v3

Version 4 upgrades from algosdk v2 to v3. The extent of required changes will depend on how your application uses the SDK. Some applications may need minimal changes, while others may require more extensive updates.
For a complete guide to migrating from algosdk v2 to v3, see the official migration guide.

​
Network configuration changes

Along with algosdk v3 support, v4 includes improvements to network configuration. The new approach is more flexible and allows configuring custom AVM-compatible networks without modifying the library’s codebase.

​
Single network configuration

If your application uses a single public Algorand network (MainNet, TestNet, BetaNet), migrate from: 
const manager = new WalletManager({
  wallets: [...],
  network: NetworkId.TESTNET,
  algod: {
    token: '<YOUR_TOKEN>',
    baseServer: '<YOUR_SERVER_URL>',
    port: '<YOUR_PORT>'
  }
})

​
Multiple network configuration

If your application supports multiple networks, migrate from: 
const manager = new WalletManager({
  wallets: [...],
  network: NetworkId.TESTNET,
  algod: {
    [NetworkId.TESTNET]: {
      token: '<YOUR_TOKEN>',
      baseServer: '<YOUR_SERVER_URL>',
      port: '<YOUR_PORT>'
    },
    [NetworkId.MAINNET]: {
      token: '<YOUR_TOKEN>',
      baseServer: '<YOUR_SERVER_URL>',
      port: '<YOUR_PORT>'
    }
  }
})

​
Custom networks

For other AVM networks (like Voi), you can use the NetworkConfigBuilder and its addNetwork method: 
const networks = new NetworkConfigBuilder()
  .addNetwork('voi-mainnet', {
    algod: {
      token: '',
      baseServer: 'https://mainnet-api.voi.nodely.dev',
      port: ''
    },
    isTestnet: false,
    genesisHash: 'r20fSQI8gWe/kFZziNonSPCXLwcQmH/nxROvnnueWOk=',
    genesisId: 'voimain-v1.0',
    caipChainId: 'algorand:r20fSQI8gWe_kFZziNonSPCXLwcQmH_n'
  })
  .build()

const manager = new WalletManager({
  wallets: [...],
  networks,
  defaultNetwork: 'voi-mainnet'
})
See the Configuration guide for more details about network configuration options.

​
Framework adapter changes

Network-related functionality has been moved from useWallet to a dedicated useNetwork hook: 
// Network-related returns were part of useWallet
const {
  activeNetwork,
  setActiveNetwork
} = useWallet()
If your project supports network switching, you’ll need to update your imports and split the network functionality between hooks: 
// Before - all functionality from useWallet
import { useWallet } from '@txnlab/use-wallet-react'
const { activeNetwork, setActiveNetwork, /* other wallet returns */ } = useWallet()

// After - network returns moved to useNetwork
import { useWallet, useNetwork } from '@txnlab/use-wallet-react'
const { /* wallet returns */ } = useWallet()
const { activeNetwork, setActiveNetwork } = useNetwork()

​
Next steps

After completing the migration:

Test your application

Test all wallet connections, transactions, and network switching functionality.

Review algosdk changes

Check the algosdk v3 migration guide for SDK-specific changes.

Configuration guide

Explore the enhanced network configuration options.

Switching networks

Learn about the new network switching capabilities.

Build docs developers (and LLMs) love

Get started for freeTalk to us