Docs
Getting Started

Use Case

This flow covers the common path from “I want to swap” to a settled P2P deal.

Terms used below:

  • Taker: the user who responds to an offer.
  • Maker: the user who created the offer.
  • Stablecoin buyer: sends fiat (cash/bank transfer) and receives stablecoins.
  • Stablecoin seller: deposits stablecoins into escrow and receives fiat.
  • Escrow: the on-chain lock used for the one-sided guarantee (see Features).

Quick request (Screens 1–3)

Screen 1 — Location

  • Detect location automatically, or let the user set it manually.

Screen 2 — Create a request

Collect the minimum inputs:

  • Side: Buy or Sell (stablecoins)
  • Amount
  • Payment method (optional): cash, bank transfer

Screen 3 — Show matches

  • Show the most recent counter-offers matching the request filters.
  • Include location as a ranking/filter input.
  • Provide a clear CTA to Create custom offer.

Custom offer creation (from the quick request)

Pre-fill fields from the quick request, then show extended settings:

  • Side: Buy or Sell (stablecoins)
  • Asset: USDT / USDC
    • If you support “any”, call it out explicitly (example: “Any stablecoin”).
  • Network (optional): TRC-20, Solana, Base
  • Payment method (optional): cash, bank transfer
  • Premium (%): price adjustment vs the reference rate
    • Example: +2% means the taker pays 2% more than the reference.
  • Deal duration: how long this offer stays valid once accepted

After saving, the offer is added to the shared offers list.

“Bump daily” should be explicit in UI copy. It means “refresh this offer to keep it visible/active”.

Opening an existing offer + escrow settlement

Open offer details

The taker selects an offer and sees:

  • Side, asset, network, payment method(s)
  • Price/premium and limits
  • Maker rating / reputation signals (if enabled)

Confirm terms in chat

  • Open a contact window with the maker.
  • Agree on the practical details (meeting point or bank transfer details).
  • Prefer in-app chat for auditability and dispute resolution.

Create the deal (escrow)

  1. Stablecoin seller (escrow depositor) deposits the agreed stablecoins (USDT/USDC) into escrow.
  2. Stablecoin buyer (fiat sender) transfers the fiat via the agreed payment method.
  3. The stablecoin seller confirms receipt of fiat.
  4. Escrow releases stablecoins to the stablecoin buyer’s address.

Maker/taker roles flip by side:

  • If the maker creates a Sell offer: maker = stablecoin seller, taker = stablecoin buyer.
  • If the maker creates a Buy offer: maker = stablecoin buyer, taker = stablecoin seller.