Skip to content

valiss-dev/spec

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

valiss spec

The normative, language-neutral specification of the valiss wire format and verification rules, plus the conformance vectors every implementation is tested against. This is the cross-language contract: valiss-go, valiss-py, and future implementations all conform to a spec version here.

Layout

spec/
├── SPEC-1.md        normative wire spec, version 1
├── vectors/         conformance test vectors (JSON), shared by all impls
│   └── ...
└── README.md

Versioning

The spec version is independent of any library's semantic version (ADR 0006): an implementation advertises the spec version(s) it implements. The wire format carries an explicit version discriminator so versions coexist (ADR 0009). The current spec version is 1; SPEC-1.md is frozen once accepted and only errata (clarifications that do not change conforming behavior) are applied to it. A breaking change is a new SPEC-2.md, never an edit to SPEC-1.md.

Conformance

An implementation conforms to spec 1 if it passes every vector under vectors/. Vectors are generated from the reference implementation, reviewed, and frozen with the spec version. See vectors/README.md for the vector format and the runner contract.

About

valiss wire specification and conformance vectors

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors