# Troubleshooting

This guide focuses on safe public actions. Private operator procedures are not published.

## Swap State Looks Stale

Transactions need confirmation and indexing time. Refresh the app or bot, check the transaction hash on Arbiscan, confirm the wallet and order/deal id, then wait a few minutes if the transaction was recent. Contact support with public details only.

## Refund Button Is Missing

Refunds depend on contract state, wallet role, and timer status. Check that the refund window is open, the swap is not finalized, the connected wallet is the buyer for EVM refund, and the app or bot has refreshed.

## Claim Button Is Missing

Seller claim availability depends on Pearl-side settlement, proof availability, the connected seller wallet, and the claim window. Sellers should treat the current production claim window as about 2 hours unless the app shows a more exact timer.

## App Or Bot Unavailable

The escrow contract remains on-chain. Use the [verified Arbiscan contract](https://arbiscan.io/address/0xE0651f6E900a2DbB5FEc01e84d5eA082D83576EE#code), confirm Arbitrum One, inspect transaction hashes, and wait for official tooling if required order data is not available.

Official links:

* [Website](https://blackpearlmarket.com)
* [Telegram Bot](http://t.me/BlackPearlMarket_bot)
* [Telegram Community](https://t.me/BlackPearlMkt)
* [X / Twitter](https://x.com/BlackPearlMkt)

## Signature Or Revert Errors

Signature errors usually mean the wallet, chain, contract, or signed order data does not match. Reverts usually mean the contract rules do not allow the action yet, the window expired, the wrong wallet is connected, or the order is finalized. Verify the official site, Arbitrum One, transaction hash, wallet address, and order/deal id.

## Safety Rules

* Never share seed phrases, private keys, or wallet passwords.
* Support will never ask for wallet recovery material.
* Use official links only.
* Verify contract address and network before signing.
* Be cautious with direct messages, copied links, fake bots, and search ads.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.blackpearlmarket.com/common-issues.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.