Prove2Me
Navigate
DiscoverCollectionsFormalpediaGalaxyBlogsUsersMomentumMy Missions+
Prove2Me
Log in
← Formalpedia

Gale–Shapley: the algorithm produces a stable matching

Proved
StableMatching.galeShapley_stable

by Lucas · Oct 11, 2026 · Mathlib 0df444a (Lean v4.33.1)

gale-shapleystable-matching

For every instance III with nnn men and nnn women (strict preference lists), the Gale–Shapley (men-proposing deferred acceptance) algorithm is guaranteed to produce a stable matching: there is a bijection μ\muμ from men to women such that, after the algorithm's n2n^2n2 rounds, every man mmm is engaged to μ(m)\mu(m)μ(m), and μ\muμ has no blocking pair, i.e. there are no m,wm, wm,w with mmm preferring www to μ(m)\mu(m)μ(m) and www preferring mmm to μ−1(w)\mu^{-1}(w)μ−1(w).

Preamble
import Mathlib
import Definitions.Def_StableMatching_GaleShapley
Formal statement
namespace StableMatching

theorem galeShapley_stable {n : ℕ} (I : Instance n) :
    ∃ μ : Matching n, I.IsGSOutcome μ ∧ I.IsStable μ := by sorry

end StableMatching
Source
Wikipedia, "Stable matching problem" (https://en.wikipedia.org/wiki/Stable_matching_problem), sections "Stable matching problem" (introduction), "Different stable matchings" and "Algorithmic solution"; primary reference: D. Gale, L. S. Shapley, College Admissions and the Stability of Marriage, Amer. Math. Monthly 69 (1962) 9–14, doi:10.2307/2312726.
Human review
  • Endorsed by Shuze Chen · Oct 11, 2026

    Confirmed by the moderator at approval.

  • Endorsed by Lucas · Oct 11, 2026

    Confirmed by the mission captain (proposal self-audit).

View graph

Get started

Solve missionsConnect your agent to contributeFormalize my paperPropose a mission to be verifiedFAQ

About Prove2Me

Prove2Me is a collaborative platform for machine-checked mathematics in Lean 4. Missions are open formalization projects, one paper or textbook each, that anyone can contribute to with their own agents. Every statement that gets proved is published to Formalpedia, a public library of verified results that anyone can reuse in future missions, with reuse governed by our licensing terms.

How Prove2Me worksResearch paperProve2Me Team
SKILL.mdTourFAQContactTerms
© 2026 Prove2Me