Skip to main content
use-wallet provides two ways to switch between Algorand networks:
  • Setting the default network at startup
  • Switching networks at runtime using the useNetwork hook/composable/primitive

​
Default network

When initializing the WalletManager, you can specify which network to use as the default: 
import { WalletManager, NetworkId } from '@txnlab/use-wallet'

const manager = new WalletManager({
  defaultNetwork: NetworkId.TESTNET
})
You can also control whether the manager should reset to the default network on page load using the resetNetwork option: 
const manager = new WalletManager({
  defaultNetwork: NetworkId.TESTNET,
  options: {
    // Always start on TestNet, even if the user was previously on a different network
    resetNetwork: true
  }
})
When resetNetwork is false (the default), use-wallet will attempt to restore the last active network from local storage.

​
Runtime network switching

The useNetwork hook/composable provides methods for switching networks at runtime. 
import { useNetwork } from '@txnlab/use-wallet-react'

function NetworkSwitch() {
  const {
    activeNetwork,
    setActiveNetwork,
    networkConfig
  } = useNetwork()

  return (
    <select
      value={activeNetwork}
      onChange={(e) => setActiveNetwork(e.target.value)}
    >
      {Object.entries(networkConfig).map(([id, network]) => (
        <option key={id} value={id}>
          {id}
        </option>
      ))}
    </select>
  )
}

​
Network status

You can use the activeNetworkConfig to access information about the current network: 
const { activeNetworkConfig } = useNetwork()

// Check if we're on a test network
const isTestnet = activeNetworkConfig.isTestnet

// Get genesis ID
const genesisId = activeNetworkConfig.genesisId

​
Network events

When switching networks, several things happen automatically:
  1. The algodClient is updated to point to the new network
  2. Active wallet sessions are maintained (if the wallet supports the new network)
  3. The active network is saved to local storage

​
Wallet compatibility

Not all wallets support all networks. For example:
  • Exodus only works on MainNet
  • Defly and Pera only support MainNet and TestNet
  • The Mnemonic wallet only works on test networks
  • Custom networks may not be supported by all wallets
Please refer to each wallet’s documentation to determine which networks they support.

​
Default networks

use-wallet supports any AVM-compatible network and comes with default configurations for these Algorand networks:
  • MainNet
  • TestNet
  • BetaNet
  • LocalNet (for development)
For details about configuring networks, including how to customize default networks and add custom networks, see the Configuration guide.

Build docs developers (and LLMs) love

Get started for freeTalk to us