@openvtc/trust-tasks 0.21.16 → 0.22.1

package/src/vtc/endorsements/show/0.1/payload.ts

@@ -101,31 +101,31 @@ export const PAYLOAD_SCHEMA = {
         "endorsementId": {
           "type": "string",
           "minLength": 1,
-          "description": "Community-scoped identifier for this endorsement row."
+          "description": "Community-scoped identifier for this row. The name is legacy; it identifies a statement, and vtc/endorsements/revoke also takes the `endorsementId` of a role credential issued by vtc/vetting/vetters/grant."
         },
         "typeUri": {
           "type": "string",
           "minLength": 1,
           "maxLength": 512,
-          "description": "The registered endorsement type this VEC asserts; see vtc/endorsement-types/*."
+          "description": "What the row records. A registered predicate IRI: a statement (StatementCredential) whose `credentialSubject.predicate` it is — see vtc/endorsement-types/*. `role:vetter`: a vetter role credential (Verifiable Authority Credential) issued by vtc/vetting/vetters/grant. `IdentityVerificationCredential`: the community's identity-verification credential, a plain W3C VC (not a DTGCredential). The two reserved values are not IRIs, so they never collide with a registered predicate."
         },
         "subjectDid": {
           "type": "string",
           "pattern": "^did:",
-          "description": "DID of the endorsement's subject (becomes credentialSubject.id)."
+          "description": "DID of the statement's subject (becomes credentialSubject.id)."
         },
         "claim": {
           "type": "object",
-          "description": "The attested claim body, validated against the endorsement type's claimSchema when it declares one."
+          "description": "The attested claim body — the statement's `credentialSubject.object.value` — validated against the registered predicate's claimSchema when it declares one."
         },
         "issued": {
           "$ref": "#/$defs/CredentialReference",
-          "description": "A pointer to the issued VEC — its identifier and lifetime, not its bytes. `endorsements/issue` additionally returns the credential itself, because that is the one call whose caller has no other way to receive it."
+          "description": "A pointer to the issued statement credential — its identifier and lifetime, not its bytes. `endorsements/issue` additionally returns the credential itself, because that is the one call whose caller has no other way to receive it."
         },
         "statusListIndex": {
           "type": "integer",
           "minimum": 0,
-          "description": "The endorsement's slot on the community's shared Revocation status list. Published, so a foreign verifier can check revocation without contacting this community."
+          "description": "The statement's slot on the community's shared Revocation status list, referenced by its `credentialStatus`. Published, so a foreign verifier can check revocation without contacting this community."
         },
         "revokedAt": {
           "type": [
@@ -133,7 +133,7 @@ export const PAYLOAD_SCHEMA = {
             "null"
           ],
           "format": "date-time",
-          "description": "When the endorsement was revoked, or null while live."
+          "description": "When the statement was revoked, or null while live."
         }
       }
     },
@@ -223,31 +223,31 @@ export const RESPONSE_PAYLOAD_SCHEMA = {
         "endorsementId": {
           "type": "string",
           "minLength": 1,
-          "description": "Community-scoped identifier for this endorsement row."
+          "description": "Community-scoped identifier for this row. The name is legacy; it identifies a statement, and vtc/endorsements/revoke also takes the `endorsementId` of a role credential issued by vtc/vetting/vetters/grant."
         },
         "typeUri": {
           "type": "string",
           "minLength": 1,
           "maxLength": 512,
-          "description": "The registered endorsement type this VEC asserts; see vtc/endorsement-types/*."
+          "description": "What the row records. A registered predicate IRI: a statement (StatementCredential) whose `credentialSubject.predicate` it is — see vtc/endorsement-types/*. `role:vetter`: a vetter role credential (Verifiable Authority Credential) issued by vtc/vetting/vetters/grant. `IdentityVerificationCredential`: the community's identity-verification credential, a plain W3C VC (not a DTGCredential). The two reserved values are not IRIs, so they never collide with a registered predicate."
         },
         "subjectDid": {
           "type": "string",
           "pattern": "^did:",
-          "description": "DID of the endorsement's subject (becomes credentialSubject.id)."
+          "description": "DID of the statement's subject (becomes credentialSubject.id)."
         },
         "claim": {
           "type": "object",
-          "description": "The attested claim body, validated against the endorsement type's claimSchema when it declares one."
+          "description": "The attested claim body — the statement's `credentialSubject.object.value` — validated against the registered predicate's claimSchema when it declares one."
         },
         "issued": {
           "$ref": "#/$defs/CredentialReference",
-          "description": "A pointer to the issued VEC — its identifier and lifetime, not its bytes. `endorsements/issue` additionally returns the credential itself, because that is the one call whose caller has no other way to receive it."
+          "description": "A pointer to the issued statement credential — its identifier and lifetime, not its bytes. `endorsements/issue` additionally returns the credential itself, because that is the one call whose caller has no other way to receive it."
         },
         "statusListIndex": {
           "type": "integer",
           "minimum": 0,
-          "description": "The endorsement's slot on the community's shared Revocation status list. Published, so a foreign verifier can check revocation without contacting this community."
+          "description": "The statement's slot on the community's shared Revocation status list, referenced by its `credentialStatus`. Published, so a foreign verifier can check revocation without contacting this community."
         },
         "revokedAt": {
           "type": [
@@ -255,7 +255,7 @@ export const RESPONSE_PAYLOAD_SCHEMA = {
             "null"
           ],
           "format": "date-time",
-          "description": "When the endorsement was revoked, or null while live."
+          "description": "When the statement was revoked, or null while live."
         }
       }
     },

package/src/vtc/join-requests/decide/0.1/payload.ts

@@ -37,9 +37,9 @@ export interface VTCJoinRequestsDecideResponsePayload {
    */
   vmc?: {} | null;
   /**
-   * The endorsement credential carrying the role this decision granted, delivered inline alongside `vmc` and on the same reasoning. Present only where the decision admitted the applicant and granted a role.
+   * The role credential this decision issued: a Verifiable Authority Credential (`type` including `AuthorityCredential`) issued by the community with `issuerScope` `public`, whose `credentialSubject.authority` is `{ scope: <community DID>, actions: ["role:<name>"] }` — the shape vtc/vetting/vetters/grant/0.1 issues. Delivered inline alongside `vmc` and on the same reasoning. Present only where the decision admitted the applicant and granted a role. Formerly `roleVec`; roles are authority, not endorsements.
    */
-  roleVec?: {} | null;
+  roleVac?: {} | null;
   ext?: Ext;
 }
 
@@ -131,12 +131,12 @@ export const PAYLOAD_SCHEMA = {
           ],
           "description": "The membership credential issued by this decision, delivered inline. Present only where the decision admitted the applicant.\n\nInline because the alternative is worse: the applicant would poll for a status, learn they were admitted, and then fetch the credential separately — a second round trip whose only purpose is to collect something the community already had in hand when it decided."
         },
-        "roleVec": {
+        "roleVac": {
           "type": [
             "object",
             "null"
           ],
-          "description": "The endorsement credential carrying the role this decision granted, delivered inline alongside `vmc` and on the same reasoning. Present only where the decision admitted the applicant and granted a role."
+          "description": "The role credential this decision issued: a Verifiable Authority Credential (`type` including `AuthorityCredential`) issued by the community with `issuerScope` `public`, whose `credentialSubject.authority` is `{ scope: <community DID>, actions: [\"role:<name>\"] }` — the shape vtc/vetting/vetters/grant/0.1 issues. Delivered inline alongside `vmc` and on the same reasoning. Present only where the decision admitted the applicant and granted a role. Formerly `roleVec`; roles are authority, not endorsements."
         },
         "ext": {
           "$ref": "#/$defs/Ext"
@@ -191,12 +191,12 @@ export const RESPONSE_PAYLOAD_SCHEMA = {
           ],
           "description": "The membership credential issued by this decision, delivered inline. Present only where the decision admitted the applicant.\n\nInline because the alternative is worse: the applicant would poll for a status, learn they were admitted, and then fetch the credential separately — a second round trip whose only purpose is to collect something the community already had in hand when it decided."
         },
-        "roleVec": {
+        "roleVac": {
           "type": [
             "object",
             "null"
           ],
-          "description": "The endorsement credential carrying the role this decision granted, delivered inline alongside `vmc` and on the same reasoning. Present only where the decision admitted the applicant and granted a role."
+          "description": "The role credential this decision issued: a Verifiable Authority Credential (`type` including `AuthorityCredential`) issued by the community with `issuerScope` `public`, whose `credentialSubject.authority` is `{ scope: <community DID>, actions: [\"role:<name>\"] }` — the shape vtc/vetting/vetters/grant/0.1 issues. Delivered inline alongside `vmc` and on the same reasoning. Present only where the decision admitted the applicant and granted a role. Formerly `roleVec`; roles are authority, not endorsements."
         },
         "ext": {
           "$ref": "#/$defs/Ext"

package/src/vtc/join-requests/manifest/0.2/payload.ts

@@ -67,7 +67,7 @@ export interface VettingRequirements {
    */
   version: string;
   /**
-   * The endorsement type URI a counted vetting statement carries as `credentialSubject.endorsement.type`, as registered with the community via vtc/endorsement-types/register.
+   * The predicate IRI a counted vetting statement carries in `credentialSubject.predicate` — `https://registry.trustoverip.org/dtg/vsc/vetted/1`, the DTG VSC registry's identity-vetting predicate, or a predicate in a namespace the community controls — registered as one the community accepts via vtc/endorsement-types/register. A statement under any other predicate does not count.
    */
   statementType: string;
   /**
@@ -106,7 +106,7 @@ export interface VettingRequirements {
    */
   eligibleVetters: {
     /**
-     * The role named in a community-issued `CommunityRole` endorsement credential (see `vtc/vetting/vetters/grant/0.1`). A statement counts only if its issuer holds that credential.
+     * The role a statement's issuer must hold, matched as the action `role:<role>` in a Verifiable Authority Credential (`AuthorityCredential`) the community issued to that issuer, whose `authority.scope` is the community's DID (see `vtc/vetting/vetters/grant/0.1`). A statement counts only if its issuer holds such a credential.
      */
     role: string;
   };
@@ -274,7 +274,7 @@ export const PAYLOAD_SCHEMA = {
           "format": "uri",
           "minLength": 1,
           "maxLength": 512,
-          "description": "The endorsement type URI a counted vetting statement carries as `credentialSubject.endorsement.type`, as registered with the community via vtc/endorsement-types/register."
+          "description": "The predicate IRI a counted vetting statement carries in `credentialSubject.predicate` — `https://registry.trustoverip.org/dtg/vsc/vetted/1`, the DTG VSC registry's identity-vetting predicate, or a predicate in a namespace the community controls — registered as one the community accepts via vtc/endorsement-types/register. A statement under any other predicate does not count."
         },
         "minStatements": {
           "type": "integer",
@@ -341,7 +341,7 @@ export const PAYLOAD_SCHEMA = {
               "minLength": 1,
               "maxLength": 128,
               "pattern": "^[a-zA-Z][a-zA-Z0-9_-]*$",
-              "description": "The role named in a community-issued `CommunityRole` endorsement credential (see `vtc/vetting/vetters/grant/0.1`). A statement counts only if its issuer holds that credential."
+              "description": "The role a statement's issuer must hold, matched as the action `role:<role>` in a Verifiable Authority Credential (`AuthorityCredential`) the community issued to that issuer, whose `authority.scope` is the community's DID (see `vtc/vetting/vetters/grant/0.1`). A statement counts only if its issuer holds such a credential."
             }
           },
           "description": "How a vetter's eligibility is established."
@@ -637,7 +637,7 @@ export const RESPONSE_PAYLOAD_SCHEMA = {
           "format": "uri",
           "minLength": 1,
           "maxLength": 512,
-          "description": "The endorsement type URI a counted vetting statement carries as `credentialSubject.endorsement.type`, as registered with the community via vtc/endorsement-types/register."
+          "description": "The predicate IRI a counted vetting statement carries in `credentialSubject.predicate` — `https://registry.trustoverip.org/dtg/vsc/vetted/1`, the DTG VSC registry's identity-vetting predicate, or a predicate in a namespace the community controls — registered as one the community accepts via vtc/endorsement-types/register. A statement under any other predicate does not count."
         },
         "minStatements": {
           "type": "integer",
@@ -704,7 +704,7 @@ export const RESPONSE_PAYLOAD_SCHEMA = {
               "minLength": 1,
               "maxLength": 128,
               "pattern": "^[a-zA-Z][a-zA-Z0-9_-]*$",
-              "description": "The role named in a community-issued `CommunityRole` endorsement credential (see `vtc/vetting/vetters/grant/0.1`). A statement counts only if its issuer holds that credential."
+              "description": "The role a statement's issuer must hold, matched as the action `role:<role>` in a Verifiable Authority Credential (`AuthorityCredential`) the community issued to that issuer, whose `authority.scope` is the community's DID (see `vtc/vetting/vetters/grant/0.1`). A statement counts only if its issuer holds such a credential."
             }
           },
           "description": "How a vetter's eligibility is established."

package/src/vtc/members/credentials/0.1/payload.ts

@@ -32,7 +32,7 @@ export interface VTCMembersCredentialsResponsePayload {
    */
   membershipCredential?: {};
   /**
-   * The role Verifiable Endorsement Credential. A verifiable credential, carried verbatim and opaque to this schema. Maintainers must not re-serialise it — the bytes carry a proof over themselves. Matches the `vrcJsonld` idiom in vtc/relationships/list/0.2.
+   * The role credential: a community-issued Verifiable Authority Credential (`AuthorityCredential`) conferring `role:<name>` at the community's DID. A verifiable credential, carried verbatim and opaque to this schema. Maintainers must not re-serialise it — the bytes carry a proof over themselves. Matches the `vrcJsonld` idiom in vtc/relationships/list/0.2.
    */
   roleCredential?: {};
   /**
@@ -121,7 +121,7 @@ export const PAYLOAD_SCHEMA = {
         "roleCredential": {
           "type": "object",
           "minProperties": 1,
-          "description": "The role Verifiable Endorsement Credential. A verifiable credential, carried verbatim and opaque to this schema. Maintainers must not re-serialise it — the bytes carry a proof over themselves. Matches the `vrcJsonld` idiom in vtc/relationships/list/0.2."
+          "description": "The role credential: a community-issued Verifiable Authority Credential (`AuthorityCredential`) conferring `role:<name>` at the community's DID. A verifiable credential, carried verbatim and opaque to this schema. Maintainers must not re-serialise it — the bytes carry a proof over themselves. Matches the `vrcJsonld` idiom in vtc/relationships/list/0.2."
         },
         "memberVmc": {
           "type": "object",
@@ -189,7 +189,7 @@ export const RESPONSE_PAYLOAD_SCHEMA = {
         "roleCredential": {
           "type": "object",
           "minProperties": 1,
-          "description": "The role Verifiable Endorsement Credential. A verifiable credential, carried verbatim and opaque to this schema. Maintainers must not re-serialise it — the bytes carry a proof over themselves. Matches the `vrcJsonld` idiom in vtc/relationships/list/0.2."
+          "description": "The role credential: a community-issued Verifiable Authority Credential (`AuthorityCredential`) conferring `role:<name>` at the community's DID. A verifiable credential, carried verbatim and opaque to this schema. Maintainers must not re-serialise it — the bytes carry a proof over themselves. Matches the `vrcJsonld` idiom in vtc/relationships/list/0.2."
         },
         "memberVmc": {
           "type": "object",

package/src/vtc/members/list/0.1/payload.ts

@@ -194,12 +194,12 @@ export const PAYLOAD_SCHEMA = {
           ],
           "description": "Id of the member's current Verifiable Membership Credential, if issued."
         },
-        "currentRoleVecId": {
+        "currentRoleVacId": {
           "type": [
             "string",
             "null"
           ],
-          "description": "Id of the member's current role Verifiable Endorsement Credential, if issued."
+          "description": "Id of the member's current role credential — a community-issued Verifiable Authority Credential conferring `role:<name>` — if issued. Formerly `currentRoleVecId`."
         },
         "personhood": {
           "type": "boolean",
@@ -355,12 +355,12 @@ export const RESPONSE_PAYLOAD_SCHEMA = {
           ],
           "description": "Id of the member's current Verifiable Membership Credential, if issued."
         },
-        "currentRoleVecId": {
+        "currentRoleVacId": {
           "type": [
             "string",
             "null"
           ],
-          "description": "Id of the member's current role Verifiable Endorsement Credential, if issued."
+          "description": "Id of the member's current role credential — a community-issued Verifiable Authority Credential conferring `role:<name>` — if issued. Formerly `currentRoleVecId`."
         },
         "personhood": {
           "type": "boolean",

package/src/vtc/members/personhood/assert/0.1/payload.ts

@@ -28,9 +28,9 @@ export interface VTCMembersPersonhoodAssertResponsePayload {
    */
   vmc: {};
   /**
-   * Re-issued role credential (opaque here).
+   * Re-issued role credential (opaque here): a Verifiable Authority Credential (`type` including `AuthorityCredential`) issued by the community with `issuerScope` `public`, whose `credentialSubject.authority` is `{ scope: <community DID>, actions: ["role:<name>"] }` — the shape vtc/vetting/vetters/grant/0.1 issues.
    */
-  roleVec: {};
+  roleVac: {};
   ext?: Ext;
 }
 
@@ -92,7 +92,7 @@ export const PAYLOAD_SCHEMA = {
         "did",
         "personhood",
         "vmc",
-        "roleVec"
+        "roleVac"
       ],
       "properties": {
         "did": {
@@ -108,9 +108,9 @@ export const PAYLOAD_SCHEMA = {
           "type": "object",
           "description": "Re-issued membership credential carrying the asserted personhood (opaque here)."
         },
-        "roleVec": {
+        "roleVac": {
           "type": "object",
-          "description": "Re-issued role credential (opaque here)."
+          "description": "Re-issued role credential (opaque here): a Verifiable Authority Credential (`type` including `AuthorityCredential`) issued by the community with `issuerScope` `public`, whose `credentialSubject.authority` is `{ scope: <community DID>, actions: [\"role:<name>\"] }` — the shape vtc/vetting/vetters/grant/0.1 issues."
         },
         "ext": {
           "$ref": "#/$defs/Ext"
@@ -144,7 +144,7 @@ export const RESPONSE_PAYLOAD_SCHEMA = {
         "did",
         "personhood",
         "vmc",
-        "roleVec"
+        "roleVac"
       ],
       "properties": {
         "did": {
@@ -160,9 +160,9 @@ export const RESPONSE_PAYLOAD_SCHEMA = {
           "type": "object",
           "description": "Re-issued membership credential carrying the asserted personhood (opaque here)."
         },
-        "roleVec": {
+        "roleVac": {
           "type": "object",
-          "description": "Re-issued role credential (opaque here)."
+          "description": "Re-issued role credential (opaque here): a Verifiable Authority Credential (`type` including `AuthorityCredential`) issued by the community with `issuerScope` `public`, whose `credentialSubject.authority` is `{ scope: <community DID>, actions: [\"role:<name>\"] }` — the shape vtc/vetting/vetters/grant/0.1 issues."
         },
         "ext": {
           "$ref": "#/$defs/Ext"

package/src/vtc/members/personhood/revoke/0.1/payload.ts

@@ -24,9 +24,9 @@ export interface VTCMembersPersonhoodRevokeResponsePayload {
    */
   vmc?: {};
   /**
-   * Newly-minted role credential; omitted on an idempotent no-op.
+   * Newly-minted role credential (opaque here): a Verifiable Authority Credential (`type` including `AuthorityCredential`) issued by the community with `issuerScope` `public`, whose `credentialSubject.authority` is `{ scope: <community DID>, actions: ["role:<name>"] }` — the shape vtc/vetting/vetters/grant/0.1 issues. Omitted on an idempotent no-op.
    */
-  roleVec?: {};
+  roleVac?: {};
   ext?: Ext;
 }
 
@@ -97,9 +97,9 @@ export const PAYLOAD_SCHEMA = {
           "type": "object",
           "description": "Newly-minted membership credential carrying personhood false; omitted on an idempotent no-op."
         },
-        "roleVec": {
+        "roleVac": {
           "type": "object",
-          "description": "Newly-minted role credential; omitted on an idempotent no-op."
+          "description": "Newly-minted role credential (opaque here): a Verifiable Authority Credential (`type` including `AuthorityCredential`) issued by the community with `issuerScope` `public`, whose `credentialSubject.authority` is `{ scope: <community DID>, actions: [\"role:<name>\"] }` — the shape vtc/vetting/vetters/grant/0.1 issues. Omitted on an idempotent no-op."
         },
         "ext": {
           "$ref": "#/$defs/Ext"
@@ -147,9 +147,9 @@ export const RESPONSE_PAYLOAD_SCHEMA = {
           "type": "object",
           "description": "Newly-minted membership credential carrying personhood false; omitted on an idempotent no-op."
         },
-        "roleVec": {
+        "roleVac": {
           "type": "object",
-          "description": "Newly-minted role credential; omitted on an idempotent no-op."
+          "description": "Newly-minted role credential (opaque here): a Verifiable Authority Credential (`type` including `AuthorityCredential`) issued by the community with `issuerScope` `public`, whose `credentialSubject.authority` is `{ scope: <community DID>, actions: [\"role:<name>\"] }` — the shape vtc/vetting/vetters/grant/0.1 issues. Omitted on an idempotent no-op."
         },
         "ext": {
           "$ref": "#/$defs/Ext"

package/src/vtc/members/renew/0.1/payload.ts

@@ -16,9 +16,9 @@ export interface VTCMembersRenewResponsePayload {
    */
   vmc: {};
   /**
-   * The freshly-issued role Verifiable Endorsement Credential (opaque here).
+   * The freshly-issued role credential (opaque here): a Verifiable Authority Credential (`type` including `AuthorityCredential`) issued by the community with `issuerScope` `public`, whose `credentialSubject.authority` is `{ scope: <community DID>, actions: ["role:<name>"] }` — the shape vtc/vetting/vetters/grant/0.1 issues.
    */
-  roleVec: {};
+  roleVac: {};
   /**
    * Whether the renewed membership carries a personhood assertion.
    */
@@ -74,7 +74,7 @@ export const PAYLOAD_SCHEMA = {
       "required": [
         "did",
         "vmc",
-        "roleVec",
+        "roleVac",
         "personhood",
         "personhoodChanged"
       ],
@@ -87,9 +87,9 @@ export const PAYLOAD_SCHEMA = {
           "type": "object",
           "description": "The freshly-issued W3C Verifiable Membership Credential (opaque here)."
         },
-        "roleVec": {
+        "roleVac": {
           "type": "object",
-          "description": "The freshly-issued role Verifiable Endorsement Credential (opaque here)."
+          "description": "The freshly-issued role credential (opaque here): a Verifiable Authority Credential (`type` including `AuthorityCredential`) issued by the community with `issuerScope` `public`, whose `credentialSubject.authority` is `{ scope: <community DID>, actions: [\"role:<name>\"] }` — the shape vtc/vetting/vetters/grant/0.1 issues."
         },
         "personhood": {
           "type": "boolean",
@@ -130,7 +130,7 @@ export const RESPONSE_PAYLOAD_SCHEMA = {
       "required": [
         "did",
         "vmc",
-        "roleVec",
+        "roleVac",
         "personhood",
         "personhoodChanged"
       ],
@@ -143,9 +143,9 @@ export const RESPONSE_PAYLOAD_SCHEMA = {
           "type": "object",
           "description": "The freshly-issued W3C Verifiable Membership Credential (opaque here)."
         },
-        "roleVec": {
+        "roleVac": {
           "type": "object",
-          "description": "The freshly-issued role Verifiable Endorsement Credential (opaque here)."
+          "description": "The freshly-issued role credential (opaque here): a Verifiable Authority Credential (`type` including `AuthorityCredential`) issued by the community with `issuerScope` `public`, whose `credentialSubject.authority` is `{ scope: <community DID>, actions: [\"role:<name>\"] }` — the shape vtc/vetting/vetters/grant/0.1 issues."
         },
         "personhood": {
           "type": "boolean",

package/src/vtc/members/rotate/0.1/payload.ts

@@ -31,9 +31,9 @@ export interface VTCMembersRotateResponsePayload {
    */
   vmc: {};
   /**
-   * Role credential re-issued to the new DID (opaque here).
+   * Role credential re-issued to the new DID (opaque here): a Verifiable Authority Credential (`type` including `AuthorityCredential`) issued by the community with `issuerScope` `public`, whose `credentialSubject.authority` is `{ scope: <community DID>, actions: ["role:<name>"] }` — the shape vtc/vetting/vetters/grant/0.1 issues.
    */
-  roleVec: {};
+  roleVac: {};
   ext?: Ext;
 }
 
@@ -111,7 +111,7 @@ export const PAYLOAD_SCHEMA = {
         "newDid",
         "method",
         "vmc",
-        "roleVec"
+        "roleVac"
       ],
       "properties": {
         "newDid": {
@@ -129,9 +129,9 @@ export const PAYLOAD_SCHEMA = {
           "type": "object",
           "description": "Membership credential re-issued to the new DID (opaque here)."
         },
-        "roleVec": {
+        "roleVac": {
           "type": "object",
-          "description": "Role credential re-issued to the new DID (opaque here)."
+          "description": "Role credential re-issued to the new DID (opaque here): a Verifiable Authority Credential (`type` including `AuthorityCredential`) issued by the community with `issuerScope` `public`, whose `credentialSubject.authority` is `{ scope: <community DID>, actions: [\"role:<name>\"] }` — the shape vtc/vetting/vetters/grant/0.1 issues."
         },
         "ext": {
           "$ref": "#/$defs/Ext"
@@ -165,7 +165,7 @@ export const RESPONSE_PAYLOAD_SCHEMA = {
         "newDid",
         "method",
         "vmc",
-        "roleVec"
+        "roleVac"
       ],
       "properties": {
         "newDid": {
@@ -183,9 +183,9 @@ export const RESPONSE_PAYLOAD_SCHEMA = {
           "type": "object",
           "description": "Membership credential re-issued to the new DID (opaque here)."
         },
-        "roleVec": {
+        "roleVac": {
           "type": "object",
-          "description": "Role credential re-issued to the new DID (opaque here)."
+          "description": "Role credential re-issued to the new DID (opaque here): a Verifiable Authority Credential (`type` including `AuthorityCredential`) issued by the community with `issuerScope` `public`, whose `credentialSubject.authority` is `{ scope: <community DID>, actions: [\"role:<name>\"] }` — the shape vtc/vetting/vetters/grant/0.1 issues."
         },
         "ext": {
           "$ref": "#/$defs/Ext"

package/src/vtc/members/show/0.1/payload.ts

@@ -154,12 +154,12 @@ export const PAYLOAD_SCHEMA = {
           ],
           "description": "Id of the member's current Verifiable Membership Credential, if issued."
         },
-        "currentRoleVecId": {
+        "currentRoleVacId": {
           "type": [
             "string",
             "null"
           ],
-          "description": "Id of the member's current role Verifiable Endorsement Credential, if issued."
+          "description": "Id of the member's current role credential — a community-issued Verifiable Authority Credential conferring `role:<name>` — if issued. Formerly `currentRoleVecId`."
         },
         "personhood": {
           "type": "boolean",
@@ -298,12 +298,12 @@ export const RESPONSE_PAYLOAD_SCHEMA = {
           ],
           "description": "Id of the member's current Verifiable Membership Credential, if issued."
         },
-        "currentRoleVecId": {
+        "currentRoleVacId": {
           "type": [
             "string",
             "null"
           ],
-          "description": "Id of the member's current role Verifiable Endorsement Credential, if issued."
+          "description": "Id of the member's current role credential — a community-issued Verifiable Authority Credential conferring `role:<name>` — if issued. Formerly `currentRoleVecId`."
         },
         "personhood": {
           "type": "boolean",

package/src/vtc/members/update/0.1/payload.ts

@@ -201,12 +201,12 @@ export const PAYLOAD_SCHEMA = {
           ],
           "description": "Id of the member's current Verifiable Membership Credential, if issued."
         },
-        "currentRoleVecId": {
+        "currentRoleVacId": {
           "type": [
             "string",
             "null"
           ],
-          "description": "Id of the member's current role Verifiable Endorsement Credential, if issued."
+          "description": "Id of the member's current role credential — a community-issued Verifiable Authority Credential conferring `role:<name>` — if issued. Formerly `currentRoleVecId`."
         },
         "personhood": {
           "type": "boolean",
@@ -345,12 +345,12 @@ export const RESPONSE_PAYLOAD_SCHEMA = {
           ],
           "description": "Id of the member's current Verifiable Membership Credential, if issued."
         },
-        "currentRoleVecId": {
+        "currentRoleVacId": {
           "type": [
             "string",
             "null"
           ],
-          "description": "Id of the member's current role Verifiable Endorsement Credential, if issued."
+          "description": "Id of the member's current role credential — a community-issued Verifiable Authority Credential conferring `role:<name>` — if issued. Formerly `currentRoleVecId`."
         },
         "personhood": {
           "type": "boolean",

package/src/vtc/schemas/accepts/list/0.1/payload.ts

@@ -178,7 +178,7 @@ export const PAYLOAD_SCHEMA = {
           "format": "uri",
           "minLength": 1,
           "maxLength": 512,
-          "description": "The endorsement type URI a counted vetting statement carries as `credentialSubject.endorsement.type`, as registered with the community via vtc/endorsement-types/register."
+          "description": "The predicate IRI a counted vetting statement carries in `credentialSubject.predicate` — `https://registry.trustoverip.org/dtg/vsc/vetted/1`, the DTG VSC registry's identity-vetting predicate, or a predicate in a namespace the community controls — registered as one the community accepts via vtc/endorsement-types/register. A statement under any other predicate does not count."
         },
         "minStatements": {
           "type": "integer",
@@ -245,7 +245,7 @@ export const PAYLOAD_SCHEMA = {
               "minLength": 1,
               "maxLength": 128,
               "pattern": "^[a-zA-Z][a-zA-Z0-9_-]*$",
-              "description": "The role named in a community-issued `CommunityRole` endorsement credential (see `vtc/vetting/vetters/grant/0.1`). A statement counts only if its issuer holds that credential."
+              "description": "The role a statement's issuer must hold, matched as the action `role:<role>` in a Verifiable Authority Credential (`AuthorityCredential`) the community issued to that issuer, whose `authority.scope` is the community's DID (see `vtc/vetting/vetters/grant/0.1`). A statement counts only if its issuer holds such a credential."
             }
           },
           "description": "How a vetter's eligibility is established."
@@ -487,7 +487,7 @@ export const RESPONSE_PAYLOAD_SCHEMA = {
           "format": "uri",
           "minLength": 1,
           "maxLength": 512,
-          "description": "The endorsement type URI a counted vetting statement carries as `credentialSubject.endorsement.type`, as registered with the community via vtc/endorsement-types/register."
+          "description": "The predicate IRI a counted vetting statement carries in `credentialSubject.predicate` — `https://registry.trustoverip.org/dtg/vsc/vetted/1`, the DTG VSC registry's identity-vetting predicate, or a predicate in a namespace the community controls — registered as one the community accepts via vtc/endorsement-types/register. A statement under any other predicate does not count."
         },
         "minStatements": {
           "type": "integer",
@@ -554,7 +554,7 @@ export const RESPONSE_PAYLOAD_SCHEMA = {
               "minLength": 1,
               "maxLength": 128,
               "pattern": "^[a-zA-Z][a-zA-Z0-9_-]*$",
-              "description": "The role named in a community-issued `CommunityRole` endorsement credential (see `vtc/vetting/vetters/grant/0.1`). A statement counts only if its issuer holds that credential."
+              "description": "The role a statement's issuer must hold, matched as the action `role:<role>` in a Verifiable Authority Credential (`AuthorityCredential`) the community issued to that issuer, whose `authority.scope` is the community's DID (see `vtc/vetting/vetters/grant/0.1`). A statement counts only if its issuer holds such a credential."
             }
           },
           "description": "How a vetter's eligibility is established."

package/src/vtc/schemas/accepts/register/0.1/payload.ts

@@ -161,7 +161,7 @@ export const PAYLOAD_SCHEMA = {
           "format": "uri",
           "minLength": 1,
           "maxLength": 512,
-          "description": "The endorsement type URI a counted vetting statement carries as `credentialSubject.endorsement.type`, as registered with the community via vtc/endorsement-types/register."
+          "description": "The predicate IRI a counted vetting statement carries in `credentialSubject.predicate` — `https://registry.trustoverip.org/dtg/vsc/vetted/1`, the DTG VSC registry's identity-vetting predicate, or a predicate in a namespace the community controls — registered as one the community accepts via vtc/endorsement-types/register. A statement under any other predicate does not count."
         },
         "minStatements": {
           "type": "integer",
@@ -228,7 +228,7 @@ export const PAYLOAD_SCHEMA = {
               "minLength": 1,
               "maxLength": 128,
               "pattern": "^[a-zA-Z][a-zA-Z0-9_-]*$",
-              "description": "The role named in a community-issued `CommunityRole` endorsement credential (see `vtc/vetting/vetters/grant/0.1`). A statement counts only if its issuer holds that credential."
+              "description": "The role a statement's issuer must hold, matched as the action `role:<role>` in a Verifiable Authority Credential (`AuthorityCredential`) the community issued to that issuer, whose `authority.scope` is the community's DID (see `vtc/vetting/vetters/grant/0.1`). A statement counts only if its issuer holds such a credential."
             }
           },
           "description": "How a vetter's eligibility is established."
@@ -460,7 +460,7 @@ export const RESPONSE_PAYLOAD_SCHEMA = {
           "format": "uri",
           "minLength": 1,
           "maxLength": 512,
-          "description": "The endorsement type URI a counted vetting statement carries as `credentialSubject.endorsement.type`, as registered with the community via vtc/endorsement-types/register."
+          "description": "The predicate IRI a counted vetting statement carries in `credentialSubject.predicate` — `https://registry.trustoverip.org/dtg/vsc/vetted/1`, the DTG VSC registry's identity-vetting predicate, or a predicate in a namespace the community controls — registered as one the community accepts via vtc/endorsement-types/register. A statement under any other predicate does not count."
         },
         "minStatements": {
           "type": "integer",
@@ -527,7 +527,7 @@ export const RESPONSE_PAYLOAD_SCHEMA = {
               "minLength": 1,
               "maxLength": 128,
               "pattern": "^[a-zA-Z][a-zA-Z0-9_-]*$",
-              "description": "The role named in a community-issued `CommunityRole` endorsement credential (see `vtc/vetting/vetters/grant/0.1`). A statement counts only if its issuer holds that credential."
+              "description": "The role a statement's issuer must hold, matched as the action `role:<role>` in a Verifiable Authority Credential (`AuthorityCredential`) the community issued to that issuer, whose `authority.scope` is the community's DID (see `vtc/vetting/vetters/grant/0.1`). A statement counts only if its issuer holds such a credential."
             }
           },
           "description": "How a vetter's eligibility is established."