Wallet

Introduction

The Hippius Desktop Wallet provides complete control over your hAlpha tokens with local wallet management. Unlike the web version, the desktop app stores encrypted wallet data locally on your device, providing enhanced security and offline access to your wallet addresses.

You can create new wallets, import existing ones via mnemonic phrases or backup files, send and receive tokens, view your balance and transaction history, and manage an address book — all secured with your personal password.

Getting Started

When you first launch Hippius Desktop, you'll be guided through wallet setup. You have three options:

• Enter an existing mnemonic to use a wallet you already have
• Create a new wallet with a fresh mnemonic phrase
• Import a wallet from a backup file

Creating a New Wallet

1. When you first open the wallet page, a unique 12-word mnemonic phrase is automatically generated and displayed on screen.
2. Write down this phrase and store it securely — this is the only way to recover your wallet if you lose access.
3. Click I've Saved My Mnemonic to continue.
4. Enter a name for your wallet (e.g., "Main Wallet").
5. Create a strong password to encrypt your wallet.
6. Confirm your password and click Create Wallet.

Important

Your mnemonic phrase is the master key to your wallet. Anyone with access to it can control your funds. Never share it, never store it digitally in plain text, and never enter it on websites or apps you don't trust.

Importing a Wallet with Mnemonic

If you have an existing mnemonic phrase from another wallet:

1. On the Welcome screen, click on Add Existing Wallet and enter your mnemonic phrase in the input field.
2. Click Next.
3. Enter the password you want to use for this wallet in Hippius Desktop.
4. Click Access Wallet.

Alternatively, you can click Import Wallet to import from a backup file:

1. Click Import Wallet on the Welcome screen.
2. Click Select Backup File and choose your .zip backup file.
3. Enter the password that was used when the backup was created.
4. Click Import Wallet.

How Transaction Signing Works

Hippius Desktop uses a secure password-based signing model:

• Your mnemonic phrase is encrypted with your password and stored locally
• When you perform any transaction (send, stake, unstake, bridge), you're prompted to enter your password
• The password temporarily decrypts your mnemonic to sign the transaction
• After signing, the decrypted mnemonic is immediately cleared from memory

This means you don't need to "unlock" your wallet upfront — your wallet is effectively locked at all times, and you authenticate each transaction individually.

tip

This design provides enhanced security: even if someone gains access to your device, they cannot make transactions without knowing your password.

Wallet Overview

The Wallet page displays three widget cards at a glance:

Widget	What It Shows
Native Balance	Your current hALPHA balance with Send and Receive buttons
Stake hAlpha	Your staked amount, locked balance, unbonding status, redeemable funds, and quick actions
Bridge Tokens	A shortcut to bridge tokens between Alpha and hAlpha

Below the widgets you'll find a Balance Overview chart and tabs for Transaction History and Address Book.

Managing Multiple Wallets

Hippius Desktop supports multiple local wallets. You can switch between them, add new ones, or remove wallets you no longer need.

Switching Wallets

1. Click the Active Wallet dropdown in the top-right corner of the Wallet page.
2. Your local wallets are listed with their names and truncated addresses.
3. Click Switch Wallet next to the wallet you want to use.

Your selection is remembered across sessions. When you make a transaction, you'll be prompted for the password of the currently active wallet.

Adding a New Wallet

You can add additional wallets at any time:

1. Click the Active Wallet dropdown.
2. Click Add Wallet.
3. Choose to create a new wallet or import an existing one.
4. Follow the same steps as initial wallet setup.

Wallet Settings

Access wallet management options through the Wallet Settings:

1. Click the Settings menu item or alernatively you can click on the Settings icon in wallet selection dialog.
2. Navigate to the Wallet Settings tab.

Wallet Table

The Wallet Settings tab displays a table of all your local wallets with:

Column	Description
Wallet	Name and truncated address (click to copy)
Date	When the wallet was added
Status	Active indicator
Actions	Three-dot menu with Edit, Export, and Delete options

Editing a Wallet Name

1. Click the three-dot menu (⋮) in the Actions column next to the wallet you want to edit.
2. Select Edit from the dropdown.
3. Enter a new name.
4. Click Save.

Exporting a Wallet Backup

Export your wallet as an encrypted backup file to restore it later or transfer to another device:

1. Click the three-dot menu (⋮) in the Actions column next to the wallet you want to export.
2. Select Export from the dropdown.
3. Choose where to save the .zip backup file.
4. The backup contains your encrypted wallet data — you'll need your original password to import it later.

note

The exported backup is encrypted with your wallet password. Keep both the backup file and your password safe.

Deleting a Wallet

1. Click the three-dot menu (⋮) in the Actions column next to the wallet you want to delete.
2. Select Delete from the dropdown.
3. Review the warning — this action cannot be undone unless you have a backup or your mnemonic phrase.
4. Click Confirm Delete.

warning

Deleting a wallet removes it from Hippius Desktop permanently. Make sure you have your mnemonic phrase saved or a backup file exported before deleting.

Sending Balance

You can send hAlpha to any wallet on the Hippius blockchain.

1. Open the Wallet page and ensure the correct wallet is active.
2. Click Send Balance.
3. Enter the recipient's wallet address, or select one from your Address Book.
4. Enter the amount to send. Click Max to send your full balance minus the transaction fee.
5. Click Send.
6. A confirmation dialog appears showing the transaction details (amount, recipient, wallet).
7. Enter your wallet password to decrypt your mnemonic and sign the transaction.
8. Click Confirm.

A loading notification will appear while the transaction is being processed. You'll receive a success notification with the block hash once it's confirmed.

note

The transaction fee is automatically deducted. If your balance is too low to cover the fee, you'll see an error before the dialog opens.

Receiving Balance

1. Open the Wallet page.
2. Click Receive Balance.
3. Scan the QR code with your phone, or click the copy button next to your deposit address.
4. Send tokens to this address from any Hippius-compatible wallet.

Balance Overview Chart

The Balance Overview chart tracks your balance over time. Use the time range selector to view:

• Last 7 Days (default)
• Last 30 Days
• Last 60 Days
• 1 Year
• MAX (all time)

Hover over the chart to see the exact balance at any point in time.

Transaction History

The Transaction History tab shows all your incoming and outgoing token transfers:

Column	Description
Block	The blockchain block number
Amount	The transfer amount in hALPHA
From	The sender's address (click to copy)
To	The recipient's address (click to copy)
Transaction Type	Sent or Received (relative to your active wallet)
Transaction Date	When the transaction was confirmed

You can sort by block number, amount, or date. Results are paginated at 10 per page.

tip

Switching your active wallet will update the transaction history to show transfers for the newly selected account.

Address Book

The Address Book lets you save wallet addresses you frequently send tokens to.

Adding a New Address

1. Navigate to the Address Book tab on the Wallet page.
2. Click New Address.
3. Enter a name and wallet address.
4. Click Save.

Editing or Deleting an Address

Click the action menu (three dots) on any address entry to Edit or Delete it.

Security Best Practices

1. Never share your mnemonic phrase — it provides full access to your wallet
2. Use a strong, unique password for each wallet
3. Export backups of important wallets and store them securely offline
4. Keep your mnemonic phrase written down in a secure physical location
5. Verify addresses before sending tokens — transactions cannot be reversed

Frequently Asked Questions

1. What happens if I forget my wallet password?

You can re-import your wallet using your mnemonic phrase and set a new password. Your funds are tied to the mnemonic, not the password.

2. Can I use the same wallet in multiple devices?

Yes, you can import the same wallet (via mnemonic or backup file) on multiple devices. Each device will have its own password.

3. Is my mnemonic stored securely?

Yes, your mnemonic is encrypted with your password and stored locally on your device. It is never sent to any server.

4. What is the difference between Send Balance and Bridge Tokens?

Send Balance transfers hAlpha to another address on the Hippius network. Bridge Tokens converts between Alpha (Bittensor) and hAlpha (Hippius) across networks.

5. Why do I need to enter my password for every transaction?

This is a security feature. Your mnemonic is encrypted at rest and only decrypted momentarily to sign transactions, then immediately cleared from memory.