Skip to main content

Troubleshooting

This guide helps diagnose and resolve common issues when using Orvex. If you don't find your issue here, please reach out via official support channels.

Transaction Failures

"Transaction Reverted" or "Out of Gas"

Symptoms: Transaction fails with generic error or runs out of gas.

Common Causes:

  1. Insufficient gas limit — Orvex operations (especially with hooks) can be gas-intensive

    • Solution: Increase gas limit in wallet settings
    • Recommended: 500,000+ gas for swaps, 800,000+ for liquidity operations

  2. Slippage exceeded — Price moved beyond your slippage tolerance before transaction executed

    • Solution: Increase slippage tolerance or try again when market is less volatile

  3. Deadline expired — Transaction sat in mempool too long

    • Solution: Increase gas price for faster inclusion, or set longer deadline

"Insufficient Liquidity"

Symptoms: Swap fails with insufficient liquidity error.

Common Causes:

  1. Position out of range — Concentrated liquidity moved out of active price range

    • Solution: Trade a smaller amount, or wait for liquidity to return to range

  2. Low liquidity pool — Pool doesn't have enough depth for your trade size

    • Solution: Split trade into smaller amounts or use a different pool

  3. Price impact too high — Your trade would move the price significantly

    • Solution: Reduce trade size or use multi-hop routing

"Insufficient Balance"

Symptoms: Can't complete transaction due to balance error.

Check:

  1. Token balance — Do you have enough tokens?
  2. Gas token balance — Do you have native tokens for gas fees?
  3. Allowance — Have you approved the router to spend your tokens?

Solution: Acquire more tokens or approve the router contract.

Wallet Connection Issues

"Wallet Not Connecting"

Troubleshooting Steps:

  1. Refresh the page — Clear cache and reload
  2. Check wallet extension — Ensure it's installed and unlocked
  3. Try different browser — Some wallets work better on specific browsers
  4. Update wallet — Ensure you're running latest version
  5. Disable other wallets — Multiple wallet extensions can conflict

Still not working?

  • Try connecting in incognito/private mode
  • Disable browser extensions temporarily
  • Check if wallet supports Status Network

"Wrong Network"

Symptoms: Wallet connected but can't interact with Orvex.

Solution:

  1. Click network selector in your wallet
  2. Add Status Network if not present:
    • Network Name: Status Network
    • RPC URL: (official RPC - verify from Status docs)
    • Chain ID: (verify from Status docs)
    • Symbol: SNT or native token
    • Block Explorer: (official explorer URL)
  3. Switch to Status Network
  4. Refresh the Orvex app

Approval and Allowance Errors

"Approval Transaction Failed"

Common Causes:

  1. Insufficient gas — Increase gas limit
  2. Nonce issues — Clear pending transactions in wallet
  3. RPC errors — Try different RPC endpoint

Solution:

  • Reset wallet account (doesn't affect funds, just clears cache)
  • Use a different RPC provider
  • Wait for pending transactions to clear

"Endless Approval Loop"

Symptoms: App keeps asking for approvals repeatedly.

Causes:

  • Browser cache issue
  • RPC sync delay
  • Wallet state mismatch

Solution:

  1. Clear browser cache
  2. Disconnect and reconnect wallet
  3. Hard refresh page (Ctrl+Shift+R or Cmd+Shift+R)
  4. Try incognito mode

Slippage Errors

"Slippage Tolerance Exceeded"

What it means: Price moved more than your allowed slippage before transaction executed.

Solutions:

For high-volatility pairs:

  • Increase slippage tolerance (1-5% depending on market conditions)
  • Trade smaller amounts
  • Use limit orders (when available)

For stable pairs:

  • Keep slippage low (0.1-0.5%)
  • If failing repeatedly, check if pool has liquidity

Warning: Very high slippage (Greater than 5%) can expose you to front-running. Only use when necessary.

"Price Impact Too High"

What it means: Your trade size would significantly move the market price.

Solutions:

  1. Reduce trade size — Break into multiple smaller trades
  2. Check liquidity depth — Trade during periods of higher liquidity
  3. Use multi-hop routes — Router may find better path through multiple pools
  4. Wait for more liquidity — Check if pools are being voted on for emissions

Understanding Price Impact:

  • Less than 1% — Normal for liquid pairs
  • 1-3% — Acceptable for medium trades
  • 3-5% — High impact, consider splitting trade
  • Greater than 5% — Very high impact, trade at your own risk

Rewards Claiming Problems

"No Rewards Available"

Check:

  1. Epoch completion — Rewards claimable only after epoch ends (Wednesday 23:59 UTC)
  2. Voting deadline — Did you vote before Thursday 00:00 UTC snapshot?
  3. Staking status — Are your LP positions staked in a gauge?
  4. Pool activity — Did the pool you voted for generate fees?

Solution: Wait for current epoch to complete, ensure you vote before next snapshot.

"Claim Transaction Failed"

Common Causes:

  1. Gas too low — Increase gas limit
  2. Multiple claims — Some reward types claimed separately
  3. Contract sync — Wait a few blocks after epoch ends

Solution:

  • Wait 10-15 minutes after epoch end
  • Try claiming individual reward types separately
  • Increase gas limit to 300,000+

veORVX Management Issues

"Can't Increase Lock Amount"

Check:

  1. ORVX balance — Do you have enough ORVX?
  2. ORVX approval — Have you approved the veORVX contract?
  3. Lock expiration — Some operations not allowed on expired locks

Solution: Approve veORVX contract to spend ORVX, then try again.

"Can't Extend Lock Duration"

Common Causes:

  1. Already at max duration — 2-year maximum
  2. Lock already extended — Can only extend once per epoch
  3. Lock expired — Must withdraw and create new lock

Solution: Check current lock expiration date and ensure you're not at maximum.

"Voting Power Not Updating"

Symptoms: Increased lock but veORVX balance hasn't changed.

Explanation:

  • veORVX decays linearly over time
  • Extensions/increases may offset decay
  • Balance updates at next epoch snapshot (Thursday 00:00 UTC)

Solution: Wait for next epoch snapshot to see updated voting power.

Gas Optimization Tips

Reduce Transaction Costs

  1. Batch operations — Use multicall when available
  2. Approve once — Use max approval (type(uint256).max) for frequently used tokens
  3. Trade during low activity — Gas prices lower during off-peak hours
  4. Consolidate positions — Merge veNFTs to reduce management costs
  5. Vote strategically — Consider gas costs vs expected rewards

When Gas Is Too High

  • Wait for network congestion to decrease
  • Use gas price trackers to time transactions
  • Consider if transaction value justifies gas cost
  • For small amounts, wait until you have more to transact

Position Management

"Can't Remove Liquidity"

Check:

  1. Staked in gauge — Unstake from gauge first
  2. Position NFT ownership — Ensure you own the position NFT
  3. Partial removal — Try removing smaller amount first

Solution: Unstake from gauge, then remove liquidity from PoolManager.

"Position Showing Zero Value"

Common Causes:

  1. Out of range — Concentrated liquidity position outside active price
  2. UI display bug — Refresh page or check on-chain
  3. Impermanent loss — Value changed due to price movement

Solution:

  • Check current pool price vs your position range
  • Verify position on block explorer
  • Rebalance position if needed

Browser and UI Issues

"App Won't Load"

Troubleshooting:

  1. Clear browser cache
  2. Disable ad blockers
  3. Try different browser (Chrome, Brave, Firefox)
  4. Check internet connection
  5. Verify app URL is official (https://www.orvex.fi)

"Balances Not Updating"

Solutions:

  1. Hard refresh (Ctrl+Shift+R / Cmd+Shift+R)
  2. Disconnect and reconnect wallet
  3. Switch to different RPC endpoint
  4. Wait a few minutes for indexer to sync

Getting Additional Help

If your issue persists:

  1. Check official docs — https://docs.orvex.fi
  2. Join Discord — Official Orvex Discord (link on website)
  3. Search existing issues — GitHub or community forums
  4. Contact support — Via official channels only

When reporting issues, include:

  • Transaction hash (if applicable)
  • Wallet address
  • Network and browser being used
  • Screenshots of error messages
  • Steps to reproduce the issue

Security Warnings

NEVER:

  • Share your private key or seed phrase
  • Approve unknown contracts
  • Click links from unofficial sources
  • Rush transactions during "limited time offers"

ALWAYS:

  • Verify contract addresses
  • Use official Orvex website only
  • Enable wallet transaction previews
  • Start with small test transactions

Still Need Help?

Visit official Orvex support channels:

For urgent security issues, contact the team directly through verified channels only.