# Wallet Management
Learn how to create, import, and manage wallets with Hyperion MCP Server.
## Overview
The Hyperion MCP Server provides comprehensive wallet management capabilities, allowing you to:
- Create new wallets with secure mnemonic phrases
- Import existing wallets using private keys or mnemonics
- Manage multiple wallets simultaneously
- Switch between wallets easily
- Query wallet information and balances
## Creating Wallets
### Create a New Wallet
**Tool**: `create_wallet`
Creates a new Ethereum-compatible wallet with a randomly generated mnemonic phrase.
**Parameters**:
- `name` (string, required): A friendly name for your wallet
**Example**:
```
Create a new wallet named "main-wallet"
```
**Response**:
```
Wallet created successfully!
Address: 0x1234567890123456789012345678901234567890
Mnemonic: word1 word2 word3 word4 word5 word6 word7 word8 word9 word10 word11 word12
⚠️ IMPORTANT: Save your mnemonic phrase securely. It's the only way to recover your wallet!
```
**Best Practices**:
- Use descriptive names (e.g., "trading-wallet", "nft-wallet")
- Store mnemonic phrases in a secure password manager
- Never share your mnemonic with anyone
- Consider writing it down and storing in a safe place
## Importing Wallets
### Import via Private Key
**Tool**: `import_wallet`
Import an existing wallet using its private key.
**Parameters**:
- `privateKey` (string, required): 64-character hex private key (without 0x prefix)
- `name` (string, optional): Friendly name for the wallet
**Example**:
```
Import wallet with private key abc123def456... and name it "imported-wallet"
```
**Response**:
```
Wallet imported successfully!
Address: 0x9876543210987654321098765432109876543210
```
### Import via Mnemonic
**Tool**: `import_wallet`
Import an existing wallet using its mnemonic phrase.
**Parameters**:
- `mnemonic` (string, required): 12 or 24-word mnemonic phrase
- `name` (string, optional): Friendly name for the wallet
**Example**:
```
Import wallet with mnemonic "word1 word2 word3..." and name it "recovery-wallet"
```
## Managing Multiple Wallets
### List All Wallets
**Tool**: `list_wallets`
View all wallets stored in the MCP server.
**Example**:
```
List all my wallets
```
**Response**:
```
Available Wallets:
1. main-wallet
Address: 0x1234...7890
Status: Active
2. trading-wallet
Address: 0x9876...4321
Status: Inactive
3. nft-wallet
Address: 0xabcd...ef01
Status: Inactive
Total: 3 wallets
Current Active: main-wallet
```
### Set Current Wallet
**Tool**: `set_current_wallet`
Switch to a different wallet for transactions.
**Parameters**:
- `name` (string, required): Name of the wallet to activate
**Example**:
```
Set current wallet to "trading-wallet"
```
**Response**:
```
Current wallet set to: trading-wallet
Address: 0x9876543210987654321098765432109876543210
```
### Get Current Wallet
**Tool**: `get_current_wallet`
Display information about the currently active wallet.
**Example**:
```
Show me the current wallet
```
**Response**:
```
Current Active Wallet:
Name: trading-wallet
Address: 0x9876543210987654321098765432109876543210
Balance: 10.5 tMETIS
```
## Checking Balances
### Get Native Balance
**Tool**: `get_native_balance`
Check tMETIS (native token) balance for any address.
**Parameters**:
- `address` (string, optional): Wallet address (uses current wallet if not specified)
**Example**:
```
Check my tMETIS balance
```
**Response**:
```
Native Balance (tMETIS):
Address: 0x1234567890123456789012345678901234567890
Balance: 10.5 tMETIS
Network: Hyperion Testnet (Chain ID: 133717)
```
### Get Token Balance
**Tool**: `get_balance`
Check balance for ERC20 tokens or native tokens.
**Parameters**:
- `address` (string, optional): Wallet address
- `tokenAddress` (string, optional): ERC20 token contract address
**Example**:
```
Check balance of token 0xabc...def for my wallet
```
## Security Best Practices
### Protecting Your Wallets
1. **Never Share Private Keys or Mnemonics**
- Private keys and mnemonics provide full access to your wallet
- Anyone with these can steal your funds
2. **Use Strong Wallet Names**
- Avoid using sensitive information in wallet names
- Names are stored locally and visible in listings
3. **Backup Your Mnemonics**
- Write down mnemonics on paper
- Store in multiple secure locations
- Consider using a hardware wallet for large amounts
4. **Test with Small Amounts First**
- Always test with small amounts before large transactions
- Verify addresses carefully before sending
5. **Keep Software Updated**
- Regularly update the MCP server
- Stay informed about security patches
### Environment Security
- Store wallets on encrypted drives
- Use secure operating systems
- Enable firewall protection
- Avoid using wallets on public computers
## Advanced Topics
### Wallet Storage
Wallets are stored locally in encrypted format at:
```
~/.hyperion-mcp/wallets/
```
### Derivation Paths
The server uses standard Ethereum derivation paths:
```
m/44'/60'/0'/0/0
```
This ensures compatibility with other Ethereum wallets like MetaMask.
---
**Next**: Learn about [Blockchain Operations](./blockchain-operations.md) →
