Hyperliquid Wallet Won't Connect? OneKey Troubleshooting Guide
Before You Troubleshoot: Confirm You’re on the Official Hyperliquid Site
A “can’t connect” report is often caused by phishing frontends or typo-squatted domains that fail to complete a proper wallet handshake (or worse, try to trick you into signing malicious messages).
- Check Hyperliquid’s official links (landing page, app, docs, X, Discord): Hyperliquid Support — official links. (hyperliquid.zendesk.com)
- Review Hyperliquid’s security reminders (including examples of lookalike domains): Hyperliquid Docs — Support Guide. (hyperliquid.gitbook.io)
If the URL is wrong, stop immediately. Fixing connection issues is meaningless if you’re not interacting with the real app.
Understand What You’re Connecting To: HyperCore vs HyperEVM
Hyperliquid users commonly mix up two different environments:
HyperCore (trading + balances)
This is where most users trade perps/spot through the main app interface.
- Deposits for many users are USDC on Arbitrum (details below).
- Your wallet may be asked to sign messages for authentication or actions, depending on the flow.
HyperEVM (smart contracts)
This is the EVM environment with its own Chain ID and RPC settings. If your wallet is on the wrong chain (or missing the network), connections and signing can fail.
- HyperEVM mainnet parameters: Hyperliquid Docs — HyperEVM. (hyperliquid.gitbook.io)
- How to add HyperEVM to a wallet: Hyperliquid Docs — How to use the HyperEVM. (hyperliquid.gitbook.io)
Quick Fix Checklist (Do These First)
These steps solve a large share of “won’t connect” cases:
- Hard refresh the page (and try a private/incognito window).
- Disable conflicting extensions (privacy script blockers, multiple injected wallet providers, aggressive ad blockers).
- Update OneKey Wallet (extension or mobile) to the latest version.
- Replug / re-pair your OneKey hardware wallet, unlock it, and keep it awake during connection.
- If using WalletConnect: disconnect the session inside OneKey Wallet and reconnect.
If you still can’t connect, work through the targeted sections below.
Fix 1: Network Mismatch (Most Common)
Scenario A: You’re trying to deposit USDC, but your wallet is not on Arbitrum One
Hyperliquid’s support docs note that only USDC deposits from Arbitrum are supported in that specific deposit flow, and deposits under 5 USDC may not be credited. See: Hyperliquid Docs — Deposited via Arbitrum network (USDC). (hyperliquid.gitbook.io)
Make sure your wallet is on Arbitrum One (Chain ID 42161). Official network settings are listed here: Arbitrum Foundation — Add Arbitrum network. (support.arbitrum.io)
What to do in OneKey Wallet
- Open OneKey Wallet → Networks → ensure Arbitrum One is enabled/added.
- Confirm you have a small amount of ETH on Arbitrum for gas.
Scenario B: You’re trying to use a HyperEVM dApp, but your wallet is not on HyperEVM
HyperEVM mainnet uses Chain ID 999 and the official JSON-RPC endpoint is:
Network Name: Hyperliquid
Chain ID: 999
RPC URL: https://rpc.hyperliquid.xyz/evm
Currency Symbol: HYPE
Source: Hyperliquid Docs — How to use the HyperEVM. (hyperliquid.gitbook.io)
Common symptom
- The site “connects” but actions fail, signatures don’t appear, or you see perpetual “switch network” prompts.
Fix
- Add/switch to HyperEVM in OneKey Wallet using the parameters above.
- Retry the connection after switching networks.
Fix 2: WalletConnect Session Timeouts, QR Pairing Issues, or Stale Sessions
WalletConnect-based connections can fail due to:
- Expired pending requests
- Stale sessions after browser sleep
- Multiple wallet apps trying to intercept the same connection
WalletConnect documents that request expiry is short by default (commonly around 5 minutes) unless extended by the app/wallet integration: WalletConnect Docs — Extended session expiry. (docs.walletconnect.network)
What to do
- In OneKey Wallet, remove the old WalletConnect connection/session.
- Refresh the Hyperliquid page and reconnect.
- Keep your phone and desktop on a stable network (avoid captive portals).
- If you scan a QR code, approve promptly—don’t leave the request pending.
Fix 3: RPC Endpoint Issues (Especially on HyperEVM)
On HyperEVM, everything routes through JSON-RPC. Hyperliquid notes there is no websocket support on the official RPC endpoint: Hyperliquid Docs — HyperEVM. (hyperliquid.gitbook.io)
Symptoms
- Wallet connects, but balances never load
- Transaction simulation hangs
- DApp UI keeps spinning
Fixes
- Try again with a clean browser profile (extensions can block RPC calls).
- If you’re a power user building or using advanced dApps, consider testing connectivity via a known RPC provider directory (for example): Alchemy — HyperEVM RPC & resources. (alchemy.com)
Fix 4: Signing Prompts Don’t Show Up (EIP-712 / Typed Data)
Hyperliquid-related actions may rely on modern signing formats. Many dApps use EIP-712 typed data (eth_signTypedData) for clearer, structured signing prompts.
Reference: EIP-712 specification. (eips.ethereum.org)
If you’re using OneKey hardware wallet
- Keep the device unlocked and connected.
- Watch for a signing request in OneKey Wallet and on the device (some prompts only appear on the device).
- If a request looks unfamiliar, reject it and re-check you’re on the correct domain (see the official links section).
Fix 5: “Connected” but Deposits/Balance Look Wrong (Verify Onchain First)
Sometimes the wallet connection is fine—the real issue is the deposit token/network.
Confirm your deposit on Arbitrum using Arbiscan
Arbiscan is the Arbitrum block explorer and can be used to verify whether your transaction succeeded: Arbiscan — What is Arbiscan?. (info.arbiscan.io)
What to check
- Transaction status: success/fail
- Token transferred: USDC (and correct contract)
- Recipient address: matches the address you connected
Also re-check Hyperliquid’s deposit constraints (USDC on Arbitrum, minimum deposit rules): Hyperliquid Docs — Deposited via Arbitrum network (USDC). (hyperliquid.gitbook.io)
Why These Issues Are Showing Up More Often (Ecosystem Shift)
Two broader industry dynamics make wallet connection reliability more important (and occasionally more fragile):
- More mainstream attention on Hyperliquid: In 2025, a regulated exchange-traded product referencing Hyperliquid was launched, reflecting growing institutional visibility. See: GlobeNewswire — 21Shares launches Hyperliquid ETP (Aug 29, 2025). (globenewswire.com)
- More users moving from “trading-only” to “onchain apps”: As HyperEVM usage expands, users must manage an additional chain (ID 999) and RPC routing, which increases the surface area for misconfiguration. See: Hyperliquid Docs — How to use the HyperEVM. (hyperliquid.gitbook.io)
When You Should Stop and Ask for Help (Safely)
If you’ve confirmed:
- Correct official URL
- Correct network (Arbitrum One for deposits or HyperEVM for dApps)
- WalletConnect session is fresh
- RPC access is not blocked
…but it still won’t connect, use official channels (and ignore unsolicited DMs):
- Hyperliquid Support — official links (hyperliquid.zendesk.com)
- Hyperliquid Docs — Support Guide (hyperliquid.gitbook.io)
Why OneKey Can Be a Good Fit for Hyperliquid Users
If you trade frequently on Hyperliquid (or interact with HyperEVM dApps), using OneKey hardware wallet with OneKey Wallet can help reduce key-exposure risk while still supporting common connection methods (injected wallet connections and WalletConnect-style flows).
The key is operational discipline:
- Verify domains first
- Confirm chain settings (Arbitrum One vs HyperEVM)
- Treat every signature as a security decision—not just a “login step”



