@openvtc/trust-tasks 0.24.0 → 0.24.2

package/dist/vtc/join-requests/wallet-session/status/0.1/payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../../../../../src/vtc/join-requests/wallet-session/status/0.1/payload.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,sCAAsC,CAAC;AAGhE;;GAEG;AACH,MAAM,WAAW,yCAAyC;IACxD;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,GAAG,CAAC;CACX;AACD,MAAM,WAAW,iDAAiD;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,KAAK,EAAE,gBAAgB,GAAG,kBAAkB,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;IACnF;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;OAEG;IACH,MAAM,CAAC,EAAE,qBAAqB,GAAG,mBAAmB,GAAG,kBAAkB,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;IAChH,GAAG,CAAC,EAAE,GAAG,CAAC;CACX;AACD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,WAAW,EAAE,CAAC,mBAAmB,EAAE,GAAG,mBAAmB,EAAE,CAAC,CAAC;IAC7D;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AACD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,kHAAkH;AAClH,YAAY,EAAE,GAAG,EAAE,CAAC;AAEpB,2BAA2B;AAC3B,eAAO,MAAM,QAAQ,EAAG,yEAAkF,CAAC;AAE3G,mEAAmE;AACnE,MAAM,MAAM,OAAO,GAAG,yCAAyC,CAAC;AAEhE,qEAAqE;AACrE,eAAO,MAAM,iBAAiB,EAAG,kFAA2F,CAAC;AAE7H,4EAA4E;AAC5E,MAAM,MAAM,QAAQ,GAAG,iDAAiD,CAAC;AAEzE;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqKjB,CAAC;AAEX,mEAAmE;AACnE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmJ1B,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAOP,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAOhB,CAAC"}

package/dist/vtc/join-requests/wallet-session/status/0.1/payload.js

@@ -0,0 +1,360 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/vtc/join-requests/wallet-session/status/0.1/payload.schema.json
+ */
+/** Trust Task type URI. */
+export const TYPE_URI = "https://trusttasks.org/spec/vtc/join-requests/wallet-session/status/0.1";
+/** Trust Task response type URI (request type URI + "#response"). */
+export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/vtc/join-requests/wallet-session/status/0.1#response";
+/**
+ * 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/vtc/join-requests/wallet-session/status/0.1",
+    "title": "VTC Join-Requests Wallet Session Status — payload",
+    "description": "An applicant reads the state of a wallet presentation session they opened with vtc/join-requests/wallet-session/start, and, once a wallet has answered, what the presentation established. The applicant is the document proof's signer. The outer document members are owned by the framework — SPEC §6.3.",
+    "type": "object",
+    "additionalProperties": false,
+    "required": [
+        "sessionId"
+    ],
+    "properties": {
+        "sessionId": {
+            "type": "string",
+            "minLength": 16,
+            "maxLength": 128,
+            "description": "The session to read, as vtc/join-requests/wallet-session/start returned it."
+        },
+        "ext": {
+            "$ref": "#/$defs/Ext"
+        }
+    },
+    "$defs": {
+        "PresentedCredential": {
+            "title": "PresentedCredential",
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+                "credentialQueryId",
+                "format",
+                "issuer"
+            ],
+            "description": "One credential the wallet presented, described without any of its claim values.",
+            "properties": {
+                "credentialQueryId": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 128,
+                    "description": "The `id` of the DCQL credential query this credential was presented for — the key it arrived under in the OpenID4VP `vp_token`."
+                },
+                "format": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 64,
+                    "description": "The credential format identifier, as OpenID4VP names it (`dc+sd-jwt`, `mso_mdoc`). Carried verbatim."
+                },
+                "issuer": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 2048,
+                    "description": "The identifier of the credential's issuer as the community verified it — a DID, or for an issuer identified by an X.509 certificate, the certificate subject or hash the community's policy names it by."
+                },
+                "vct": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 2048,
+                    "description": "The SD-JWT VC credential type (`vct`). Present for SD-JWT VC credentials."
+                }
+            }
+        },
+        "Evidence": {
+            "title": "Evidence",
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+                "satisfied",
+                "holder",
+                "credentials"
+            ],
+            "description": "What a verified wallet presentation established. Never claim values.",
+            "properties": {
+                "satisfied": {
+                    "type": "boolean",
+                    "description": "Whether the presentation satisfies the criterion's DCQL query. Satisfying the query is not admission: the community still decides the join under the criterion's `admission`."
+                },
+                "holder": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 2048,
+                    "description": "The identifier of the key that held the presented credentials — for an SD-JWT VC, the `did:key` of its `cnf` key. Recorded beside the applicant DID, never as it."
+                },
+                "credentials": {
+                    "type": "array",
+                    "minItems": 1,
+                    "maxItems": 32,
+                    "items": {
+                        "$ref": "#/$defs/PresentedCredential"
+                    },
+                    "description": "The credentials presented, one entry each."
+                },
+                "heldUntil": {
+                    "type": "string",
+                    "format": "date-time",
+                    "description": "When evidence not yet recorded on a join request is discarded if the applicant has not submitted under the session's criterion. Absent when the evidence is recorded on a request."
+                }
+            }
+        },
+        "Response": {
+            "$anchor": "response",
+            "title": "VTC Join-Requests Wallet Session Status — response payload",
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+                "sessionId",
+                "state",
+                "expiresAt"
+            ],
+            "properties": {
+                "sessionId": {
+                    "type": "string",
+                    "minLength": 16,
+                    "maxLength": 128
+                },
+                "state": {
+                    "type": "string",
+                    "enum": [
+                        "awaitingWallet",
+                        "requestRetrieved",
+                        "presented",
+                        "refused",
+                        "expired"
+                    ],
+                    "description": "`awaitingWallet`: no wallet has fetched the request object. `requestRetrieved`: a wallet has fetched it and not yet answered. `presented`: a wallet answered and the presentation verified; see `evidence`. `refused`: a wallet answered and the community did not accept the answer, or the wallet declined; see `reason`. `expired`: the session closed unanswered."
+                },
+                "expiresAt": {
+                    "type": "string",
+                    "format": "date-time",
+                    "description": "When the session closes, or closed, if unanswered."
+                },
+                "requestId": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 128,
+                    "description": "The join request the session's evidence is recorded on. Present when the session was bound to one, or its evidence has since been attached to one by a submission."
+                },
+                "evidence": {
+                    "$ref": "#/$defs/Evidence",
+                    "description": "Present only when `state` is `presented`."
+                },
+                "reason": {
+                    "type": "string",
+                    "enum": [
+                        "presentationInvalid",
+                        "queryNotSatisfied",
+                        "issuerNotTrusted",
+                        "statusNotValid",
+                        "walletDeclined"
+                    ],
+                    "description": "Why the session ended `refused`. `presentationInvalid`: the response or a presentation failed verification — decryption, `state`, signature, key binding, nonce or audience. `queryNotSatisfied`: the presentations verified but do not satisfy the query. `issuerNotTrusted`: a credential's issuer is not one the criterion accepts. `statusNotValid`: a credential's status is revoked or suspended, or could not be read. `walletDeclined`: the wallet answered with an OpenID4VP error, such as `access_denied`. Present only when `state` is `refused`."
+                },
+                "ext": {
+                    "$ref": "#/$defs/Ext"
+                }
+            }
+        },
+        "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-]+)+$"
+            }
+        }
+    }
+};
+/** As {@link PAYLOAD_SCHEMA}, for the success-response variant. */
+export const RESPONSE_PAYLOAD_SCHEMA = {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$ref": "#/$defs/Response",
+    "$defs": {
+        "PresentedCredential": {
+            "title": "PresentedCredential",
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+                "credentialQueryId",
+                "format",
+                "issuer"
+            ],
+            "description": "One credential the wallet presented, described without any of its claim values.",
+            "properties": {
+                "credentialQueryId": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 128,
+                    "description": "The `id` of the DCQL credential query this credential was presented for — the key it arrived under in the OpenID4VP `vp_token`."
+                },
+                "format": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 64,
+                    "description": "The credential format identifier, as OpenID4VP names it (`dc+sd-jwt`, `mso_mdoc`). Carried verbatim."
+                },
+                "issuer": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 2048,
+                    "description": "The identifier of the credential's issuer as the community verified it — a DID, or for an issuer identified by an X.509 certificate, the certificate subject or hash the community's policy names it by."
+                },
+                "vct": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 2048,
+                    "description": "The SD-JWT VC credential type (`vct`). Present for SD-JWT VC credentials."
+                }
+            }
+        },
+        "Evidence": {
+            "title": "Evidence",
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+                "satisfied",
+                "holder",
+                "credentials"
+            ],
+            "description": "What a verified wallet presentation established. Never claim values.",
+            "properties": {
+                "satisfied": {
+                    "type": "boolean",
+                    "description": "Whether the presentation satisfies the criterion's DCQL query. Satisfying the query is not admission: the community still decides the join under the criterion's `admission`."
+                },
+                "holder": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 2048,
+                    "description": "The identifier of the key that held the presented credentials — for an SD-JWT VC, the `did:key` of its `cnf` key. Recorded beside the applicant DID, never as it."
+                },
+                "credentials": {
+                    "type": "array",
+                    "minItems": 1,
+                    "maxItems": 32,
+                    "items": {
+                        "$ref": "#/$defs/PresentedCredential"
+                    },
+                    "description": "The credentials presented, one entry each."
+                },
+                "heldUntil": {
+                    "type": "string",
+                    "format": "date-time",
+                    "description": "When evidence not yet recorded on a join request is discarded if the applicant has not submitted under the session's criterion. Absent when the evidence is recorded on a request."
+                }
+            }
+        },
+        "Response": {
+            "$anchor": "response",
+            "title": "VTC Join-Requests Wallet Session Status — response payload",
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+                "sessionId",
+                "state",
+                "expiresAt"
+            ],
+            "properties": {
+                "sessionId": {
+                    "type": "string",
+                    "minLength": 16,
+                    "maxLength": 128
+                },
+                "state": {
+                    "type": "string",
+                    "enum": [
+                        "awaitingWallet",
+                        "requestRetrieved",
+                        "presented",
+                        "refused",
+                        "expired"
+                    ],
+                    "description": "`awaitingWallet`: no wallet has fetched the request object. `requestRetrieved`: a wallet has fetched it and not yet answered. `presented`: a wallet answered and the presentation verified; see `evidence`. `refused`: a wallet answered and the community did not accept the answer, or the wallet declined; see `reason`. `expired`: the session closed unanswered."
+                },
+                "expiresAt": {
+                    "type": "string",
+                    "format": "date-time",
+                    "description": "When the session closes, or closed, if unanswered."
+                },
+                "requestId": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 128,
+                    "description": "The join request the session's evidence is recorded on. Present when the session was bound to one, or its evidence has since been attached to one by a submission."
+                },
+                "evidence": {
+                    "$ref": "#/$defs/Evidence",
+                    "description": "Present only when `state` is `presented`."
+                },
+                "reason": {
+                    "type": "string",
+                    "enum": [
+                        "presentationInvalid",
+                        "queryNotSatisfied",
+                        "issuerNotTrusted",
+                        "statusNotValid",
+                        "walletDeclined"
+                    ],
+                    "description": "Why the session ended `refused`. `presentationInvalid`: the response or a presentation failed verification — decryption, `state`, signature, key binding, nonce or audience. `queryNotSatisfied`: the presentations verified but do not satisfy the query. `issuerNotTrusted`: a credential's issuer is not one the criterion accepts. `statusNotValid`: a credential's status is revoked or suspended, or could not be read. `walletDeclined`: the wallet answered with an OpenID4VP error, such as `access_denied`. Present only when `state` is `refused`."
+                },
+                "ext": {
+                    "$ref": "#/$defs/Ext"
+                }
+            }
+        },
+        "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-]+)+$"
+            }
+        }
+    }
+};
+/**
+ * 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: false,
+    payloadSchema: PAYLOAD_SCHEMA,
+};
+/**
+ * SPEC.md §7.2 policy for the success-response variant. `isRecipientRequired`
+ * tracks the *issuer* party's requirement because a response swaps the
+ * parties (§7.3 item 5).
+ */
+export const RESPONSE_SPEC = {
+    typeUri: RESPONSE_TYPE_URI,
+    isBearer: false,
+    isProofRequired: true,
+    isRecipientRequired: true,
+    isIssuedAtRequired: false,
+    payloadSchema: RESPONSE_PAYLOAD_SCHEMA,
+};
+//# sourceMappingURL=payload.js.map

package/dist/vtc/join-requests/wallet-session/status/0.1/payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.js","sourceRoot":"","sources":["../../../../../../src/vtc/join-requests/wallet-session/status/0.1/payload.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openvtc/trust-tasks",
-  "version": "0.24.0",
+  "version": "0.24.2",
   "description": "Generated TypeScript bindings for the Trust Tasks framework registry.",
   "type": "module",
   "main": "./dist/index.js",

package/src/_shared/components.ts

@@ -443,6 +443,8 @@ export type Capability_DeviceV0_1 =
   | "room-open"
   | "key-export"
   | "sign-sshsig"
+  | "sign-jws"
+  | "sign-csr"
   | "external-accounts-manage"
   | "external-auth-use";
 /**
@@ -465,6 +467,8 @@ export type Capability_DeviceV0_2 =
   | "roomOpen"
   | "keyExport"
   | "signSshsig"
+  | "signJws"
+  | "signCsr"
   | "externalAccountsManage"
   | "externalAuthUse";
 /**
@@ -5673,6 +5677,59 @@ export interface Field {
     [k: string]: unknown | undefined;
   };
 }
+/**
+ * The `file` member of a sealed record body: everything that describes a file, sealed with the record, signed by the record's author, and never seen by the host. Defined here so that clients interoperate; no host task carries it, because the host receives only ciphertext.
+ *
+ * **Byte encodings.** In every derivation below, `fileId` is its **32 decoded bytes**, never its base64url text; `roomId` is the **UTF-8 bytes** of the room identifier exactly as it appears on the wire; string constants are their ASCII bytes; `u8`, `u32be` and `u64be` are unsigned integers of that width, big-endian. Epochs are unsigned 64-bit on the wire. An implementation that holds epochs in a narrower type **MUST** refuse a value it cannot represent with `malformedRequest` (or, reading a manifest, refuse the file), and **MUST NOT** truncate it.
+ *
+ * **The file key.** `file_key = HKDF-SHA256(ikm = storage_key(epoch), salt = fileId, info = "openvtc/room/file/v1" || roomId || u64be(epoch))`, where `storage_key(epoch)` is the room's per-epoch storage key, the one records are sealed under. It is derived per file and never stored. It is bound to the room and the epoch, so a key released for one room cannot open a blob relocated from another, and releasing it exposes one file and nothing else.
+ *
+ * **Padding.** With `padding: "padme"`, the plaintext of length `L = size` is extended with zero bytes to `padme(L)`: for `L < 2`, `padme(L) = L`; otherwise `E = floor(log2 L)`, `S = floor(log2 E) + 1`, `z = E − S`, `mask = 2^z − 1`, and `padme(L) = (L + mask) & ~mask`. The padded length is `padme(size)`; without padding it is `size`. Padding bytes **MUST** be zero.
+ *
+ * **The STREAM construction.** The padded plaintext is cut into `segmentSize`-byte segments, the last holding the remainder; an empty plaintext is one empty final segment. Segment `i` is sealed with ChaCha20-Poly1305 under `file_key`, with nonce `u32be(0) || u64be(i)` and associated data `"openvtc/room/file/v1" || roomId || fileId || u64be(epoch) || u64be(i) || u8(final)`, where `final` is 1 on the last segment and 0 on every other. A host that truncates, reorders or splices ciphertext produces an authentication failure, never a shorter or rearranged file. The nonces are counters, so a `file_key` MUST NOT seal two different files; a fresh random `fileId` is what guarantees it. Each sealed segment is one transfer chunk of the blob (BlobManifest), so `segmentSize + 16` is the blob's `chunks.chunkSize`, and an empty file is one 16-byte chunk.
+ *
+ * **Reading.** A reader opens the record, derives or obtains the file key, and **MUST**, before trusting a byte:
+ * - check that the blob's `chunks.chunkSize` equals `segmentSize + 16` and that `chunks.chunkCount` equals `max(1, ceil(paddedLength / segmentSize))`, and refuse the file otherwise;
+ * - decrypt every segment in order, refusing the file on any authentication failure or on a final flag anywhere but the last segment;
+ * - check that the decrypted length equals the padded length, that every padding byte is zero, and, after removing the padding, that the plaintext matches `digest`.
+ *
+ * A reader **MUST** refuse a file that fails any check, and **MUST NOT** present it with a warning instead. A reader that streams **MUST NOT** treat the plaintext as received — save it under its final name, render it, or hand it to another component — until the digest has verified; it writes to a temporary destination and discards that destination on a mismatch.
+ */
+export interface FileManifest {
+  /**
+   * 32 random bytes, base64url without padding, minted by the uploader for this file and never reused. The salt of the file key.
+   */
+  fileId: string;
+  /**
+   * The file's name as the uploader gave it. Sealed: the host never sees it. Readers MUST treat it as untrusted text: strip path separators before using it as a local file name, and never interpret it as markup.
+   */
+  name: string;
+  /**
+   * IANA media type, without parameters. Advisory: a reader decides how to render from the bytes and its own policy, never from this alone.
+   */
+  mediaType?: string;
+  /**
+   * Plaintext bytes, before padding. The decrypted length is `padme(size)` with `padme` padding and `size` without.
+   */
+  size: number;
+  /**
+   * Digest of the plaintext bytes. Signed, with the rest of the record body, by the record's author, so a reader that verifies it knows which member put exactly these bytes there.
+   */
+  digest: DigestMultibase;
+  /**
+   * The epoch whose storage key the file key derives from. Usually the record's own epoch; a record rewritten under a later epoch that keeps the same blob keeps the file's original epoch here. Unsigned 64-bit; see Byte encodings.
+   */
+  epoch: number;
+  /**
+   * Plaintext bytes per STREAM segment: the transfer chunk size less the 16-byte tag, so that one sealed segment is one chunk.
+   */
+  segmentSize: number;
+  /**
+   * Whether the plaintext was padded before sealing, so that ciphertext sizes do not fingerprint known documents. `padme`: zero bytes appended to reach `padme(size)`, the formula above. Absent means `none`. The padding is inside the final segments, and a reader checks it is zero and removes it by truncating to `size`.
+   */
+  padding?: "none" | "padme";
+  blobRef: BlobRef;
+}
 /**
  * A person's account on one forge. `id` is authoritative; `login` is for display only, because logins can be renamed and re-registered.
  */

package/src/device/list/0.1/payload.ts

@@ -250,6 +250,8 @@ export const PAYLOAD_SCHEMA = {
         "room-open",
         "key-export",
         "sign-sshsig",
+        "sign-jws",
+        "sign-csr",
         "external-accounts-manage",
         "external-auth-use"
       ],
@@ -592,6 +594,8 @@ export const RESPONSE_PAYLOAD_SCHEMA = {
         "room-open",
         "key-export",
         "sign-sshsig",
+        "sign-jws",
+        "sign-csr",
         "external-accounts-manage",
         "external-auth-use"
       ],

package/src/device/list/0.2/payload.ts

@@ -250,6 +250,8 @@ export const PAYLOAD_SCHEMA = {
         "roomOpen",
         "keyExport",
         "signSshsig",
+        "signJws",
+        "signCsr",
         "externalAccountsManage",
         "externalAuthUse"
       ],
@@ -592,6 +594,8 @@ export const RESPONSE_PAYLOAD_SCHEMA = {
         "roomOpen",
         "keyExport",
         "signSshsig",
+        "signJws",
+        "signCsr",
         "externalAccountsManage",
         "externalAuthUse"
       ],

package/src/device/register/0.1/payload.ts

@@ -218,6 +218,8 @@ export const PAYLOAD_SCHEMA = {
         "room-open",
         "key-export",
         "sign-sshsig",
+        "sign-jws",
+        "sign-csr",
         "external-accounts-manage",
         "external-auth-use"
       ],
@@ -550,6 +552,8 @@ export const RESPONSE_PAYLOAD_SCHEMA = {
         "room-open",
         "key-export",
         "sign-sshsig",
+        "sign-jws",
+        "sign-csr",
         "external-accounts-manage",
         "external-auth-use"
       ],

package/src/device/register/0.2/payload.ts

@@ -218,6 +218,8 @@ export const PAYLOAD_SCHEMA = {
         "roomOpen",
         "keyExport",
         "signSshsig",
+        "signJws",
+        "signCsr",
         "externalAccountsManage",
         "externalAuthUse"
       ],
@@ -550,6 +552,8 @@ export const RESPONSE_PAYLOAD_SCHEMA = {
         "roomOpen",
         "keyExport",
         "signSshsig",
+        "signJws",
+        "signCsr",
         "externalAccountsManage",
         "externalAuthUse"
       ],

package/src/index.ts

@@ -306,6 +306,8 @@ export * as KeysRename_v0_1 from "./keys/rename/0.1/payload.js";
 export * as KeysRevoke_v0_1 from "./keys/revoke/0.1/payload.js";
 export * as KeysSetExportability_v0_1 from "./keys/set-exportability/0.1/payload.js";
 export * as KeysShow_v0_1 from "./keys/show/0.1/payload.js";
+export * as KeysSignCsr_v0_1 from "./keys/sign-csr/0.1/payload.js";
+export * as KeysSignJws_v0_1 from "./keys/sign-jws/0.1/payload.js";
 export * as KeysSignSshsig_v0_1 from "./keys/sign-sshsig/0.1/payload.js";
 export * as KeysSign_v0_1 from "./keys/sign/0.1/payload.js";
 export * as MediatorOpsShared_v0_1 from "./messaging/_shared/0.1/mediator-ops.js";
@@ -736,6 +738,8 @@ export * as VtcJoinRequestsSubmit_v0_2 from "./vtc/join-requests/submit/0.2/payl
 export * as VtcJoinRequestsSubmit_v0_3 from "./vtc/join-requests/submit/0.3/payload.js";
 export * as VtcJoinRequestsSupplement_v0_1 from "./vtc/join-requests/supplement/0.1/payload.js";
 export * as VtcJoinRequestsVettingShow_v0_1 from "./vtc/join-requests/vetting/show/0.1/payload.js";
+export * as VtcJoinRequestsWalletSessionStart_v0_1 from "./vtc/join-requests/wallet-session/start/0.1/payload.js";
+export * as VtcJoinRequestsWalletSessionStatus_v0_1 from "./vtc/join-requests/wallet-session/status/0.1/payload.js";
 export * as VtcJoinRequestsWithdraw_v0_1 from "./vtc/join-requests/withdraw/0.1/payload.js";
 export * as VtcMembersAdminRemove_v0_1 from "./vtc/members/admin-remove/0.1/payload.js";
 export * as VtcMembersAuthorityReducedNotice_v0_1 from "./vtc/members/authority-reduced-notice/0.1/payload.js";