# Examples & Use Cases
Real-world examples and prompts for using Hyperion MCP Server.
## Wallet Management Examples
### Example 1: Create and Fund a Wallet
**Goal:** Set up a new wallet and check its balance
**Prompt:**
```
1. Create a new wallet named "trading-wallet"
2. Show me the wallet address and mnemonic
3. Once I fund it with testnet tokens, check my balance
```
**Expected Flow:**
1. Wallet created with address and mnemonic
2. User funds wallet via faucet
3. Balance shows the received tMETIS
### Example 2: Import Existing Wallet
**Goal:** Import a wallet from another source
**Prompt:**
```
I have a private key: abc123def456...xyz789
Please import it as "imported-wallet" and show me the address
```
**Expected Response:**
```
Wallet imported successfully!
Address: 0x1234567890123456789012345678901234567890
```
### Example 3: Multi-Wallet Management
**Goal:** Manage multiple wallets for different purposes
**Prompt:**
```
1. Create three wallets: "main-wallet", "trading-wallet", "nft-wallet"
2. List all wallets
3. Set "trading-wallet" as the current active wallet
4. Show me the current wallet details
```
## Transaction Examples
### Example 4: Send Tokens to Multiple Recipients
**Goal:** Distribute tokens to several addresses
**Prompt:**
```
I want to send 0.5 tMETIS to each of these addresses:
- 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb
- 0x9876543210987654321098765432109876543210
Please:
1. Estimate gas for each transaction
2. Send the tokens
3. Show me the transaction hashes
```
### Example 5: Monitor Transaction Status
**Goal:** Track a transaction and verify completion
**Prompt:**
```
I sent a transaction with hash 0xabc123...def456
Please:
1. Get the transaction details
2. Check if it's confirmed
3. Show me the explorer link
```
### Example 6: Query Block Information
**Goal:** Get blockchain data
**Prompt:**
```
1. Show me the latest block information
2. Get details for block 1234567
3. Tell me the current gas price
```
## Token Deployment Examples
### Example 7: Deploy a Simple ERC20 Token
**Goal:** Create a basic token for testing
**Prompt:**
```
Deploy an ERC20 token with these specifications:
- Name: TestToken
- Symbol: TEST
- Initial Supply: 1000000
- Decimals: 18
- Not mintable
Show me the contract address and explorer link.
```
**Expected Response:**
```
ERC20 Token Deployed Successfully!
Contract Address: 0xabc123...def456
Transaction Hash: 0xtx789...hash012
Token Name: TestToken
Token Symbol: TEST
Initial Supply: 1,000,000 TEST
Gas Used: 850,000
Contract Explorer: https://hyperion-testnet.metisdevops.link/address/0xabc123...def456
```
### Example 8: Deploy a Mintable Token
**Goal:** Create a token that can be minted later
**Prompt:**
```
Deploy a mintable ERC20 token:
- Name: GrowToken
- Symbol: GROW
- Initial Supply: 500000
- Decimals: 18
I want to be able to mint more tokens later.
```
### Example 9: Mint Additional Tokens
**Goal:** Add more tokens to circulation
**Prompt:**
```
For my GrowToken contract at 0xabc123...def456:
1. Mint 100000 additional tokens
2. Send them to 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb
3. Show me the transaction details
```
### Example 10: Query Token Information
**Goal:** Get comprehensive token details
**Prompt:**
```
Get all information about the token at 0xabc123...def456:
- Name and symbol
- Total supply
- Decimals
- Owner address
- Contract explorer link
```
## NFT Examples
### Example 11: Deploy an NFT Collection
**Goal:** Create a new NFT collection
**Prompt:**
```
Deploy an ERC721 NFT collection:
- Name: CoolArtNFTs
- Symbol: COOL
- Mintable: Yes
I want to be able to mint NFTs later.
```
### Example 12: Mint NFTs
**Goal:** Create individual NFTs in the collection
**Prompt:**
```
For my CoolArtNFTs collection at 0xnft123...abc456:
1. Mint NFT #1 to 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb
URI: ipfs://QmX1234567890abcdefghijklmnopqrst
2. Mint NFT #2 to 0x9876543210987654321098765432109876543210
URI: ipfs://QmY0987654321zyxwvutsrqponmlkjihg
Show me both transaction hashes.
```
### Example 13: Query NFT Collection
**Goal:** Get NFT collection information
**Prompt:**
```
Get information about the NFT collection at 0xnft123...abc456:
- Collection name and symbol
- Owner address
- Total NFTs minted
- Explorer link
```
## Advanced Scenarios
### Example 14: Complete DApp Setup
**Goal:** Set up a complete token ecosystem
**Prompt:**
```
Help me set up a complete token ecosystem:
1. Create a wallet named "dapp-admin"
2. Deploy an ERC20 token:
- Name: DAppToken
- Symbol: DAPP
- Supply: 10000000
- Mintable: true
3. Deploy an ERC721 collection:
- Name: DAppNFTs
- Symbol: DNFT
- Mintable: true
4. Mint 100 DAppTokens to 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb
5. Mint NFT #1 to the same address
Show me all contract addresses and transaction hashes.
```
### Example 15: Gas Optimization Analysis
**Goal:** Analyze and optimize gas costs
**Prompt:**
```
I need to send 1000 tokens to 10 different addresses.
1. Estimate the gas cost for sending to one address
2. Calculate total gas for all 10 transfers
3. Suggest ways to optimize gas usage
4. Execute the transfers
```
### Example 16: Token Distribution Campaign
**Goal:** Distribute tokens to multiple recipients
**Prompt:**
```
I have a list of 5 addresses that should receive 100 tokens each:
- 0x1111111111111111111111111111111111111111
- 0x2222222222222222222222222222222222222222
- 0x3333333333333333333333333333333333333333
- 0x4444444444444444444444444444444444444444
- 0x5555555555555555555555555555555555555555
Please:
1. Check my balance
2. Estimate total gas needed
3. Send 100 tokens to each address
4. Provide a summary with all transaction hashes
```
## Debugging Examples
### Example 17: Troubleshoot Failed Transaction
**Goal:** Understand why a transaction failed
**Prompt:**
```
My transaction 0xfailed123...hash456 failed. Can you:
1. Get the transaction details
2. Check the gas used vs gas limit
3. Explain what went wrong
4. Suggest how to fix it
```
### Example 18: Verify Token Deployment
**Goal:** Confirm a token was deployed correctly
**Prompt:**
```
I deployed a token at 0xtoken123...abc456. Please verify:
1. Get the token information
2. Check the total supply matches my deployment
3. Verify the owner is my wallet
4. Confirm it's on the correct network
```
## Tips for Effective Prompts
1. **Be Specific**
- Include exact addresses and amounts
- Specify wallet names clearly
- Provide all required parameters
2. **Break Down Complex Tasks**
- Separate multi-step operations
- Verify each step before proceeding
- Ask for confirmation before large transactions
3. **Include Context**
- Explain what you're trying to achieve
- Provide relevant background information
- Ask for suggestions if unsure
4. **Verify Results**
- Always check transaction hashes
- Verify amounts and addresses
- Use explorer links to confirm
---
**Next**: Check [Troubleshooting](./troubleshooting.md) for common issues →
