> For the complete documentation index, see [llms.txt](https://wanitools.gitbook.io/wani-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wanitools.gitbook.io/wani-docs/boost-bot-v2/errors.md).

# Errors

Common errors you may encounter while using **Boost Bot V2** and how to fix them.

## Startup Errors

<details>

<summary><code>No License Key Found, Put License Key In Config.yaml</code></summary>

> *No additional fix details provided.*

</details>

<details>

<summary><code>Error -> [Connection Failed]</code></summary>

> *No additional fix details provided.*

</details>

<details>

<summary><code>Error -> [Invalid License Key]</code></summary>

> *No additional fix details provided.*

</details>

<details>

<summary><code>Some Error With Config -> ... | How To Fix: ...</code></summary>

> *No additional fix details provided.*

</details>

## Token / Boosting Errors

<details>

<summary><code>401 Unauthorized (Bad / Locked Token)</code></summary>

> *No additional fix details provided.*

</details>

<details>

<summary><code>Token Locked [403]</code></summary>

> *No additional fix details provided.*

</details>

<details>

<summary><code>Captcha Detected, No Solver Enabled</code></summary>

> *No additional fix details provided.*

</details>

<details>

<summary><code>CapKey Missing In Config.yaml</code></summary>

> *No additional fix details provided.*

</details>

<details>

<summary><code>Unsupported CapService '...'</code></summary>

> *No additional fix details provided.*

</details>

<details>

<summary><code>provider returned hCaptcha test token (couldn't actually solve)</code></summary>

> *No additional fix details provided.*

</details>

<details>

<summary><code>timed out waiting for solution</code></summary>

> *No additional fix details provided.*

</details>

<details>

<summary><code>Join Failed</code></summary>

> *No additional fix details provided.*

</details>

<details>

<summary><code>No User ID</code></summary>

> *No additional fix details provided.*

</details>

<details>

<summary><code>Token Exchange Failed</code></summary>

> *No additional fix details provided.*

</details>

<details>

<summary><code>Insufficient tokens</code></summary>

> *No additional fix details provided.*

</details>

## AutoBuy / Webhook Errors

<details>

<summary><code>Invalid Webhook Signature</code></summary>

> *No additional fix details provided.*

</details>

<details>

<summary><code>Out of token stock</code></summary>

> *No additional fix details provided.*

</details>

<details>

<summary><code>SellAuth autobuying is disabled</code> / <code>SellApp autobuying is disabled</code> / etc.</summary>

> *No additional fix details provided.*

</details>

<details>

<summary><code>No StoreId configured</code> (Komerza only)</summary>

> *No additional fix details provided.*

</details>

## Panel / Tunnel Errors

<details>

<summary><code>[Panel] Instance Link Failed — Retrying In Background</code></summary>

> *No additional fix details provided.*

</details>

<details>

<summary><code>[Tunnel] Connect Failed</code></summary>

This issue usually shows up in one of two ways on your stock/redeem site:

**🔴 Page Offline**

* **Problem:** The bot is not connected to the panel tunnel.
* **Fix:** Make sure the bot is running. The tunnel connects automatically when the bot starts.

**🟡 Bot Timeout**

* **Problem:** The bot connected but didn't respond within 30 seconds.
* **Fix:** The bot may be overloaded or processing a large order. Wait a moment and refresh.

</details>

## Dynamic URL Errors

<details>

<summary><code>[Dynamic URL] ... [No Variants]</code></summary>

* **Problem:** The bot found a product on your store but it has no variants set up.
* **Fix:** Make sure the product has at least one variant with the delivery type set to `Dynamic`.

</details>

<details>

<summary><code>[Dynamic URL] ... [Update Failed]</code></summary>

* **Problem:** The bot couldn't update the dynamic URL for a product.
* **Fix:** Check your `APIKey` is correct and has write permissions on your store.

</details>

<details>

<summary><code>[Dynamic URL] ... [Dynamic Already Set]</code></summary>

> **Note:** The product's dynamic URL already matches — no update was needed. **This is not an error.**

</details>

## Token Checker Errors

<details>

<summary>Tokens showing as <code>Invalid</code> / <code>Locked</code> / <code>NoNitro</code> / <code>NoBoosts</code></summary>

* **Problem:** The checker found tokens that can't be used for boosting.
* **Fix:** These tokens are automatically sorted out. Enable the relevant options in config to filter them:

```yaml
TokenChecker:
  Options:
    Invalid: true
    Locked: true
    NoNitro: true
    NoBoosts: true
```

</details>

## OAuth Setup Errors

<details>

<summary><code>Redirect URI ... is not supported by client</code></summary>

* **Problem:** The redirect URI the bot uses doesn't match what's registered in your Discord app.
* **Fix:** Go to [discord.com/developers/applications](https://discord.com/developers/applications) → your bot → OAuth2 → add exactly:

```
https://api.wanibootz.cc/client/<instanceID>/oauth2
```

</details>

## General Tips

* Check `Data/Output/crash.log` if the bot crashes — it contains the full error traceback.
* Tokens that fail are automatically moved to `Data/Output/Failed.txt`.
* Tokens that hit captcha are moved to `Data/Output/Captcha.txt`.
* Successful tokens are logged to `Data/Output/Success.txt`.
* If the bot exits immediately after starting, check `Config.yaml` for missing or incorrect values.