Lean 4로 형식 검증하는 Rust 웹 프레임워크 h5i, 인증·인가 성질을 수학적으로 증명한다
800스타를 넘긴 형식 검증 웹 프레임워크
Rust製 웹 프레임워크 h5i(h5i-dev/h5i)가 GitHub 스타 800개를 돌파했습니다. 작성자 Koukyosyumei의 X 포스트(2026-10-26 21:51) 발표 기준이며, 10월 27일 확인 시점의 실측 스타 수는 856개입니다. Axum 기반 프레임워크이며, 라이선스는 Apache-2.0, 주 언어는 Rust, 레포 생성일은 2026-03-11입니다. crates.io에는 h5i-app(0.1.3)도 공개돼 있습니다.
핵심 아이디어는 단순합니다. 웹 앱의 비즈니스 로직을 Rust에서 Lean 4로 변환해, 그 성질을 수학적으로 증명하는 것입니다. README 기준 변환에는 Aeneas를 사용합니다. 애플리케이션 로직과 인프라를 분리하는 verifiable application kernel 구조가 전제이며, 검증 대상은 핵심 로직으로 한정됩니다.
테스트 통과와 증명은 보증 수준이 다릅니다
2026년은 AI 에이전트가 수 분 만에 웹 앱을 만드는 시대가 됐습니다. 하지만 테스트를 수천·수만 개 통과해도 프로그램이 옳다는 보장은 되지 않습니다. 테스트는 실행해 본 경우에 대해서만 말해주고, 실행하지 않은 입력에 대해서는 침묵합니다. h5i는 이 간극을 형식 검증으로 메우려는 시도입니다.
기존 Rust 생태계를 그대로 쓰면서 핵심 로직만 Lean 4로 검증한다는 점이 실무 도입의 문턱을 낮춥니다. 앱 전체를 증명 언어로 다시 쓰는 방식이 아니라, 틀리면 보안 사고로 직결되는 부분만 골라 증명하는 방식입니다. 프레임워크 외에도 브라우저 자동화, 레드티밍, 보안 회귀 테스트, 샌드박스 AI 에이전트용 통합 개발 인프라를 함께 제공합니다.
무엇을 증명하는가
README가 제시하는 검증 대상 성질은 인증·인가, 세션·토큰 관리, 입력 검증, 데이터 무결성 등입니다. 하나하나가 실무에서 사고로 이어지기 쉬운 영역입니다. 권한 검사가 한 경로에서 빠지면 인가 우회가 되고, 토큰 만료 처리가 어긋나면 세션 탈취로 이어집니다.
| 검증 대상 | 증명이 다루는 질문 |
|---|---|
| 인가·인증 | 권한 없는 주체가 보호 자원에 도달할 수 없는가 |
| 세션·토큰 관리 | 발급·만료·무효화 규칙이 모든 경로에서 지켜지는가 |
| 입력 검증 | 허용되지 않은 입력이 핵심 로직에 닿지 않는가 |
| 데이터 무결성 | 저장·전달 과정에서 데이터가 의도대로 유지되는가 |
여기서 증명의 단위를 정확히 이해하는 것이 중요합니다. 증명되는 것은 명시적으로 정의한 성질뿐입니다. 정의하지 않은 성질은 증명되지 않으며, 정의 자체가 틀렸으면 증명은 틀린 정의를 보증할 뿐입니다.
벤치마크 수치와 미확인 주의
포스트가 제시한 벤치마크 수치 — 6개 OSS 웹 앱 재작성, 1만 행 가까운 코어 로직, 300개 이상 성질 증명, 원본 구현의 버그 4건 발견 — 는 작성자 주장 단계로, 레포 README와 공개 문서에서 직접 대조하지 못했습니다. 이 글에서는 미확인으로 다룹니다.
수치가 사실이라면 의미가 큽니다. 300개가 넘는 성질을 증명하고 원본 버그 4건을 찾았다는 주장은, 형식 검증이 연구실 데모를 넘어 실제 코드베이스에서 동작했다는 신호가 되기 때문입니다. 하지만 대조가 되지 않은 상태에서는 이 수치를 근거로 도입을 정당화해서는 안 됩니다. 수치는 참고 수준으로 두고, 실제 판단은 레포의 코드와 증명 사례를 직접 확인한 뒤에 내리는 것이 순서입니다.
형식 검증의 한계도 작성자가 인정합니다
형식 검증 자체의 한계도 작성자가 인정합니다. 증명되는 것은 명시적으로 정의한 성질뿐이고, 스펙 누락이나 과도한 가정, 검증 대상 밖 코드에는 별도 대책이 필요합니다. 증명은 스펙의 정확성을 보증하지 않습니다. 스펙이 현실과 어긋나면, 증명된 코드도 현실에서는 틀릴 수 있습니다.
GPU 가속도 범용 기능이 아닙니다. 지원되는 커널에 한정된 선택 기능으로, 범용 가속으로 읽어서는 안 됩니다. 형식 검증 프레임워크의 본질은 가속이 아니라 보증이며, 부가 기능의 범위를 과장하지 않는 것이 중요합니다.
실무 판단: 전수 적용이 아니라 파일럿 1개로
실무 판단은 이렇게 정리됩니다. 모든 코드 프로젝트에 h5i를 전수 적용하지 않습니다. 보안이 핵심인 신규 Rust 웹 서비스 1개를 파일럿 후보로 삼고, 기존 프로젝트에는 프로퍼티 테스트와 불변식 검사로 개념만 차용하는 것이 현실적인 순서입니다. 현 프로젝트 스택과 맞지 않는 기술을 전수 도입하면 재작성 수준의 비용이 들기 때문입니다.
파일럿을 고를 때는 기준을 먼저 정하는 것이 좋습니다. 인증·인가·세션처럼 틀리면 사고가 되는 로직이 중심인지, 핵심 로직을 인프라에서 분리할 수 있는지, 증명할 성질을 문장으로 또렷하게 쓸 수 있는지가 기준이 됩니다. 세 가지가 모두 또렷하지 않으면, 파일럿 단계에서 증명 대상을 좁히는 것이 먼저입니다.
반대로, 당장 도입하지 않더라도 가져갈 교훈은 분명합니다. 테스트 통과를 최종 보증으로 보지 않고, 핵심 성질을 문장으로 정의해 두는 습관 자체가 코드 품질을 바꿉니다. 성질을 정의할 수 없는 로직은, 증명 여부를 떠나 설계가 모호하다는 신호일 수 있습니다.
아직 확인되지 않은 것들
- 벤치마크 수치(6개 앱·1만 행·300개 이상 성질·버그 4건)는 작성자 주장 단계로, 공개 문서에서 직접 대조하지 못했습니다.
- 스펙 누락·과도한 가정·검증 대상 밖 코드에 대한 대책은 작성자가 한계로 인정한 부분이며, 구체적인 해소 방법은 별도 확인이 필요합니다.
- GPU 가속의 실제 적용 범위는 지원 커널에 한정되며, 범용 가속 여부는 확인되지 않았습니다.