docs(wolfcrypt-tls): add README.md

Adds a README with quick-start examples for TLS client and server,
feature flag table, and FIPS notice. Wires it into Cargo.toml so
crates.io displays it.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: MarkAtwood

wolfcrypt-tls/Cargo.toml

@@ -7,6 +7,7 @@ license = "MIT"
 keywords = ["wolfcrypt", "wolfssl", "tls", "fips", "cryptography"]
 categories = ["cryptography"]
 description = "Safe Rust TLS API backed by wolfSSL"
+readme = "README.md"
 homepage = "http://wolfssl.com"
 repository = "https://github.com/wolfSSL/wolfssl-rs"
 

wolfcrypt-tls/README.md

@@ -0,0 +1,49 @@
+# wolfcrypt-tls
+
+Safe Rust TLS client and server backed by [wolfSSL](https://wolfssl.com). Exported as the `wolfssl` crate.
+
+## Usage
+
+```toml
+[dependencies]
+wolfcrypt-tls = "0.1"
+```
+
+```rust
+use wolfssl::{TlsClientConfig, TlsClient, RootCertStore};
+use std::io::{Read, Write};
+use std::net::TcpStream;
+
+let mut roots = RootCertStore::new();
+roots.add_pem(include_bytes!("ca.pem"));
+
+let config = TlsClientConfig::builder()
+    .with_root_certificates(roots)
+    .with_no_client_auth()
+    .build()?;
+
+let stream = TcpStream::connect("example.com:443")?;
+let mut tls = TlsClient::new(config, "example.com", stream)?;
+tls.write_all(b"GET / HTTP/1.1\r\nHost: example.com\r\n\r\n")?;
+```
+
+Server-side uses `TlsServerConfig` and `TlsServer` symmetrically.
+
+## Features
+
+| Feature | Description |
+|---------|-------------|
+| `vendored` | Compile wolfSSL from source (requires `WOLFSSL_SRC` or pkg-config) |
+| `fips` | Enable the wolfSSL FIPS 140-3 code path |
+
+FIPS 140-3 validated builds require a wolfSSL commercial license and the validated source tree. See the [workspace README](https://github.com/wolfSSL/wolfssl-rs) for details.
+
+## Status
+
+- TLS 1.2 and TLS 1.3
+- Blocking I/O (async support planned)
+- Unix and Windows socket support
+
+## License
+
+MIT