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
enlists
Meaning
enThe issuer, a Verifiable Trust Network, attests that it lists the subject, a community or network, in its published set, under the governance framework the object names.
Classificationstatus-assertion
Objectvalue; schema https://registry.trustoverip.org/dtg/vsc/lists/1/listing.schema.json
Subject–object relationshipcredentialSubject.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 membersnone
taskContextOPTIONAL
Minimum issuer scopepublic
IssuerThe Verifiable Trust Network itself, or its VTA under the network's policy.
Verification establishesThat 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
  • that the subject is a member of the network: membership is a completed VMC pair between the two, and a listing alone is unacknowledged (VTI-VTN-011, VTI-VTN-013)
  • that the subject agreed to be listed
  • that the subject is recognised by the network, or by any party that recognises the network: listing is not transitive with recognition (VTI-VTN-022)
  • that the subject holds any authority, role or capability in the network or elsewhere (VTI-VTN-020)
  • anything about the parties the subject itself lists or admits
Defined inhttps://trustoverip.github.io/dtgwg-vti-spec/
Governed bythe 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

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.