> For the complete documentation index, see [llms.txt](https://docs.ama.one/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ama.one/wallet/creating-a-wallet/web-wallet.md).

# Web Wallet

### 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. Navigate to [https://wallet.ama.one](https://wallet.ama.one/)
3. You'll see the wallet welcome screen with two options:
   * "Create New Wallet"
   * "Import Existing Wallet"

![](/files/iadEqzTp00YvUFZsWkBB)

#### 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

![](/files/sM62BHeAohY5mkenfkib)

#### 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

![](/files/XBvJyc8VaqyHqFLaVsRV)

#### 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

![](/files/aKWNEVO2CpyNwEFmcVF9)

**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)

![](/files/s6pvBBwYHsGwfL2V6J9X)

#### 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

![](/files/ED85ZBHkFua2L5s7vPDs)

**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

![](/files/OypQ3BsKaHDe9E3Qe2tK)

**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

![](/files/p4ZWTlD5hRI0ZKhskuEt)

### 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](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. Visit [https://wallet.ama.one](https://wallet.ama.one/)
2. Click the three-dot menu in the browser
3. Select "More tools" → "Create shortcut"
4. Check "Open as window" for an app-like experience
5. Click "Create"

**For Firefox:**

1. Visit [https://wallet.ama.one](https://wallet.ama.one/)
2. Resize the browser window to your preference
3. Drag the tab to your desktop
4. A shortcut will be created

### Generating a New Wallet

#### Quick Generation Guide

For users who want to quickly generate a new wallet:

1. **Visit**: [https://wallet.ama.one](https://wallet.ama.one/)
2. **Click**: "Create New Wallet"
3. **Enter**: A wallet name
4. **Copy**: Your generated seed (CRITICAL - save this!)
5. **Create**: A strong vault password
6. **Download**: Your vault file
7. **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](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

![](/files/CblpYrAbNpzXbUF30fGS)![](/files/hLLFJAEcZFzRw7osTuSo)

**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

![](/files/WVykqu1bi6mAEjI2kIcW)

**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

![](/files/oUEgr8pXZ47YqwPmOMdj)

**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

![](/files/D4dN4MKIoWqJlTUAfsC9)

#### 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**:

   ```bash
   cd ~/.cache/amadeus/
   ```
3. **Display your private key**:

   ```bash
   more sk
   ```
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. **Go to** [https://wallet.ama.one](https://wallet.ama.one/)
2. **Click** "Create New Wallet"
3. **Enter** a wallet name (e.g., "Mining Wallet")
4. **Check** the "Import existing seed" checkbox
5. **Paste** the private key from the `sk` file
6. **Continue** with vault creation as described in previous sections

<pre class="language-bash"><code class="lang-bash"><strong>cd ~/.cache/amadeus/
</strong>ls -ltr
total 8
-rw-rw-r-- 1 amadeus amadeus   88 Jun  5 00:16 sk
drwxr-xr-x 3 amadeus amadeus 4096 Jun 23 17:01 db

more sk
&#x3C;your secret key will be displayed>

</code></pre>

#### 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

```bash
# Create a secure backup
cp ~/.cache/amadeus/sk ~/mining_wallet_backup_$(date +%Y%m%d).txt

# Set appropriate permissions
chmod 600 ~/mining_wallet_backup_*.txt
```

#### 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**

* **Bookmark** [https://wallet.ama.one](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**

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

***