Skip to content

Chesterguan/HAVEN

Repository files navigation

HAVEN Logo

HAVEN Protocol

Health Asset Value & Exchange Network

An independent, open protocol for patient-controlled health data. HAVEN specifies how health data is referenced, consented to, audited, and valued — without prescribing storage, computation, or payment mechanisms.

License: CC BY 4.0  ·  Status: v2.0 Draft  ·  Not a company. Not a product.


The problem

Every blood test and clinical note you generate becomes training data for AI systems you'll never see. You can't audit who accessed your records. You can't set conditions on how your data is used. You don't share in the value your data creates.

This isn't a policy failure — it's an infrastructure failure. No standard protocol exists that ties governance to data. HAVEN is that protocol.


Four primitives

Primitive What it does
Health Asset Content-addressed (SHA-256) reference to governed clinical data. Consent reference is structurally required — no ungoverned assets.
Consent Protocol Machine-executable, granular, immediately revocable authorization. Closed-world: silence = denial.
Provenance Record Append-only, hash-chained, Ed25519-signed audit trail. Every access logged. Tamper-evident.
Contribution Model 3-gate quality protocol + tier-weighted value score. Measures what patient data contributes to a study.

HAVEN builds on FHIR R4 and OMOP CDM — standards already mandated or widely adopted. It does not specify storage, encryption, key management, identity, or payment rails.


Documentation

Document Description
Whitepaper (English) Protocol overview, design rationale, full references
Whitepaper (中文) 协议规范中文版
Whitepaper (Français) Spécification du protocole
Implementation Guide How to build HAVEN-compliant systems (with code)
Formal Specifications RFC-style specs — MUST/SHOULD/MAY requirements
Examples Annotated examples for each primitive
Test Vectors Conformance test data (valid + invalid cases)

Contributing

HAVEN is an independent open protocol. There is no company. The spec improves through use, critique, and real-world implementation experience.

Most valuable right now:

  • Adversarial spec review — find ambiguities, edge cases, contradictions
  • Implementation reports — try to build something; tell us where the spec failed you
  • Test vector additions — especially boundary conditions and multi-primitive scenarios

See CONTRIBUTING.md for how to contribute effectively, and ROADMAP.md for what's open and what's planned.


Related projects

  • PSDL — Patient Scenario Definition Language. Declarative policy language for HAVEN consent and clinical scenarios. Recommended but not required.

Contact


HAVEN Protocol v2.0 | February 2026 | CC BY 4.0

About

Health Asset Value & Exchange Network

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •