Hyperliquid Recovery FAQ: Flagged Address Troubleshooting

This troubleshooting guide provides technical solutions for extracting assets from a flagged Hyperliquid address or restricted account.

🤖 Bot Basic Questions

Q: What is Hyperliquid Recovery Bot?

A: Hyperliquid Recovery Bot is a professional Telegram bot designed specifically for Hyperliquid ecosystem users to help users safely recover digital assets from addresses flagged as high-risk.

Q: Is the bot free to use?

A: Address detection is completely FREE. Asset recovery services charge:

  • Service Fee: 0.5% of total asset value (minimum 1 USDC)
  • Withdrawal Fees: 2 USDC (Hyperliquid platform)
  • Example: Recover $1,000 → Pay $7 → Get $993

Q: How to confirm this is the official bot?

A: Please ensure you access the bot using the official link:

Q: What languages does the bot support?

A: Currently supports:

  • Chinese: Complete Simplified Chinese support
  • English: Full English language support

Q: What are the bot's operating hours?

A: The bot runs continuously and can be used at any time. However, it is recommended to perform important operations when network conditions are good.

🔍 Address Detection Questions

Q: What address formats are supported?

A: Supports standard Hyperliquid address formats:

  • Length: 42 characters (including 0x prefix)
  • Format: 0x + 40 hexadecimal characters
  • Example: 0x1234567890123456789012345678901234567890

Q: How long does detection take?

A: Usually completed within a few seconds to a few minutes, depending on:

  • Network conditions
  • Hyperliquid API response speed
  • Number and complexity of assets in the address

Q: Is the detected asset information accurate?

A: Yes, the bot uses Hyperliquid official API to get real-time data, which is accurate and reliable. However, please note:

  • Price information may have 1-2 minutes delay
  • Some new tokens may temporarily have no price information
  • Network congestion may affect data updates

Q: Why do some assets not display prices?

A: Possible reasons:

  • Newly listed tokens have no price data yet
  • Low liquidity tokens
  • Price API temporarily unavailable
  • Token has been delisted or stopped trading

Q: Can multiple addresses be detected?

A: Each detection run currently processes one address. You can repeat detection for different addresses.

Q: How long is detection history saved?

A: This public guide does not treat detection history as a long-term record. Please use the current result page as your main reference.

🛠️ Asset Recovery Questions

Q: What asset types can be recovered?

A: The bot can recover 4 types of assets:

  • ✅ Spot Assets: USDC, ETH, BTC, and other tokens
  • ✅ Perpetual Contracts: Long/short positions
  • ✅ Vault Assets: Assets deposited in vaults (if not locked)
  • ✅ Staked Assets: HYPE tokens staked to validators (requires waiting period)

Q: When is asset recovery needed?

A: When your address is flagged as high-risk and:

  • The frontend can connect the address, but typically you are unable to perform Hyperliquid L1 native asset operations (like transfers, trades, or withdrawals).
  • The frontend may show a warning overlay with system responses such as:
Action blocked: Address flagged for suspicious activity. Your address has been flagged as high risk by a third-party screening tool. This frontend interface does not support connection to the Hyperliquid blockchain by high risk addresses.
  • A red warning overlay appears and operation buttons are disabled.
  • Cannot perform normal trading operations.
  • Assets may be restricted in frontend operations.

Q: How long does the recovery process take?

A: Spot and perpetual assets are usually recovered quickly. For staked assets, recovery usually takes 2-3 runs depending on current state:

  • Optimized path (2 runs): when undelegated balance already exists
  • Standard path (3 runs): when only delegated balance exists (typically 1 day + 7 days windows)

Q: Can the recovery process be cancelled?

A: Once confirmed to start recovery operation, it cannot be cancelled. Therefore, please carefully check all information before confirmation.

Q: Is the private key secure?

A: Follow these basic rules:

  • Enter credentials only in the bot's official recovery flow
  • Never send private keys or mnemonics to any person, group, form, or external website
  • Do not screenshot, forward, or paste credentials into chat windows
  • If you cannot confirm the bot entry is official, stop and verify first

Q: What if I have staked HYPE tokens?

A: The bot handles staking states automatically and tells you when to rerun:

  • It may complete in 2 runs if part of the balance is already ready for the next stage
  • Or require 3 runs if the balance must first pass through the full unstake waiting flow

Q: What if my vault assets are locked?

A: The bot will skip locked vault assets:

  • Wait for the lock period to end
  • Then run recovery again to withdraw them

Q: Can I specify withdrawal to a specific address?

A: No. Recovery does not require destination input. Funds are withdrawn to the Arbitrum address corresponding to the source address.

Q: What to do if recovery fails?

A: First check which task-level outcome appears on the result page:

  • failed: this run was interrupted by a fatal error; review the cause before retrying
  • partial: this run recovered some assets, but remaining assets still need attention
  • waiting_to_rerun: this run progressed correctly, but you must wait for protocol windows to end before the next run

If the final outcome is truly failed, the bot will automatically retry on network failures. If it continues to fail:

  1. Check your internet connection
  2. Verify private key is correct
  3. Check error message
  4. Contact support if needed

Q: How much does recovery cost?

A: Total cost = Service Fee + Withdrawal Fees

  • Service Fee: 0.5% of total asset value (minimum 1 USDC)
  • Withdrawal Fees: 2 USDC (Hyperliquid platform charges)

Examples: | Your Assets | Service Fee | Withdrawal Fees | Total Cost | You Receive | |-------------|-------------|-----------------|------------|-------------| | $100 | $1 | $2 | $3 | $97 | | $1,000 | $5 | $2 | $7 | $993 | | $10,000 | $50 | $2 | $52 | $9,948 |

Q: What does the service fee include?

A: Service fee includes:

  • All asset conversions (ETH, BTC, etc. → USDC)
  • All account transfers (Spot → Perpetual)
  • Recovery orchestration and execution service
  • Technical support

Note: Hyperliquid withdrawal fees are billed separately under Withdrawal Fees.

Q: When is the service fee charged?

A: Service fee is processed during the service-fee collection stage in the recovery pipeline. If execution does not reach fee collection, no service fee is charged.

Q: Why are there withdrawal fees?

A: Hyperliquid platform charges 1 USDC per withdrawal. The bot makes 2 withdrawals:

  1. First withdrawal: Collect service fee (1 USDC)
  2. Second withdrawal: Send your assets (1 USDC) Total: 2 USDC withdrawal fees

Q: How to ensure operation security?

A: Please follow these security recommendations:

  • Operate in secure devices and network environments
  • Do not enter private keys in public places
  • Carefully verify each operation step
  • If you use a shared device, log out and close related chats after use

Q: Will private keys be saved?

A: This user guide focuses on what you should do as a user: only enter credentials in the bot's official recovery flow, never provide them to any person or external page, and verify results with transaction hashes and on-chain records.

Q: How to prevent fraud?

A: Please note:

  • Only use the official bot @HyperliquidRecoveryBot
  • Do not enter private keys elsewhere
  • Outside the bot's official recovery flow, no support staff, private chat, or group will ask for your private key or mnemonic
  • Be wary of false promises and unreasonable profit guarantees

Q: What to do if suspicious activity is found?

A: If any suspicious activity is found:

  1. Stop operation immediately
  2. Screenshot and save evidence (excluding sensitive information)

🔧 Technical Questions

Q: Why does address validation fail?

A: Possible reasons:

  • Incorrect address format (missing 0x prefix or wrong length)
  • Contains invalid characters
  • Extra spaces or characters included during copy-paste
  • Not a valid Hyperliquid (EVM) address format

Q: Why does private key validation fail?

A: Possible reasons:

  • Private key format does not match current input requirements (including optional prefix/length mismatch)
  • Incorrect private key length (should be 64 hexadecimal characters)
  • Private key does not match address
  • Extra characters included during input

Q: How to handle network errors?

A: When encountering network errors:

  1. Check if network connection is stable
  2. Try switching to a more stable network
  3. Wait a few minutes and retry

Q: What to do if API calls fail?

A: API call failures may be due to:

  • Hyperliquid API temporarily unavailable
  • Network connection issues
  • Request frequency too high
  • Recommend retrying later

📱 User Experience Questions

Q: Can it be used on mobile phones?

A: Yes, the bot fully supports mobile use. Recommendations:

  • Use the latest version of Telegram app
  • Ensure stable mobile network connection
  • Operate in secure environment

Q: What to do if interface display is abnormal?

A: If interface display is abnormal:

  1. Try restarting Telegram app
  2. Send /start command to reinitialize
  3. Check if Telegram app is the latest version

Q: What to do if operation response is slow?

A: Slow operation response may be due to:

  • Unstable network connection
  • High Telegram server load
  • Slow Hyperliquid API response
  • Recommend operating when network conditions are good

🆘 Emergency Situations

Q: What to do if errors occur during recovery process?

A: If errors occur during recovery process:

  1. Don't panic, record error information
  2. Check if network connection is normal
  3. Check whether the result page shows partial or waiting_to_rerun, since these do not always mean the run failed

Q: What to do if assets don't arrive on Arbitrum?

A: If assets do not arrive on the source address on Arbitrum:

  1. Check transaction hash status in blockchain explorer
  2. Confirm the source address is correct and can receive on Arbitrum
  3. Wait for Hyperliquid processing and additional confirmations (arrival may take several to more than ten minutes)

📊 Other Questions

Q: Can I view historical operation records?

A: The public workflow should not currently be treated as providing a complete recovery-task history viewer. Use the result summary and transaction hashes as the primary audit trail.

Q: Will the bot be updated regularly?

A: Yes, we will update the bot regularly:

  • Fix known issues
  • Add new features
  • Improve user experience
  • Enhance security

Q: Are there tutorials or videos available?

A: Currently provides:

  • Detailed text tutorials
  • Illustrated user guides
  • Frequently asked questions
  • Video tutorials are in production
  • Check this documentation for the latest guides and updates

💬 Have Other Questions?

If your question is not answered here, please:

  1. View Other Documentation:

  2. Use In-Bot Feedback:

    • Submit your issue with non-sensitive details
    • Include error messages and tx hash when available

  3. Community Support:

    • Join user discussion groups
    • View community discussions
    • Share usage experiences

Remember: We are committed to providing you with the best service and support!