Creating a Wallet

How to create a wallet

Why You Need a Wallet

The Amadeus Wallet is your gateway to the Amadeus ecosystem. It serves as a secure digital vault that enables you to:

  • Store and manage AMA tokens: Safely hold your AMA tokens and other supported cryptocurrencies

  • Send and receive transactions: Transfer tokens to other users or receive payments

  • Connect to mining operations: Link your wallet to mining software to receive mining rewards

  • Interact with the Amadeus blockchain: Participate in the decentralized network

  • Track your portfolio: Monitor your balance and transaction history in real-time

Without a wallet, you cannot:

  • Receive mining rewards

  • Participate in the Amadeus economy

  • Store or transfer AMA tokens

  • Access decentralized applications (dApps) on the Amadeus network

Supported Wallets

Currently, the Amadeus ecosystem supports:

Official Amadeus Web Wallet

  • Type: Browser-based web wallet

  • Platforms: Works on all modern browsers (Chrome, Firefox, Safari, Edge)

  • Features:

    • No installation required

    • Cross-platform compatibility

    • Secure vault file system

    • Built-in transaction history

    • Real-time balance updates

    • Multiple token support

Planned Support (Coming Soon)

  • Amadeus Mobile Wallet: iOS and Android applications

  • Plugin wallet: Own Chrome based plugin wallet

  • Hardware Wallet Integration: Support for hardware wallets

  • Third-party Wallet Support: Integration with popular multi-chain wallets

Creating a Wallet (Step-by-Step Guide)

Creating an Amadeus wallet is a straightforward process that takes just a few minutes. Follow these steps carefully to ensure your wallet is set up securely.

Prerequisites

  • Modern web browser (Chrome, Firefox, Safari, or Edge)

  • Secure location to store your vault file

  • Strong password that you can remember

Step 1: Access the Wallet Application

  1. Open your web browser

  2. You'll see the wallet welcome screen with two options:

    • "Create New Wallet"

    • "Import Existing Wallet"

Step 2: Begin Wallet Creation

  1. Click the "Create New Wallet" button

  2. You'll be taken to the wallet creation wizard, which consists of three main steps:

    • Enter Wallet Name

    • Configure Seed

    • Create Vault

Step 3: Enter Wallet Name

  1. Wallet Name: Enter a memorable name for your wallet

    • This is for your reference only and helps identify your wallet

    • Examples: "Main Wallet", "Mining Wallet", "Personal Wallet"

    • Maximum 50 characters allowed

    • Can contain letters, numbers, spaces, and special characters

  2. Click "Continue" to proceed

Step 4: Configure Your Seed

This is the most critical step in wallet creation. Your seed is your private key that controls access to your funds.

Understanding Seeds

  • Seed64: A 64-byte (512-bit) cryptographic seed

  • Format: Base58-encoded string (typically 87-88 characters)

  • Purpose: Used to derive your wallet's public and private keys

  • Security: This is your wallet's master key - never share it!

Automatic Seed Generation (Recommended)

  1. By default, the wallet will automatically generate a secure random seed

  2. Your generated seed will appear in the "Generated Seed" field

  3. Important: Copy this seed immediately and store it securely

  4. Click the copy button next to the seed field to copy it to your clipboard

  5. The refresh button allows you to generate a new seed if desired

Using a Custom Seed (Advanced)

  1. Toggle the "Import existing seed" checkbox

  2. Paste your existing Seed64 into the field

  3. The wallet will automatically derive and display your public key

  4. This option is for:

    • Recovering an existing wallet

    • Importing a wallet from another device

    • Advanced users who generate seeds externally

Security Best Practices for Seeds

  • Never share your seed with anyone

  • Store multiple copies in secure locations

  • Consider using:

    • Password manager

    • Encrypted USB drive

    • Paper backup in a safe

    • Safety deposit box

  • Never store in:

    • Email

    • Cloud storage (unless encrypted)

    • Screenshots

    • Unencrypted text files

Step 5: Review Your Public Key

  1. After seed configuration, your public key is automatically displayed

  2. The public key is derived from your seed using BLS12-381 cryptography

  3. This is your wallet address that others will use to send you tokens

  4. Format: Base58-encoded string (typically 96 characters)

Step 6: Create Your Vault

The vault is an encrypted file that stores your wallet information securely.

Setting Your Vault Password

  1. Enter a strong password for your vault

    • Minimum 8 characters

    • Must include:

      • Uppercase letter (A-Z)

      • Lowercase letter (a-z)

      • Number (0-9)

      • Special character (!@#$%^&*, etc.)

    • Example: "MySecure#Wallet2024!"

  2. Confirm your password by entering it again

Understanding the Vault System

  • Encryption: Uses AES-256-GCM encryption

  • Key Derivation: PBKDF2 with 100,000 iterations

  • Salt: Unique salt generated for each vault

  • Security: Your seed is never stored in plain text

Step 7: Download Your Vault File

  1. Click "Create and Download Vault"

  2. Your browser will automatically download a JSON file

  3. Default filename: [WalletName]_vault.json

  4. Critical: Save this file in a secure location

Vault File Contents

The vault file contains:

  • Encrypted wallet data

  • Wallet name

  • Salt and initialization vector (IV)

  • Creation timestamp

  • NO plain text sensitive information

Step 8: Wallet Creation Success

  1. You'll see a success screen confirming your wallet creation

  2. Your wallet details are displayed:

    • Wallet name

    • Public key (address)

  3. Click "Go to Dashboard" to access your wallet

Download and Install

Since the Amadeus Wallet is a web-based application, there's no traditional installation process. However, you can enhance your experience:

Accessing the Web Wallet

  1. Direct Access: Visit https://wallet.ama.one

  2. Bookmark: Add to your browser bookmarks for quick access

  3. Mobile: Access from any mobile browser

Creating a Desktop Shortcut (Optional)

For Chrome/Edge:

  1. Click the three-dot menu in the browser

  2. Select "More tools" → "Create shortcut"

  3. Check "Open as window" for an app-like experience

  4. Click "Create"

For Firefox:

  1. Resize the browser window to your preference

  2. Drag the tab to your desktop

  3. A shortcut will be created

Generating a New Wallet

Quick Generation Guide

For users who want to quickly generate a new wallet:

  1. Click: "Create New Wallet"

  2. Enter: A wallet name

  3. Copy: Your generated seed (CRITICAL - save this!)

  4. Create: A strong vault password

  5. Download: Your vault file

  6. Done: Access your dashboard

Advanced Generation Options

Using External Seed Generators

Advanced users may generate seeds using:

  • Hardware random number generators

  • Cryptographic libraries

  • Offline seed generation tools

Requirements for external seeds:

  • Must be exactly 64 bytes (512 bits)

  • Should use cryptographically secure randomness

Receiving and Sending AMA Tokens

Receiving Tokens

Receiving AMA tokens is simple and secure:

Step 1: Access Your Wallet Address

  1. Log into your wallet at https://wallet.ama.one

  2. Navigate to the Dashboard

  3. Your public key (wallet address) is displayed prominently

  4. Click the copy button next to your address

Step 2: Share Your Address

Share your public key with the sender through:

  • Secure messaging

  • Email (address only, never seeds!)

  • QR code (coming soon)

  • In-person

Step 3: Confirm Receipt

  1. Transactions typically confirm within seconds

  2. Your balance updates automatically

  3. View transaction details in the "Transactions" tab

Sending Tokens

Sending AMA tokens requires an unlocked wallet:

Step 1: Unlock Your Wallet

  1. If your session has expired, click "Unlock Wallet"

  2. Enter your vault password

  3. Your wallet unlocks for 30 minutes by default

Step 2: Navigate to Send

  1. Click the "Send" button on the dashboard

  2. Or navigate to Wallet → Send from the menu

Step 3: Enter Transaction Details

  1. Recipient Address:

    • Paste the recipient's Amadeus public key

    • Must be a valid Base58 address (48 bytes decoded)

    • Double-check the address - transactions are irreversible!

  2. Amount:

    • Enter the amount to send

    • Can use percentage buttons (25%, 50%, 75%, 100%)

    • Displays available balance

    • Supports decimal amounts

  3. Token Selection:

    • Choose which token to send (default: AMA)

    • Shows balance for selected token

    • Additional tokens supported as ecosystem grows

Step 4: Confirm and Send

  1. Review transaction details carefully:

    • Recipient address (verify first/last characters)

    • Amount and token type

    • Current balance

  2. Click "Send Tokens"

  3. Transaction is signed locally with your private key

  4. Submitted to the Amadeus network

Step 5: Transaction Confirmation

  1. Success screen shows:

    • Transaction ID (hash)

    • Confirmation status

    • Option to send another transaction

  2. Transaction typically confirms in:

    • 1-3 seconds for standard transactions

    • Up to 10 seconds during high network activity

Transaction Fees

TBD: Fee structure may be implemented in future network upgrades

Connecting Your Wallet to Mining

To receive mining rewards, you need to import the mining wallet that was automatically created when you started mining.

Prerequisites

  • Amadeus mining software already installed and configured

  • Access to your home directory where mining keys are stored

  • The wallet creation steps completed from previous sections

Important: Mining Creates Its Own Wallet

When you first run the Amadeus miner, it automatically generates a private key and stores it in your system. To access your mining rewards, you must import this key into your web wallet.

Step-by-Step: Import Your Mining Wallet

Step 1: Locate Your Mining Private Key

  1. Open a terminal on your mining machine

  2. Navigate to the Amadeus cache directory:

  3. Display your private key:

  4. Copy the displayed key - this is your mining wallet's private key (Seed64)

[Placeholder: Screenshot of terminal showing sk file location]

Step 2: Import to Web Wallet

  1. Click "Create New Wallet"

  2. Enter a wallet name (e.g., "Mining Wallet")

  3. Check the "Import existing seed" checkbox

  4. Paste the private key from the sk file

  5. Continue with vault creation as described in previous sections

Security Considerations

⚠️ Critical Security Notes:

  • The sk file contains your mining wallet's private key

  • Back up this file immediately to prevent loss of mining rewards

  • Never share the contents of this file

  • Store securely using the same practices as your main wallet seed

Backing Up Your Mining Key

Verifying Your Mining Wallet

  1. After importing, check your wallet dashboard

  2. Your balance will show accumulated mining rewards

  3. Transaction history will display all mining payouts

  4. Public key shown in wallet matches your miner's address

Alternative: Using Multiple Wallets

You can also:

  1. Keep mining wallet separate for security

  2. Transfer funds periodically to your main wallet

  3. Use mining wallet exclusively for mining operations

Troubleshooting

Cannot Find sk File

  • Ensure miner has run at least once

  • Check correct path: ~/.cache/amadeus/

  • Verify permissions to access the directory

Import Fails

  • Confirm the key is exactly as shown in the file

  • No extra spaces or line breaks

  • Must be valid Base58 format

No Mining Rewards Showing

  • Mining rewards appear after blocks are mined

  • Check the mining documentation for payout schedules

  • Ensure miner is properly configured and running

Next Steps

After successfully importing your mining wallet:

  1. Monitor your mining rewards on the dashboard

  2. Set up regular backups of your mining keys

  3. Consider transferring rewards to a main wallet periodically

  4. Review security practices for both wallets

Security Best Practices

Essential Security Measures

1. Seed Protection

  • Never share your seed with anyone

  • Never enter your seed on suspicious websites

  • Store offline in multiple secure locations

  • Use encryption for digital backups

  • Consider splitting seed across locations (advanced)

2. Vault File Security

  • Encrypt vault file before cloud storage

  • Use unique passwords for each vault

  • Store separately from seed backups

  • Regular backups to prevent loss

  • Version control for vault updates

3. Password Management

  • Use strong, unique passwords for vaults

  • Enable password manager integration

  • Never reuse passwords across services

  • Change passwords if compromise suspected

4. Device Security

  • Keep browsers updated

  • Use antivirus software

  • Avoid public WiFi for transactions

  • Clear cache after wallet sessions

  • Use dedicated device for large holdings

Operational Security (OpSec)

Public Information

Safe to share:

  • ✅ Your public key (wallet address)

  • ✅ Transaction IDs

  • ✅ General balance ranges (if comfortable)

Never share:

  • ❌ Your seed/private key

  • ❌ Vault passwords

  • ❌ Exact holdings

  • ❌ Personal identifying information

Phishing Protection

  • Verify URL before entering passwords

  • Check SSL certificate (padlock icon)

  • Ignore emails asking for seeds

  • Report phishing to community moderators

Physical Security

  • Secure workstation when away

  • Lock screens during breaks

  • Private location for wallet access

  • Shoulder surfing awareness

  • Clean desk policy for seed storage

Recovery Planning

Backup Strategy

  1. 3-2-1 Rule:

    • 3 copies of important data

    • 2 different storage media

    • 1 offsite backup

  2. Test Recovery:

    • Regularly verify backup integrity

    • Practice recovery procedures

    • Document recovery steps

    • Update backups after changes

Emergency Access

  • Trusted contacts for emergency (lawyer, family)

  • Clear instructions for recovery

  • Legal documentation for inheritance

  • Time-locked recovery options (planned feature)

FAQs (Wallet Section)

General Questions

Q: Is the Amadeus Wallet free to use? A: Yes, the Amadeus Wallet is completely free. There are no charges for creating wallets, storing tokens, or accessing features.

Q: Can I create multiple wallets? A: Yes, you can create as many wallets as needed. Each wallet requires its own seed and vault file.

Q: What browsers are supported? A: Modern versions of Chrome, Firefox, Safari, and Edge. Mobile browsers are also supported.

Security Questions

Q: Where is my private key stored? A: Your private key is encrypted within your vault file and only decrypted in-memory when you unlock your wallet. It's never sent to servers or stored in plain text.

Q: What happens if I lose my vault password? A: If you have your seed backed up, you can create a new wallet by importing your seed. Without the seed, funds cannot be recovered.

Q: Is my wallet data sent to Amadeus servers? A: No. The wallet operates client-side. Only public blockchain queries (balance, transactions) communicate with Amadeus nodes.

Q: Can Amadeus team access my wallet? A: No. The wallet is non-custodial. Only you have access to your seeds and private keys.

Technical Questions

Q: What cryptography does the wallet use? A:

  • Key Generation: BLS12-381 elliptic curve

  • Encryption: AES-256-GCM

  • Key Derivation: PBKDF2 with SHA-256

  • Hashing: BLAKE3 for transaction hashes

Q: What is the wallet session timeout? A: Default timeout is 30 minutes. The session extends with activity. After timeout, you'll need to re-enter your vault password.

Q: Can I adjust transaction fees? A: Currently, Amadeus has no transaction fees. This may change with future network updates.

Q: What's the difference between seed and private key? A: Your seed is 64 bytes and used to derive your private key (32 bytes) through cryptographic reduction. The seed is your master secret.

Troubleshooting

Q: My balance isn't updating A:

  1. Check your internet connection

  2. Refresh the page

  3. Click the refresh button on the balance card

  4. Verify the transaction was sent to the correct address

Q: I can't unlock my wallet A:

  1. Ensure you're using the correct vault file

  2. Verify your password (check caps lock)

  3. Try re-uploading the vault file

  4. Confirm the vault file isn't corrupted

Q: Transaction failed A:

  1. Check recipient address format

  2. Verify sufficient balance

  3. Ensure wallet is unlocked

  4. Try again after a few moments

  5. Check network status

Q: Can't connect wallet to mining A:

  1. Use your public key, not seed

  2. Remove any extra spaces in address

  3. Restart mining software after configuration

  4. Verify pool accepts Amadeus addresses

Future Features

Q: What features are planned? A: Upcoming features include:

  • Mobile applications (iOS/Android)

  • Hardware wallet support

  • Multi-signature wallets

  • QR code transactions

  • Advanced portfolio analytics

  • DeFi integrations

  • Plugin wallet


Last updated