This repository is a working research package for settling the smooth-domain Reed--Solomon mutual correlated agreement (MCA) and proximity-list questions that arise in the Proximity Prize program.
See the related IACR ePrint paper. Visit the project's website.
The central theme is simple:
Smooth multiplicative Reed--Solomon domains do not appear to have a clean “up to capacity with negligible error” theorem. They have a corrected reserve theory. Any near-capacity theorem must clear explicit entropy, quotient, field-accounting, list-size, and MCA/line-decoding floors.
The repo is meant for people and AI agents who want to help turn that corrected theory into proofs, counterexamples, parameter certificates, and eventually protocol-grade statements.
The core repo consists of four main papers, one prize-facing theorem note, and two guide files. .tex versions are in tex folder, .pdf are in the root folder and Python scripts for heuristics are in scripts folder.
| File | Short name | Role |
|---|---|---|
RS_disproof_v3.tex |
Paper A: no-slack obstruction | Refutes the unslacked, support-wise line-MCA reading of “up to capacity” for smooth multiplicative RS domains. Provides explicit lower-bound mechanisms and deployed-field obstructions. |
slackMCA_v4.tex |
Paper B: slack / quotient / entropy theory | Main theory paper. Builds the corrected reserve framework and now promotes the solved high-agreement line/list/curve boundary layer into the main theory. |
cs25_cap_v12.tex |
Paper D: two-sided cap, safe-side pincer, and certificate grammar | This is the main Proximity Prize submission reference. It keeps the self-contained cap route and adds the safe-side pincer, deployed-row two-sided intervals, map/rational smooth extensions, circle/genus-one transports, explicit witness machinery, optimized failure profile, and certificate grammar v2. |
snarks_v5.tex |
Paper C: SNARK ledger | Turns the corrected theory into a protocol-facing certificate and adds a theorem-backed high-agreement ledger compiler for line/list/curve coding numerators. |
towards-prize.tex |
Towards Prize: sparse threshold note | Compact prize-facing note. It packages the delta^* staircase viewpoint, deployed KoalaBear pincer, and the new sparse residual reduction emca = max(eca, sigma_C/q) into the current execution target. |
README.md |
Repo overview | Explains what the papers do, how they depend on each other, and what the project is trying to prove. |
AGENTS.md |
Research-agent guide | Gives AI agents and new contributors a prioritized list of proof targets, toy cases, scripts, and “do not confuse these” rules. |
The paper-letter order follows the internal blueprint: A = no-slack, B = slack theory, C = SNARK ledger, D = universal cap. The logical reading order is usually A → B → D → C.
Let C = RS[F, D, k], where D is a smooth multiplicative domain, usually a subgroup or multiplicative coset of power-of-two order n, and rho = k/n is one of
rho in {1/2, 1/4, 1/8, 1/16}.
The Proximity Prize regime asks for sharp thresholds near capacity, especially for target error
epsilon* = 2^-128,
k <= 2^40,
|F| < 2^256.
There are two linked threshold problems.
- MCA / correlated-agreement threshold. Determine how close the radius
deltacan get to1 - rhowhile the MCA error remains negligible. - Interleaved-list threshold. Determine how close
deltacan get to1 - rhowhile the relevant interleaved list size is at most a negligible fraction of the challenge field.
These are protocol-relevant because many proximity/SNARK reductions have a soundness term schematically like
MCA_error(C, delta) + |interleaved_list(C, delta)| / |challenge field| + query_error.
A list theorem alone is not enough unless it is connected to the exact MCA, CA, line-decoding, or curve-MCA quantity used by the protocol.
The old hoped-for statement was roughly:
Smooth-domain Reed--Solomon codes should behave well all the way up to capacity, provided the field is large enough.
The corrected picture is:
Smooth-domain Reed--Solomon codes have explicit near-capacity obstruction floors. A positive theorem must work at radius
1 - rho - eta, whereetaclears every known floor and every protocol ledger.
The ledgers that must be separated are:
- Generated-field entropy. The list/locator entropy denominator is the field generated by the domain and the received word, not automatically the large extension challenge field.
- Quotient-core obstructions. Smooth domains have quotient fibers. If
kandnalign with large quotient scales, large lists or bad slopes can appear. - Locator-fiber list size. Base-code locator fibers must be bounded before they can be used in a protocol list budget.
- Interleaved list size. The protocol often consumes
|Lambda(Int(C, mu), delta)|, not merely the base-code list size. - Challenge-field division. The list term is divided by the field in which the verifier samples the relevant challenge. Do not silently replace this by a larger or smaller field.
- MCA / CA / line-decoding / curve-MCA. These are related but not interchangeable without a theorem.
- Known failure ladders and universal caps. Some gaps are ruled out by explicit lower bounds or by the universal cap.
The current public paper set is A v3, B v4, D v12, C v5, plus the compact towards-prize threshold note. The version changes matter for the website and scanner as follows:
- Paper B v4 promotes the high-agreement tangent/list/curve boundary layer
from experimental notes into the main theory. Public tangent and
interleaved-list high-agreement rows should now cite
slackMCA_v4.texwhen they use this theorem package. - Paper D v12 is the main Proximity Prize submission reference. It keeps the headline universal MCA cap self-contained, adds a two-sided threshold sandwich, proves the deep-regime safe theorem and MCA-from-CA pincer, extends the cap machinery to map/rational smooth domains, and packages deployed-row claims in certificate grammar v2. Auditing this paper is currently the main project focus.
- Paper C v5 adds the theorem-backed high-agreement ledger compiler for protocol-facing line/list/curve numerator accounting. It changes certificate packaging and denominator checks, not the mathematical value of the MCA cap rows.
towards-prize.texis a compact companion to Paper D v12, not the final submission authority. It does not add a new leaderboard row by itself. Its role is to state thedelta^*staircase problem compactly, record the deployed KoalaBear pincer, and reduce the remaining MCA task to the sparse residual layer plus CA/list certificates.
Paper A: no-slack obstruction
|
v
Paper B: slack / entropy / quotient-core theory
|\
| \__ Paper D: self-contained MCA universal cap
|
v
Paper C: SNARK/protocol ledger consuming B and D
RS_disproof_v3.tex is the base lower-bound paper.
It shows that the no-slack, support-wise line-MCA version of the up-to-capacity conjecture is false for smooth multiplicative RS domains. The organizing mechanism is the quotient locator identity: restricted sums in a smooth quotient subgroup produce many bad slopes for lines of the form
x^(k+a) + z x^k.
The paper gives explicit consequences over common smooth prime fields such as BabyBear, KoalaBear, 3*2^30+1, and Fermat-prime examples. Its role in the repo is to be the lower-bound oracle: if a proposed theorem contradicts Paper A’s obstruction intervals, the theorem is false or missing a reserve hypothesis.
slackMCA_v4.tex is the main theory paper.
It generalizes the obstruction into a corrected positive/negative theory. It separates:
- generated-field entropy floors,
- quotient-core list obstructions,
- characteristic-zero rigidity and finite-field collision sieves,
- exact slack bad-slope calculus,
- dyadic descent and failure ladders,
- tangent and quotient-periodic MCA floors,
- residue-line normal forms,
- local-limit conjectures for list decoding and MCA.
Version v4 additionally closes the theorem-backed high-agreement boundary layer:
affine/projective line and no-loss CA numerators are exact in the tangent range,
interleaved lists are unique in their high-agreement range, and degree-d
finite power-curve ledgers have a proved upper envelope with split moving-root
exactness.
Paper B is where most new mathematics should land. It contains the theorem/conjecture shape for a corrected reserve theorem: not “up to capacity,” but “up to capacity minus every explicit floor.”
cs25_cap_v12.tex is the main Proximity Prize submission reference.
It keeps the self-contained universal MCA cap:
delta*_C(2^-128) <= 1 - rho - 2^-9 for rho in {1/2, 1/4, 1/8},
delta*_C(2^-128) <= 1 - rho - 2^-10 for rho = 1/16,
throughout the challenge range |F| < 2^256, with the stated smoothness/divisibility hypotheses. It gives error > 2^-86 uniformly and improves to > 2^-42 when |F| >= 2n.
Version v10 also contains the large-row first-grid cap. For the official
rates, once k is at least 127, 78, 58, 47 respectively and q>n, the first
closed grid point below capacity is already CA/MCA unsafe:
delta*_C(2^-128) <= 1 - rho - 1/n.
It also adds the current safe-side and certificate package: a deep-regime MCA safe theorem for all linear codes, a reduction from MCA to CA up to half the minimum distance, a self-contained half-Johnson CA bound, map-smooth and rational-smooth cap extensions, circle/genus-one transports, explicit witness machinery, an optimized failure profile, and finite certificate grammar v2.
Paper D supersedes the older internal cap in Paper B for final constants. Paper B keeps its native quotient-core cap because it explains the mechanism; Paper D v12 owns the current field-size-universal and two-sided cap package, and is the canonical source for final submission hypotheses, denominators, endpoint conventions, and proof status.
Version v12 supersedes v10/v11 as the active draft. The main remaining work is audit: check the direct conversion/radius conventions, the optional BCIKS half-distance import, exact-integer certificate replay paths, and the precise scope of the circle/genus-one model transfers.
snarks_v5.tex turns the corrected theory into a protocol-facing reserve certificate.
Its purpose is not to prove all missing MCA/list theorems. Its purpose is to prevent protocol analyses from mixing ledgers. In particular, it insists on distinguishing:
- base field vs generated field vs extension challenge field,
- implementation interleaving vs protocol list arity,
- base-code lists vs interleaved lists,
- CA vs MCA vs line-decoding vs curve-MCA,
- theorem-backed mode vs conjectural aggressive mode vs obstruction-audit mode.
Version v5 also adds the high-agreement ledger compiler: before invoking near-capacity conjectures, a protocol certificate can first check the exact line/list/curve numerator formulas in the small-radius theorem-backed range.
Paper C is the bridge from theory to systems. Once the missing local-limit and line/MCA statements are proved, Paper C should become a compiler from a code/domain tuple to a soundness certificate.
A rough status map:
| Topic | Current status |
|---|---|
| No-slack smooth-domain MCA obstruction | Proved in Paper A. |
| Explicit deployed-field lower-bound floors | Proved in Paper A/B for the stated regimes. |
| Quotient-core list obstructions | Proved in Paper B. |
| Exact slack calculus and many failure ladders | Proved in Paper B. |
| Universal field-size MCA cap | Proved in Paper D v12 under its printed divisor/binomial/subfield hypotheses. |
| First-grid and widened deployed-row MCA caps | Proved in Paper D v12 under its printed k, q>n, subfield, and certificate hypotheses. |
| Safe-side pincer and two-sided threshold sandwich | Proved self-contained up to the deep/half-Johnson edges; half-distance edge depends on the isolated BCIKS import. |
| Map/rational smooth, circle, and genus-one extensions | Proved in Paper D v12 under its stated model hypotheses; these are high-priority audit targets. |
| Certificate grammar and printed deployed certificates | Stated in Paper D v12; every "verified exactly" inequality should have a reproducible script or printed integer certificate. |
| Generated-field locator local limit above all floors | Open. Main list-side positive theorem target. |
| Corrected MCA / residue-line local limit above all floors | Open. Main MCA-side positive theorem target. |
| Line-decoding formulation of corrected MCA | Open. Important for protocols. |
| Extension-line MCA transfer | Open: prove a clean lift or find counterexamples. |
| Sharp interleaved-list constants near capacity | Open. Important for protocol soundness budgets. |
| Protocol-level FRI/WHIR ledger rewrites | Open engineering/proof task. |
| Certificate scanner | Prototype in experimental/notes/certificate_scanner/; emits JSON/Markdown A/B/C/D ledger reports. |
Good first contributions include:
- Proof audits. Verify individual lemmas and theorem dependencies in the four papers. Flag any hidden field-size, divisibility, monotonicity, or support-wise assumptions.
- Scripted certificates. Implement scanners for entropy reserve, quotient profiles, restricted sums, interleaved-list budgets, and challenge-field accounting.
- Toy-case exploration. Exhaust small fields/domains to discover or refute local-limit behavior.
- Paper D v12 audit. Check direct conversion/radius conventions, ABF normalization, the optional BCIKS import, exact-integer certificates, and circle/genus-one model transfers.
- Hankel certificates. Use
scripts/aperiodic_eliminant_schema.jsonto package exact-agreement eliminants, empty chart certificates, or named residual obstructions for the Paper D v12 certificate grammar. - New bounds. Attack the local-limit conjectures, interleaved-list constants, extension-line MCA, or domain-shattering alternatives.
- Protocol rewrites. Rewrite FRI, WHIR, or other proximity reductions in the exact ledger format of Paper C.
See AGENTS.md for a prioritized task list and suggested toy cases.
The first heuristic script is scripts/run_frontier.py, an EXPERIMENTAL Paper B frontier scanner. For each prime p passed on the command line, intended with 32 | p-1, it builds the order-32 multiplicative subgroup of F_p, uses a meet-in-the-middle subset enumeration at fixed l = 18, and records which elementary-symmetric fingerprints (e1, e2) are realized by l subgroup elements. Its coverage line measures how much of F_p^2 this restricted quotient-locator map hits and appends the result to frontier_results.txt; full coverage is evidence about quotient/restricted-sum frontier behavior, not a proof by itself. The script currently requires numpy and sympy.
The certificate scanner prototype lives in
experimental/notes/certificate_scanner/. It reads a row/config JSON and emits
both a machine-readable report and a Markdown audit for generated-field entropy,
exact-divisibility quotient profile, Paper D cap hypotheses, high-agreement
line/list/curve ledgers, and the combined protocol-ledger verdict. It is a
ledger-audit tool, not a proof of extension-line MCA, arbitrary-word locator
local limits, aperiodic Hankel-pencil packing, or deployed protocol soundness.
The aperiodic Hankel certificate schema lives at
scripts/aperiodic_eliminant_schema.json. It is for Paper D v12 certificate
packets: row and domain hash, exact agreement levels, removed tangent/quotient
ledgers, regular minors, pivot charts, eliminants, empty-chart proofs,
dimension-degree fallbacks, and named residual obstructions.
The broader intended script layer is:
scripts/
run_frontier.py # EXPERIMENTAL psi_2 restricted-subset frontier scan
entropy_margin.py # generated-field entropy reserve
quotient_profile.py # active quotient scales at actual (n, k, a)
restricted_sum_dp.py # restricted-sum / DSH verification certificates
locator_fiber_scan.py # small-field locator-fiber experiments
mca_slope_scan.py # small-field bad-slope / residue-line experiments
interleaved_budget.py # base/interleaved list-to-field soundness budget
certificate_emit.py # JSON + TeX certificate tables for Paper C
aperiodic_eliminant_schema.json
# Paper D v12 Hankel eliminant certificate schema
experimental/notes/certificate_scanner/
certificate_scanner.py # EXPERIMENTAL A/B/C/D + high-agreement ledger scanner
examples/*.json # reproducible row configs
outputs/*.report.{json,md} # replayable scanner outputs
A useful script should emit both human-readable output and a machine-checkable certificate. Hand-computed tables should eventually be replaced by script output.
Use these conventions when adding results:
rho = k/nis the rate.delta = 1 - rho - etais the proximity radius.etais the reserve/gap from capacity.q_genis the field generated by the domain/received-word data.q_lineis the field from which line or CA/MCA challenges are sampled.q_chalis the verifier challenge field; it may or may not equalq_line.muis protocol list arity.nuis implementation interleaving.Qprofis the quotient-profile obstruction ledger.
When in doubt, keep the fields separate. Most false near-capacity claims come from giving the same field-size credit to two different ledgers.
When editing the papers:
- Cite companion results with theorem/proposition numbers, not just “the companion proves.”
- Mark every result as proved, conditional, conjectural, experimental, or audit-only.
- Cite the main Paper D v12 MCA cap, safe-side pincer, and certificate grammar as the active Paper D package, under their printed hypotheses and audit caveats.
- Do not state an error-one result from Paper D’s cap; Paper D caps the threshold and gives a small certified failure probability, but the error-one-in-the-band problem remains open.
- Keep Paper D as the canonical reference for the final universal-cap constants.
- Keep Paper C as the canonical reference for protocol ledgers and field-accounting rules.
The goal is to settle the Proximity Prize MCA/list questions for smooth-domain Reed--Solomon codes in a way that is useful for proof systems.
A positive outcome would be a theorem-backed reserve certificate: given a domain, rate, field, interleaving, and protocol reduction, the repo can certify a near-capacity radius and soundness budget.
A negative outcome is also valuable: every obstruction becomes a new floor, a warning for protocol designers, or a reason to switch to folded/subspace-design codes, random/punctured domains, or domain-shattered constructions.
Either way, the aim is to replace folklore “near-capacity RS should work” claims with exact, checkable mathematics.
The current work was done with GPT-5.5 Pro and Claude Fable 5 and still needs proper revision. Human input is welcome.