HeartPrefs — standards submissions
An open, portable, signed matching-intent standard for agent-mediated matching. CC-BY-4.0.
Filegokhanturhan.com/heartprefs/standards/05 pages
HeartPrefs · pages
Ready-to-submit artifacts for making HeartPrefs an official, portable, permanent standard. Each item here is prepared so the founder only has to submit it — the actual external submissions (IANA, W3C, the perma-id/w3id.org PR, and serving did.json) are founder actions, because they are outward-facing and irreversible.
Authored 2026-07-04, each verified against its first-party spec (links below). Nothing here has been submitted yet.
Status
| Artifact | Standard | This folder | External submission (founder) | Issue |
|---|---|---|---|---|
| DID issuer document | W3C DID Core / did:web |
did/did.json + did/README.md |
serve at https://ishtar.numetal.xyz/.well-known/did.json (via ishtar-website, not the venue) |
GOK-166 |
| Permanent schema URL | w3id.org | w3id/ |
PR to github.com/perma-id/w3id.org |
GOK-163 |
| Media type | IANA / RFC 6838 | iana/vnd.heartprefs+json.txt |
email [email protected] or the IANA web form |
GOK-164 |
| Community Group | W3C CG | w3c-cg/charter.md + w3c-cg/README.md |
"Create a Community Group" on w3.org + gather 5 supporters | GOK-172 |
⚠ One decision to make first (media-type tree)
RFC 6838 restricts the standards tree (application/heartprefs+json) to formats recognized by a standards body. HeartPrefs is not there yet, so the registrable name today is the vendor tree: application/vnd.heartprefs+json (RFC 6838 §3.2 — "vendor" explicitly includes consortia and non-commercial entities). Once the W3C Community Group (GOK-172) adopts the spec, it can graduate to the standards-tree application/heartprefs+json.
- The IANA application here uses
application/vnd.heartprefs+jsonaccordingly. spec/0.1/SPEC.md §10still advertisesapplication/heartprefs+json"(registration pending; use provisionally)". Recommended follow-up (not done in this PR — it's a normative spec change for you to bless): reconcile the SPEC to stateapplication/vnd.heartprefs+jsonas the registered type andapplication/heartprefs+jsonas the target after CG adoption.
Suggested submission order
- Launch the W3C CG (free; gives you a standards body → unlocks the standards-tree media type + a neutral governance home).
- Register the IANA media type (
vnd.now; the CG can graduate it later). - File the w3id PR (optional) — a permanent, host-independent schema URL. The schema
$idnow resolves via GitHub raw (…/main/spec/0.1/heartprefs.schema.json); registeringw3id.org/heartprefslets you switch the$idto the permalink later. - Serve
did.jsononce the issuer signing key is chosen (seedid/README.md) — needed before the 18+ VC path (GOK-166) goes live.
First-party sources (verified 2026-07-04)
- did:web — https://w3c-ccg.github.io/did-method-web/ ; DID Core — https://www.w3.org/TR/did-core/
- IANA media types — RFC 6838 https://www.rfc-editor.org/rfc/rfc6838 ;
+jsonsuffix — RFC 6839 - w3id — https://github.com/perma-id/w3id.org
- W3C Community Groups — https://www.w3.org/community/about/faq/
- VC Data Model 2.0 — https://www.w3.org/TR/vc-data-model-2.0/