# Overview

Black Pearl Market is an independent OTC marketplace and tooling layer for PEARL and PRC20 assets. It helps users trade PEARL with a clear, non-custodial flow backed by an EVM escrow contract and public indexed state.

## What It Does

Black Pearl Market connects five public-facing parts:

| Component     | Role                                                                 |
| ------------- | -------------------------------------------------------------------- |
| OTC Web App   | Create bids, take asks, view swaps, claim, refund, and track status. |
| Pearl Wallet  | Non-custodial PEARL wallet and dApp approval flow.                   |
| Telegram Bot  | Guided marketplace, wallet, referral, and recovery experience.       |
| PRC20 Indexer | Public market and lifecycle state derived from chain data.           |
| EVM Escrow    | Contract that holds buyer USDC and enforces claim/refund rules.      |

## Settlement Model

Buyers lock USDC in the escrow contract. Sellers complete the PEARL-side settlement and claim USDC from the contract when eligible. Buyer USDC is not sent directly to the seller wallet.

Black Pearl Market uses:

* 0% buyer protocol fee;
* seller-side protocol fee accounting;
* explicit claim and refund windows;
* no user-facing co-sign flow as the primary model;
* explorer-verifiable EVM contract state.

## Order Modes

Black Pearl Market supports two settlement experiences:

* **Bot-Assisted Orders:** eligible Telegram session steps may be automated for a smoother flow.
* **Human-Confirmed Orders:** users or counterparties manually confirm required steps.

Both use the same smart contract lifecycle and both are non-custodial.

## PEARL Ecosystem Context

PEARL is the native asset of the Pearl chain. PRC20 is an inscription-based token model indexed from Pearl chain activity. Black Pearl Market supports practical PEARL movement across compatible wallets, the web app, and Telegram-assisted workflows.

Black Pearl Market is independent. It is not endorsed by, sponsored by, or officially associated with Pearl Research Labs, Pearl Compute, Black Pearl Compute LLC, Cipher Mining, or any similarly named entity unless explicitly stated through official channels.


---

# 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/readme/overview.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.