https://github.com/pulseengine/rules_rocq_rust
Bazel rules for Rocq theorem proving and rocq-of-rust integration with hermetic Nix toolchains
https://github.com/pulseengine/rules_rocq_rust
bazel formal-verification pulseengine rocq rust theorem-proving toolchain
Last synced: 3 months ago
JSON representation
Bazel rules for Rocq theorem proving and rocq-of-rust integration with hermetic Nix toolchains
- Host: GitHub
- URL: https://github.com/pulseengine/rules_rocq_rust
- Owner: pulseengine
- License: other
- Created: 2026-01-11T12:30:35.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-03-01T11:39:19.000Z (3 months ago)
- Last Synced: 2026-03-01T14:57:23.570Z (3 months ago)
- Topics: bazel, formal-verification, pulseengine, rocq, rust, theorem-proving, toolchain
- Language: Starlark
- Homepage: https://rules-rocq-rust.pulseengine.eu/
- Size: 310 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# rules_rocq_rust
Bazel rules for Rocq theorem proving and Rust formal verification
Bazel rules for Rocq theorem proving and Rust formal verification with hermetic toolchain support via [Nix](https://nixos.org/).
> [!NOTE]
> Part of the PulseEngine toolchain. Powers the mechanized proofs in Meld, Loom, and PulseEngine verification infrastructure.
## Features
- **Rust to Rocq to Proofs**: Complete pipeline from Rust code to verified proofs
- **rocq-of-rust Integration**: Translate Rust to Rocq via [rocq-of-rust](https://github.com/formal-land/rocq-of-rust)
- **Hermetic Toolchains**: Rocq 9.0, coqutil, Hammer, smpl via nixpkgs
- **Cross-Platform**: Linux, macOS (Intel and Apple Silicon)
- **Bazel 8 bzlmod**: Modern module system support
## Prerequisites
### Nix (Required)
```bash
# macOS
sh <(curl -L https://nixos.org/nix/install)
. /nix/var/nix/profiles/default/etc/profile.d/nix-daemon.sh
# Linux
sh <(curl -L https://nixos.org/nix/install) --daemon
```
### Rust Nightly (Linux only)
On Linux, rocq-of-rust requires Rust nightly with rustc internals:
```bash
rustup toolchain install nightly-2024-12-07
rustup component add rustc-dev rust-src --toolchain nightly-2024-12-07
export LIBRARY_PATH="$(rustc +nightly-2024-12-07 --print sysroot)/lib:$LIBRARY_PATH"
```
On macOS, Nix provides the complete Rust toolchain automatically.
## Quick Start
### 1. Add to MODULE.bazel
```starlark
bazel_dep(name = "rules_rocq_rust", version = "0.1.0")
git_override(
module_name = "rules_rocq_rust",
remote = "https://github.com/pulseengine/rules_rocq_rust.git",
commit = "",
)
# Configure Rocq toolchain
rocq = use_extension("@rules_rocq_rust//rocq:extensions.bzl", "rocq")
rocq.toolchain()
use_repo(rocq, "rocq_toolchains", "rocq_stdlib", "rocq_coqutil", "rocq_hammer", "rocq_hammer_tactics", "rocq_smpl")
register_toolchains("@rocq_toolchains//:all")
# Configure rocq-of-rust
rocq_of_rust = use_extension("@rules_rocq_rust//coq_of_rust:extensions.bzl", "rocq_of_rust")
rocq_of_rust.toolchain(use_real_library = True)
use_repo(rocq_of_rust, "rocq_of_rust_toolchains", "rocq_of_rust_source")
register_toolchains("@rocq_of_rust_toolchains//:all")
```
### 2. Create a Rust file to verify
```rust
// point.rs
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct Point { pub x: i32, pub y: i32 }
impl Point {
pub fn origin() -> Self { Point { x: 0, y: 0 } }
pub fn new(x: i32, y: i32) -> Self { Point { x, y } }
}
```
### 3. Add BUILD.bazel
```starlark
load("@rules_rocq_rust//coq_of_rust:defs.bzl", "rocq_rust_verified_library")
load("@rules_rocq_rust//rocq:defs.bzl", "rocq_library")
rocq_rust_verified_library(
name = "point_verified",
rust_sources = ["point.rs"],
extra_flags = ["-impredicative-set"],
)
rocq_library(
name = "point_proofs",
srcs = ["point_proofs.v"],
deps = [":point_verified"],
extra_flags = ["-impredicative-set"],
)
```
### 4. Build and verify
```bash
bazel build //:point_proofs
```
## API Reference
### rocq_library
Compiles Rocq `.v` files to `.vo`.
| Attribute | Description |
|-----------|-------------|
| `srcs` | Rocq source files (`.v`) |
| `deps` | Dependencies on other `rocq_library` targets |
| `include_path` | Logical path for this library (default: package path) |
| `extra_flags` | Extra flags passed to coqc |
### coq_of_rust_library
Translates Rust source files to Rocq.
| Attribute | Description |
|-----------|-------------|
| `rust_sources` | Rust source files to translate |
| `edition` | Rust edition (default: "2021") |
### rocq_rust_verified_library
Convenience macro: translates Rust to Rocq and compiles.
### rocq_proof_test
Test rule that verifies proofs compile successfully.
## Toolchain Contents
| Component | Description |
|-----------|-------------|
| Rocq 9.0.1 | Core theorem prover |
| coqutil | Utility library |
| Hammer | Automated proof tactics |
| smpl | Simplification tactics |
| rocq-of-rust | Rust-to-Rocq translator (pinned version) |
## Supported Platforms
| Platform | Status |
|----------|--------|
| Linux x86_64 | Supported |
| Linux aarch64 | Supported |
| macOS x86_64 | Supported |
| macOS aarch64 | Supported |
## Troubleshooting
### "unable to find library -lLLVM-19-rust-*" (Linux)
```bash
export LIBRARY_PATH="$(rustc +nightly-2024-12-07 --print sysroot)/lib:$LIBRARY_PATH"
```
### "rustc-dev component not found"
```bash
rustup component add rustc-dev rust-src --toolchain nightly-2024-12-07
```
## Example
See `examples/rust_to_rocq/` for a complete working example:
```bash
bazel build //examples/rust_to_rocq:point_proofs
bazel build //examples/rust_to_rocq:advanced_verified
bazel test //examples/rust_to_rocq:point_proofs_test
```
## License
Apache-2.0 — see [LICENSE](LICENSE).
---
Part of PulseEngine — formally verified WebAssembly toolchain for safety-critical systems