descriptor-POC

A Rust workspace implementing output descriptor parsing and validation rules, structured as composable crates with a proof-of-concept CLI and mock service for end-to-end testing.

descriptor-POC/
descriptor/ # core: parsing & validation rules
client/ # interaction surface for consumers
poc-cli/ # proof-of-concept CLI
mock-service/ # testing harness / simulated backend
Cargo.toml # workspace manifest
Developer toolingDescriptor parsing & validationCensorship resistance
descriptor-POC
$ cargo build --workspace
Compiling descriptor v0.1.0
Compiling client v0.1.0
Compiling poc-cli v0.1.0
Compiling mock-service v0.1.0
Finished dev [unoptimized] target(s)
$ ./target/debug/poc-cli validate --help
Parse and validate an output descriptor
Usage: poc-cli validate <DESCRIPTOR>
descriptor
Core library

The foundational crate implementing descriptor parsing and the validation rules that govern descriptor correctness, structure, and policy semantics.

  • Descriptor parsing into a typed AST
  • Validation rules for policy structure and key origin
  • Deterministic checksum handling
client
Client layer

A client crate providing the interaction surface for consumers that need to construct, validate, and inspect descriptors against the core rules.

  • High-level builder API over the core parser
  • Validation result reporting for downstream consumers
  • Decoupled from transport specifics
poc-cli
Command-line interface

A proof-of-concept CLI exposing descriptor parsing and validation as a developer-facing command, designed for quick inspection and scripting.

  • Parse and validate descriptors from stdin or args
  • Human-readable validation diagnostics
  • Composable in shell pipelines
mock-service
Testing harness

A mock service crate simulating a descriptor-aware service endpoint, enabling end-to-end testing of the client and CLI against a controlled, predictable backend.

  • Predictable simulated responses
  • Integration test scaffolding for the full workspace
  • No external network dependencies