Crate vr_jcs 

VertRule JCS Glovebox

RFC 8785 JSON Canonicalization Scheme (JCS)

This crate is the single authorized location for JSON canonicalization in the VertRule ecosystem. All receipt serialization and digest computation MUST use these functions to ensure deterministic hashing.

The implementation enforces the RFC 8785 rules that materially affect wire compatibility:

• UTF-16 code-unit sorting for object property names
• ECMAScript-compatible primitive serialization
• UTF-8 output without insignificant whitespace
• duplicate-property rejection on raw JSON parse paths
• I-JSON string / number validation

API

• to_canon_bytes — Serialize any Serialize type to canonical JSON bytes
• to_canon_string — Serialize any Serialize type to a canonical JSON string
• to_canon_bytes_from_slice — Parse raw JSON and return canonical bytes (rejects duplicates)
• to_canon_string_from_str — Parse raw JSON string and return canonical string
• canonicalize — Sort object keys recursively in a serde_json::Value (in-place)

Usage

use vr_jcs::to_canon_string;
use serde::Serialize;

#[derive(Serialize)]
struct Receipt {
    z_field: u64,
    a_field: u64,
}

let receipt = Receipt { z_field: 1, a_field: 2 };
let json = to_canon_string(&receipt).expect("serialization");
assert_eq!(json, r#"{"a_field":2,"z_field":1}"#);

Enforcement

Any code path that computes a digest over JSON MUST use this crate. Using serde_json::to_string() directly for digest input is forbidden.

Enums

JcsError

Error type for canonical JSON operations.

Functions

canonicalize

Recursively sort all object keys in a JSON value for canonical representation.

to_canon_bytes

Serialize any Serialize type to canonical JSON bytes.

to_canon_bytes_from_slice

Parse raw JSON text and return canonical JSON bytes.

to_canon_string

Serialize any Serialize type to a canonical JSON string.

to_canon_string_from_str

Parse raw JSON text and return a canonical JSON string.