# wolfcrypt-sys
Raw FFI bindings to wolfCrypt, generated by bindgen. This is the foundation crate for the wolfssl-rs workspace.
## Usage
Prefer the higher-level crates (`wolfcrypt`, `wolfcrypt-ring-compat`, `wolfcrypt-tls`) over depending on this directly.
```toml
wolfcrypt-sys = { version = "0.1", features = ["vendored"] }
```
## Finding wolfSSL
The build script searches in order:
1. `WOLFSSL_LIB_DIR` + `WOLFSSL_INCLUDE_DIR` environment variables
2. `WOLFSSL_DIR` install prefix
3. `vendored` feature + `WOLFSSL_SRC` — compiles from source via `wolfssl-src`
4. `pkg-config`
## Features
| `vendored` | Compile wolfSSL from source (requires `WOLFSSL_SRC`) |
| `fips` | Enable the FIPS 140-3 code path |
| `riscv-bare-metal` | Bare-metal RISC-V configuration (Caliptra) |
## License
MIT