> For the complete documentation index, see [llms.txt](https://easyauth.papelship.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://easyauth.papelship.com/documentation/best-practies/troubleshooting.md).

# Troubleshooting

This page provides solutions to common build, linker, and runtime issues encountered when integrating EasyAuth.

***

## Common Linker Errors

<details>

<summary><code>LNK2019: unresolved external symbol sodium_init</code></summary>

* **Cause**: `libsodium.lib` is missing from the linker input.
* **Solution**: Add `libsodium.lib` to **Project Properties -> Linker -> Input -> Additional Dependencies**, and verify the path is in **Additional Library Directories**.

</details>

<details>

<summary><code>LNK2019: unresolved external symbol WSAStartup</code> or <code>InternetOpenA</code></summary>

* **Cause**: Windows system network libraries are not linked.
* **Solution**: Add `ws2_32.lib;wininet.lib;crypt32.lib;shlwapi.lib;wbemuuid.lib;gdiplus.lib;` to **Additional Dependencies**.

</details>

***

## Runtime Troubleshooting

<details>

<summary>Program exits immediately with <code>TAMPER_DETECTED</code> (0xFA6C291)</summary>

* **Cause**: The runtime `.text` section CRC32 checksum computed by the client does not match the whitelist hash registered on the EasyAuth server.
* **Solution**:

</details>

<details>

<summary><code>network_connect()</code> returns <code>false</code></summary>

* **Checks**:
  * Ensure the EasyAuth server instance is online and the listening port (e.g. `8888` / `7710`) is forwarded / open on your firewall.
  * Check for active third-party firewalls or antivirus blocking TCP connections.

</details>

<details>

<summary>qPAnalyzer AI False Positives on Command Line or Notepad</summary>

* **Solution**: Ensure your server is running the latest forensic vision prompt which checks the actual functional GUI widgets (registers, disassembly, address tables) rather than relying solely on window title bar strings.

</details>