@openvtc/trust-tasks 0.25.1 → 0.25.2

package/dist/vta/pcs/tokens/request/0.1/payload.d.ts

@@ -0,0 +1,908 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/vta/pcs/tokens/request/0.1/payload.schema.json
+ */
+import type { CommunityParameters, Ext, PublishedConfig, PublishedEvent, TickLength, Tier } from "../../../../../_shared/components.js";
+/**
+ * A vetter's client asks its VTA for one draw of the attestation-token drip: blinded serials bound to the vetter's member DID, the label and the tick.
+ */
+export interface VTAPCSTokensRequestPayload {
+    /**
+     * The context the engine belongs to. Its key is derived from this context's base.
+     */
+    contextId: string;
+    /**
+     * The community's DID: the helper whose parameters the engine runs under.
+     */
+    community: string;
+    /**
+     * The community's published hidden-vetting parameters, copied verbatim from its join manifest.
+     */
+    parameters: CommunityParameters;
+    /**
+     * The token label to draw under.
+     */
+    label: string;
+    /**
+     * The tick of the label being drawn.
+     */
+    tick: number;
+    /**
+     * How many tokens to ask for: normally the parameters' dripPerTick.
+     */
+    count: number;
+    ext?: Ext;
+}
+export interface VTAPCSTokensRequestResponsePayload {
+    request: TokenDrawRequest;
+    ext?: Ext;
+}
+/**
+ * The payload of a vtc/vetting/vetters/pcs-tokens/0.1 request, without its ext.
+ */
+export interface TokenDrawRequest {
+    label: string;
+    tick: number;
+    /**
+     * @minItems 1
+     * @maxItems 64
+     */
+    requests: [
+        {
+            commitment: string;
+            openingProof: string;
+        },
+        ...{
+            commitment: string;
+            openingProof: string;
+        }[]
+    ];
+}
+/** Shared definitions this specification references, re-exported under the names it used to declare them with. */
+export type { CommunityParameters, Ext, PublishedConfig, PublishedEvent, TickLength, Tier };
+/** Trust Task type URI. */
+export declare const TYPE_URI: "https://trusttasks.org/spec/vta/pcs/tokens/request/0.1";
+/** Stable alias for this specification's request payload shape. */
+export type Payload = VTAPCSTokensRequestPayload;
+/** Trust Task response type URI (request type URI + "#response"). */
+export declare const RESPONSE_TYPE_URI: "https://trusttasks.org/spec/vta/pcs/tokens/request/0.1#response";
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = VTAPCSTokensRequestResponsePayload;
+/**
+ * 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/vta/pcs/tokens/request/0.1";
+    readonly title: "VTA PCS — Tokens — Request — payload";
+    readonly description: "A vetter's client asks its VTA for one draw of the attestation-token drip: blinded serials bound to the vetter's member DID, the label and the tick.";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["contextId", "community", "parameters", "label", "tick", "count"];
+    readonly properties: {
+        readonly contextId: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly description: "The context the engine belongs to. Its key is derived from this context's base.";
+        };
+        readonly community: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly description: "The community's DID: the helper whose parameters the engine runs under.";
+        };
+        readonly parameters: {
+            readonly $ref: "#/$defs/CommunityParameters";
+            readonly description: "The community's published hidden-vetting parameters, copied verbatim from its join manifest.";
+        };
+        readonly label: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 128;
+            readonly description: "The token label to draw under.";
+        };
+        readonly tick: {
+            readonly type: "integer";
+            readonly minimum: 0;
+            readonly description: "The tick of the label being drawn.";
+        };
+        readonly count: {
+            readonly type: "integer";
+            readonly minimum: 1;
+            readonly maximum: 64;
+            readonly description: "How many tokens to ask for: normally the parameters' dripPerTick.";
+        };
+        readonly ext: {
+            readonly $ref: "#/$defs/Ext";
+        };
+    };
+    readonly $defs: {
+        readonly TokenDrawRequest: {
+            readonly title: "TokenDrawRequest";
+            readonly description: "The payload of a vtc/vetting/vetters/pcs-tokens/0.1 request, without its ext.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["label", "tick", "requests"];
+            readonly properties: {
+                readonly label: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 128;
+                };
+                readonly tick: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                };
+                readonly requests: {
+                    readonly type: "array";
+                    readonly minItems: 1;
+                    readonly maxItems: 64;
+                    readonly items: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["commitment", "openingProof"];
+                        readonly properties: {
+                            readonly commitment: {
+                                readonly type: "string";
+                                readonly pattern: "^z[1-9A-HJ-NP-Za-km-z]+$";
+                            };
+                            readonly openingProof: {
+                                readonly type: "string";
+                                readonly pattern: "^z[1-9A-HJ-NP-Za-km-z]+$";
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        readonly Response: {
+            readonly $anchor: "response";
+            readonly title: "VTA PCS — Tokens — Request — response payload";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["request"];
+            readonly properties: {
+                readonly request: {
+                    readonly $ref: "#/$defs/TokenDrawRequest";
+                };
+                readonly ext: {
+                    readonly $ref: "#/$defs/Ext";
+                };
+            };
+        };
+        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 CommunityParameters: {
+            readonly title: "CommunityParameters";
+            readonly description: "The community's hidden-vetting parameters exactly as its join manifest publishes them, under the criterion's `vetting.ext`. The caller copies them in verbatim on every call that needs them, because the community rotates labels and the engine keeps no copy of its own: a stale copy costs the caller a refused proof, never a mistaken one.";
+            readonly $ref: "#/$defs/PublishedConfig";
+        };
+        readonly PublishedConfig: {
+            readonly title: "PublishedConfig";
+            readonly description: "The parameters exactly as they now appear in this community's join manifest, under vetting.ext. What an applicant and a vetter read.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["suite", "helperKey", "tokenKey", "vetterLabels", "tokenLabels", "dripPerTick", "tickLength", "events"];
+            readonly properties: {
+                readonly suite: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly helperKey: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly description: "The helper verification key, multibase — named for its role on the wire rather than for hvk.";
+                };
+                readonly tokenKey: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly description: "The token verification key, multibase — named for its role on the wire rather than for tvk.";
+                };
+                readonly vetterLabels: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly description: "Class labels published whole, e.g. vetter/2026-09 — a request names one of these, not the bare period.";
+                };
+                readonly tokenLabels: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                };
+                readonly dripPerTick: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                };
+                readonly tickLength: {
+                    readonly $ref: "#/$defs/TickLength";
+                };
+                readonly events: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/$defs/PublishedEvent";
+                    };
+                };
+            };
+        };
+        readonly PublishedEvent: {
+            readonly title: "PublishedEvent";
+            readonly description: "The published shape drops approvedBy and graceDays: who approved is the community's own record, and a vetter is told closesAfter when its request is approved rather than being handed the raw grace period here.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["eventId", "startDate", "endDate", "groupFloor", "tiers"];
+            readonly properties: {
+                readonly eventId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly startDate: {
+                    readonly type: "string";
+                    readonly format: "date";
+                };
+                readonly endDate: {
+                    readonly type: "string";
+                    readonly format: "date";
+                };
+                readonly groupFloor: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                };
+                readonly tiers: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/$defs/Tier";
+                    };
+                };
+            };
+        };
+        readonly Tier: {
+            readonly title: "Tier";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["name", "dripPerTick"];
+            readonly properties: {
+                readonly name: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly description: "How the menu names it: desk, busy-desk.";
+                };
+                readonly dripPerTick: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                    readonly description: "How many tokens a tick under this tier yields.";
+                };
+            };
+        };
+        readonly TickLength: {
+            readonly title: "TickLength";
+            readonly type: "string";
+            readonly pattern: "^P(?:\\d+D(?:T\\d+H)?|T\\d+H)$";
+            readonly description: "The length of one tick of the drip, as an ISO 8601 duration in days and/or hours — at least `PT1H`. A label's tick `t` is the window starting `t` tick lengths after the label's start (`vtc/vetting/vetters/pcs-tokens`).";
+        };
+    };
+};
+/** As {@link PAYLOAD_SCHEMA}, for the success-response variant. */
+export declare const RESPONSE_PAYLOAD_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $ref: "#/$defs/Response";
+    readonly $defs: {
+        readonly TokenDrawRequest: {
+            readonly title: "TokenDrawRequest";
+            readonly description: "The payload of a vtc/vetting/vetters/pcs-tokens/0.1 request, without its ext.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["label", "tick", "requests"];
+            readonly properties: {
+                readonly label: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 128;
+                };
+                readonly tick: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                };
+                readonly requests: {
+                    readonly type: "array";
+                    readonly minItems: 1;
+                    readonly maxItems: 64;
+                    readonly items: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["commitment", "openingProof"];
+                        readonly properties: {
+                            readonly commitment: {
+                                readonly type: "string";
+                                readonly pattern: "^z[1-9A-HJ-NP-Za-km-z]+$";
+                            };
+                            readonly openingProof: {
+                                readonly type: "string";
+                                readonly pattern: "^z[1-9A-HJ-NP-Za-km-z]+$";
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        readonly Response: {
+            readonly $anchor: "response";
+            readonly title: "VTA PCS — Tokens — Request — response payload";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["request"];
+            readonly properties: {
+                readonly request: {
+                    readonly $ref: "#/$defs/TokenDrawRequest";
+                };
+                readonly ext: {
+                    readonly $ref: "#/$defs/Ext";
+                };
+            };
+        };
+        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 CommunityParameters: {
+            readonly title: "CommunityParameters";
+            readonly description: "The community's hidden-vetting parameters exactly as its join manifest publishes them, under the criterion's `vetting.ext`. The caller copies them in verbatim on every call that needs them, because the community rotates labels and the engine keeps no copy of its own: a stale copy costs the caller a refused proof, never a mistaken one.";
+            readonly $ref: "#/$defs/PublishedConfig";
+        };
+        readonly PublishedConfig: {
+            readonly title: "PublishedConfig";
+            readonly description: "The parameters exactly as they now appear in this community's join manifest, under vetting.ext. What an applicant and a vetter read.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["suite", "helperKey", "tokenKey", "vetterLabels", "tokenLabels", "dripPerTick", "tickLength", "events"];
+            readonly properties: {
+                readonly suite: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly helperKey: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly description: "The helper verification key, multibase — named for its role on the wire rather than for hvk.";
+                };
+                readonly tokenKey: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly description: "The token verification key, multibase — named for its role on the wire rather than for tvk.";
+                };
+                readonly vetterLabels: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly description: "Class labels published whole, e.g. vetter/2026-09 — a request names one of these, not the bare period.";
+                };
+                readonly tokenLabels: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                };
+                readonly dripPerTick: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                };
+                readonly tickLength: {
+                    readonly $ref: "#/$defs/TickLength";
+                };
+                readonly events: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/$defs/PublishedEvent";
+                    };
+                };
+            };
+        };
+        readonly PublishedEvent: {
+            readonly title: "PublishedEvent";
+            readonly description: "The published shape drops approvedBy and graceDays: who approved is the community's own record, and a vetter is told closesAfter when its request is approved rather than being handed the raw grace period here.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["eventId", "startDate", "endDate", "groupFloor", "tiers"];
+            readonly properties: {
+                readonly eventId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly startDate: {
+                    readonly type: "string";
+                    readonly format: "date";
+                };
+                readonly endDate: {
+                    readonly type: "string";
+                    readonly format: "date";
+                };
+                readonly groupFloor: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                };
+                readonly tiers: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/$defs/Tier";
+                    };
+                };
+            };
+        };
+        readonly Tier: {
+            readonly title: "Tier";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["name", "dripPerTick"];
+            readonly properties: {
+                readonly name: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly description: "How the menu names it: desk, busy-desk.";
+                };
+                readonly dripPerTick: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                    readonly description: "How many tokens a tick under this tier yields.";
+                };
+            };
+        };
+        readonly TickLength: {
+            readonly title: "TickLength";
+            readonly type: "string";
+            readonly pattern: "^P(?:\\d+D(?:T\\d+H)?|T\\d+H)$";
+            readonly description: "The length of one tick of the drip, as an ISO 8601 duration in days and/or hours — at least `PT1H`. A label's tick `t` is the window starting `t` tick lengths after the label's start (`vtc/vetting/vetters/pcs-tokens`).";
+        };
+    };
+};
+/**
+ * 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/vta/pcs/tokens/request/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/vta/pcs/tokens/request/0.1";
+        readonly title: "VTA PCS — Tokens — Request — payload";
+        readonly description: "A vetter's client asks its VTA for one draw of the attestation-token drip: blinded serials bound to the vetter's member DID, the label and the tick.";
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly required: readonly ["contextId", "community", "parameters", "label", "tick", "count"];
+        readonly properties: {
+            readonly contextId: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly description: "The context the engine belongs to. Its key is derived from this context's base.";
+            };
+            readonly community: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly description: "The community's DID: the helper whose parameters the engine runs under.";
+            };
+            readonly parameters: {
+                readonly $ref: "#/$defs/CommunityParameters";
+                readonly description: "The community's published hidden-vetting parameters, copied verbatim from its join manifest.";
+            };
+            readonly label: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 128;
+                readonly description: "The token label to draw under.";
+            };
+            readonly tick: {
+                readonly type: "integer";
+                readonly minimum: 0;
+                readonly description: "The tick of the label being drawn.";
+            };
+            readonly count: {
+                readonly type: "integer";
+                readonly minimum: 1;
+                readonly maximum: 64;
+                readonly description: "How many tokens to ask for: normally the parameters' dripPerTick.";
+            };
+            readonly ext: {
+                readonly $ref: "#/$defs/Ext";
+            };
+        };
+        readonly $defs: {
+            readonly TokenDrawRequest: {
+                readonly title: "TokenDrawRequest";
+                readonly description: "The payload of a vtc/vetting/vetters/pcs-tokens/0.1 request, without its ext.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["label", "tick", "requests"];
+                readonly properties: {
+                    readonly label: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 128;
+                    };
+                    readonly tick: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                    };
+                    readonly requests: {
+                        readonly type: "array";
+                        readonly minItems: 1;
+                        readonly maxItems: 64;
+                        readonly items: {
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["commitment", "openingProof"];
+                            readonly properties: {
+                                readonly commitment: {
+                                    readonly type: "string";
+                                    readonly pattern: "^z[1-9A-HJ-NP-Za-km-z]+$";
+                                };
+                                readonly openingProof: {
+                                    readonly type: "string";
+                                    readonly pattern: "^z[1-9A-HJ-NP-Za-km-z]+$";
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+            readonly Response: {
+                readonly $anchor: "response";
+                readonly title: "VTA PCS — Tokens — Request — response payload";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["request"];
+                readonly properties: {
+                    readonly request: {
+                        readonly $ref: "#/$defs/TokenDrawRequest";
+                    };
+                    readonly ext: {
+                        readonly $ref: "#/$defs/Ext";
+                    };
+                };
+            };
+            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 CommunityParameters: {
+                readonly title: "CommunityParameters";
+                readonly description: "The community's hidden-vetting parameters exactly as its join manifest publishes them, under the criterion's `vetting.ext`. The caller copies them in verbatim on every call that needs them, because the community rotates labels and the engine keeps no copy of its own: a stale copy costs the caller a refused proof, never a mistaken one.";
+                readonly $ref: "#/$defs/PublishedConfig";
+            };
+            readonly PublishedConfig: {
+                readonly title: "PublishedConfig";
+                readonly description: "The parameters exactly as they now appear in this community's join manifest, under vetting.ext. What an applicant and a vetter read.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["suite", "helperKey", "tokenKey", "vetterLabels", "tokenLabels", "dripPerTick", "tickLength", "events"];
+                readonly properties: {
+                    readonly suite: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly helperKey: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly description: "The helper verification key, multibase — named for its role on the wire rather than for hvk.";
+                    };
+                    readonly tokenKey: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly description: "The token verification key, multibase — named for its role on the wire rather than for tvk.";
+                    };
+                    readonly vetterLabels: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                        };
+                        readonly description: "Class labels published whole, e.g. vetter/2026-09 — a request names one of these, not the bare period.";
+                    };
+                    readonly tokenLabels: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                        };
+                    };
+                    readonly dripPerTick: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                    };
+                    readonly tickLength: {
+                        readonly $ref: "#/$defs/TickLength";
+                    };
+                    readonly events: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly $ref: "#/$defs/PublishedEvent";
+                        };
+                    };
+                };
+            };
+            readonly PublishedEvent: {
+                readonly title: "PublishedEvent";
+                readonly description: "The published shape drops approvedBy and graceDays: who approved is the community's own record, and a vetter is told closesAfter when its request is approved rather than being handed the raw grace period here.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["eventId", "startDate", "endDate", "groupFloor", "tiers"];
+                readonly properties: {
+                    readonly eventId: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly startDate: {
+                        readonly type: "string";
+                        readonly format: "date";
+                    };
+                    readonly endDate: {
+                        readonly type: "string";
+                        readonly format: "date";
+                    };
+                    readonly groupFloor: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                    };
+                    readonly tiers: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly $ref: "#/$defs/Tier";
+                        };
+                    };
+                };
+            };
+            readonly Tier: {
+                readonly title: "Tier";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["name", "dripPerTick"];
+                readonly properties: {
+                    readonly name: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly description: "How the menu names it: desk, busy-desk.";
+                    };
+                    readonly dripPerTick: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly description: "How many tokens a tick under this tier yields.";
+                    };
+                };
+            };
+            readonly TickLength: {
+                readonly title: "TickLength";
+                readonly type: "string";
+                readonly pattern: "^P(?:\\d+D(?:T\\d+H)?|T\\d+H)$";
+                readonly description: "The length of one tick of the drip, as an ISO 8601 duration in days and/or hours — at least `PT1H`. A label's tick `t` is the window starting `t` tick lengths after the label's start (`vtc/vetting/vetters/pcs-tokens`).";
+            };
+        };
+    };
+};
+/**
+ * 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 declare const RESPONSE_SPEC: {
+    readonly typeUri: "https://trusttasks.org/spec/vta/pcs/tokens/request/0.1#response";
+    readonly isBearer: false;
+    readonly isProofRequired: false;
+    readonly isRecipientRequired: true;
+    readonly isIssuedAtRequired: true;
+    readonly payloadSchema: {
+        readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+        readonly $ref: "#/$defs/Response";
+        readonly $defs: {
+            readonly TokenDrawRequest: {
+                readonly title: "TokenDrawRequest";
+                readonly description: "The payload of a vtc/vetting/vetters/pcs-tokens/0.1 request, without its ext.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["label", "tick", "requests"];
+                readonly properties: {
+                    readonly label: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 128;
+                    };
+                    readonly tick: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                    };
+                    readonly requests: {
+                        readonly type: "array";
+                        readonly minItems: 1;
+                        readonly maxItems: 64;
+                        readonly items: {
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["commitment", "openingProof"];
+                            readonly properties: {
+                                readonly commitment: {
+                                    readonly type: "string";
+                                    readonly pattern: "^z[1-9A-HJ-NP-Za-km-z]+$";
+                                };
+                                readonly openingProof: {
+                                    readonly type: "string";
+                                    readonly pattern: "^z[1-9A-HJ-NP-Za-km-z]+$";
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+            readonly Response: {
+                readonly $anchor: "response";
+                readonly title: "VTA PCS — Tokens — Request — response payload";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["request"];
+                readonly properties: {
+                    readonly request: {
+                        readonly $ref: "#/$defs/TokenDrawRequest";
+                    };
+                    readonly ext: {
+                        readonly $ref: "#/$defs/Ext";
+                    };
+                };
+            };
+            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 CommunityParameters: {
+                readonly title: "CommunityParameters";
+                readonly description: "The community's hidden-vetting parameters exactly as its join manifest publishes them, under the criterion's `vetting.ext`. The caller copies them in verbatim on every call that needs them, because the community rotates labels and the engine keeps no copy of its own: a stale copy costs the caller a refused proof, never a mistaken one.";
+                readonly $ref: "#/$defs/PublishedConfig";
+            };
+            readonly PublishedConfig: {
+                readonly title: "PublishedConfig";
+                readonly description: "The parameters exactly as they now appear in this community's join manifest, under vetting.ext. What an applicant and a vetter read.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["suite", "helperKey", "tokenKey", "vetterLabels", "tokenLabels", "dripPerTick", "tickLength", "events"];
+                readonly properties: {
+                    readonly suite: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly helperKey: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly description: "The helper verification key, multibase — named for its role on the wire rather than for hvk.";
+                    };
+                    readonly tokenKey: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly description: "The token verification key, multibase — named for its role on the wire rather than for tvk.";
+                    };
+                    readonly vetterLabels: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                        };
+                        readonly description: "Class labels published whole, e.g. vetter/2026-09 — a request names one of these, not the bare period.";
+                    };
+                    readonly tokenLabels: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                        };
+                    };
+                    readonly dripPerTick: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                    };
+                    readonly tickLength: {
+                        readonly $ref: "#/$defs/TickLength";
+                    };
+                    readonly events: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly $ref: "#/$defs/PublishedEvent";
+                        };
+                    };
+                };
+            };
+            readonly PublishedEvent: {
+                readonly title: "PublishedEvent";
+                readonly description: "The published shape drops approvedBy and graceDays: who approved is the community's own record, and a vetter is told closesAfter when its request is approved rather than being handed the raw grace period here.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["eventId", "startDate", "endDate", "groupFloor", "tiers"];
+                readonly properties: {
+                    readonly eventId: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly startDate: {
+                        readonly type: "string";
+                        readonly format: "date";
+                    };
+                    readonly endDate: {
+                        readonly type: "string";
+                        readonly format: "date";
+                    };
+                    readonly groupFloor: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                    };
+                    readonly tiers: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly $ref: "#/$defs/Tier";
+                        };
+                    };
+                };
+            };
+            readonly Tier: {
+                readonly title: "Tier";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["name", "dripPerTick"];
+                readonly properties: {
+                    readonly name: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly description: "How the menu names it: desk, busy-desk.";
+                    };
+                    readonly dripPerTick: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly description: "How many tokens a tick under this tier yields.";
+                    };
+                };
+            };
+            readonly TickLength: {
+                readonly title: "TickLength";
+                readonly type: "string";
+                readonly pattern: "^P(?:\\d+D(?:T\\d+H)?|T\\d+H)$";
+                readonly description: "The length of one tick of the drip, as an ISO 8601 duration in days and/or hours — at least `PT1H`. A label's tick `t` is the window starting `t` tick lengths after the label's start (`vtc/vetting/vetters/pcs-tokens`).";
+            };
+        };
+    };
+};
+//# sourceMappingURL=payload.d.ts.map