avian-flightdeck

Frequently Asked Questions (FAQ)

General Wallet Questions

What is Avian FlightDeck Wallet?

Avian FlightDeck Wallet is a progressive web application (PWA) that provides a secure, privacy-focused wallet for the Avian blockchain. It runs entirely in your browser with no server dependencies for core wallet functions.

Is my wallet data secure?

Yes! Your private keys and sensitive data are encrypted using scrypt-based encryption and stored locally on your device. The wallet uses industry-standard cryptographic practices and never transmits your private keys to any server.

Can I use this wallet on mobile devices?

Absolutely! Avian FlightDeck Wallet is designed as a mobile-first PWA that works seamlessly across desktop, tablet, and mobile devices. You can even install it as an app on your phone.

Message Utilities

What are Message Utilities?

Message Utilities provide cryptographic tools for message signing, verification, encryption, and decryption. These tools allow you to prove ownership of addresses and communicate securely with other Avian users.

How do I sign a message?

  1. Navigate to the Message Utilities section
  2. Select the “Sign” tab
  3. Enter your wallet address and the message you want to sign
  4. Click “Sign Message” and enter your password if prompted
  5. Copy the generated signature to share with others

Use case: Proving you own a specific Avian address without revealing your private key.

How do I verify a signed message?

  1. Go to the “Verify” tab in Message Utilities
  2. Enter the signer’s Avian address
  3. Paste the original message (must be exact)
  4. Paste the signature
  5. Click “Verify Signature”

Bonus: When verification succeeds, the public key is automatically extracted and can be used for encryption!

How does message encryption work?

Message encryption uses ECDH (Elliptic Curve Diffie-Hellman) to create a shared secret between you and the recipient:

  1. To encrypt: Go to “Encrypt” tab, enter the recipient’s public key and your message
  2. To decrypt: Go to “Decrypt” tab, paste the encrypted message and enter your address

Important: You need the recipient’s public key to encrypt messages for them. The easiest way to get this is by verifying one of their signed messages first.

Can I use public keys from verified signatures for encryption?

Yes! This is one of the most powerful features:

  1. When you verify someone’s signature, their public key is automatically extracted
  2. Switch to the “Encrypt” tab and you’ll see buttons for all extracted public keys
  3. Click any address button to automatically use that public key for encryption

This creates a seamless workflow: verify → extract public key → encrypt messages.

Are my encrypted messages compatible with other wallets?

The message signing/verification is compatible with Avian Core wallet and other standard Bitcoin-based wallets. However, the encryption format is specific to this wallet implementation.

What’s the difference between signing and encrypting?

You can combine both: sign a message to prove authenticity, then encrypt it for privacy.

Wallet Management

Can I have multiple wallets?

Yes! Avian FlightDeck Wallet supports multiple wallets. You can:

How do I rename a wallet?

  1. Go to Wallet Settings → My Wallets
  2. Hover over any wallet name to see the edit icon (pencil)
  3. Click the edit icon to enable inline editing
  4. Type the new name and press Enter (or click the checkmark)
  5. Press Escape to cancel editing
  6. The new name will appear immediately in both the wallet list and sidebar

Can I view detailed transaction information?

Yes! The wallet provides comprehensive UTXO (Unspent Transaction Output) management:

  1. UTXO Overview: View all your unspent transaction outputs in a paginated table
  2. Sortable Columns: Sort by transaction ID, amount, confirmations, or status
  3. Search & Filter: Find specific transactions using the search bar
  4. Pagination: Navigate through large numbers of UTXOs efficiently
  5. Detailed Information: See transaction IDs, addresses, amounts, and confirmation status
  6. Dust Detection: Automatically identifies and highlights dust UTXOs

What are UTXOs and why should I care?

UTXOs (Unspent Transaction Outputs) are the “coins” in your wallet. Understanding them helps with:

How do I backup my wallet?

You can backup your wallet in several ways:

Always store backups securely and never share them with anyone.

Important: If your wallet uses a BIP39 passphrase (25th word), you need BOTH the mnemonic phrase AND the passphrase to restore your wallet. You can export the passphrase separately in the wallet settings under “Export Recovery Phrase”.

What if I forget my password?

Your password encrypts your private keys locally. If you forget it:

Can I import wallets from other applications?

Yes! You can import wallets using:

Address Book & Contacts

How do I manage contacts?

The Address Book feature allows you to:

Can I categorize my contacts?

Yes! You can assign categories to contacts:

How do QR codes work?

Transactions

How do I send AVN?

  1. Go to the Send section
  2. Enter or select the recipient address (use Address Book for saved contacts)
  3. Enter the amount to send
  4. Choose your fee rate and UTXO selection strategy
  5. For HD wallets, optionally select a specific change address
  6. Use “Subtract fee from amount” to deduct fees from the send amount rather than adding them
  7. Review and confirm the transaction

What is “Subtract fee from amount”?

This feature allows you to send an exact amount by deducting the transaction fee from the send amount rather than adding it on top:

What are UTXOs and coin selection strategies?

UTXOs (Unspent Transaction Outputs) are like digital coins in your wallet. You can choose how to select them:

For HD wallets, you can also:

How do I track transaction history?

Your transaction history is automatically synced and includes:

Privacy & Security

How does the wallet protect my privacy?

What security features are available?

Should I enable notifications?

Notifications are optional but recommended for:

All notifications work locally - no external services are used.

Troubleshooting

The wallet won’t connect to the network

  1. Check your internet connection
  2. Try refreshing the page
  3. The wallet will automatically retry connecting to Electrum servers
  4. If problems persist, try using a different network or browser

I’m getting “Non-base58 character” errors

This usually means:

Try re-importing your wallet with the correct mnemonic or private key.

My transaction is stuck or unconfirmed

The app is running slowly

Advanced Features

What is HD wallet derivation?

HD (Hierarchical Deterministic) wallets can generate multiple addresses from a single seed:

How do I configure HD wallet settings?

For HD wallets, you can customize several settings:

These settings affect both the Derived Addresses panel and transaction creation.

Can I use hardware wallets?

Currently, Avian FlightDeck Wallet operates as a software wallet. Hardware wallet integration may be added in future versions.

How do I export transaction history?

You can view your complete transaction history within the wallet. For external analysis, you can:

Getting Help

Where can I report bugs or request features?

Is there a community for support?

Yes! The Avian community is active and helpful:

How can I contribute to the project?

Contributions are welcome:

This FAQ covers the most common questions about Avian FlightDeck Wallet. For technical documentation, see the other docs in this folder. For the latest updates and changes, check RECENT_UPDATES.md.