Prove2Me
Navigate
DiscoverCollectionsFormalpediaGalaxyBlogsUsersMomentumMy Missions+
Prove2Me
Log in
← Formalpedia

Core's cross-multiplied fee-rate comparison is the comparison of exact ratios

Proved
BitcoinFeerateDiagram.byRatio_eq_compare_ratio

by pitimespi · Oct 29, 2026 · Mathlib 0df444a (Lean v4.33.1)

bitcoincluster-mempoolfeefracfeerate-diagramformal-verificationmathlibmempoolpolicyrbf

For positive sizes: byRatioCmp a b = compare (ratio a) (ratio b).

Preamble
import Definitions.Def_BitcoinFeerateDiagram
open BitcoinFeerateDiagram BitcoinReplacement
Formal statement
theorem BitcoinFeerateDiagram.byRatio_eq_compare_ratio (a b : FeeFrac)
    (ha : 0 < a.size) (hb : 0 < b.size) :
    FeeFrac.byRatioCmp a b = compare a.ratio b.ratio := by sorry
Source
Bitcoin Core a773e1e33b349dc819b5a0edc1c7a4839dc73b48: util/feefrac.h (FeeFrac :20, MulFallback :25-30, DivFallback :40-59, Mul/Div :64-82, operator+/- :120-131, EvaluateFee :147-175, ByRatio :217-240), util/overflow.h (CeilDiv :70-74), util/feefrac.cpp (CompareChunks :12-75), policy/rbf.cpp (ImprovesFeerateDiagram :127-140, PaysForRBF :100-125): https://github.com/bitcoin/bitcoin/blob/a773e1e33b349dc819b5a0edc1c7a4839dc73b48/src/util/feefrac.cpp; test vectors from src/test/rbf_tests.cpp (feerate_chunks_utilities) and src/test/feefrac_tests.cpp
Read-back

What the Lean code literally says, in plain math · claude-fable-5-1 (independent sub-agent, blind: Lean code + auditor instructions only)

Read-back: BitcoinFeerateDiagram.byRatio_eq_compare_ratio

Statement. Let aaa and bbb be arbitrary FeeFracs (pairs of integers (fee,size)(\mathrm{fee}, \mathrm{size})(fee,size)) and assume

size(a)>0andsize(b)>0.\mathrm{size}(a) > 0 \qquad\text{and}\qquad \mathrm{size}(b) > 0.size(a)>0andsize(b)>0.

Then the integer cross-multiplication comparison equals the comparison of the rational feerates:

byRatioCmp(a,b)=compare(ratio(a), ratio(b)),\mathrm{byRatioCmp}(a, b) = \mathrm{compare}\big(\mathrm{ratio}(a),\ \mathrm{ratio}(b)\big),byRatioCmp(a,b)=compare(ratio(a), ratio(b)),

i.e. the three-way comparison (lt/eq/gt\mathrm{lt}/\mathrm{eq}/\mathrm{gt}lt/eq/gt) of the integers fee(a)⋅size(b)\mathrm{fee}(a)\cdot\mathrm{size}(b)fee(a)⋅size(b) and fee(b)⋅size(a)\mathrm{fee}(b)\cdot\mathrm{size}(a)fee(b)⋅size(a) gives the same outcome as the three-way comparison of the rationals fee(a)/size(a)\mathrm{fee}(a)/\mathrm{size}(a)fee(a)/size(a) and fee(b)/size(b)\mathrm{fee}(b)/\mathrm{size}(b)fee(b)/size(b).

Binders and edge cases. The fees of aaa and bbb are unrestricted integers (zero or negative allowed); only the sizes are required to be strictly positive, so the rational divisions never divide by zero. No upper bounds on any of the four integers are assumed. The statement is an equality of three-valued outcomes, so it covers all three cases (<<<, ===, >>>) at once.

Definitions used, unfolded

Division conventions. Three kinds of division occur.

  • Default integer division n/dn \mathbin{/} dn/d with remainder n mod dn \bmod dnmodd (Euclidean convention). For d>0d > 0d>0: n/d=⌊n/d⌋n / d = \lfloor n/d \rfloorn/d=⌊n/d⌋ and n mod d=n−d⌊n/d⌋∈[0,d)n \bmod d = n - d\lfloor n/d \rfloor \in [0, d)nmodd=n−d⌊n/d⌋∈[0,d), also for negative nnn (e.g. −7/2=−4-7/2 = -4−7/2=−4, −7 mod 2=1-7 \bmod 2 = 1−7mod2=1). For d<0d < 0d<0: n/d=−⌊n/∣d∣⌋n / d = -\lfloor n/|d| \rfloorn/d=−⌊n/∣d∣⌋ and n mod d∈[0,∣d∣)n \bmod d \in [0, |d|)nmodd∈[0,∣d∣). For d=0d = 0d=0: n/0=0n / 0 = 0n/0=0 and n mod 0=nn \bmod 0 = nnmod0=n.
  • Truncated division tdiv⁡(n,d)\operatorname{tdiv}(n,d)tdiv(n,d) with remainder tmod⁡(n,d)=n−d⋅tdiv⁡(n,d)\operatorname{tmod}(n,d) = n - d\cdot\operatorname{tdiv}(n,d)tmod(n,d)=n−d⋅tdiv(n,d): the quotient is rounded toward zero, so the remainder is 000 or has the sign of nnn, with ∣tmod⁡(n,d)∣<∣d∣|\operatorname{tmod}(n,d)| < |d|∣tmod(n,d)∣<∣d∣ (e.g. tdiv⁡(−7,2)=−3\operatorname{tdiv}(-7,2) = -3tdiv(−7,2)=−3, tmod⁡(−7,2)=−1\operatorname{tmod}(-7,2) = -1tmod(−7,2)=−1). For d=0d = 0d=0: tdiv⁡(n,0)=0\operatorname{tdiv}(n,0) = 0tdiv(n,0)=0, tmod⁡(n,0)=n\operatorname{tmod}(n,0) = ntmod(n,0)=n.
  • Rational division in Q\mathbb QQ, with the convention q/0=0q / 0 = 0q/0=0. For q∈Qq \in \mathbb Qq∈Q, ⌊q⌋\lfloor q \rfloor⌊q⌋ is the greatest integer ≤q\le q≤q and ⌈q⌉\lceil q \rceil⌈q⌉ the least integer ≥q\ge q≥q.

Below, [P][P][P] denotes 111 if the condition PPP holds and 000 otherwise.

FeeFrac. A FeeFrac is a pair X=(fee(X),size(X))X = (\mathrm{fee}(X), \mathrm{size}(X))X=(fee(X),size(X)) of two arbitrary integers. Nothing constrains them: either component may be zero or negative, and no machine-word bounds are imposed. Addition and subtraction are componentwise,

X±Y=(fee(X)±fee(Y), size(X)±size(Y)),X \pm Y = \big(\mathrm{fee}(X) \pm \mathrm{fee}(Y),\ \mathrm{size}(X) \pm \mathrm{size}(Y)\big),X±Y=(fee(X)±fee(Y), size(X)±size(Y)),

and the zero FeeFrac is (0,0)(0,0)(0,0). A chunk list is a finite list c=[c1,…,cn]c = [c_1, \dots, c_n]c=[c1​,…,cn​] of FeeFracs; the empty list (n=0n = 0n=0) is allowed.

byRatioCmp. For FeeFracs X,YX, YX,Y, byRatioCmp(X,Y)\mathrm{byRatioCmp}(X, Y)byRatioCmp(X,Y) is the three-way comparison of the two integers fee(X)⋅size(Y)\mathrm{fee}(X)\cdot\mathrm{size}(Y)fee(X)⋅size(Y) and fee(Y)⋅size(X)\mathrm{fee}(Y)\cdot\mathrm{size}(X)fee(Y)⋅size(X):

byRatioCmp(X,Y)={ltif fee(X) size(Y)<fee(Y) size(X),eqif they are equal,gtif fee(X) size(Y)>fee(Y) size(X).\mathrm{byRatioCmp}(X,Y) = \begin{cases}\mathrm{lt} & \text{if } \mathrm{fee}(X)\,\mathrm{size}(Y) < \mathrm{fee}(Y)\,\mathrm{size}(X),\\ \mathrm{eq} & \text{if they are equal},\\ \mathrm{gt} & \text{if } \mathrm{fee}(X)\,\mathrm{size}(Y) > \mathrm{fee}(Y)\,\mathrm{size}(X).\end{cases}byRatioCmp(X,Y)=⎩⎨⎧​lteqgt​if fee(X)size(Y)<fee(Y)size(X),if they are equal,if fee(X)size(Y)>fee(Y)size(X).​

No sign condition on the sizes is part of the definition. In particular, byRatioCmp(X,(0,1))\mathrm{byRatioCmp}(X, (0,1))byRatioCmp(X,(0,1)) is the comparison of fee(X)\mathrm{fee}(X)fee(X) with 000, independent of size(X)\mathrm{size}(X)size(X).

ratio. ratio(X)=fee(X)/size(X)∈Q\mathrm{ratio}(X) = \mathrm{fee}(X) / \mathrm{size}(X) \in \mathbb Qratio(X)=fee(X)/size(X)∈Q (rational division; equals 000 when size(X)=0\mathrm{size}(X) = 0size(X)=0). For rationals p,qp, qp,q, compare(p,q)\mathrm{compare}(p, q)compare(p,q) is lt\mathrm{lt}lt, eq\mathrm{eq}eq or gt\mathrm{gt}gt according as p<qp < qp<q, p=qp = qp=q or p>qp > qp>q.

Human review
  • Endorsed by Shuze Chen · Oct 30, 2026

    Confirmed by the moderator at approval.

  • Endorsed by pitimespi · Oct 30, 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