Verified Deal Escrow

The Deal Room is where verified ground meets capital. A deal escrows the buyer's funds against a specific parcel and walks a strict state machine. Release is gated on a CLEAR LandSnap verification — no CLEAR verdict, no release. That gate is the product's core mechanic.

Simulated funds in this proof of concept

In this prototype, all funds movement is simulated. No real money is held, moved or released, and the escrow balances are demo data. In production, a licensed escrow/trust partner holds buyer funds while EoG provides the verification trigger that authorizes release.

States

funded ──▶ verifying ──▶ released
                │
                └──▶ flagged   (terminal)
                     released is also terminal

State	Meaning	For the buyer	For the seller
funded	Deal opened; the escrowed amount is committed against the parcel	Funds are committed but not yet moving toward release	Parcel is under deal; completion not yet in motion
verifying	Completion requested; the deal is waiting on the verification gate	Funds stay locked while verification runs	Release pending — contingent on a CLEAR verdict
released	A CLEAR verification exists; escrow released	Funds released to complete the purchase	Paid out against verified ground
flagged	The latest verification came back FLAGGED	Escrow frozen — funds do not move to the seller	Transaction blocked until the disqualifier is resolved

released and flagged are terminal: a deal in either state cannot be advanced further.

The verification gate

Advancing a deal from verifying checks the parcel's verification history:

• If the latest verification is FLAGGED → the deal flips to flagged and freezes, with the fatal flag displayed as the reason.
• If a CLEAR verification exists → the deal moves to released, linked to that verification.
• Otherwise → release is refused with 409 verification_required:

{
  "error": "verification_required",
  "message": "Escrow release requires a clear field verification. Run LandSnap verification on this parcel first."
}

In the portal this refusal renders as a warning banner on the deal card with a Run LandSnap Verification shortcut — the guided demo walks through exactly this flow.

Masked amounts

Deal amounts are stored in full but rendered masked in the Deal Room (₦••,•••,•••). Hover or click the masked figure to reveal it; it re-masks when you move away. The API returns the raw amount_ngn integer — masking is a presentation-layer choice.

Seeded deals

Parcel	Buyer	Amount	Starts in state
Independence Layout Residential Plot (Enugu)	Nnamdi Investments Ltd	₦38,000,000	verifying — deliberately unverified, so the release gate fires on your first Advance
Epe Corridor Acreage (Lagos)	Harcourt Capital Partners	₦45,000,000	funded — advance once to request completion

The dashboard stats strip aggregates the pipeline: pipeline value and active-escrow counts cover deals in funded + verifying, and the "accepting LPs" counter shows deals still in funded.

Opening a deal

From any parcel report (Open Escrow Deal) or the Deal Room (+ New Deal): pick a parcel, enter a buyer name, and optionally an amount in ₦ — leave it blank to default to the parcel's asking price. The deal opens directly in funded.