Skip to main content

Wallet Address Modes

Wallet address modes define how your wallet generates and uses blockchain addresses to send and receive funds. Depending on the mode, your wallet can either operate with a single address for all transactions or manage multiple addresses for different purposes.

Understanding these modes is important because they directly impact:

  • Simplicity of use
  • Compatibility with decentralized applications (dApps)
  • Privacy and fund organization

This article explains how each mode works, when to use them, and the limitations when switching between modes.

Single Address Mode

Single Address Mode is the simplest way to use a wallet. In this mode, the wallet uses only one address (index 0) for all transactions, including sending and receiving both HTR and custom tokens.

Single Address Mode is recommended for:

  • New users getting started with the wallet
  • Everyday usage where simplicity is important
  • Maximum compatibility with existing tools and dApps

The main advantage of Single Address Mode is its simplicity and fewer compatibility issues. However, it brings a couple of limitations, including:

  • Privacy: Using a single address for all transactions can make it easier for others to track your activity on the blockchain.
  • Organization: It can be harder to manage and organize funds since all transactions are associated with the same address.
  • Security: If the single address is compromised, all funds in the wallet are at risk.
  • Separate Balances: You cannot have separate balances for different tokens or purposes, which can make it difficult to differentiate between funds and use cases effectively.

Multiple Address Mode

Multi Address Mode enables the wallet to generate and manage multiple addresses. Each address can be used independently, allowing for more flexibility in how funds are handled.

warning

Multi Address Mode is not compatible with all dApps, and some may require Single Address Mode to function properly.

Multi Address Mode is ideal for:

  • Users who prioritize privacy and want to reduce the traceability of their transactions
  • Users who want to use each address for a different purpose (e.g., one for receiving funds, another for sending, and others for specific tokens)

It's important to note that Multi Address Mode requires a stronger understanding of wallet and address management.

Switching Between Modes

Users can change their wallet address mode at any time through the wallet settings. However, there are important restrictions when switching from Multi Address Mode back to Single Address Mode.

  • Switching from Multi Address ModeSingle Address Mode is only allowed if:
    • No secondary address (any address other than the primary one) has ever been used.
  • A secondary address is considered “in use” if any of the following applies:
    • It currently holds any tokens (HTR or custom tokens)
    • It has any transaction history (sent or received), even if the balance is now zero

These limitations are in place to prevent potential loss of funds or confusion that could arise from switching modes after multiple addresses have been used. If you need to switch back to Single Address Mode, ensure that all secondary addresses are unused and have no transaction history.

warning

If any secondary address has been used, switching back to Single Address Mode will be blocked.

Choosing the Right Mode

When deciding which mode to use, consider your needs for privacy, organization, and compatibility with dApps.

Use CaseRecommended Mode
Simple, everyday usageSingle Address Mode
Maximum dApp compatibilitySingle Address Mode
Privacy-focused usageMulti Address Mode
Managing multiple fund purposesMulti Address Mode
Advanced wallet controlMulti Address Mode