@openvtc/trust-tasks 0.25.0 → 0.25.2

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

@@ -0,0 +1,1149 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/vta/pcs/tokens/accept/0.1/payload.schema.json
+ */
+import type { CommunityParameters, Ext, Multibase, PublishedConfig, PublishedEvent, TickLength, Tier, TokenDraw, VetterSummary } from "../../../../../_shared/components.js";
+/**
+ * A vetter's client hands its VTA the community's answer to a token draw; the VTA unblinds the tokens into the vetter's wallet.
+ */
+export interface VTAPCSTokensAcceptPayload {
+    /**
+     * 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 payload of the community's vtc/vetting/vetters/pcs-tokens/0.1 response, without its ext.
+     */
+    response: {
+        label: string;
+        tick: number;
+        /**
+         * @minItems 1
+         * @maxItems 64
+         */
+        preCredentials: [string, ...string[]];
+    };
+    ext?: Ext;
+}
+export interface VTAPCSTokensAcceptResponsePayload {
+    /**
+     * Tokens taken into the wallet.
+     */
+    received: number;
+    vetter: VetterSummary;
+    ext?: Ext;
+}
+/** Shared definitions this specification references, re-exported under the names it used to declare them with. */
+export type { CommunityParameters, Ext, Multibase, PublishedConfig, PublishedEvent, TickLength, Tier, TokenDraw, VetterSummary };
+/** Trust Task type URI. */
+export declare const TYPE_URI: "https://trusttasks.org/spec/vta/pcs/tokens/accept/0.1";
+/** Stable alias for this specification's request payload shape. */
+export type Payload = VTAPCSTokensAcceptPayload;
+/** Trust Task response type URI (request type URI + "#response"). */
+export declare const RESPONSE_TYPE_URI: "https://trusttasks.org/spec/vta/pcs/tokens/accept/0.1#response";
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = VTAPCSTokensAcceptResponsePayload;
+/**
+ * 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/accept/0.1";
+    readonly title: "VTA PCS — Tokens — Accept — payload";
+    readonly description: "A vetter's client hands its VTA the community's answer to a token draw; the VTA unblinds the tokens into the vetter's wallet.";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["contextId", "community", "parameters", "response"];
+    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 response: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["label", "tick", "preCredentials"];
+            readonly description: "The payload of the community's vtc/vetting/vetters/pcs-tokens/0.1 response, without its ext.";
+            readonly properties: {
+                readonly label: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 128;
+                };
+                readonly tick: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                };
+                readonly preCredentials: {
+                    readonly type: "array";
+                    readonly minItems: 1;
+                    readonly maxItems: 64;
+                    readonly items: {
+                        readonly type: "string";
+                        readonly pattern: "^z[1-9A-HJ-NP-Za-km-z]+$";
+                    };
+                };
+            };
+        };
+        readonly ext: {
+            readonly $ref: "#/$defs/Ext";
+        };
+    };
+    readonly $defs: {
+        readonly Response: {
+            readonly $anchor: "response";
+            readonly title: "VTA PCS — Tokens — Accept — response payload";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["received", "vetter"];
+            readonly properties: {
+                readonly received: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "Tokens taken into the wallet.";
+                };
+                readonly vetter: {
+                    readonly $ref: "#/$defs/VetterSummary";
+                };
+                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 VetterSummary: {
+            readonly title: "VetterSummary";
+            readonly description: "A vetter engine as the VTA holds it, without its key, its credentials or its tokens.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["contextId", "community", "memberDid", "suite", "id", "enrolledLabels", "pendingLabels", "tokensFree", "tokensHeld", "drawsInFlight", "attested"];
+            readonly properties: {
+                readonly contextId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly community: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly memberDid: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly description: "The member DID the engine draws tokens as. Bound into every token request.";
+                };
+                readonly suite: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 64;
+                };
+                readonly id: {
+                    readonly $ref: "#/$defs/Multibase";
+                    readonly description: "The vetter's PCS identifier for this community.";
+                };
+                readonly enrolledLabels: {
+                    readonly type: "array";
+                    readonly description: "Class labels this vetter holds a credential under, newest first.";
+                    readonly items: {
+                        readonly type: "string";
+                        readonly pattern: "^vetter/[0-9]{4}-[0-9]{2}$";
+                    };
+                };
+                readonly pendingLabels: {
+                    readonly type: "array";
+                    readonly description: "Class labels requested and not yet accepted.";
+                    readonly items: {
+                        readonly type: "string";
+                        readonly pattern: "^vetter/[0-9]{4}-[0-9]{2}$";
+                    };
+                };
+                readonly tokensFree: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "Tokens held and not reserved.";
+                };
+                readonly tokensHeld: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "Tokens held in all.";
+                };
+                readonly drawsInFlight: {
+                    readonly type: "array";
+                    readonly description: "Draws requested and not yet accepted or abandoned.";
+                    readonly items: {
+                        readonly $ref: "#/$defs/TokenDraw";
+                    };
+                };
+                readonly attested: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "Attestations made through this engine.";
+                };
+            };
+        };
+        readonly TokenDraw: {
+            readonly title: "TokenDraw";
+            readonly description: "One draw of the token drip: a label and a tick.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["label", "tick"];
+            readonly properties: {
+                readonly label: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 128;
+                };
+                readonly tick: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                };
+            };
+        };
+        readonly Multibase: {
+            readonly title: "Multibase";
+            readonly description: "A binary value, multibase base58btc over the suite's canonical encoding.";
+            readonly type: "string";
+            readonly pattern: "^z[1-9A-HJ-NP-Za-km-z]+$";
+        };
+        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 Response: {
+            readonly $anchor: "response";
+            readonly title: "VTA PCS — Tokens — Accept — response payload";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["received", "vetter"];
+            readonly properties: {
+                readonly received: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "Tokens taken into the wallet.";
+                };
+                readonly vetter: {
+                    readonly $ref: "#/$defs/VetterSummary";
+                };
+                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 VetterSummary: {
+            readonly title: "VetterSummary";
+            readonly description: "A vetter engine as the VTA holds it, without its key, its credentials or its tokens.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["contextId", "community", "memberDid", "suite", "id", "enrolledLabels", "pendingLabels", "tokensFree", "tokensHeld", "drawsInFlight", "attested"];
+            readonly properties: {
+                readonly contextId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly community: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly memberDid: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly description: "The member DID the engine draws tokens as. Bound into every token request.";
+                };
+                readonly suite: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 64;
+                };
+                readonly id: {
+                    readonly $ref: "#/$defs/Multibase";
+                    readonly description: "The vetter's PCS identifier for this community.";
+                };
+                readonly enrolledLabels: {
+                    readonly type: "array";
+                    readonly description: "Class labels this vetter holds a credential under, newest first.";
+                    readonly items: {
+                        readonly type: "string";
+                        readonly pattern: "^vetter/[0-9]{4}-[0-9]{2}$";
+                    };
+                };
+                readonly pendingLabels: {
+                    readonly type: "array";
+                    readonly description: "Class labels requested and not yet accepted.";
+                    readonly items: {
+                        readonly type: "string";
+                        readonly pattern: "^vetter/[0-9]{4}-[0-9]{2}$";
+                    };
+                };
+                readonly tokensFree: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "Tokens held and not reserved.";
+                };
+                readonly tokensHeld: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "Tokens held in all.";
+                };
+                readonly drawsInFlight: {
+                    readonly type: "array";
+                    readonly description: "Draws requested and not yet accepted or abandoned.";
+                    readonly items: {
+                        readonly $ref: "#/$defs/TokenDraw";
+                    };
+                };
+                readonly attested: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "Attestations made through this engine.";
+                };
+            };
+        };
+        readonly TokenDraw: {
+            readonly title: "TokenDraw";
+            readonly description: "One draw of the token drip: a label and a tick.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["label", "tick"];
+            readonly properties: {
+                readonly label: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 128;
+                };
+                readonly tick: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                };
+            };
+        };
+        readonly Multibase: {
+            readonly title: "Multibase";
+            readonly description: "A binary value, multibase base58btc over the suite's canonical encoding.";
+            readonly type: "string";
+            readonly pattern: "^z[1-9A-HJ-NP-Za-km-z]+$";
+        };
+        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/accept/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/accept/0.1";
+        readonly title: "VTA PCS — Tokens — Accept — payload";
+        readonly description: "A vetter's client hands its VTA the community's answer to a token draw; the VTA unblinds the tokens into the vetter's wallet.";
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly required: readonly ["contextId", "community", "parameters", "response"];
+        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 response: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["label", "tick", "preCredentials"];
+                readonly description: "The payload of the community's vtc/vetting/vetters/pcs-tokens/0.1 response, without its ext.";
+                readonly properties: {
+                    readonly label: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 128;
+                    };
+                    readonly tick: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                    };
+                    readonly preCredentials: {
+                        readonly type: "array";
+                        readonly minItems: 1;
+                        readonly maxItems: 64;
+                        readonly items: {
+                            readonly type: "string";
+                            readonly pattern: "^z[1-9A-HJ-NP-Za-km-z]+$";
+                        };
+                    };
+                };
+            };
+            readonly ext: {
+                readonly $ref: "#/$defs/Ext";
+            };
+        };
+        readonly $defs: {
+            readonly Response: {
+                readonly $anchor: "response";
+                readonly title: "VTA PCS — Tokens — Accept — response payload";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["received", "vetter"];
+                readonly properties: {
+                    readonly received: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "Tokens taken into the wallet.";
+                    };
+                    readonly vetter: {
+                        readonly $ref: "#/$defs/VetterSummary";
+                    };
+                    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 VetterSummary: {
+                readonly title: "VetterSummary";
+                readonly description: "A vetter engine as the VTA holds it, without its key, its credentials or its tokens.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["contextId", "community", "memberDid", "suite", "id", "enrolledLabels", "pendingLabels", "tokensFree", "tokensHeld", "drawsInFlight", "attested"];
+                readonly properties: {
+                    readonly contextId: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly community: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly memberDid: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly description: "The member DID the engine draws tokens as. Bound into every token request.";
+                    };
+                    readonly suite: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 64;
+                    };
+                    readonly id: {
+                        readonly $ref: "#/$defs/Multibase";
+                        readonly description: "The vetter's PCS identifier for this community.";
+                    };
+                    readonly enrolledLabels: {
+                        readonly type: "array";
+                        readonly description: "Class labels this vetter holds a credential under, newest first.";
+                        readonly items: {
+                            readonly type: "string";
+                            readonly pattern: "^vetter/[0-9]{4}-[0-9]{2}$";
+                        };
+                    };
+                    readonly pendingLabels: {
+                        readonly type: "array";
+                        readonly description: "Class labels requested and not yet accepted.";
+                        readonly items: {
+                            readonly type: "string";
+                            readonly pattern: "^vetter/[0-9]{4}-[0-9]{2}$";
+                        };
+                    };
+                    readonly tokensFree: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "Tokens held and not reserved.";
+                    };
+                    readonly tokensHeld: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "Tokens held in all.";
+                    };
+                    readonly drawsInFlight: {
+                        readonly type: "array";
+                        readonly description: "Draws requested and not yet accepted or abandoned.";
+                        readonly items: {
+                            readonly $ref: "#/$defs/TokenDraw";
+                        };
+                    };
+                    readonly attested: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "Attestations made through this engine.";
+                    };
+                };
+            };
+            readonly TokenDraw: {
+                readonly title: "TokenDraw";
+                readonly description: "One draw of the token drip: a label and a tick.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["label", "tick"];
+                readonly properties: {
+                    readonly label: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 128;
+                    };
+                    readonly tick: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                    };
+                };
+            };
+            readonly Multibase: {
+                readonly title: "Multibase";
+                readonly description: "A binary value, multibase base58btc over the suite's canonical encoding.";
+                readonly type: "string";
+                readonly pattern: "^z[1-9A-HJ-NP-Za-km-z]+$";
+            };
+            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/accept/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 Response: {
+                readonly $anchor: "response";
+                readonly title: "VTA PCS — Tokens — Accept — response payload";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["received", "vetter"];
+                readonly properties: {
+                    readonly received: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "Tokens taken into the wallet.";
+                    };
+                    readonly vetter: {
+                        readonly $ref: "#/$defs/VetterSummary";
+                    };
+                    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 VetterSummary: {
+                readonly title: "VetterSummary";
+                readonly description: "A vetter engine as the VTA holds it, without its key, its credentials or its tokens.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["contextId", "community", "memberDid", "suite", "id", "enrolledLabels", "pendingLabels", "tokensFree", "tokensHeld", "drawsInFlight", "attested"];
+                readonly properties: {
+                    readonly contextId: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly community: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly memberDid: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly description: "The member DID the engine draws tokens as. Bound into every token request.";
+                    };
+                    readonly suite: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 64;
+                    };
+                    readonly id: {
+                        readonly $ref: "#/$defs/Multibase";
+                        readonly description: "The vetter's PCS identifier for this community.";
+                    };
+                    readonly enrolledLabels: {
+                        readonly type: "array";
+                        readonly description: "Class labels this vetter holds a credential under, newest first.";
+                        readonly items: {
+                            readonly type: "string";
+                            readonly pattern: "^vetter/[0-9]{4}-[0-9]{2}$";
+                        };
+                    };
+                    readonly pendingLabels: {
+                        readonly type: "array";
+                        readonly description: "Class labels requested and not yet accepted.";
+                        readonly items: {
+                            readonly type: "string";
+                            readonly pattern: "^vetter/[0-9]{4}-[0-9]{2}$";
+                        };
+                    };
+                    readonly tokensFree: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "Tokens held and not reserved.";
+                    };
+                    readonly tokensHeld: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "Tokens held in all.";
+                    };
+                    readonly drawsInFlight: {
+                        readonly type: "array";
+                        readonly description: "Draws requested and not yet accepted or abandoned.";
+                        readonly items: {
+                            readonly $ref: "#/$defs/TokenDraw";
+                        };
+                    };
+                    readonly attested: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "Attestations made through this engine.";
+                    };
+                };
+            };
+            readonly TokenDraw: {
+                readonly title: "TokenDraw";
+                readonly description: "One draw of the token drip: a label and a tick.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["label", "tick"];
+                readonly properties: {
+                    readonly label: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 128;
+                    };
+                    readonly tick: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                    };
+                };
+            };
+            readonly Multibase: {
+                readonly title: "Multibase";
+                readonly description: "A binary value, multibase base58btc over the suite's canonical encoding.";
+                readonly type: "string";
+                readonly pattern: "^z[1-9A-HJ-NP-Za-km-z]+$";
+            };
+            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