cmn-substrate 0.1.1

CMN protocol core — Ed25519 signatures, BLAKE3 tree hashing, JSON schema validation, URI parsing, and JCS canonicalization. Zero I/O, WASM-compatible.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

# cmn-substrate

Core library for the [Code Mycelial Network](https://cmn.dev) protocol. Zero I/O, WASM-compatible.

## What it does

- **Data models** — Spore, Mycelium, Taste, CMN entry structs with serde serialization
- **Cryptography** — Ed25519 signatures and BLAKE3 content hashing with JCS canonicalization
- **Tree hashing** — Git-like Merkle tree (blob_tree_blake3_nfc) with Unicode NFC normalization
- **URI parsing** — `cmn://domain/b3.hash` with domain and URL validation (rejects SSRF)
- **Schema validation** — Embedded JSON Schema (draft 2020-12) for all protocol artifacts
- **HTTP client** — Optional async client for fetching manifests, mycelium, taste reports (feature-gated)
- **Archive extraction** — Optional tar+zstd extraction with security hardening (feature-gated)

## Features

| Feature | Description |
|---------|-------------|
| `client` | HTTP client via reqwest |
| `client-safe-dns` | Client with DNS filtering (adds tokio) |
| `archive-ruzstd` | Tar extraction with ruzstd (WASM-compatible) |
| `archive-zstd` | Tar extraction with zstd (native, faster) |

## Usage

```toml
[dependencies]
cmn-substrate = "0.1"

# With HTTP client
cmn-substrate = { version = "0.1", features = ["client-safe-dns"] }
```

```rust
use substrate::{parse_uri, validate_schema, compute_blake3_hash};

// Parse a CMN URI
let uri = parse_uri("cmn://example.com/b3.abc123")?;

// Validate a document against its schema
let doc: serde_json::Value = serde_json::from_str(&json_str)?;
validate_schema(&doc)?;
```

## License

MIT