# Design Boundaries

Black Pearl Market is designed for transparent, recoverable cross-network settlement. This page explains the main boundaries users should understand.

## Cross-Network Settlement

Pearl and EVM settlement occur on separate networks. The protocol uses explicit lifecycle states, timers, transaction links, and recovery actions so users can follow the flow.

## Indexed State

The web app and bot use indexed chain data. Status may refresh after confirmations, indexing, or proof verification. If a transaction was recent, refresh and check the explorer link.

## Infrastructure Availability

The website, bot, API, and indexer are tooling layers. If they are temporarily unavailable, the EVM escrow contract remains visible on Arbiscan. Advanced users can inspect or interact with the verified contract when they have the required data.

## Claim And Refund Timing

Sellers should claim USDC before the claim window expires. In the current production flow, sellers should treat this as about 2 hours unless the app shows a more exact timer.

If the seller misses the window, the buyer may become eligible to refund according to contract rules.

## Custom RPC

Black Pearl Market tooling uses the public PEARL RPC endpoint at `https://rpc.blackpearlmarket.com`. Future tooling is planned to let advanced users configure custom RPC endpoints for additional resilience. Users should only use RPC providers they trust.

## User Safety

* Use official links.
* Verify the contract address.
* Keep seed phrases and private keys private.
* Review transaction prompts.
* Contact support with public transaction details only.


---

# 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/threat-model/known-limitations.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.