/ mm0 Public

Metamath Zero specification language

You must be signed in to change notification settings

# digama0/mm0

## Folders and files

NameName
Last commit message
Last commit date

# Metamath Zero

The MM0 project consists of a number of tools and verifiers and a specification centered on the language Metamath Zero.

## Quick Start

There are a bunch of interrelated projects in this repository. If you want to install something to play with, I recommend `mm0-rs` + `vscode-mm0` to get a decent MM0 IDE. There is also a video tutorial for this combination.

## Introduction

Metamath Zero is a language for writing specifications and proofs. Its emphasis is on balancing simplicity of verification and human readability of the specification. That is, it should be easy to see what exactly is the meaning of a proven theorem, but at the same time the language is as pared down as possible to minimize the number of complications in potential verifiers.

The language was inspired by Metamath and Lean, two proof languages at opposite ends of a spectrum.

• Metamath is a logical framework with a focus on simplicity of the verifier and as a result a multitude of different verifiers exist for it. It has a strong specification, and proof checking is seriously fast (on the order of 1-10s to check the entire considerable library set.mm).

However, it suffers from a number of soundness issues. These are not bugs because the verifier checks exactly what it claims, but rather issues with the semantics of a reasonable Metamath axiomatization.

• Proof expressions in Metamath are strings of symbols, not trees. This is good for verification speed because computers can handle strings well, but it means that if the input expression grammar is ambiguous (and Metamath does not check this), then it is possible for proofs to take advantage of this and possibly derive a contradiction. (So one can view this as a kind of analogue to C "undefined behavior" in that the verifier is not checking this condition but needs it for the intended model to work.)
• Definitions are just axioms in Metamath. There are tools in the Metamath ecosystem to check that definitions are conservative, but they are not built in to the verifier and yet are important for the semantic model.
• Lean is an interactive theorem prover based on dependent type theory. It has a robust tactic interface and a server mode for interacting with text editors to give live feedback, which helps considerably with proof authoring.

However, it uses a very strong axiomatic framework, which cannot be "turned off", so it's not easy to verify proofs in a weak logic except by deep embedding, where many of the tactic features no longer apply. It is also monolithic - there is only one program that can read `.lean` files (although it does have an export format which can be checked by an external typechecker), and this program is huge and full of bugs. (To date, there have been no proofs of false in the most paranoid mode, but verification of the full program is impractical.)

Metamath Zero aims to be Metamath without the verification gaps. It is interpretable as a subset of HOL, but with checking times comparable to Metamath. On the other hand, because there is no substitute for human appraisal of the definitions and the endpoint theorems themselves, the specification format is designed to be clear and straightforward, and visually resembles Lean.

We embrace the difference between fully explicit proofs that are verified by a trusted verifier, and proof scripts that are used by front-end tools like Lean to generate proofs. Metamath Zero is focused on the proof side, with the expectation that proofs will not be written by hand but rather compiled from a more user friendly but untrusted language. So MM0 proofs tend to be very verbose and explicit (but not repetitive, because that is a performance issue).

The goal of this project is to build a formally verified (in MM0) verifier for MM0, down to the hardware, to build a strong trust base on which to build verifiers for more mainstream languages or other verified programs. This has lead to a number of subprojects that are contained in this repository.

## Metamath One and Metamath Zero

Metamath zero is a specification-only language, and it is paired with proofs with a defined theory but an implementation-defined concrete syntax. Currently the lisp-like MMU format and the binary MMB format are supported by `mm0-rs` and `mm0-hs`, and the `mm0-c` verifier supports only MMB. But neither of these is intended for being written by humans. If MM0 is the specification, then these are the compiled program meeting the specification.

But then what plays the role of the source text in this analogy? Metamath One is a language which extends the syntax of MM0 with the ability to write proofs, including elaboration and unification, and with a metaprogramming environment to allow the writing of tactics. The result of processing an MM1 file is an MM0 specification file and a MMU or MMB proof file (alternatively, an MM0 file can be written separately and matched against the MM1 file). Because the process is proof producing, it need not be trusted.

The MM1 files in the `examples/` directory have been written using the VSCode extension, which uses the Language Server Protocol to communicate to `mm0-rs server` (`mm0-rs` can also communicate to any other LSP-compliant editor), which enables support for syntax highlighting, go-to-definition and hover. Most importantly, it supports live diagnostics (red squiggles on errors), which allows for rapid feedback on proof progress. (The interface is strongly inspired by `vscode-lean`.)

## What you will find in this repository

• `mm0.md` is an informal specification of the language.
• The `examples/` directory contains a number of MM0 test files.
• `mm0-rs` is a compiler and LSP server for MM1.
• `mm1.md` is a description of the MM1 language (this is in the `mm0-hs` directory but it is up to date for `mm0-rs`).
• `mm0-rs compile` can be used to run an MM1 file to produce an MMU or MMB output. If there are errors in the file, it will provide similar information to the server mode.
• `mm0-rs server` is not meant to be used directly, but starts the program in server mode, where it sends and receives JSON data along stdin and stdout according to the LSP specification. This is used by the `vscode-mm0` extension.
• `mm0-c` is a verifier written in C that defines the MMB binary proof file format.
• `mmb.md` is an informal specification of the MMB format.
• You can compile the verifier using `gcc main.c -o mm0-c`, and run it with `./mm0-c file.mmb`.
• The `mm0-hs` program is a verifier written in Haskell that contains most of the "tooling" for MM0. Most importers and exporters are implemented as subparts of this program. See `mm0-hs/README.md` for a more complete description of capabilities.
• `mm1.md` is a description of the MM1 language.
• `mm0-hs verify` can be used to check a MM0 specification and MMU proof.
• `mm0-hs export` will translate an MMU file to MMB format.
• `mm0-hs compile` can be used to run a MM1 file to produce an MMB output, similar to `mm0-rs`. (However, the MM1 implementation is out of date and this will not work on most mm1 files in the examples directory).
• `mm0-hs server` is also similar to `mm0-rs server` and also out of date.
• `mm0-hs from-mm` performs wholescale translations from Metamath to MM0 + MMU or MM0 + MMB. This is the best way to obtain a large test set, because `set.mm` is quite large and advanced.
• `mm0-hs to-hol` will show MM0 theorems and proofs in HOL syntax. Currently the syntax is only meant to be somewhat representative of a HOL based system; this is mostly a IR for other translations.
• `mm0-hs to-othy` will translate MM0 theorems into OpenTheory, which can be further translated into production systems including HOL Light, HOL4, ProofPower and Isabelle. (Unfortunately there is a ~30x blow up in this translation due to limitations of the OpenTheory axiom system. It is possible that the secondary targets can obtain better results by a direct translation.)
• `mm0-hs to-lean` translates MM0 into Lean source files.
• `mm0-lean` contains a tactic framework for writing MM0 proofs using Lean. [WIP]
• `mm0-lean/x86.lean` is a Lean formalization of the Intel x86 semantics.
• `vim` contains some basic vim files for syntax coloring. Copy them into `\$HOME/.vim/` (e.g. with `cp -r vim/* ~/.vim/`) to install them.

## Third party MM0 verifiers

Since MM0 has a simple specification, there have been a few alternative verifiers written for MM0. (I (@digama0) am not directly affiliated with these verifier projects, and some of them are in WIP status. See the linked repositories for more information.)

Metamath Zero specification language

## Releases

No releases published

## Packages 0

No packages published