rscrypto

rscrypto는 암호화 프리미티브, 암호화 및 고속 해시, 비밀번호 해싱, 체크섬을 하나의 기능 모델 뒤에 통합합니다. 대상(target)별로 제한된 SIMD 및 어셈블리는 프로덕션 C/FFI, OpenSSL 또는 시스템 라이브러리 의존성 없이 휴대용 Rust 백엔드를 가속화합니다.

rscrypto는 프리미티브 크레이트이며, TLS 스택, PKI 툴킷, 키 저장소 또는 프로토콜 구현이 아닙니다.

측정된 성능

2026-08-18 스냅샷은 8개의 Linux CI 러너에서 각 플랫폼, 프리미티브, 연산 및 입력 형태에 대해 커밋 7eb44e9을 가장 빠른 일치 외부 구현과 비교합니다. 외부 기준선은 경쟁사 간 평균이 아니라 사례별로 선택됩니다. 비율은 external / rscrypto이며, 높을수록 좋습니다.

6,144개의 정확한 사례 비교에서 rscrypto는 3,780건에서 5% 이상 빨랐고, 1,695건에서 5% 이내였으며, 669건에서 더 느렸습니다. 기하 평균 속도 향상은 전체 1.62배였으며, 체크섬 6.18배, RSA 1.65배, AEAD 1.61배, ML-KEM 1.55배를 포함합니다.

차트의 Apple Silicon 결과는 별도의 2026-07-04 로컬 스냅샷이며, Linux 집계에는 포함되지 않습니다.

이는 전체 스위트 리드이지 모든 연산이 승리한다는 주장이 아닙니다. 동일한 스냅샷은 모든 원시 행과 함께 s390x ECDSA 회귀 및 더 느린 rapidhash-stream/one-write 경로를 게시합니다. 배포 워크로드에 결과를 적용하기 전에 전체 성적표는 benchmark overview를, benchmarking guide를 읽으십시오.

보증

보안 주장은 폐쇄적 실패(fail closed) 방식입니다. 누락되거나 오래된 증거는 게이트를 약화시키는 대신 주장을 제거합니다.

• 정확성 증거는 NIST, RFC, 업스트림 및 Wycheproof 벡터를 별도의 구현, 속성, 부정 테스트 및 Miri와 결합합니다.
• 퍼즈 타깃은 프리미티브, 파서, 상태 머신 및 트레이트 경계에 걸쳐 프로덕션 구현을 실행합니다. 최소화된 시드는 별도의 샌나타이저 레인과 함께 테스트로 재생됩니다.
• 휴대용 대 가속화 차등 테스트는 네이티브 타깃에서 길이, 정렬, 테일, 상태 전환, 디스패치 및 폴백 동작을 다룹니다.
• 상수 시간 하네스는 ct.toml의 정확한 연산을 목록화하고, 최적화된 링크 바이너리 검사, 선언된 고정 형태 커널에 대한 BINSEC 증명, 선언된 종단 간 사례에 대한 DudeCT 타이밍 테스트를 결합합니다.
• 고정 크기 비밀 소유자는 Debug를 마스킹하고, 일반 동등성을 생략하며, 드롭 시 소유 바이트를 덮어씁니다. 검증 실패는 불투명하며, 실패한 AEAD 열기는 호출자 출력 버퍼를 지웁니다.

상수 시간 주장은 일치하는 서명 릴리스가 필수 타깃, 기능, 컴파일러, 프로필 및 연산 게이트를 통과하는 입증된 증거 번들을 포함할 때만 존재합니다. 분기 없는 것처럼 보이는 소스는 증거로 취급되지 않습니다. 릴리스 아티팩트는 서명 태그로 게이트되며, crates.io Trusted Publishing을 통해 게시되고 GitHub 빌드 출처 증명(attestations)으로 보호됩니다.

test evidence, constant-time model, secret lifecycle, threat model 및 release contract를 검토하십시오.

남은 독립 검토 격차는 제3자 보안 감사입니다. 프로젝트는 현재 이를 위한 자금을 조달할 수 없습니다. 자동화된 증거는 해당 검토를 대체하지 않으므로, rscrypto는 감사됨, FIPS 140-3 검증됨, 공식적으로 검증됨 또는 크레이트 전체가 상수 시간이라고 주장하지 않습니다.

의심되는 취약점은 공개 이슈가 아닌 SECURITY.md 프로세스에 따라 GitHub Private Vulnerability Reporting을 통해 보고하십시오.

필요한 것만 설치

최소 no_std SHA-2 빌드:

[dependencies]
rscrypto = { version = "0.9", default-features = false, features = ["sha2"] }

OS 난수 활성화를 포함한 전체 프리미티브 스택:

[dependencies]
rscrypto = { version = "0.9", features = ["full", "getrandom"] }

기본 기능은 std이며, default-features = false는 이를 제거합니다. 운영 체제에서 솔트, 키, 논스 또는 RSA 키 생성 엔트로피를 얻는 API에만 getrandom을 활성화하십시오. feature guide는 정확한 의존성과 배포 제어를 담당합니다.

빠른 시작

use rscrypto::Sha256;

let one_shot = Sha256::digest(b"hello world");

let mut hasher = Sha256::new();
hasher.update(b"hello ");
hasher.update(b"world");

assert_eq!(hasher.finalize(), one_shot);

해시 API는 원샷 및 스트리밍 사용을 지원합니다. AEAD, 서명, RSA, X25519, ML-KEM, 비밀번호 해싱 및 백엔드 내부 검사를 위한 실행 가능한 워크플로는 examples/README.md에 있습니다.

프리미티브 및 기능 맵

정확한 타입과 메서드는 docs.rs를 사용하십시오. 다른 라이브러리를 대체할 때는 migration guide를 사용하십시오.

플랫폼 및 디스패치

휴대용 Rust 구현이 바이트 단위 권위자입니다. 컴파일 타임 타깃 지원 및 std 사용 시 감지된 런타임 CPU 기능은 적격 SIMD 또는 어셈블리 커널을 선택합니다. 지원되지 않는 가속화는 휴대용 Rust로 폴백됩니다.

platform guide는 타깃 매트릭스, 디스패치 모델, no_std 범위 및 portable-only의 한계를 담당합니다.

프로젝트

코드를 변경하기 전에 CONTRIBUTING.md를 읽으십시오. 게시된 변경 사항은 CHANGELOG.md에 있습니다.

라이선스

Apache-2.0 또는 MIT 이중 라이선스로, 선택에 따라 적용됩니다.