lists/1 draft
Predicate IRI, exact bytes: https://registry.trustoverip.org/dtg/vsc/lists/1
Machine-readable: predicate.jsonld, also served at this URL with Accept: application/ld+json. Definition format: predicate.schema.json.
Definition
| Label |
| ||
|---|---|---|---|
| Meaning |
| ||
| Classification | status-assertion | ||
| Object | value; schema https://registry.trustoverip.org/dtg/vsc/lists/1/listing.schema.json | ||
| Subject–object relationship | credentialSubject.id is the DID of the listed community or network, and object.value.nodeType states which it is (VTI-VTN-031). The issuer is the network whose published set the listing belongs to; a listing is never issued by the listed party. | ||
| Additional members | none | ||
taskContext | OPTIONAL | ||
| Minimum issuer scope | public | ||
| Issuer | The Verifiable Trust Network itself, or its VTA under the network's policy. | ||
| Verification establishes | That the issuer published the subject in its set, as a community or a network, under the governance framework and version the object names, from validFrom for as long as the listing's status shows it in force. | ||
| Verification does not establish |
| ||
| Defined in | https://trustoverip.github.io/dtgwg-vti-spec/ | ||
| Governed by | the working group that maintains this registry |
The type-level bound of the specification's What Verification Establishes applies in full: a statement attests; it never confers representation, authority, membership, admission, governed status or task completion.
Profile
A statement under this predicate is a listing: a Verifiable Trust Network (VTN) puts a community or another network in its published set. A VTN curates; it may list a party without asking it (VTI specification, The Verifiable Trust Network, VTI-VTN-010). This entry is the normative definition of the statement the VTI specification's network chapter calls a listing.
A listing is not a grant
The DTG Credentials Core Specification's membership credential (VMC) is an edge: a community-issued grant and a member-issued acknowledgement that carries the grant's digest. A listing is a different kind of thing. It is true the moment the network publishes it, and it needs nothing from the party it names, which is what the specification's statement/establishment test puts on the statement side.
Expressing a listing as an unacknowledged VMC grant would make one artifact do two jobs. It would be worthless alone as evidence of membership — Membership Edge Completion forbids reading a bare grant that way — and yet meaningful alone as a listing. Repudiation would have no credential to name, and delisting and removing a member would be one status flip instead of two separate acts. A listing therefore stands beside the grant: revoking the listing is delisting (VTI-VTN-053), and revoking the grant ends a membership.
Acknowledgement state is derived
The listing carries no acknowledgement state, and its object schema has no member for one. VTI-VTN-011 requires every published entry to show whether the listed party acknowledged it, and that state is read off the listing's companions:
| Companions | State |
|---|---|
| the listing alone | listed, unacknowledged |
| the listing and a completed VMC pair between the network and the subject | acknowledged — a membership |
the listing and a repudiates/1 statement by the subject naming the listing's digest |
repudiated |
Because the listing is immutable, the network cannot misstate the state, and a listed party can make its repudiation known even if the network does not publish it.
Notes for implementers
- A VTN SHOULD publish a listing for every party it admits as a member, so that its published set has exactly one representation and every membership has a listing beside it.
nodeTypeuses the values of the DTGnodeTypevocabulary for communities and networks, so the two vocabularies do not diverge.- The framework is named with its version. A party that extends recognition to a network's listed parties names the network and the version relied on (VTI-VTN-023), and a listing made under one version is distinguishable from one made under the next.
- The issuer's correlation scope is
public. A listing is a statement a network publishes about a party that may never have heard of it, so it must be checkable by anyone the published set reaches. What a listing means when a restricted network publishes its set only to its members (directed) is open, and is to be settled with the specification's discussion of community identifier scope before this version leaves draft. - The example's identifiers and digest are illustrative.
Examples
examples/listing-network.json
{
"@context": [
"https://www.w3.org/ns/credentials/v2",
"https://registry.trustoverip.org/dtg/context/v1"
],
"id": "urn:uuid:6f1c2a8e-4b7d-4c0e-9f3a-2d5e8b1c7a40",
"type": [
"VerifiableCredential",
"DTGCredential",
"StatementCredential"
],
"issuer": "did:webvh:QmWhn7yRkPqLu4WgXyN3c8pT2rJ6mK9sB1dF4gH7jL0n:whn.example",
"issuerScope": "public",
"validFrom": "2026-11-03T09:00:00Z",
"credentialSubject": {
"id": "did:webvh:QmAu2Td9hRkPqLu4WgXyN3c8pT2rJ6mK9sB1dF4gH7jL:health-au.example",
"predicate": "https://registry.trustoverip.org/dtg/vsc/lists/1",
"object": {
"value": {
"nodeType": "VTN",
"framework": {
"iri": "https://whn.example/governance",
"version": "1.0"
}
}
}
},
"credentialStatus": {
"id": "https://whn.example/v1/status/revocation#4",
"type": "BitstringStatusListEntry",
"statusPurpose": "revocation",
"statusListIndex": "4",
"statusListCredential": "https://whn.example/v1/status/revocation"
},
"proof": {
"type": "DataIntegrityProof",
"cryptosuite": "eddsa-jcs-2022",
"created": "2026-11-03T09:00:00Z",
"proofPurpose": "assertionMethod",
"verificationMethod": "did:webvh:QmWhn7yRkPqLu4WgXyN3c8pT2rJ6mK9sB1dF4gH7jL0n:whn.example#key-0",
"proofValue": "z3FXQjecWJKT…illustrative…"
}
}
Last changed 2026-11-03.