MindPalaceX · The Workshop
The Idea Wall →

On the Idea Wall · ▲ 0 votes

SwapEscrow — the spec

A free, community-run marketplace where solo business owners post currency swap requests, get matched with counterparts, and settle through escrow — no bank intermediary, no fee skimming. The platform's job is to make peer-to-peer FX trustworthy enough that strangers complete real transactions without anyone holding their hand.

---

Decisions locked

QuestionAnswer
ShapeMarketplace
AudienceSolo business owners needing FX without bank overhead
Core loopPost swap need → get matched → funds held in escrow → both parties confirm → escrow releases
Success metric at 30 daysSwaps complete end-to-end without manual intervention

---

The core loop

  1. Post — A user submits a swap request: currency pair, amount, preferred rate, and a deadline.
  2. Match — The platform surfaces compatible counterpart listings; the user accepts a match or waits for an incoming match request.
  3. Deposit — Both parties deposit their respective currencies into escrow within a set window; failure to deposit cancels the match and re-queues both listings.
  4. Confirm — Each party confirms receipt of the swapped funds in their external account.
  5. Release — Escrow releases automatically once both confirmations are logged; the listing closes.
  6. Rate — Each party leaves a trust score for the other, feeding the reputation layer used in future matching priority.

---

v1 scope

Swap Listing Board — The public feed where users post and browse open swap requests, filtered by currency pair and amount range. Lives on the home/marketplace screen.

Escrow Vault — Holds both parties' deposits for the duration of a matched swap; releases only on dual confirmation or returns funds on timeout/dispute trigger. Lives on the active-swap detail screen.

Match Engine — Compares open listings on currency pair, rate tolerance, and amount; surfaces compatible pairs and notifies both users. Runs server-side; surfaces results on the user's dashboard.

Confirmation Flow — A two-step UI where each counterpart logs "funds received" before escrow releases; a countdown timer enforces the confirmation window. Lives on the active-swap detail screen.

Reputation & Trust Score — A post-swap rating collected from both parties; score is visible on user profiles and used to rank matches. Lives on the profile screen and influences match-engine sorting.

---

Deliberately later

  • In-app wallet / fiat on-ramp — requires payment licensing; v2 once regulatory groundwork is done.
  • Automated rate feed / price oracle — adds third-party dependency; manual rate negotiation is safer at low volume.
  • Dispute arbitration panel — community moderators need a user base to recruit from first; build v2 once transaction volume justifies it.
  • KYC / identity verification — compliance layer that slows onboarding; introduce when transaction sizes or regulations demand it.
  • Group / bulk swaps — multi-party coordination is a distinct UX problem; earns its own design cycle after the two-party loop is proven.
  • Mobile native app — progressive web app ships faster; native is a v2 investment when retention data justifies it.

---

Data model sketch

  • users — id, display name, email, trust score, joined date, KYC status flag
  • listings — id, user_id, sell currency, buy currency, amount, rate floor/ceiling, expiry, status (open / matched / closed / expired)
  • matches — id, listing_id_a, listing_id_b, matched_at, status (pending deposit / escrowed / confirming / complete / disputed / cancelled)
  • escrow_deposits — id, match_id, user_id, currency, amount, deposited_at, released_at
  • confirmations — id, match_id, user_id, confirmed_at, notes
  • ratings — id, match_id, rater_id, ratee_id, score (1–5), comment, created_at
  • disputes — id, match_id, raised_by, reason, status, created_at, resolved_at

---

Screens

  • Home / Listing Board — browse and filter all open swap listings by currency pair and amount.
  • Post a Swap — form to create a new listing with pair, amount, rate tolerance, and deadline.
  • Dashboard — user's active listings, pending matches, and escrow statuses at a glance.
  • Active Swap Detail — per-match view: deposit status, confirmation buttons, countdown timer, escrow state.
  • Profile — public trust score, completed swap count, and rating history.
  • Match Notification / Accept Screen — surfaces an incoming match for review and one-tap acceptance or decline.

---

How to use this document

  • Bring it into Mind Palace, where the guided platform and its AI coach pick up from exactly this document and build the product with you step by step.
  • Hand it to a developer as the complete v1 brief — scope, data model, and screens are all defined.
  • Keep it as the single source of truth while you build, so every feature decision can be checked against what SwapEscrow is actually for.

This is Ayodeji's. Build yours.

A spec like this is step 3 of Mind Palace's nine — the other six take a weekend: working software, a real offer, first customers.

Want to build this with Ayodeji?

Tell us who you are and we'll broker the introduction — their contact details stay private until they say yes.