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
Open your web browser
Navigate to https://wallet.ama.one
You'll see the wallet welcome screen with two options:
"Create New Wallet"
"Import Existing Wallet"

Step 2: Begin Wallet Creation
Click the "Create New Wallet" button
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
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
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)
By default, the wallet will automatically generate a secure random seed
Your generated seed will appear in the "Generated Seed" field
Important: Copy this seed immediately and store it securely
Click the copy button next to the seed field to copy it to your clipboard
The refresh button allows you to generate a new seed if desired

Using a Custom Seed (Advanced)
Toggle the "Import existing seed" checkbox
Paste your existing Seed64 into the field
The wallet will automatically derive and display your public key
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
After seed configuration, your public key is automatically displayed
The public key is derived from your seed using BLS12-381 cryptography
This is your wallet address that others will use to send you tokens
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
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!"
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
Click "Create and Download Vault"
Your browser will automatically download a JSON file
Default filename:
[WalletName]_vault.jsonCritical: 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
You'll see a success screen confirming your wallet creation
Your wallet details are displayed:
Wallet name
Public key (address)
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
Direct Access: Visit https://wallet.ama.one
Bookmark: Add to your browser bookmarks for quick access
Mobile: Access from any mobile browser
Creating a Desktop Shortcut (Optional)
For Chrome/Edge:
Visit https://wallet.ama.one
Click the three-dot menu in the browser
Select "More tools" → "Create shortcut"
Check "Open as window" for an app-like experience
Click "Create"
For Firefox:
Visit https://wallet.ama.one
Resize the browser window to your preference
Drag the tab to your desktop
A shortcut will be created
Generating a New Wallet
Quick Generation Guide
For users who want to quickly generate a new wallet:
Visit: https://wallet.ama.one
Click: "Create New Wallet"
Enter: A wallet name
Copy: Your generated seed (CRITICAL - save this!)
Create: A strong vault password
Download: Your vault file
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
Log into your wallet at https://wallet.ama.one
Navigate to the Dashboard
Your public key (wallet address) is displayed prominently
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
Transactions typically confirm within seconds
Your balance updates automatically
View transaction details in the "Transactions" tab
Sending Tokens
Sending AMA tokens requires an unlocked wallet:
Step 1: Unlock Your Wallet
If your session has expired, click "Unlock Wallet"
Enter your vault password
Your wallet unlocks for 30 minutes by default
Step 2: Navigate to Send
Click the "Send" button on the dashboard
Or navigate to Wallet → Send from the menu

Step 3: Enter Transaction Details
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!
Amount:
Enter the amount to send
Can use percentage buttons (25%, 50%, 75%, 100%)
Displays available balance
Supports decimal amounts
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
Review transaction details carefully:
Recipient address (verify first/last characters)
Amount and token type
Current balance
Click "Send Tokens"
Transaction is signed locally with your private key
Submitted to the Amadeus network
Step 5: Transaction Confirmation
Success screen shows:
Transaction ID (hash)
Confirmation status
Option to send another transaction
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
Open a terminal on your mining machine
Navigate to the Amadeus cache directory:
Display your private key:
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
Go to https://wallet.ama.one
Click "Create New Wallet"
Enter a wallet name (e.g., "Mining Wallet")
Check the "Import existing seed" checkbox
Paste the private key from the
skfileContinue with vault creation as described in previous sections
Security Considerations
⚠️ Critical Security Notes:
The
skfile contains your mining wallet's private keyBack 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
After importing, check your wallet dashboard
Your balance will show accumulated mining rewards
Transaction history will display all mining payouts
Public key shown in wallet matches your miner's address
Alternative: Using Multiple Wallets
You can also:
Keep mining wallet separate for security
Transfer funds periodically to your main wallet
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:
Monitor your mining rewards on the dashboard
Set up regular backups of your mining keys
Consider transferring rewards to a main wallet periodically
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
Bookmark https://wallet.ama.one
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
3-2-1 Rule:
3 copies of important data
2 different storage media
1 offsite backup
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:
Check your internet connection
Refresh the page
Click the refresh button on the balance card
Verify the transaction was sent to the correct address
Q: I can't unlock my wallet A:
Ensure you're using the correct vault file
Verify your password (check caps lock)
Try re-uploading the vault file
Confirm the vault file isn't corrupted
Q: Transaction failed A:
Check recipient address format
Verify sufficient balance
Ensure wallet is unlocked
Try again after a few moments
Check network status
Q: Can't connect wallet to mining A:
Use your public key, not seed
Remove any extra spaces in address
Restart mining software after configuration
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