> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hidemytx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Solutions for common issues in HideMyTx.

## RAILGUN / Shielded Send issues

<AccordionGroup>
  <Accordion title="RAILGUN engine stuck loading">
    If the engine initialization spinner does not resolve after 2 minutes:

    1. Refresh the page and reconnect your wallet
    2. If it still stalls, open the **Advanced** section and click **Deep Resync** to clear and rebuild the local state
    3. If Deep Resync does not help, try **Full State Reset** and reconnect
  </Accordion>

  <Accordion title="Private balance shows 0 after shielding">
    After shielding, RAILGUN needs to scan the new block and detect your deposit. This can take a few minutes. The balance may appear as **Pending** first, then move to Available.

    If the balance does not appear after 5 minutes:

    1. Click **Resync** in the Shielded Send panel
    2. If that does not resolve it, click **Deep Resync**
  </Accordion>

  <Accordion title="ZK proof generation fails or hangs">
    ZK proof generation is memory- and CPU-intensive. If it fails:

    1. Close other tabs to free browser memory
    2. Refresh the page and retry
    3. If proof generation consistently fails, try the **Emergency Unshield** option in the Advanced panel to recover funds without a ZK proof
  </Accordion>

  <Accordion title="POI status shows 'Pending' and won't resolve">
    Private Proof of Innocence (POI) is processed by external aggregators. If POI is stuck:

    1. Open the POI diagnostics panel and manually trigger a refresh
    2. Wait — POI aggregators process transactions on their own schedule and may take several hours in peak periods
    3. If POI remains unresolved after 24 hours, consult the RAILGUN community resources
  </Accordion>
</AccordionGroup>

## Private Swaps (Houdini) issues

<AccordionGroup>
  <Accordion title="Order status is stuck on WAITING">
    The `WAITING` status means your deposit was detected but is waiting for block confirmations. For networks with slow confirmation times (e.g., Bitcoin), this can take 30–60 minutes. You do not need to keep the page open — status is polled automatically when you return.
  </Accordion>

  <Accordion title="I sent funds to the deposit address but the order shows FAILED">
    * Verify you sent the exact token and amount shown on the deposit screen
    * Verify the deposit address matches the one shown (not a cached address from a previous order)
    * Contact Houdini support with your order ID if the issue persists
  </Accordion>
</AccordionGroup>

## Cross-Chain Swaps (NEAR Intents) issues

<AccordionGroup>
  <Accordion title="No quote available for my pair">
    Solver availability depends on liquidity. Try:

    * A larger swap amount (some solvers have minimums)
    * A different token pair with more liquidity
    * Waiting a few minutes and retrying
  </Accordion>

  <Accordion title="Swap shows PENDING for a long time">
    Settlement time depends on the source and destination chain finality. Bitcoin-based swaps can take 30–60 minutes. If the status does not update after the expected time, use the **Refresh status** button to manually poll.
  </Accordion>
</AccordionGroup>