@openvtc/trust-tasks 0.22.5 → 0.22.6

package/CHANGELOG.md

@@ -11,6 +11,38 @@ The package versions over **its own API** — what a consumer compiles against
 not over `SPEC.md`. Below 1.0 a breaking change bumps the leading non-zero
 component.
 
+## 0.22.6 — 2026-10-02
+
+
+### Added
+
+- **auth/signing-key**: Enroll 0.2 — the identity's own authorization, and key replacement (#712)
+
+auth/signing-key/enroll/0.2 adds two optional members to 0.1:
+
+  - authorization: a complete auth/signing-key/authorize/0.1 document (new),
+    issued and signed by identityDid, addressed to the consumer, whose payload
+    is the enrolment's payload with authorization removed. A valid one is the
+    authority evidence of control over identityDid in place of an
+    operation-bound step-up. For a holder who signs in with a key its agent
+    holds (a VTA wallet persona) and has no passkey at the consumer, it is the
+    only evidence available, and it is the stronger of the two.
+  - replaces: an active delegation of the same identity revoked in the same
+    critical section as the enrolment. At the consumer's cap a holder whose
+    other keys live on browsers it no longer has could neither list nor revoke
+    them — both need a working key — and so could not enrol at all.
+
+  tooManyKeys gains details.activeKeys, listed only once the enrolment's
+  authority evidence has been accepted. New codes: authorizationInvalid,
+  replaceNotFound (one answer for every reason). The cap is decided after the
+  evidence and standing, counting a replaced key as gone. Producers SHOULD mint
+  a new key per enrolment: an expired delegation still answers
+  alreadyEnrolled.
+
+  authorization is an open object in the enroll schema on purpose: its proof
+  covers every member, so a binding must not narrow it to a typed struct that
+  drops one before verification.
+
 ## 0.22.5 — 2026-10-02
 
 

package/dist/auth/signing-key/authorize/0.1/payload.d.ts

@@ -0,0 +1,199 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/auth/signing-key/authorize/0.1/payload.schema.json
+ */
+import type { DeviceLabel, Ext, SigningKeyDid, SigningKeyScope } from "../../../../_shared/components.js";
+/**
+ * The terms of one signing-key enrolment, signed by the identity the key will act for. Exactly the payload of the auth/signing-key/enroll/0.2 document that carries this one as its `authorization`, with that member removed; the consumer compares the two and refuses any difference. The outer document members (id, type, issuer, recipient, issuedAt, expiresAt, proof) are owned by the framework — SPEC §6.3.
+ */
+export interface AuthSigningKeyAuthorizePayload {
+    signingKeyDid: SigningKeyDid;
+    /**
+     * The identity authorizing the delegation. Equal to the document's `issuer`: the identity signs for itself.
+     */
+    identityDid: string;
+    scope: SigningKeyScope;
+    deviceLabel?: DeviceLabel;
+    /**
+     * The lifetime the enrolment requests, as in auth/signing-key/enroll/0.2.
+     */
+    expiresAt?: string;
+    /**
+     * The identity's active key the enrolment replaces, as in auth/signing-key/enroll/0.2. Signed here so an authorization to add a key cannot be reused to remove one.
+     */
+    replaces?: SigningKeyDid;
+    ext?: Ext;
+}
+/** Shared definitions this specification references, re-exported under the names it used to declare them with. */
+export type { DeviceLabel, Ext, SigningKeyDid, SigningKeyScope };
+/** Trust Task type URI. */
+export declare const TYPE_URI: "https://trusttasks.org/spec/auth/signing-key/authorize/0.1";
+/** Stable alias for this specification's request payload shape. */
+export type Payload = AuthSigningKeyAuthorizePayload;
+/**
+ * This specification's payload schema, as a value.
+ *
+ * SPEC.md §7.2 item 2 is performed against this. It is shipped as data
+ * rather than only as a `.json` file because TypeScript types are erased
+ * at runtime: without a schema a consumer has nothing to validate, and
+ * every REQUIRED payload member is optional in practice. Cross-file
+ * `$ref`s are already inlined, so it needs no resolver.
+ */
+export declare const PAYLOAD_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $id: "https://trusttasks.org/spec/auth/signing-key/authorize/0.1";
+    readonly title: "Auth — Signing Key Authorize — payload";
+    readonly description: "The terms of one signing-key enrolment, signed by the identity the key will act for. Exactly the payload of the auth/signing-key/enroll/0.2 document that carries this one as its `authorization`, with that member removed; the consumer compares the two and refuses any difference. The outer document members (id, type, issuer, recipient, issuedAt, expiresAt, proof) are owned by the framework — SPEC §6.3.";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["signingKeyDid", "identityDid", "scope"];
+    readonly properties: {
+        readonly signingKeyDid: {
+            readonly $ref: "#/$defs/SigningKeyDid";
+        };
+        readonly identityDid: {
+            readonly type: "string";
+            readonly pattern: "^did:";
+            readonly minLength: 5;
+            readonly maxLength: 2048;
+            readonly description: "The identity authorizing the delegation. Equal to the document's `issuer`: the identity signs for itself.";
+        };
+        readonly scope: {
+            readonly $ref: "#/$defs/SigningKeyScope";
+        };
+        readonly deviceLabel: {
+            readonly $ref: "#/$defs/DeviceLabel";
+        };
+        readonly expiresAt: {
+            readonly type: "string";
+            readonly format: "date-time";
+            readonly description: "The lifetime the enrolment requests, as in auth/signing-key/enroll/0.2.";
+        };
+        readonly replaces: {
+            readonly $ref: "#/$defs/SigningKeyDid";
+            readonly description: "The identity's active key the enrolment replaces, as in auth/signing-key/enroll/0.2. Signed here so an authorization to add a key cannot be reused to remove one.";
+        };
+        readonly ext: {
+            readonly $ref: "#/$defs/Ext";
+        };
+    };
+    readonly $defs: {
+        readonly Ext: {
+            readonly title: "Ext";
+            readonly description: "Vendor-namespaced extension object per SPEC.md §4.5.1. Each immediate key MUST be a reverse-DNS namespace; structure under each namespace is opaque to the framework.";
+            readonly type: "object";
+            readonly minProperties: 1;
+            readonly additionalProperties: true;
+            readonly propertyNames: {
+                readonly pattern: "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$";
+            };
+        };
+        readonly SigningKeyDid: {
+            readonly title: "SigningKeyDid";
+            readonly type: "string";
+            readonly minLength: 9;
+            readonly maxLength: 256;
+            readonly pattern: "^did:key:z[1-9A-HJ-NP-Za-km-z]+$";
+            readonly description: "The delegated key, as a `did:key` — an Ed25519 multikey (`z6Mk…`) derived from the public half of a keypair the holder generated for itself, typically a non-extractable browser key. `did:key` only, because its document is a function of the key and resolves with no network: a key whose DID document could be rewritten after enrolment is not the key that was enrolled.";
+        };
+        readonly DeviceLabel: {
+            readonly title: "DeviceLabel";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 128;
+            readonly description: "A human-readable name for where the key lives, chosen by the enrolling identity — e.g. `Work laptop — Chrome`. Read by that identity and by administrators deciding which key to revoke; retained with the delegation. Free text authored by the enrolling identity, untrusted, and attributed to it wherever it is rendered. Absent rather than invented when none was chosen: an invented label is indistinguishable from a chosen one to somebody deciding which key to revoke.";
+        };
+        readonly SigningKeyScope: {
+            readonly title: "SigningKeyScope";
+            readonly type: "string";
+            readonly enum: readonly ["console"];
+            readonly description: "What a delegated key may be accepted for. `console`: the operations an administration console performs on the identity's behalf, authorized by the identity's own standing. Never an approver's signature on a consent or approval decision, whatever the scope: those require an `assertionMethod` key of the approver's own DID document, which a delegated key never is. A closed enumeration so a consumer cannot be asked for a scope it does not define; a later version adds values.";
+        };
+    };
+};
+/**
+ * SPEC.md §7.2 policy for the request variant, from this specification's
+ * front matter. Pass to `consumeInbound` — items 5b, 7 and 8 are
+ * per-specification and cannot be derived from the document alone, and
+ * item 2 needs the schema this carries.
+ */
+export declare const SPEC: {
+    readonly typeUri: "https://trusttasks.org/spec/auth/signing-key/authorize/0.1";
+    readonly isBearer: false;
+    readonly isProofRequired: true;
+    readonly isRecipientRequired: true;
+    readonly isIssuedAtRequired: true;
+    readonly payloadSchema: {
+        readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+        readonly $id: "https://trusttasks.org/spec/auth/signing-key/authorize/0.1";
+        readonly title: "Auth — Signing Key Authorize — payload";
+        readonly description: "The terms of one signing-key enrolment, signed by the identity the key will act for. Exactly the payload of the auth/signing-key/enroll/0.2 document that carries this one as its `authorization`, with that member removed; the consumer compares the two and refuses any difference. The outer document members (id, type, issuer, recipient, issuedAt, expiresAt, proof) are owned by the framework — SPEC §6.3.";
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly required: readonly ["signingKeyDid", "identityDid", "scope"];
+        readonly properties: {
+            readonly signingKeyDid: {
+                readonly $ref: "#/$defs/SigningKeyDid";
+            };
+            readonly identityDid: {
+                readonly type: "string";
+                readonly pattern: "^did:";
+                readonly minLength: 5;
+                readonly maxLength: 2048;
+                readonly description: "The identity authorizing the delegation. Equal to the document's `issuer`: the identity signs for itself.";
+            };
+            readonly scope: {
+                readonly $ref: "#/$defs/SigningKeyScope";
+            };
+            readonly deviceLabel: {
+                readonly $ref: "#/$defs/DeviceLabel";
+            };
+            readonly expiresAt: {
+                readonly type: "string";
+                readonly format: "date-time";
+                readonly description: "The lifetime the enrolment requests, as in auth/signing-key/enroll/0.2.";
+            };
+            readonly replaces: {
+                readonly $ref: "#/$defs/SigningKeyDid";
+                readonly description: "The identity's active key the enrolment replaces, as in auth/signing-key/enroll/0.2. Signed here so an authorization to add a key cannot be reused to remove one.";
+            };
+            readonly ext: {
+                readonly $ref: "#/$defs/Ext";
+            };
+        };
+        readonly $defs: {
+            readonly Ext: {
+                readonly title: "Ext";
+                readonly description: "Vendor-namespaced extension object per SPEC.md §4.5.1. Each immediate key MUST be a reverse-DNS namespace; structure under each namespace is opaque to the framework.";
+                readonly type: "object";
+                readonly minProperties: 1;
+                readonly additionalProperties: true;
+                readonly propertyNames: {
+                    readonly pattern: "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$";
+                };
+            };
+            readonly SigningKeyDid: {
+                readonly title: "SigningKeyDid";
+                readonly type: "string";
+                readonly minLength: 9;
+                readonly maxLength: 256;
+                readonly pattern: "^did:key:z[1-9A-HJ-NP-Za-km-z]+$";
+                readonly description: "The delegated key, as a `did:key` — an Ed25519 multikey (`z6Mk…`) derived from the public half of a keypair the holder generated for itself, typically a non-extractable browser key. `did:key` only, because its document is a function of the key and resolves with no network: a key whose DID document could be rewritten after enrolment is not the key that was enrolled.";
+            };
+            readonly DeviceLabel: {
+                readonly title: "DeviceLabel";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 128;
+                readonly description: "A human-readable name for where the key lives, chosen by the enrolling identity — e.g. `Work laptop — Chrome`. Read by that identity and by administrators deciding which key to revoke; retained with the delegation. Free text authored by the enrolling identity, untrusted, and attributed to it wherever it is rendered. Absent rather than invented when none was chosen: an invented label is indistinguishable from a chosen one to somebody deciding which key to revoke.";
+            };
+            readonly SigningKeyScope: {
+                readonly title: "SigningKeyScope";
+                readonly type: "string";
+                readonly enum: readonly ["console"];
+                readonly description: "What a delegated key may be accepted for. `console`: the operations an administration console performs on the identity's behalf, authorized by the identity's own standing. Never an approver's signature on a consent or approval decision, whatever the scope: those require an `assertionMethod` key of the approver's own DID document, which a delegated key never is. A closed enumeration so a consumer cannot be asked for a scope it does not define; a later version adds values.";
+            };
+        };
+    };
+};
+//# sourceMappingURL=payload.d.ts.map

package/dist/auth/signing-key/authorize/0.1/payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../../../../src/auth/signing-key/authorize/0.1/payload.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAG1G;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,aAAa,EAAE,aAAa,CAAC;IAC7B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,eAAe,CAAC;IACvB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,GAAG,CAAC,EAAE,GAAG,CAAC;CACX;AAED,kHAAkH;AAClH,YAAY,EAAE,WAAW,EAAE,GAAG,EAAE,aAAa,EAAE,eAAe,EAAE,CAAC;AAEjE,2BAA2B;AAC3B,eAAO,MAAM,QAAQ,EAAG,4DAAqE,CAAC;AAE9F,mEAAmE;AACnE,MAAM,MAAM,OAAO,GAAG,8BAA8B,CAAC;AAErD;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6EjB,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAOP,CAAC"}

package/dist/auth/signing-key/authorize/0.1/payload.js

@@ -0,0 +1,108 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/auth/signing-key/authorize/0.1/payload.schema.json
+ */
+/** Trust Task type URI. */
+export const TYPE_URI = "https://trusttasks.org/spec/auth/signing-key/authorize/0.1";
+/**
+ * This specification's payload schema, as a value.
+ *
+ * SPEC.md §7.2 item 2 is performed against this. It is shipped as data
+ * rather than only as a `.json` file because TypeScript types are erased
+ * at runtime: without a schema a consumer has nothing to validate, and
+ * every REQUIRED payload member is optional in practice. Cross-file
+ * `$ref`s are already inlined, so it needs no resolver.
+ */
+export const PAYLOAD_SCHEMA = {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://trusttasks.org/spec/auth/signing-key/authorize/0.1",
+    "title": "Auth — Signing Key Authorize — payload",
+    "description": "The terms of one signing-key enrolment, signed by the identity the key will act for. Exactly the payload of the auth/signing-key/enroll/0.2 document that carries this one as its `authorization`, with that member removed; the consumer compares the two and refuses any difference. The outer document members (id, type, issuer, recipient, issuedAt, expiresAt, proof) are owned by the framework — SPEC §6.3.",
+    "type": "object",
+    "additionalProperties": false,
+    "required": [
+        "signingKeyDid",
+        "identityDid",
+        "scope"
+    ],
+    "properties": {
+        "signingKeyDid": {
+            "$ref": "#/$defs/SigningKeyDid"
+        },
+        "identityDid": {
+            "type": "string",
+            "pattern": "^did:",
+            "minLength": 5,
+            "maxLength": 2048,
+            "description": "The identity authorizing the delegation. Equal to the document's `issuer`: the identity signs for itself."
+        },
+        "scope": {
+            "$ref": "#/$defs/SigningKeyScope"
+        },
+        "deviceLabel": {
+            "$ref": "#/$defs/DeviceLabel"
+        },
+        "expiresAt": {
+            "type": "string",
+            "format": "date-time",
+            "description": "The lifetime the enrolment requests, as in auth/signing-key/enroll/0.2."
+        },
+        "replaces": {
+            "$ref": "#/$defs/SigningKeyDid",
+            "description": "The identity's active key the enrolment replaces, as in auth/signing-key/enroll/0.2. Signed here so an authorization to add a key cannot be reused to remove one."
+        },
+        "ext": {
+            "$ref": "#/$defs/Ext"
+        }
+    },
+    "$defs": {
+        "Ext": {
+            "title": "Ext",
+            "description": "Vendor-namespaced extension object per SPEC.md §4.5.1. Each immediate key MUST be a reverse-DNS namespace; structure under each namespace is opaque to the framework.",
+            "type": "object",
+            "minProperties": 1,
+            "additionalProperties": true,
+            "propertyNames": {
+                "pattern": "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$"
+            }
+        },
+        "SigningKeyDid": {
+            "title": "SigningKeyDid",
+            "type": "string",
+            "minLength": 9,
+            "maxLength": 256,
+            "pattern": "^did:key:z[1-9A-HJ-NP-Za-km-z]+$",
+            "description": "The delegated key, as a `did:key` — an Ed25519 multikey (`z6Mk…`) derived from the public half of a keypair the holder generated for itself, typically a non-extractable browser key. `did:key` only, because its document is a function of the key and resolves with no network: a key whose DID document could be rewritten after enrolment is not the key that was enrolled."
+        },
+        "DeviceLabel": {
+            "title": "DeviceLabel",
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "description": "A human-readable name for where the key lives, chosen by the enrolling identity — e.g. `Work laptop — Chrome`. Read by that identity and by administrators deciding which key to revoke; retained with the delegation. Free text authored by the enrolling identity, untrusted, and attributed to it wherever it is rendered. Absent rather than invented when none was chosen: an invented label is indistinguishable from a chosen one to somebody deciding which key to revoke."
+        },
+        "SigningKeyScope": {
+            "title": "SigningKeyScope",
+            "type": "string",
+            "enum": [
+                "console"
+            ],
+            "description": "What a delegated key may be accepted for. `console`: the operations an administration console performs on the identity's behalf, authorized by the identity's own standing. Never an approver's signature on a consent or approval decision, whatever the scope: those require an `assertionMethod` key of the approver's own DID document, which a delegated key never is. A closed enumeration so a consumer cannot be asked for a scope it does not define; a later version adds values."
+        }
+    }
+};
+/**
+ * SPEC.md §7.2 policy for the request variant, from this specification's
+ * front matter. Pass to `consumeInbound` — items 5b, 7 and 8 are
+ * per-specification and cannot be derived from the document alone, and
+ * item 2 needs the schema this carries.
+ */
+export const SPEC = {
+    typeUri: TYPE_URI,
+    isBearer: false,
+    isProofRequired: true,
+    isRecipientRequired: true,
+    isIssuedAtRequired: true,
+    payloadSchema: PAYLOAD_SCHEMA,
+};
+//# sourceMappingURL=payload.js.map

package/dist/auth/signing-key/authorize/0.1/payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.js","sourceRoot":"","sources":["../../../../../src/auth/signing-key/authorize/0.1/payload.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA8BH,2BAA2B;AAC3B,MAAM,CAAC,MAAM,QAAQ,GAAG,4DAAqE,CAAC;AAK9F;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,SAAS,EAAE,8CAA8C;IACzD,KAAK,EAAE,4DAA4D;IACnE,OAAO,EAAE,wCAAwC;IACjD,aAAa,EAAE,qZAAqZ;IACpa,MAAM,EAAE,QAAQ;IAChB,sBAAsB,EAAE,KAAK;IAC7B,UAAU,EAAE;QACV,eAAe;QACf,aAAa;QACb,OAAO;KACR;IACD,YAAY,EAAE;QACZ,eAAe,EAAE;YACf,MAAM,EAAE,uBAAuB;SAChC;QACD,aAAa,EAAE;YACb,MAAM,EAAE,QAAQ;YAChB,SAAS,EAAE,OAAO;YAClB,WAAW,EAAE,CAAC;YACd,WAAW,EAAE,IAAI;YACjB,aAAa,EAAE,2GAA2G;SAC3H;QACD,OAAO,EAAE;YACP,MAAM,EAAE,yBAAyB;SAClC;QACD,aAAa,EAAE;YACb,MAAM,EAAE,qBAAqB;SAC9B;QACD,WAAW,EAAE;YACX,MAAM,EAAE,QAAQ;YAChB,QAAQ,EAAE,WAAW;YACrB,aAAa,EAAE,yEAAyE;SACzF;QACD,UAAU,EAAE;YACV,MAAM,EAAE,uBAAuB;YAC/B,aAAa,EAAE,mKAAmK;SACnL;QACD,KAAK,EAAE;YACL,MAAM,EAAE,aAAa;SACtB;KACF;IACD,OAAO,EAAE;QACP,KAAK,EAAE;YACL,OAAO,EAAE,KAAK;YACd,aAAa,EAAE,uKAAuK;YACtL,MAAM,EAAE,QAAQ;YAChB,eAAe,EAAE,CAAC;YAClB,sBAAsB,EAAE,IAAI;YAC5B,eAAe,EAAE;gBACf,SAAS,EAAE,mCAAmC;aAC/C;SACF;QACD,eAAe,EAAE;YACf,OAAO,EAAE,eAAe;YACxB,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,CAAC;YACd,WAAW,EAAE,GAAG;YAChB,SAAS,EAAE,kCAAkC;YAC7C,aAAa,EAAE,iXAAiX;SACjY;QACD,aAAa,EAAE;YACb,OAAO,EAAE,aAAa;YACtB,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,CAAC;YACd,WAAW,EAAE,GAAG;YAChB,aAAa,EAAE,odAAod;SACpe;QACD,iBAAiB,EAAE;YACjB,OAAO,EAAE,iBAAiB;YAC1B,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE;gBACN,SAAS;aACV;YACD,aAAa,EAAE,6dAA6d;SAC7e;KACF;CACO,CAAC;AAEX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,OAAO,EAAE,QAAQ;IACjB,QAAQ,EAAE,KAAK;IACf,eAAe,EAAE,IAAI;IACrB,mBAAmB,EAAE,IAAI;IACzB,kBAAkB,EAAE,IAAI;IACxB,aAAa,EAAE,cAAc;CACrB,CAAC"}