Transaction-Science/open-standards
Watch
1
0
Fork
You've already forked open-standards
 0
Code Issues Pull requests Projects Releases 15 Packages Wiki Activity Actions
open-standards/map/CONTRIBUTING.md
Transaction Science ba1212361f Add aac, map, sandbox standards; catalog the standards family 
Commit the previously-untracked standard directories and catalog them in the
root README alongside proof:

- aac/    — communication cargo class: portable boards + a ten-level
            offline-first cascade (Apache-2.0 code / CC-BY-4.0 spec).
- map/    — geospatial cargo class: range-requestable signed tilesets +
            an F0–F4 fidelity cascade (Apache-2.0 code / CC-BY-4.0 spec).
- sandbox/— isolated, metered, attested execution across the heterogeneous
            compute fabric (Apache-2.0 code / CC-BY-4.0 spec).
- jouleclaw-otel-authz, jouleclaw-trust — new jouleclaw reference crates.

Root README now lists aac, map, sandbox, and proof in the catalog, the tree,
and the contribution guide.

Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-06-07 17:04:36 -04:00

1.4 KiB
Raw Permalink Blame History

Contributing to Map

Map is one of the Transaction Science open standards. The wire format and the right to fork are public; Transaction Science is the steward, not the proprietor.

Ground rules

  • Reference code (map-rs/) is Apache-2.0. Specification text (SPEC.md, spec/, vocab/) is CC-BY-4.0.
  • Rust toolchain is pinned by the repo rust-toolchain.toml. cargo test --workspace MUST pass and cargo clippy --workspace --all-targets MUST be warning-free.
  • Any change to a wire structure requires regenerating and committing conformance/v1/ (cargo run -p map-conformance --bin gen-vectors) and a note in CHANGELOG.md.

The smallest valuable contributions

  • Conformance: adversarial negatives (a directory whose root disagrees with its entries, a revision-chain fork, a viewport whose range planner over-fetches), and independent implementations certifying against conformance/v1/.
  • Substrate port: real map-index (S2 + 4D), map-tiles (MVT / raster / 3D Tiles), map-orbital (SGP4), map-route — see ROADMAP.md.
  • Measured energy: backends feeding the receipt's HwShunt path (RAPL/SMC) so a resolver reports measured joules instead of the estimator.
  • Codecs: new tile payload codecs registered behind the Tile cargo, with conformance vectors per codec.

Issues and PRs scope by the map subdirectory tag.