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
| Question | Answer |
|---|---|
| Shape | Marketplace |
| Audience | Solo business owners needing FX without bank overhead |
| Core loop | Post swap need → get matched → funds held in escrow → both parties confirm → escrow releases |
| Success metric at 30 days | Swaps complete end-to-end without manual intervention |
---
The core loop
- Post — A user submits a swap request: currency pair, amount, preferred rate, and a deadline.
- Match — The platform surfaces compatible counterpart listings; the user accepts a match or waits for an incoming match request.
- Deposit — Both parties deposit their respective currencies into escrow within a set window; failure to deposit cancels the match and re-queues both listings.
- Confirm — Each party confirms receipt of the swapped funds in their external account.
- Release — Escrow releases automatically once both confirmations are logged; the listing closes.
- 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 flaglistings— 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_atconfirmations— id, match_id, user_id, confirmed_at, notesratings— id, match_id, rater_id, ratee_id, score (1–5), comment, created_atdisputes— 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.