{ "openapi": "3.1.0", "info": { "title": "KlineO Token Liquidity Operating System API", "version": "2.0.0", "description": "Additive v2 resources. AI output is always non-executable; issuer Safe and typed immutable adapters remain the authority boundary." }, "servers": [ { "url": "/api/liquidity-studio/v2" } ], "tags": [ { "name": "Plan" }, { "name": "Simulate" }, { "name": "Operate" }, { "name": "Intelligence" }, { "name": "Prove" }, { "name": "Platform" } ], "paths": { "/agent-runs/{runId}/research-planning": { "get": { "operationId": "getResearchPlanning", "summary": "Read current private Research proposal, clarification and linked study task", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "runId", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } } ], "responses": { "200": { "description": "Current tenant-authorized projection. Activity has no model reasoning or raw evidence.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/ResearchPlanningState" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid query or cursor" }, "401": { "description": "Session required" }, "403": { "description": "Current workspace access denied" }, "404": { "description": "Run is unavailable in this workspace" }, "503": { "description": "Recovery data temporarily unavailable" } } } }, "/agent-runs/{runId}/research-progress": { "get": { "operationId": "getResearchProgress", "summary": "Read current private Research child-study progress", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "runId", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } } ], "responses": { "200": { "description": "Current tenant-authorized projection. Activity has no model reasoning or raw evidence.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/ResearchProgress" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid query or cursor" }, "401": { "description": "Session required" }, "403": { "description": "Current workspace access denied" }, "404": { "description": "Run is unavailable in this workspace" }, "503": { "description": "Recovery data temporarily unavailable" } } } }, "/agent-runs/{runId}/research-trials/{trialKey}": { "get": { "operationId": "getResearchTrialInput", "summary": "Inspect the exact immutable inputs of a private Research study", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "runId", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, { "name": "trialKey", "in": "path", "required": true, "schema": { "type": "string", "enum": [ "baseline", "alternative-1", "alternative-2", "alternative-3" ] } } ], "responses": { "200": { "description": "Current tenant-authorized projection. Activity has no model reasoning or raw evidence.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/ResearchTrialInput" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid query or cursor" }, "401": { "description": "Session required" }, "403": { "description": "Current workspace access denied" }, "404": { "description": "Run is unavailable in this workspace" }, "503": { "description": "Recovery data temporarily unavailable" } } } }, "/agent-runs/{runId}/result": { "get": { "operationId": "getAgentRunResult", "summary": "Read and revalidate a saved Health, Proposal Review or Research report", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "runId", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } } ], "responses": { "200": { "description": "Current tenant-authorized projection. Activity has no model reasoning or raw evidence.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/AgentRunResult" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid query or cursor" }, "401": { "description": "Session required" }, "403": { "description": "Current workspace access denied" }, "404": { "description": "Run is unavailable in this workspace" }, "503": { "description": "Recovery data temporarily unavailable" } }, "description": "Interactive tenant-authorized read. Returns the immutable vault or public-project Health report, or saved Proposal Review report, after deterministic verification against its sealed capture and settled model draft. Applicability is separate from the historical report. Public-project results contain at most two frozen public observations; comparison of saved samples is not a continuous-period measurement or causal explanation. PARTIAL and ABSTAINED reports do not assess market health or grant financial authority. Proposal Review requires current narrow review authority and exposes recorded proposal evidence, exact atomic flows where available, cost gaps and current applicability; it never approves or executes a proposal. Research reports reconstruct the comparison from the immutable protocol and completed child receipts; COMPLETED describes modeled work, not financial assurance. Failed and incompatible trials remain visible. Unavailable or unverifiable results fail closed." } }, "/agent-runs/{runId}/evidence/{evidenceId}": { "get": { "operationId": "getAgentRunEvidence", "summary": "Read allowlisted fields from a sealed Health evidence record", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "runId", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, { "name": "evidenceId", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } } ], "responses": { "200": { "description": "Current tenant-authorized projection. Activity has no model reasoning or raw evidence.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/CapturedHealthEvidenceView" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid query or cursor" }, "401": { "description": "Session required" }, "403": { "description": "Current workspace access denied" }, "404": { "description": "Run is unavailable in this workspace" }, "503": { "description": "Recovery data temporarily unavailable" } }, "description": "Interactive tenant-authorized read. Evidence is the frozen captured generation, never refreshed source data. Only scalar fields from the strict source allowlists are returned; internal authorization classifications, signatures, credentials and arbitrary payload objects are excluded. Recorded source assertions are not independent verification." } }, "/agent-runs/{runId}/commands": { "post": { "operationId": "applyAgentRunCommand", "summary": "Cancel remaining work or answer a persisted clarification as its requester", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "runId", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 200 } } ], "responses": { "200": { "description": "Current tenant-authorized projection. Activity has no model reasoning or raw evidence.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/AgentControlReceipt" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid query or cursor" }, "401": { "description": "Session required" }, "403": { "description": "Current workspace access denied" }, "404": { "description": "Run is unavailable in this workspace" }, "409": { "description": "Command key conflicts or run is terminal; refresh before a new command" }, "412": { "description": "Run or clarification changed; refresh before a new command" }, "428": { "description": "Strong current run If-Match required" }, "429": { "description": "Remaining checkpoint budget exhausted" }, "503": { "description": "Recovery data temporarily unavailable" } }, "description": "Interactive requester only; current tenant/workflow authority is rechecked atomically. Retry an unconfirmed command with the identical body, If-Match and Idempotency-Key. Receipt state is the accepted command outcome, not a claim about current worker progress. Cancellation preserves settled work and does not undo external work already sent.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentControlCommand" } } } } } }, "/agent-runs": { "post": { "operationId": "startHealthAgentRun", "summary": "Admit a bounded Health, Proposal Review or Research task against an exact source version", "description": "The existing operation identifier is retained for SDK compatibility. Interactive member only. Admission checks deployment enablement, current delegated authority, tenant policy, source version and quotas. Provider assignment and profile eligibility are checked when the worker prepares model work. The caller cannot choose tools, model, budgets, organization or requester. Vault Health uses fully closed UTC-day windows; public-project Health binds saved samples. Proposal Review binds an exact V1 updatedAt, V2 resourceVersion or Research candidate Decision Pack resourceVersion plus contentHash and uses narrow ai:proposal-review authority; it does not grant general AI generation or simulation rights to an approver. Research accepts an explicit reviewed experiment or a PLAN request containing a question and explicit optional assumptions, with exact issuer-intent version and simulation authority. PLAN reserves model resources but no study compute; typed confirmation creates a separately linked execution task. It runs a private baseline plus at most three alternatives, without signed-study or publication side effects. Retry uncertain admission with the identical body and key. A receipt means accepted work, not a completed report; recover progress using the returned run ID. No proposal, approval, comment, payment or financial transaction is created or changed by this endpoint.", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 200 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentAdmissionRequest" } } } }, "responses": { "200": { "description": "The identical admission was recovered; read current task state separately.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } }, "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/AgentAdmissionReceipt" } }, "required": [ "data" ], "additionalProperties": false } } } }, "202": { "description": "A new bounded investigation was atomically admitted.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } }, "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/AgentAdmissionReceipt" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid or unsupported request.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive session required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current authority does not permit the investigation.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Subject unavailable in this workspace.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "409": { "description": "Idempotency key belongs to a different request.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "412": { "description": "Reviewed source generation or window changed.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "428": { "description": "Reviewed subject version is required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Workspace allowance or active limit reached.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Admission, provider or tenant workflow is unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } } }, "get": { "operationId": "listAgentRuns", "summary": "Recover authorized agent task history", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 25 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 2048 } }, { "name": "kind", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "HEALTH_INVESTIGATION", "PROPOSAL_REVIEW", "WHAT_IF_RESEARCH" ] } }, { "name": "state", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "QUEUED", "RUNNING", "WAITING_FOR_INPUT", "WAITING_FOR_CHILDREN", "COMPLETED", "PARTIAL", "ABSTAINED", "FAILED", "CANCELLED" ] } }, { "name": "subjectRecordType", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "VAULT", "PROPOSAL", "PROPOSAL_WORKSPACE", "ISSUER_INTENT", "SAVED_PUBLIC_PROJECT", "DECISION_PACK" ] } }, { "name": "subjectRecordId", "in": "query", "required": false, "schema": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } } ], "responses": { "200": { "description": "Current tenant-authorized projection. Activity has no model reasoning or raw evidence.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/AgentRunList" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid query or cursor" }, "401": { "description": "Session required" }, "403": { "description": "Current workspace access denied" }, "404": { "description": "Run is unavailable in this workspace" }, "503": { "description": "Recovery data temporarily unavailable" } } } }, "/agent-runs/{runId}": { "get": { "operationId": "getAgentRun", "summary": "Read persisted run status and pending clarification", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "runId", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } } ], "responses": { "200": { "description": "Current tenant-authorized projection. Activity has no model reasoning or raw evidence.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/AgentRunDetail" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid query or cursor" }, "401": { "description": "Session required" }, "403": { "description": "Current workspace access denied" }, "404": { "description": "Run is unavailable in this workspace" }, "503": { "description": "Recovery data temporarily unavailable" } } } }, "/agent-runs/{runId}/events": { "get": { "operationId": "listAgentRunEvents", "summary": "Read recorded run and checkpoint transitions", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "runId", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, { "name": "after", "in": "query", "required": false, "schema": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,18})$", "description": "Exact decimal sequence; do not coerce to a JavaScript number.", "default": "0" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "responses": { "200": { "description": "Current tenant-authorized projection. Activity has no model reasoning or raw evidence.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/AgentActivityPage" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid query or cursor" }, "401": { "description": "Session required" }, "403": { "description": "Current workspace access denied" }, "404": { "description": "Run is unavailable in this workspace" }, "503": { "description": "Recovery data temporarily unavailable" } } } }, "/public/projects/resolve": { "post": { "operationId": "resolvePublicProject", "summary": "Inspect a supported project using public market sources without a login, vault or payment", "description": "Bounded public read with no private tenant lookup or issuer ownership assertion. A successful response may be partial and explicitly retains gaps. Observing a pool does not establish graduation, locked liquidity, issuer control or tradability. No saved investigation, entitlement, payment or financial authority is created.", "security": [], "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicProjectResolveRequest" } } } }, "responses": { "200": { "description": "Public source observations with explicit limitations.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/PublicProjectAnalysis" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Malformed JSON, invalid or unsupported identifier, or extra fields.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "PUBLIC_PROJECT_INVALID_INPUT" ] }, "message": { "type": "string" }, "retryable": { "const": false } }, "required": [ "code", "message", "retryable" ], "additionalProperties": false } }, "required": [ "error" ], "additionalProperties": false } } } }, "413": { "description": "Request exceeds the 2 KiB JSON body limit.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "PUBLIC_PROJECT_INVALID_INPUT" ] }, "message": { "type": "string" }, "retryable": { "const": false } }, "required": [ "code", "message", "retryable" ], "additionalProperties": false } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Client rate or upstream concurrency limit exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store" } }, "Retry-After": { "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "PUBLIC_PROJECT_BUSY" ] }, "message": { "type": "string" }, "retryable": { "const": true } }, "required": [ "code", "message", "retryable" ], "additionalProperties": false } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Public sources are unconfigured, unavailable, unverifiable or timed out. Raw provider errors are not disclosed.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "PUBLIC_PROJECT_UNAVAILABLE", "PUBLIC_PROJECT_TIMEOUT" ] }, "message": { "type": "string" }, "retryable": { "const": true } }, "required": [ "code", "message", "retryable" ], "additionalProperties": false } }, "required": [ "error" ], "additionalProperties": false } } } } } } }, "/public/projects/investigate": { "post": { "operationId": "investigatePublicProjectLiquidity", "summary": "Inspect one bounded public reserve-scale liquidity question without a login or payment", "description": "Reads the same public project evidence as project resolution and returns a source-backed VIRTUAL pool reserve-scale finding. This is not a tradability claim, executable quote, slippage estimate, custody instruction, paid job, saved tenant investigation, or financial authority. An unavailable finding preserves the source and explains its evidence gap.", "security": [], "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicLiquidityInvestigationRequest" } } } }, "responses": { "200": { "description": "Public source evidence and bounded reserve-scale finding with explicit limitations.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/PublicLiquidityInvestigation" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Malformed JSON, unsupported identifier or question, invalid quote size, or extra fields.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "PUBLIC_INVESTIGATION_INVALID_INPUT" ] }, "message": { "type": "string" }, "retryable": { "const": false } }, "required": [ "code", "message", "retryable" ], "additionalProperties": false } }, "required": [ "error" ], "additionalProperties": false } } } }, "413": { "description": "Request exceeds the 2 KiB JSON body limit.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "PUBLIC_INVESTIGATION_INVALID_INPUT" ] }, "message": { "type": "string" }, "retryable": { "const": false } }, "required": [ "code", "message", "retryable" ], "additionalProperties": false } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Client rate or upstream concurrency limit exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store" } }, "Retry-After": { "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "PUBLIC_INVESTIGATION_BUSY" ] }, "message": { "type": "string" }, "retryable": { "const": true } }, "required": [ "code", "message", "retryable" ], "additionalProperties": false } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Public sources are unconfigured, unavailable, unverifiable or timed out. Raw provider errors are not disclosed.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "PUBLIC_INVESTIGATION_UNAVAILABLE", "PUBLIC_INVESTIGATION_TIMEOUT" ] }, "message": { "type": "string" }, "retryable": { "const": true } }, "required": [ "code", "message", "retryable" ], "additionalProperties": false } }, "required": [ "error" ], "additionalProperties": false } } } } } } }, "/projects": { "get": { "operationId": "listSavedProjects", "summary": "List saved public-project bookmarks in the current workspace", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 20, "default": 20 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "pattern": "^project_[0-9a-f]{32}$" }, "description": "Continuation position returned by this collection. Current tenant authorization is rechecked independently on every request." } ], "description": "Requires current interactive workspace membership. Developer service credentials are not accepted. A saved public-project bookmark grants no issuer ownership, treasury access, paid entitlement, financial permission or publication authority. Observations are immutable public snapshots; refreshing appends a new version without rewriting history.", "responses": { "200": { "description": "Tenant-authorized saved public-project record.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/SavedProjectList" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid input or collection cursor.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive session required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current workspace access or requested operation denied.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Record unavailable in this workspace.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request or public-source quota exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Saved project storage or public source unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } } }, "post": { "operationId": "savePublicProject", "summary": "Save an independently resolved public-project observation", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 200 } } ], "description": "Requires current interactive workspace membership. Developer service credentials are not accepted. A saved public-project bookmark grants no issuer ownership, treasury access, paid entitlement, financial permission or publication authority. Observations are immutable public snapshots; refreshing appends a new version without rewriting history.", "responses": { "200": { "description": "Tenant-authorized saved public-project record.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } }, "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/SavedProjectWriteReceipt" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid input or collection cursor.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive session required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current workspace access or requested operation denied.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Record unavailable in this workspace.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "409": { "description": "Idempotency identity conflicts or source binding changed.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request or public-source quota exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Saved project storage or public source unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicProjectResolveRequest" } } } } } }, "/projects/{projectId}": { "get": { "operationId": "getSavedProject", "summary": "Read a saved public-project bookmark and its latest observation", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "projectId", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^project_[0-9a-f]{32}$" } } ], "description": "Requires current interactive workspace membership. Developer service credentials are not accepted. A saved public-project bookmark grants no issuer ownership, treasury access, paid entitlement, financial permission or publication authority. Observations are immutable public snapshots; refreshing appends a new version without rewriting history.", "responses": { "200": { "description": "Tenant-authorized saved public-project record.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } }, "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/SavedPublicProject" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid input or collection cursor.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive session required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current workspace access or requested operation denied.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Record unavailable in this workspace.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request or public-source quota exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Saved project storage or public source unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } } } }, "/projects/{projectId}/refresh": { "post": { "operationId": "refreshSavedProject", "summary": "Append a newly resolved public observation to the exact saved project version", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "projectId", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^project_[0-9a-f]{32}$" } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 200 } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } ], "description": "Requires current interactive workspace membership. Developer service credentials are not accepted. A saved public-project bookmark grants no issuer ownership, treasury access, paid entitlement, financial permission or publication authority. Observations are immutable public snapshots; refreshing appends a new version without rewriting history.", "responses": { "200": { "description": "Tenant-authorized saved public-project record.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } }, "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/SavedProjectWriteReceipt" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid input or collection cursor.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive session required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current workspace access or requested operation denied.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Record unavailable in this workspace.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "409": { "description": "Idempotency identity conflicts or source binding changed.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "412": { "description": "Project version changed; review current evidence before a new refresh.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "428": { "description": "Strong current project If-Match required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request or public-source quota exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Saved project storage or public source unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": {}, "required": [], "additionalProperties": false, "maxProperties": 0 } } } } } }, "/projects/{projectId}/observations": { "get": { "operationId": "listSavedProjectObservations", "summary": "List immutable observation metadata without changing captured evidence", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "projectId", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^project_[0-9a-f]{32}$" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 20, "default": 20 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$", "description": "Exact immutable observation sequence; do not coerce to a JavaScript number." }, "description": "Continuation position returned by this collection. Current tenant authorization is rechecked independently on every request." } ], "description": "Requires current interactive workspace membership. Developer service credentials are not accepted. A saved public-project bookmark grants no issuer ownership, treasury access, paid entitlement, financial permission or publication authority. Observations are immutable public snapshots; refreshing appends a new version without rewriting history.", "responses": { "200": { "description": "Tenant-authorized saved public-project record.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/SavedProjectObservationList" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid input or collection cursor.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive session required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current workspace access or requested operation denied.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Record unavailable in this workspace.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request or public-source quota exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Saved project storage or public source unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } } } }, "/projects/{projectId}/observations/{version}": { "get": { "operationId": "getSavedProjectObservation", "summary": "Read the exact immutable public observation version", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "projectId", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^project_[0-9a-f]{32}$" } }, { "name": "version", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$", "description": "Exact immutable observation sequence; do not coerce to a JavaScript number." } } ], "description": "Requires current interactive workspace membership. Developer service credentials are not accepted. A saved public-project bookmark grants no issuer ownership, treasury access, paid entitlement, financial permission or publication authority. Observations are immutable public snapshots; refreshing appends a new version without rewriting history.", "responses": { "200": { "description": "Tenant-authorized saved public-project record.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } }, "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/SavedProjectObservation" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid input or collection cursor.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive session required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current workspace access or requested operation denied.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Record unavailable in this workspace.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request or public-source quota exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Saved project storage or public source unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } } } }, "/public/plans": { "get": { "operationId": "listWorkspacePlans", "summary": "Inspect configured workspace plan previews without a login or payment", "description": "Read-only public terms, separate from vault billing. Missing or expired configuration returns NOT_CONFIGURED with no plans or version. PREVIEW requires a nonexpired timestamp, version and 1–12 unique plans. Does not create orders, accept terms, start checkout, establish allowances or grant financial authority. No deployment prices are assumed.", "security": [], "parameters": [], "responses": { "200": { "description": "Current read-only catalog or explicit unconfigured state.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/WorkspacePlanCatalog" } }, "required": [ "data" ], "additionalProperties": false } } } }, "429": { "description": "Public request limit exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store" } }, "Retry-After": { "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "const": "PUBLIC_PLANS_BUSY" }, "message": { "type": "string" }, "retryable": { "const": true } }, "required": [ "code", "message", "retryable" ], "additionalProperties": false } }, "required": [ "error" ], "additionalProperties": false } } } } } } }, "/public/acp/offering": { "get": { "operationId": "getPublicAcpOffering", "summary": "Inspect the configured ACP public-analysis offering without a login or payment", "description": "Deployment-owned, read-only offering preview. Missing or expired configuration returns NOT_CONFIGURED with null offering, catalogVersion and validUntil. PREVIEW requires a nonexpired timestamp, version and one public-only offering. No purchase, job, escrow, settlement, fund transfer, private tenant access or financial authority is created. No deployment price or SLA is assumed.", "security": [], "parameters": [], "responses": { "200": { "description": "Current read-only offering preview or explicit unconfigured state.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/AcpOfferingPreview" } }, "required": [ "data" ], "additionalProperties": false } } } }, "429": { "description": "Public request limit exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store" } }, "Retry-After": { "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "const": "PUBLIC_ACP_OFFERING_BUSY" }, "message": { "type": "string" }, "retryable": { "const": true } }, "required": [ "code", "message", "retryable" ], "additionalProperties": false } }, "required": [ "error" ], "additionalProperties": false } } } } } } }, "/decision-packs/from-treasury": { "post": { "operationId": "createTreasuryDecisionPack", "summary": "Prepare a private historical treasury scenario review with its exact project evidence", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 200, "pattern": "^[\\x21-\\x7E]+$" } } ], "description": "Interactive current workspace members only. Private versioned public-evidence, Research-candidate or historical treasury-scenario review artifact; no Safe approval, finalized outcome, issuer verification, paid entitlement or publication authority. Supporting Health evidence may answer a different question, shown explicitly. Research candidates retain exact private trial references and one selected capital variant across scenarios. The project association is user-selected context, not verified issuer or quote identity. Completed candidate Review receipts can attach to matching Research candidate content under current source checks, without changing human decision or financial authority. Content edits clear the attachment in the new version while retaining immutable history. Treasury scenario packs bind an exact saved projection and historical project-control evidence without requiring Health or Research. Public drafts can be promoted to a treasury scenario pack; Research packs cannot yet attach treasury context because Candidate Review covers a different evidence scope. Treasury readiness is human review of historical declared assumptions, not current cash verification. Commercial-order references remain unsupported. Historical versions do not establish current project applicability.", "responses": { "200": { "description": "Authorized immutable artifact, collection or exact command receipt.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } }, "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/DecisionPackWriteReceipt" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid closed request or collection parameters.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive session required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current membership or role denied; service credentials are not accepted.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Record unavailable in this workspace.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "409": { "description": "Command identity conflicts or lifecycle prerequisite not met.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "412": { "description": "Reviewed project or pack version changed.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request limit exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Storage or response verification unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateTreasuryDecisionPack" } } } } } }, "/decision-packs/from-research": { "post": { "operationId": "createResearchDecisionPack", "summary": "Prepare a private review candidate from an exact Research result", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 200, "pattern": "^[\\x21-\\x7E]+$" } } ], "description": "Interactive current workspace members only. Private versioned public-evidence, Research-candidate or historical treasury-scenario review artifact; no Safe approval, finalized outcome, issuer verification, paid entitlement or publication authority. Supporting Health evidence may answer a different question, shown explicitly. Research candidates retain exact private trial references and one selected capital variant across scenarios. The project association is user-selected context, not verified issuer or quote identity. Completed candidate Review receipts can attach to matching Research candidate content under current source checks, without changing human decision or financial authority. Content edits clear the attachment in the new version while retaining immutable history. Treasury scenario packs bind an exact saved projection and historical project-control evidence without requiring Health or Research. Public drafts can be promoted to a treasury scenario pack; Research packs cannot yet attach treasury context because Candidate Review covers a different evidence scope. Treasury readiness is human review of historical declared assumptions, not current cash verification. Commercial-order references remain unsupported. Historical versions do not establish current project applicability.", "responses": { "200": { "description": "Authorized immutable artifact, collection or exact command receipt.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } }, "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/DecisionPackWriteReceipt" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid closed request or collection parameters.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive session required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current membership or role denied; service credentials are not accepted.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Record unavailable in this workspace.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "409": { "description": "Command identity conflicts or lifecycle prerequisite not met.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "412": { "description": "Reviewed project or pack version changed.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request limit exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Storage or response verification unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateResearchDecisionPack" } } } } } }, "/decision-packs": { "get": { "operationId": "listDecisionPacks", "summary": "List private analysis Decision Packs", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "pattern": "^decisionpack_[a-f0-9]{32}$" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 20, "default": 20 } } ], "description": "Interactive current workspace members only. Private versioned public-evidence, Research-candidate or historical treasury-scenario review artifact; no Safe approval, finalized outcome, issuer verification, paid entitlement or publication authority. Supporting Health evidence may answer a different question, shown explicitly. Research candidates retain exact private trial references and one selected capital variant across scenarios. The project association is user-selected context, not verified issuer or quote identity. Completed candidate Review receipts can attach to matching Research candidate content under current source checks, without changing human decision or financial authority. Content edits clear the attachment in the new version while retaining immutable history. Treasury scenario packs bind an exact saved projection and historical project-control evidence without requiring Health or Research. Public drafts can be promoted to a treasury scenario pack; Research packs cannot yet attach treasury context because Candidate Review covers a different evidence scope. Treasury readiness is human review of historical declared assumptions, not current cash verification. Commercial-order references remain unsupported. Historical versions do not establish current project applicability.", "responses": { "200": { "description": "Authorized immutable artifact, collection or exact command receipt.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/DecisionPackList" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid closed request or collection parameters.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive session required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current membership or role denied; service credentials are not accepted.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Record unavailable in this workspace.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request limit exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Storage or response verification unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } } }, "post": { "operationId": "createDecisionPack", "summary": "Create a draft bound to a saved public-project observation", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 200, "pattern": "^[\\x21-\\x7E]+$" } } ], "description": "Interactive current workspace members only. Private versioned public-evidence, Research-candidate or historical treasury-scenario review artifact; no Safe approval, finalized outcome, issuer verification, paid entitlement or publication authority. Supporting Health evidence may answer a different question, shown explicitly. Research candidates retain exact private trial references and one selected capital variant across scenarios. The project association is user-selected context, not verified issuer or quote identity. Completed candidate Review receipts can attach to matching Research candidate content under current source checks, without changing human decision or financial authority. Content edits clear the attachment in the new version while retaining immutable history. Treasury scenario packs bind an exact saved projection and historical project-control evidence without requiring Health or Research. Public drafts can be promoted to a treasury scenario pack; Research packs cannot yet attach treasury context because Candidate Review covers a different evidence scope. Treasury readiness is human review of historical declared assumptions, not current cash verification. Commercial-order references remain unsupported. Historical versions do not establish current project applicability.", "responses": { "200": { "description": "Authorized immutable artifact, collection or exact command receipt.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } }, "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/DecisionPackWriteReceipt" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid closed request or collection parameters.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive session required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current membership or role denied; service credentials are not accepted.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Record unavailable in this workspace.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "409": { "description": "Command identity conflicts or lifecycle prerequisite not met.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "412": { "description": "Reviewed project or pack version changed.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request limit exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Storage or response verification unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateDecisionPack" } } } } } }, "/decision-packs/{packId}": { "get": { "operationId": "getDecisionPack", "summary": "Read the latest Decision Pack version", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "packId", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^decisionpack_[a-f0-9]{32}$" } } ], "description": "Interactive current workspace members only. Private versioned public-evidence, Research-candidate or historical treasury-scenario review artifact; no Safe approval, finalized outcome, issuer verification, paid entitlement or publication authority. Supporting Health evidence may answer a different question, shown explicitly. Research candidates retain exact private trial references and one selected capital variant across scenarios. The project association is user-selected context, not verified issuer or quote identity. Completed candidate Review receipts can attach to matching Research candidate content under current source checks, without changing human decision or financial authority. Content edits clear the attachment in the new version while retaining immutable history. Treasury scenario packs bind an exact saved projection and historical project-control evidence without requiring Health or Research. Public drafts can be promoted to a treasury scenario pack; Research packs cannot yet attach treasury context because Candidate Review covers a different evidence scope. Treasury readiness is human review of historical declared assumptions, not current cash verification. Commercial-order references remain unsupported. Historical versions do not establish current project applicability.", "responses": { "200": { "description": "Authorized immutable artifact, collection or exact command receipt.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } }, "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/DecisionPack" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid closed request or collection parameters.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive session required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current membership or role denied; service credentials are not accepted.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Record unavailable in this workspace.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request limit exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Storage or response verification unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } } } }, "/decision-packs/{packId}/versions": { "get": { "operationId": "listDecisionPackVersions", "summary": "List immutable Decision Pack version metadata", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "packId", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^decisionpack_[a-f0-9]{32}$" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 20, "default": 20 } } ], "description": "Interactive current workspace members only. Private versioned public-evidence, Research-candidate or historical treasury-scenario review artifact; no Safe approval, finalized outcome, issuer verification, paid entitlement or publication authority. Supporting Health evidence may answer a different question, shown explicitly. Research candidates retain exact private trial references and one selected capital variant across scenarios. The project association is user-selected context, not verified issuer or quote identity. Completed candidate Review receipts can attach to matching Research candidate content under current source checks, without changing human decision or financial authority. Content edits clear the attachment in the new version while retaining immutable history. Treasury scenario packs bind an exact saved projection and historical project-control evidence without requiring Health or Research. Public drafts can be promoted to a treasury scenario pack; Research packs cannot yet attach treasury context because Candidate Review covers a different evidence scope. Treasury readiness is human review of historical declared assumptions, not current cash verification. Commercial-order references remain unsupported. Historical versions do not establish current project applicability.", "responses": { "200": { "description": "Authorized immutable artifact, collection or exact command receipt.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/DecisionPackHistory" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid closed request or collection parameters.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive session required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current membership or role denied; service credentials are not accepted.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Record unavailable in this workspace.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request limit exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Storage or response verification unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } } } }, "/decision-packs/{packId}/versions/{sequence}": { "get": { "operationId": "getDecisionPackVersion", "summary": "Read an exact historical Decision Pack version", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "packId", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^decisionpack_[a-f0-9]{32}$" } }, { "name": "sequence", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" } } ], "description": "Interactive current workspace members only. Private versioned public-evidence, Research-candidate or historical treasury-scenario review artifact; no Safe approval, finalized outcome, issuer verification, paid entitlement or publication authority. Supporting Health evidence may answer a different question, shown explicitly. Research candidates retain exact private trial references and one selected capital variant across scenarios. The project association is user-selected context, not verified issuer or quote identity. Completed candidate Review receipts can attach to matching Research candidate content under current source checks, without changing human decision or financial authority. Content edits clear the attachment in the new version while retaining immutable history. Treasury scenario packs bind an exact saved projection and historical project-control evidence without requiring Health or Research. Public drafts can be promoted to a treasury scenario pack; Research packs cannot yet attach treasury context because Candidate Review covers a different evidence scope. Treasury readiness is human review of historical declared assumptions, not current cash verification. Commercial-order references remain unsupported. Historical versions do not establish current project applicability.", "responses": { "200": { "description": "Authorized immutable artifact, collection or exact command receipt.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } }, "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/DecisionPack" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid closed request or collection parameters.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive session required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current membership or role denied; service credentials are not accepted.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Record unavailable in this workspace.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request limit exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Storage or response verification unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } } } }, "/decision-packs/{packId}/commands": { "post": { "operationId": "applyDecisionPackCommand", "summary": "Append a versioned human review action to an exact pack version", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "packId", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^decisionpack_[a-f0-9]{32}$" } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 200, "pattern": "^[\\x21-\\x7E]+$" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } ], "description": "Interactive current workspace members only. Private versioned public-evidence, Research-candidate or historical treasury-scenario review artifact; no Safe approval, finalized outcome, issuer verification, paid entitlement or publication authority. Supporting Health evidence may answer a different question, shown explicitly. Research candidates retain exact private trial references and one selected capital variant across scenarios. The project association is user-selected context, not verified issuer or quote identity. Completed candidate Review receipts can attach to matching Research candidate content under current source checks, without changing human decision or financial authority. Content edits clear the attachment in the new version while retaining immutable history. Treasury scenario packs bind an exact saved projection and historical project-control evidence without requiring Health or Research. Public drafts can be promoted to a treasury scenario pack; Research packs cannot yet attach treasury context because Candidate Review covers a different evidence scope. Treasury readiness is human review of historical declared assumptions, not current cash verification. Commercial-order references remain unsupported. Historical versions do not establish current project applicability.", "responses": { "200": { "description": "Authorized immutable artifact, collection or exact command receipt.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } }, "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/DecisionPackWriteReceipt" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid closed request or collection parameters.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive session required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current membership or role denied; service credentials are not accepted.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Record unavailable in this workspace.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "409": { "description": "Command identity conflicts or lifecycle prerequisite not met.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "412": { "description": "Reviewed project or pack version changed.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "428": { "description": "Strong current pack If-Match required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request limit exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Storage or response verification unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DecisionPackCommand" } } } } } }, "/treasury/custody-evidence": { "get": { "operationId": "listTreasuryCustodyEvidence", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 20, "default": 20 } } ], "description": "Interactive current workspace membership required. Evidence is a historical finalized balance observation, not current spendable funds or financial permission. New admission requires separately provisioned current project/custody and provider authorities and configured independent RPC verification. Signed evidenceId is the tenant-scoped exact-content replay identity; callers cannot supply verification receipts.", "responses": { "200": { "description": "Authorized historical custody evidence; spendability is not established.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/TreasuryEvidenceList" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid closed request.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive session and recent authentication for admission required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current workspace role required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Evidence unavailable in this workspace.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request limit exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Storage or verification unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } } }, "post": { "operationId": "admitTreasuryCustodyEvidence", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "description": "Interactive current workspace membership required. Evidence is a historical finalized balance observation, not current spendable funds or financial permission. New admission requires separately provisioned current project/custody and provider authorities and configured independent RPC verification. Signed evidenceId is the tenant-scoped exact-content replay identity; callers cannot supply verification receipts.", "responses": { "200": { "description": "Authorized historical custody evidence; spendability is not established.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } }, "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/TreasuryEvidenceWrite" } }, "required": [ "data" ], "additionalProperties": false } } } }, "201": { "description": "Authorized historical custody evidence; spendability is not established.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } }, "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/TreasuryEvidenceWrite" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid closed request.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive session and recent authentication for admission required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current workspace role required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Evidence unavailable in this workspace.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "409": { "description": "Evidence identity already binds different signed content.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "412": { "description": "Current authority changed or expired.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request limit exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Storage or verification unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SignedTreasuryEvidence" } } } } } }, "/treasury/custody-evidence/{evidenceId}": { "get": { "operationId": "getTreasuryCustodyEvidence", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "evidenceId", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } } ], "description": "Interactive current workspace membership required. Evidence is a historical finalized balance observation, not current spendable funds or financial permission. New admission requires separately provisioned current project/custody and provider authorities and configured independent RPC verification. Signed evidenceId is the tenant-scoped exact-content replay identity; callers cannot supply verification receipts.", "responses": { "200": { "description": "Authorized historical custody evidence; spendability is not established.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } }, "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/PersistedTreasuryEvidence" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid closed request.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive session and recent authentication for admission required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current workspace role required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Evidence unavailable in this workspace.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request limit exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Storage or verification unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } } } }, "/treasury/project-control/challenges": { "post": { "operationId": "issueProjectControlChallenge", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 200, "pattern": "^[\\x21-\\x7E]+$" } } ], "description": "Current interactive owner or treasury administrator only. Mutations require recent authentication. The server verifies a separately provisioned identity publisher and both controller/custody signatures against fresh canonical finalized chain state. Challenge nonce, actor and source identities are server bound. Acceptance consumes the nonce atomically and rechecks current authority. No spending, public disclosure, or paid entitlement is granted.", "responses": { "200": { "description": "Private actor-bound proof record. Grants no financial or publication authority.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } }, "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/ProjectControlChallengeWrite" } }, "required": [ "data" ], "additionalProperties": false } } } }, "201": { "description": "Private actor-bound proof record. Grants no financial or publication authority.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } }, "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/ProjectControlChallengeWrite" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid canonical input or required request key.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive session and recent authentication for mutations required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current workspace treasury role required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Actor-bound challenge unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "409": { "description": "Request key or consumed nonce binds different content.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "412": { "description": "Challenge expired or current project/publisher authority changed.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request limit exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Verification or storage unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProjectControlIssue" } } } } } }, "/treasury/project-control/challenges/{nonce}": { "get": { "operationId": "getProjectControlChallenge", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "nonce", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } } ], "description": "Current interactive owner or treasury administrator only. Mutations require recent authentication. The server verifies a separately provisioned identity publisher and both controller/custody signatures against fresh canonical finalized chain state. Challenge nonce, actor and source identities are server bound. Acceptance consumes the nonce atomically and rechecks current authority. No spending, public disclosure, or paid entitlement is granted.", "responses": { "200": { "description": "Private actor-bound proof record. Grants no financial or publication authority.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } }, "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/PersistedProjectControlChallenge" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid canonical input or required request key.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive session and recent authentication for mutations required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current workspace treasury role required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Actor-bound challenge unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "409": { "description": "Request key or consumed nonce binds different content.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "412": { "description": "Challenge expired or current project/publisher authority changed.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request limit exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Verification or storage unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } } } }, "/treasury/project-control/proofs": { "post": { "operationId": "acceptProjectControlProof", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "description": "Current interactive owner or treasury administrator only. Mutations require recent authentication. The server verifies a separately provisioned identity publisher and both controller/custody signatures against fresh canonical finalized chain state. Challenge nonce, actor and source identities are server bound. Acceptance consumes the nonce atomically and rechecks current authority. No spending, public disclosure, or paid entitlement is granted.", "responses": { "200": { "description": "Private actor-bound proof record. Grants no financial or publication authority.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } }, "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/ProjectControlAcceptance" } }, "required": [ "data" ], "additionalProperties": false } } } }, "201": { "description": "Private actor-bound proof record. Grants no financial or publication authority.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } }, "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/ProjectControlAcceptance" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid canonical input or required request key.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive session and recent authentication for mutations required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current workspace treasury role required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Actor-bound challenge unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "409": { "description": "Request key or consumed nonce binds different content.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "412": { "description": "Challenge expired or current project/publisher authority changed.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request limit exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Verification or storage unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProjectControlProof" } } } } } }, "/treasury/reconciliation-preview": { "post": { "operationId": "previewTreasuryReconciliation", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "description": "Read-only preview for an interactive owner or treasury administrator. The server resolves the complete active ledger at its cutoff and exact tenant custody evidence references. Request mappings are assertions for review; no mapping is admitted, no financial authority is granted, and spendability remains unestablished. Quote-valued reservations cannot be used as token cash. A block balance does not establish an end-of-day opening snapshot. There is no idempotency key because no artifact or financial mutation is persisted.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TreasuryReconciliationPreviewRequest" } } } }, "responses": { "200": { "description": "Source-bound reconciliation candidate and explicit limitations.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } }, "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/TreasuryLedgerReconciliation" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid closed reference request.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive session required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current interactive treasury role required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Referenced private evidence unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "412": { "description": "Referenced source version differs from selected immutable records.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request limit exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Source verification or reconciliation unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } } } }, "/treasury/reconciliations": { "get": { "operationId": "listTreasuryReconciliations", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "pattern": "^reconciliation_[a-f0-9]{32}$" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 20, "default": 20 } } ], "description": "Interactive workspace access required. Writes require current treasury authority and recent authentication. Draft creation resolves source records on the server. Acknowledgment retains the exact candidate, checks current ledger and custody authority under locks, and records the actor and time. It confirms a mapping assertion only: no financial permission, unrestricted cash, or independent legacy custody identity verification. Historical records do not establish current applicability. Different saved mappings must not be added together as separate funds.", "responses": { "200": { "description": "Private saved mapping or immutable history. Does not establish spendability.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/TreasuryReconciliationList" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid closed request or pagination.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive session and recent authentication for writes required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current workspace authority required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Saved record unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request limit exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Storage or source verification unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } } }, "post": { "operationId": "createTreasuryReconciliation", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 200, "pattern": "^[\\x21-\\x7E]+$" } } ], "description": "Interactive workspace access required. Writes require current treasury authority and recent authentication. Draft creation resolves source records on the server. Acknowledgment retains the exact candidate, checks current ledger and custody authority under locks, and records the actor and time. It confirms a mapping assertion only: no financial permission, unrestricted cash, or independent legacy custody identity verification. Historical records do not establish current applicability. Different saved mappings must not be added together as separate funds.", "responses": { "200": { "description": "Private saved mapping or immutable history. Does not establish spendability.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } }, "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/TreasuryReconciliationWrite" } }, "required": [ "data" ], "additionalProperties": false } } } }, "201": { "description": "Private saved mapping or immutable history. Does not establish spendability.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } }, "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/TreasuryReconciliationWrite" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid closed request or pagination.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive session and recent authentication for writes required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current workspace authority required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Saved record unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "409": { "description": "Request key already binds another request.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "412": { "description": "Ledger or custody source is no longer current.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request limit exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Storage or source verification unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TreasuryReconciliationPreviewRequest" } } } } } }, "/treasury/reconciliations/{id}": { "get": { "operationId": "getTreasuryReconciliation", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^reconciliation_[a-f0-9]{32}$" } } ], "description": "Interactive workspace access required. Writes require current treasury authority and recent authentication. Draft creation resolves source records on the server. Acknowledgment retains the exact candidate, checks current ledger and custody authority under locks, and records the actor and time. It confirms a mapping assertion only: no financial permission, unrestricted cash, or independent legacy custody identity verification. Historical records do not establish current applicability. Different saved mappings must not be added together as separate funds.", "responses": { "200": { "description": "Private saved mapping or immutable history. Does not establish spendability.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } }, "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/SavedTreasuryReconciliation" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid closed request or pagination.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive session and recent authentication for writes required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current workspace authority required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Saved record unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request limit exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Storage or source verification unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } } } }, "/treasury/reconciliations/{id}/versions": { "get": { "operationId": "listTreasuryReconciliationVersions", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^reconciliation_[a-f0-9]{32}$" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 20, "default": 20 } } ], "description": "Interactive workspace access required. Writes require current treasury authority and recent authentication. Draft creation resolves source records on the server. Acknowledgment retains the exact candidate, checks current ledger and custody authority under locks, and records the actor and time. It confirms a mapping assertion only: no financial permission, unrestricted cash, or independent legacy custody identity verification. Historical records do not establish current applicability. Different saved mappings must not be added together as separate funds.", "responses": { "200": { "description": "Private saved mapping or immutable history. Does not establish spendability.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/TreasuryReconciliationHistory" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid closed request or pagination.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive session and recent authentication for writes required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current workspace authority required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Saved record unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request limit exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Storage or source verification unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } } } }, "/treasury/reconciliations/{id}/versions/{sequence}": { "get": { "operationId": "getTreasuryReconciliationVersion", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^reconciliation_[a-f0-9]{32}$" } }, { "name": "sequence", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" } } ], "description": "Interactive workspace access required. Writes require current treasury authority and recent authentication. Draft creation resolves source records on the server. Acknowledgment retains the exact candidate, checks current ledger and custody authority under locks, and records the actor and time. It confirms a mapping assertion only: no financial permission, unrestricted cash, or independent legacy custody identity verification. Historical records do not establish current applicability. Different saved mappings must not be added together as separate funds.", "responses": { "200": { "description": "Private saved mapping or immutable history. Does not establish spendability.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } }, "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/SavedTreasuryReconciliation" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid closed request or pagination.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive session and recent authentication for writes required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current workspace authority required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Saved record unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request limit exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Storage or source verification unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } } } }, "/treasury/reconciliations/{id}/acknowledge": { "post": { "operationId": "acknowledgeTreasuryReconciliation", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^reconciliation_[a-f0-9]{32}$" } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 200, "pattern": "^[\\x21-\\x7E]+$" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } ], "description": "Interactive workspace access required. Writes require current treasury authority and recent authentication. Draft creation resolves source records on the server. Acknowledgment retains the exact candidate, checks current ledger and custody authority under locks, and records the actor and time. It confirms a mapping assertion only: no financial permission, unrestricted cash, or independent legacy custody identity verification. Historical records do not establish current applicability. Different saved mappings must not be added together as separate funds.", "responses": { "200": { "description": "Private saved mapping or immutable history. Does not establish spendability.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } }, "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/TreasuryReconciliationWrite" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid closed request or pagination.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive session and recent authentication for writes required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current workspace authority required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Saved record unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "409": { "description": "Request identity conflict or mapping already acknowledged.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "412": { "description": "Reviewed version or source authority changed.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "428": { "description": "Strong exact If-Match required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request limit exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Storage or source verification unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "confirmation": { "const": "CONFIRM_LEDGER_CUSTODY_MAPPING" } }, "required": [ "confirmation" ], "additionalProperties": false } } } } } }, "/treasury/assumptions": { "get": { "operationId": "listTreasuryAssumptions", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "pattern": "^treasury_assumptions_[a-f0-9]{32}$" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 20, "default": 20 } } ], "description": "Private issuer-declared planning assumptions tied to one acknowledged reconciliation. Writes require current workspace treasury authority and recent authentication. Creation rechecks live source authority; revisions preserve exact historical source bindings and do not assert current cash applicability. Exact token units come from server records. Immutable revisions preserve attributed history. Declarations never establish verified expense completeness, actual receipts, spendability or financial authority.", "responses": { "200": { "description": "Private declared planning inputs or immutable history. Does not establish spendability.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/TreasuryAssumptionsList" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid closed request or pagination.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive session and recent authentication for writes required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current workspace authority required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Saved record unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request limit exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Storage or source verification unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } } }, "post": { "operationId": "createTreasuryAssumptions", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 200, "pattern": "^[\\x21-\\x7E]+$" } } ], "description": "Private issuer-declared planning assumptions tied to one acknowledged reconciliation. Writes require current workspace treasury authority and recent authentication. Creation rechecks live source authority; revisions preserve exact historical source bindings and do not assert current cash applicability. Exact token units come from server records. Immutable revisions preserve attributed history. Declarations never establish verified expense completeness, actual receipts, spendability or financial authority.", "responses": { "200": { "description": "Private declared planning inputs or immutable history. Does not establish spendability.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } }, "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/TreasuryAssumptionsWrite" } }, "required": [ "data" ], "additionalProperties": false } } } }, "201": { "description": "Private declared planning inputs or immutable history. Does not establish spendability.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } }, "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/TreasuryAssumptionsWrite" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid closed request or pagination.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive session and recent authentication for writes required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current workspace authority required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Saved record unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "409": { "description": "Request key already binds another request.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "412": { "description": "Ledger or custody source is no longer current.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request limit exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Storage or source verification unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TreasuryAssumptionsCreate" } } } } } }, "/treasury/assumptions/{id}": { "get": { "operationId": "getTreasuryAssumptions", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^treasury_assumptions_[a-f0-9]{32}$" } } ], "description": "Private issuer-declared planning assumptions tied to one acknowledged reconciliation. Writes require current workspace treasury authority and recent authentication. Creation rechecks live source authority; revisions preserve exact historical source bindings and do not assert current cash applicability. Exact token units come from server records. Immutable revisions preserve attributed history. Declarations never establish verified expense completeness, actual receipts, spendability or financial authority.", "responses": { "200": { "description": "Private declared planning inputs or immutable history. Does not establish spendability.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } }, "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/TreasuryAssumptions" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid closed request or pagination.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive session and recent authentication for writes required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current workspace authority required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Saved record unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request limit exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Storage or source verification unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } } } }, "/treasury/assumptions/{id}/versions": { "get": { "operationId": "listTreasuryAssumptionsVersions", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^treasury_assumptions_[a-f0-9]{32}$" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 20, "default": 20 } } ], "description": "Private issuer-declared planning assumptions tied to one acknowledged reconciliation. Writes require current workspace treasury authority and recent authentication. Creation rechecks live source authority; revisions preserve exact historical source bindings and do not assert current cash applicability. Exact token units come from server records. Immutable revisions preserve attributed history. Declarations never establish verified expense completeness, actual receipts, spendability or financial authority.", "responses": { "200": { "description": "Private declared planning inputs or immutable history. Does not establish spendability.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/TreasuryAssumptionsHistory" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid closed request or pagination.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive session and recent authentication for writes required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current workspace authority required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Saved record unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request limit exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Storage or source verification unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } } } }, "/treasury/assumptions/{id}/versions/{sequence}": { "get": { "operationId": "getTreasuryAssumptionsVersion", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^treasury_assumptions_[a-f0-9]{32}$" } }, { "name": "sequence", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" } } ], "description": "Private issuer-declared planning assumptions tied to one acknowledged reconciliation. Writes require current workspace treasury authority and recent authentication. Creation rechecks live source authority; revisions preserve exact historical source bindings and do not assert current cash applicability. Exact token units come from server records. Immutable revisions preserve attributed history. Declarations never establish verified expense completeness, actual receipts, spendability or financial authority.", "responses": { "200": { "description": "Private declared planning inputs or immutable history. Does not establish spendability.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } }, "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/TreasuryAssumptions" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid closed request or pagination.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive session and recent authentication for writes required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current workspace authority required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Saved record unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request limit exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Storage or source verification unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } } } }, "/treasury/assumptions/{id}/revisions": { "post": { "operationId": "reviseTreasuryAssumptions", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^treasury_assumptions_[a-f0-9]{32}$" } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 200, "pattern": "^[\\x21-\\x7E]+$" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } ], "description": "Private issuer-declared planning assumptions tied to one acknowledged reconciliation. Writes require current workspace treasury authority and recent authentication. Creation rechecks live source authority; revisions preserve exact historical source bindings and do not assert current cash applicability. Exact token units come from server records. Immutable revisions preserve attributed history. Declarations never establish verified expense completeness, actual receipts, spendability or financial authority.", "responses": { "200": { "description": "Private declared planning inputs or immutable history. Does not establish spendability.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } }, "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/TreasuryAssumptionsWrite" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid closed request or pagination.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive session and recent authentication for writes required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current workspace authority required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Saved record unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "409": { "description": "Request identity conflict.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "412": { "description": "Assumptions version or source authority changed.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "428": { "description": "Strong exact If-Match required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request limit exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Storage or source verification unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TreasuryAssumptionsRevision" } } } } } }, "/treasury/projections": { "get": { "operationId": "listTreasuryProjections", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "pattern": "^treasury_projection_[a-f0-9]{32}$" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 20, "default": 20 } } ], "description": "Uses exact saved assumption and acknowledged reconciliation versions. The server computes from a common block snapshot and declared restrictions; it never accepts caller balances or computed outputs. Snapshot-day unpaid schedules are included. Conditional funding stays separate. Historical source use does not claim current source applicability. Writes require recent interactive treasury authentication; reads require current workspace access.", "responses": { "200": { "description": "Private immutable historical planning scenario. Does not establish current cash or spendability.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/TreasuryProjectionList" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid or unsupported planning inputs.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive authentication required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current workspace authority required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Saved source or scenario unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request limit exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Storage or source integrity verification unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } } }, "post": { "operationId": "createTreasuryProjection", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 200, "pattern": "^[\\x21-\\x7E]+$" } } ], "description": "Uses exact saved assumption and acknowledged reconciliation versions. The server computes from a common block snapshot and declared restrictions; it never accepts caller balances or computed outputs. Snapshot-day unpaid schedules are included. Conditional funding stays separate. Historical source use does not claim current source applicability. Writes require recent interactive treasury authentication; reads require current workspace access.", "responses": { "200": { "description": "Private immutable historical planning scenario. Does not establish current cash or spendability.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } }, "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/TreasuryProjectionWrite" } }, "required": [ "data" ], "additionalProperties": false } } } }, "201": { "description": "Private immutable historical planning scenario. Does not establish current cash or spendability.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } }, "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/TreasuryProjectionWrite" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid or unsupported planning inputs.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive authentication required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current workspace authority required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Saved source or scenario unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "409": { "description": "Request key already binds another scenario.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "412": { "description": "Exact saved source binding differs.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request limit exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Storage or source integrity verification unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TreasuryProjectionCreate" } } } } } }, "/treasury/projections/{id}": { "get": { "operationId": "getTreasuryProjection", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^treasury_projection_[a-f0-9]{32}$" } } ], "description": "Uses exact saved assumption and acknowledged reconciliation versions. The server computes from a common block snapshot and declared restrictions; it never accepts caller balances or computed outputs. Snapshot-day unpaid schedules are included. Conditional funding stays separate. Historical source use does not claim current source applicability. Writes require recent interactive treasury authentication; reads require current workspace access.", "responses": { "200": { "description": "Private immutable historical planning scenario. Does not establish current cash or spendability.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } }, "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"0x[0-9a-f]{64}\"$" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/TreasuryProjection" } }, "required": [ "data" ], "additionalProperties": false } } } }, "400": { "description": "Invalid or unsupported planning inputs.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Interactive authentication required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Current workspace authority required.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Saved source or scenario unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "Request limit exceeded.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "Storage or source integrity verification unavailable.", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } } } }, "/public/discovery/search": { "get": { "operationId": "searchDiscoveredProjects", "summary": "Search supported public Virtuals project identities", "tags": [ "Intelligence" ], "security": [], "parameters": [ { "name": "q", "in": "query", "required": true, "schema": { "type": "string", "minLength": 2, "maxLength": 200, "description": "Name, ticker, supported token address or HTTPS Virtuals project URL." } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 1 } } ], "description": "Anonymous provider-reported public market evidence. No issuer ownership, finalized onchain proof, trade execution, custody or publication authority is established.", "responses": { "200": { "description": "Search supported public Virtuals project identities", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/MarketDiscoverySearch" } }, "required": [ "data" ], "additionalProperties": false } } } }, "default": { "description": "Invalid input, access denied, source/storage failure or deadline exceeded. Workspace authentication errors may use the shared API envelope; bounded route failures expose a message. Rate-limit responses may be plain text.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/WorkflowRequestError" }, { "$ref": "#/components/schemas/WorkflowRateLimitError" }, { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } ] } }, "text/plain": { "schema": { "type": "string", "format": "binary" } }, "text/html": { "schema": { "type": "string", "format": "binary" } } } } } } }, "/public/discovery/market/{id}": { "get": { "operationId": "getDiscoveredProjectMarket", "summary": "Read provider-reported project pools and market figures", "tags": [ "Intelligence" ], "security": [], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } } ], "description": "Anonymous provider-reported public market evidence. No issuer ownership, finalized onchain proof, trade execution, custody or publication authority is established.", "responses": { "200": { "description": "Read provider-reported project pools and market figures", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/MarketDiscoveryEvidence" } }, "required": [ "data" ], "additionalProperties": false } } } }, "default": { "description": "Invalid input, access denied, source/storage failure or deadline exceeded. Workspace authentication errors may use the shared API envelope; bounded route failures expose a message. Rate-limit responses may be plain text.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/WorkflowRequestError" }, { "$ref": "#/components/schemas/WorkflowRateLimitError" }, { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } ] } }, "text/plain": { "schema": { "type": "string", "format": "binary" } }, "text/html": { "schema": { "type": "string", "format": "binary" } } } } } } }, "/public/discovery/capabilities": { "get": { "operationId": "getMarketDiscoveryCapabilities", "summary": "Read configured research capability availability", "tags": [ "Intelligence" ], "security": [], "parameters": [], "description": "Anonymous provider-reported public market evidence. No issuer ownership, finalized onchain proof, trade execution, custody or publication authority is established.", "responses": { "200": { "description": "Read configured research capability availability", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/MarketDiscoveryCapabilities" } }, "required": [ "data" ], "additionalProperties": false } } } }, "default": { "description": "Invalid input, access denied, source/storage failure or deadline exceeded. Workspace authentication errors may use the shared API envelope; bounded route failures expose a message. Rate-limit responses may be plain text.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/WorkflowRequestError" }, { "$ref": "#/components/schemas/WorkflowRateLimitError" }, { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } ] } }, "text/plain": { "schema": { "type": "string", "format": "binary" } }, "text/html": { "schema": { "type": "string", "format": "binary" } } } } } } }, "/workflows/context": { "get": { "operationId": "getWorkflowContext", "summary": "List authorized vault choices and saved-research availability", "tags": [ "Platform" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string", "maxLength": 160, "minLength": 1 } } ], "description": "Requires current interactive session and workspace membership; service credentials are not accepted unless an explicit service scope is declared. Research and directory bookmarks grant no signing, custody or execution authority.", "responses": { "200": { "description": "List authorized vault choices and saved-research availability", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/WorkflowContext" } }, "required": [ "data" ], "additionalProperties": false } } } }, "default": { "description": "Invalid input, access denied, source/storage failure or deadline exceeded. Workspace authentication errors may use the shared API envelope; bounded route failures expose a message. Rate-limit responses may be plain text.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/WorkflowRequestError" }, { "$ref": "#/components/schemas/WorkflowRateLimitError" }, { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } ] } }, "text/plain": { "schema": { "type": "string", "format": "binary" } }, "text/html": { "schema": { "type": "string", "format": "binary" } } } } } } }, "/workflows/runs": { "get": { "operationId": "listCompletedWorkflowRuns", "summary": "List completed research saved for the current workspace and reader", "tags": [ "Platform" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string", "maxLength": 160, "minLength": 1 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 1024, "pattern": "^[A-Za-z0-9_-]+$" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 20, "default": 20 } } ], "description": "Requires current interactive session and workspace membership; service credentials are not accepted unless an explicit service scope is declared. Research and directory bookmarks grant no signing, custody or execution authority.", "responses": { "200": { "description": "List completed research saved for the current workspace and reader", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/CompletedWorkflowPage" } }, "required": [ "data" ], "additionalProperties": false } } } }, "default": { "description": "Invalid input, access denied, source/storage failure or deadline exceeded. Workspace authentication errors may use the shared API envelope; bounded route failures expose a message. Rate-limit responses may be plain text.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/WorkflowRequestError" }, { "$ref": "#/components/schemas/WorkflowRateLimitError" }, { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } ] } }, "text/plain": { "schema": { "type": "string", "format": "binary" } }, "text/html": { "schema": { "type": "string", "format": "binary" } } } } } } }, "/workflows/runs/{id}": { "get": { "operationId": "getCompletedWorkflowRun", "summary": "Read one immutable research result saved for the current reader", "tags": [ "Platform" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string", "maxLength": 160, "minLength": 1 } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } ], "description": "Requires current interactive session and workspace membership; service credentials are not accepted unless an explicit service scope is declared. Research and directory bookmarks grant no signing, custody or execution authority.", "responses": { "200": { "description": "Read one immutable research result saved for the current reader", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/CompletedWorkflowRun" } }, "required": [ "data" ], "additionalProperties": false } } } }, "default": { "description": "Invalid input, access denied, source/storage failure or deadline exceeded. Workspace authentication errors may use the shared API envelope; bounded route failures expose a message. Rate-limit responses may be plain text.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/WorkflowRequestError" }, { "$ref": "#/components/schemas/WorkflowRateLimitError" }, { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } ] } }, "text/plain": { "schema": { "type": "string", "format": "binary" } }, "text/html": { "schema": { "type": "string", "format": "binary" } } } } } } }, "/workflows/run": { "post": { "operationId": "runWorkflowResearch", "summary": "Complete a bounded read-only liquidity research question", "tags": [ "Platform" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string", "maxLength": 160, "minLength": 1 } } ], "description": "Requires current interactive session and workspace membership; service credentials are not accepted unless an explicit service scope is declared. Research and directory bookmarks grant no signing, custody or execution authority. The JSON request is limited to 48 KiB. Up to six prior question/answer pairs provide conversational context, not evidence. New evidence is fetched server-side; successful production runs are saved for the current reader. AI output remains a proposal for human review.", "responses": { "200": { "description": "Complete a bounded read-only liquidity research question", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/WorkflowResearchResponse" } }, "required": [ "data" ], "additionalProperties": false } } } }, "default": { "description": "Invalid input, access denied, source/storage failure or deadline exceeded. Workspace authentication errors may use the shared API envelope; bounded route failures expose a message. Rate-limit responses may be plain text.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/WorkflowRequestError" }, { "$ref": "#/components/schemas/WorkflowRateLimitError" }, { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } ] } }, "text/plain": { "schema": { "type": "string", "format": "binary" } }, "text/html": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WorkflowResearchRequest" } } } } } }, "/virtuals-projects": { "get": { "operationId": "listSavedVirtualsProjects", "summary": "List workspace Virtuals directory bookmarks", "tags": [ "Platform" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string", "maxLength": 160, "minLength": 1 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 1024, "pattern": "^[A-Za-z0-9_-]+$" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 20, "default": 20 } } ], "description": "Requires current interactive session and workspace membership; service credentials are not accepted unless an explicit service scope is declared. Research and directory bookmarks grant no signing, custody or execution authority.", "responses": { "200": { "description": "List workspace Virtuals directory bookmarks", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/SavedVirtualsProjectPage" } }, "required": [ "data" ], "additionalProperties": false } } } }, "default": { "description": "Invalid input, access denied, source/storage failure or deadline exceeded. Workspace authentication errors may use the shared API envelope; bounded route failures expose a message. Rate-limit responses may be plain text.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/WorkflowRequestError" }, { "$ref": "#/components/schemas/WorkflowRateLimitError" }, { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } ] } }, "text/plain": { "schema": { "type": "string", "format": "binary" } }, "text/html": { "schema": { "type": "string", "format": "binary" } } } } } }, "post": { "operationId": "saveVirtualsProject", "summary": "Save an independently resolved Virtuals directory bookmark", "tags": [ "Platform" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string", "maxLength": 160, "minLength": 1 } } ], "description": "Requires current interactive session and workspace membership; service credentials are not accepted unless an explicit service scope is declared. Research and directory bookmarks grant no signing, custody or execution authority. The JSON request is limited to 4 KiB and accepts only the selected Virtuals ID. Project identity is retrieved server-side; duplicate saves return the original record with replayed=true. This route uses native bookmark replay rather than an Idempotency-Key header.", "responses": { "200": { "description": "Save an independently resolved Virtuals directory bookmark", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/SaveVirtualsProjectReceipt" } }, "required": [ "data" ], "additionalProperties": false } } } }, "default": { "description": "Invalid input, access denied, source/storage failure or deadline exceeded. Workspace authentication errors may use the shared API envelope; bounded route failures expose a message. Rate-limit responses may be plain text.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/WorkflowRequestError" }, { "$ref": "#/components/schemas/WorkflowRateLimitError" }, { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } ] } }, "text/plain": { "schema": { "type": "string", "format": "binary" } }, "text/html": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SaveVirtualsProjectRequest" } } } } } }, "/virtuals-projects/{id}": { "get": { "operationId": "getSavedVirtualsProject", "summary": "Read a workspace Virtuals directory bookmark", "tags": [ "Platform" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string", "maxLength": 160, "minLength": 1 } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } } ], "description": "Requires current interactive session and workspace membership; service credentials are not accepted unless an explicit service scope is declared. Research and directory bookmarks grant no signing, custody or execution authority.", "responses": { "200": { "description": "Read a workspace Virtuals directory bookmark", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/SavedVirtualsProject" } }, "required": [ "data" ], "additionalProperties": false } } } }, "default": { "description": "Invalid input, access denied, source/storage failure or deadline exceeded. Workspace authentication errors may use the shared API envelope; bounded route failures expose a message. Rate-limit responses may be plain text.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/WorkflowRequestError" }, { "$ref": "#/components/schemas/WorkflowRateLimitError" }, { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } ] } }, "text/plain": { "schema": { "type": "string", "format": "binary" } }, "text/html": { "schema": { "type": "string", "format": "binary" } } } } } }, "delete": { "operationId": "removeSavedVirtualsProject", "summary": "Remove the exact reviewed Virtuals directory bookmark generation", "tags": [ "Platform" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string", "maxLength": 160, "minLength": 1 } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } } ], "description": "Requires current interactive session and workspace membership; service credentials are not accepted unless an explicit service scope is declared. Research and directory bookmarks grant no signing, custody or execution authority. Send expectedResourceVersion in the JSON body. If-Match and Idempotency-Key headers are not used by this route; a stale generation fails with 412.", "responses": { "200": { "description": "Remove the exact reviewed Virtuals directory bookmark generation", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/RemoveVirtualsProjectReceipt" } }, "required": [ "data" ], "additionalProperties": false } } } }, "default": { "description": "Invalid input, access denied, source/storage failure or deadline exceeded. Workspace authentication errors may use the shared API envelope; bounded route failures expose a message. Rate-limit responses may be plain text.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/WorkflowRequestError" }, { "$ref": "#/components/schemas/WorkflowRateLimitError" }, { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } ] } }, "text/plain": { "schema": { "type": "string", "format": "binary" } }, "text/html": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RemoveVirtualsProjectRequest" } } } } } }, "/treasury-entries/{id}/versions": { "get": { "operationId": "listTreasuryLedgerEntryVersions", "summary": "List immutable versions of a treasury ledger entry", "tags": [ "Platform" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string", "maxLength": 160, "minLength": 1 } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 256, "description": "Opaque base64url resource-version cursor from data.nextCursor." } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 100 } } ], "description": "Requires current interactive session and workspace membership; service credentials are not accepted unless an explicit service scope is declared. Research and directory bookmarks grant no signing, custody or execution authority.", "responses": { "200": { "description": "List immutable versions of a treasury ledger entry", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/TreasuryLedgerVersionPage" } }, "required": [ "data" ], "additionalProperties": false } } } }, "default": { "description": "Invalid input, access denied, source/storage failure or deadline exceeded. Workspace authentication errors may use the shared API envelope; bounded route failures expose a message. Rate-limit responses may be plain text.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } } } }, "/proposals/{id}/review": { "get": { "operationId": "getProposalWorkspaceReview", "summary": "Read a resource-version-bound proposal review snapshot", "tags": [ "Platform" ], "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "proposals:read" ] } ], "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string", "maxLength": 160, "minLength": 1 } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "resourceVersion", "in": "query", "required": true, "schema": { "$ref": "#/components/schemas/Hash" } } ], "description": "Requires current workspace membership and either an interactive session or proposals:read service scope. The required resourceVersion query binds the current proposal generation; stale versions fail with 412. Comments do not advance the proposal version, so reviewEvidenceHash separately binds the review snapshot. Internal approvals and verified historical Safe submissions grant no new execution authority.", "responses": { "200": { "description": "Read a resource-version-bound proposal review snapshot", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/ProposalWorkspaceReview" } }, "required": [ "data" ], "additionalProperties": false } } } }, "default": { "description": "Invalid input, access denied, source/storage failure or deadline exceeded. Workspace authentication errors may use the shared API envelope; bounded route failures expose a message. Rate-limit responses may be plain text.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ApiError" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "x-klineo-required-service-scope": "proposals:read" } }, "/intents": { "get": { "operationId": "listIntents", "summary": "List issuer intents", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Opaque cursor returned in the previous response metadata." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "responses": { "200": { "description": "Latest tenant-isolated aggregate versions", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/IssuerIntent" } } } ] } }, "meta": { "type": "object", "additionalProperties": false, "required": [ "count", "hasMore" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string" } } } } } } } } }, "security": [ { "sessionCookie": [] } ] }, "post": { "operationId": "createIntents", "summary": "Create issuer intents", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "payload", "reason" ], "properties": { "payload": { "$ref": "#/components/schemas/IssuerIntent" }, "status": { "$ref": "#/components/schemas/OperatingSystemRecordStatus" }, "evidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "maxItems": 256 }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Append-only aggregate created", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": false, "required": [ "intent", "capitalRequirement" ], "properties": { "intent": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/IssuerIntent" } } } ] }, "capitalRequirement": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/CapitalRequirementStudy" } } } ] } } } } } } } } }, "security": [ { "sessionCookie": [] } ] } }, "/intents/{id}": { "get": { "operationId": "getIntents", "summary": "Get one issuer intents aggregate", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Current immutable aggregate version", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/IssuerIntent" } } } ] } } } } }, "headers": { "ETag": { "required": true, "schema": { "type": "string" } } } }, "404": { "description": "Not found" } }, "security": [ { "sessionCookie": [] } ] }, "patch": { "operationId": "supersedeIntents", "summary": "Supersede an intent and recompute immutable deterministic capital evidence", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "reason" ], "properties": { "payload": { "$ref": "#/components/schemas/IssuerIntent" }, "status": { "type": "string", "enum": [ "DRAFT", "VALIDATED", "PAUSED", "REVOKED" ] }, "evidenceHashes": { "type": "array", "maxItems": 256, "items": { "$ref": "#/components/schemas/Hash" } }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "200": { "description": "Append-only bounded supersession accepted with deterministic evidence", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": false, "required": [ "intent", "capitalRequirement", "validationEvidence" ], "properties": { "intent": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/IssuerIntent" } } } ] }, "capitalRequirement": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/CapitalRequirementStudy" } } } ] }, "validationEvidence": { "$ref": "#/components/schemas/OperatingSystemEvent" } } } } } } } }, "400": { "description": "Payload or safety transition is outside this bounded operation" }, "409": { "description": "Typed authority workflow is required" }, "412": { "description": "Strong precondition failed" } }, "security": [ { "sessionCookie": [] } ] } }, "/studies": { "get": { "operationId": "listStudies", "summary": "List simulation studies", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Opaque cursor returned in the previous response metadata." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "responses": { "200": { "description": "Latest tenant-isolated aggregate versions", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/SimulationStudy" } } } ] } }, "meta": { "type": "object", "additionalProperties": false, "required": [ "count", "hasMore" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string" } } } } } } } } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "studies:read" ] } ], "x-klineo-required-service-scope": "studies:read" }, "post": { "operationId": "createStudies", "summary": "Create simulation studies", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SimulationStudyRequest" } } } }, "responses": { "201": { "description": "Append-only aggregate created", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "oneOf": [ { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/SimulationStudy" } } } ] }, { "type": "object", "additionalProperties": false, "required": [ "study", "job", "interactive", "signedReportPending" ], "properties": { "study": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/SimulationStudy" } } } ] }, "job": { "$ref": "#/components/schemas/OperatingSystemJob" }, "interactive": { "const": false }, "signedReportPending": { "const": true } } } ] } } } } } } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "studies:write" ] } ], "x-klineo-required-service-scope": "studies:write" } }, "/studies/{id}": { "get": { "operationId": "getStudies", "summary": "Get one simulation studies aggregate", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Current immutable aggregate version", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/SimulationStudy" } } } ] } } } } }, "headers": { "ETag": { "required": true, "schema": { "type": "string" } } } }, "404": { "description": "Not found" } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "studies:read" ] } ], "x-klineo-required-service-scope": "studies:read" } }, "/study-shares": { "get": { "operationId": "listStudyShares", "summary": "List revocable simulation-study shares", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Opaque cursor returned in the previous response metadata." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "responses": { "200": { "description": "Latest tenant-isolated aggregate versions", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/StudyShare" } } } ] } }, "meta": { "type": "object", "additionalProperties": false, "required": [ "count", "hasMore" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string" } } } } } } } } }, "security": [ { "sessionCookie": [] } ] } }, "/study-shares/{id}": { "get": { "operationId": "getStudyShares", "summary": "Get one revocable simulation-study shares aggregate", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Current immutable aggregate version", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/StudyShare" } } } ] } } } } }, "headers": { "ETag": { "required": true, "schema": { "type": "string" } } } }, "404": { "description": "Not found" } }, "security": [ { "sessionCookie": [] } ] } }, "/strategies": { "get": { "operationId": "listStrategies", "summary": "List strategy definitions", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Opaque cursor returned in the previous response metadata." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "responses": { "200": { "description": "Latest tenant-isolated aggregate versions", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/StrategyDefinitionV2" } } } ] } }, "meta": { "type": "object", "additionalProperties": false, "required": [ "count", "hasMore" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string" } } } } } } } } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "strategies:validate" ] } ], "x-klineo-required-service-scope": "strategies:validate" }, "post": { "operationId": "createStrategies", "summary": "Create strategy definitions", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "payload", "reason" ], "properties": { "payload": { "$ref": "#/components/schemas/StrategyDefinitionV2Input" }, "status": { "$ref": "#/components/schemas/OperatingSystemRecordStatus" }, "evidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "maxItems": 256 }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Append-only aggregate created", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": false, "required": [ "strategy", "compilation" ], "properties": { "strategy": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/StrategyDefinitionV2" } } } ] }, "compilation": { "$ref": "#/components/schemas/StrategyCompilation" } } } } } } } } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "strategies:validate" ] } ], "x-klineo-required-service-scope": "strategies:validate" } }, "/strategies/{id}": { "get": { "operationId": "getStrategies", "summary": "Get one strategy definitions aggregate", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Current immutable aggregate version", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/StrategyDefinitionV2" } } } ] } } } } }, "headers": { "ETag": { "required": true, "schema": { "type": "string" } } } }, "404": { "description": "Not found" } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "strategies:validate" ] } ], "x-klineo-required-service-scope": "strategies:validate" }, "patch": { "operationId": "supersedeStrategies", "summary": "Supersede a declarative strategy only after deterministic compilation", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "reason" ], "properties": { "payload": { "$ref": "#/components/schemas/StrategyDefinitionV2Input" }, "status": { "type": "string", "enum": [ "DRAFT", "VALIDATED", "PAUSED", "REVOKED" ] }, "evidenceHashes": { "type": "array", "maxItems": 256, "items": { "$ref": "#/components/schemas/Hash" } }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "200": { "description": "Append-only bounded supersession accepted with deterministic evidence", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": false, "required": [ "strategy", "compilation", "compilationEvidence" ], "properties": { "strategy": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/StrategyDefinitionV2" } } } ] }, "compilation": { "$ref": "#/components/schemas/StrategyCompilation" }, "compilationEvidence": { "$ref": "#/components/schemas/OperatingSystemEvent" } } } } } } } }, "400": { "description": "Payload or safety transition is outside this bounded operation" }, "409": { "description": "Typed authority workflow is required" }, "412": { "description": "Strong precondition failed" } }, "security": [ { "sessionCookie": [] } ] } }, "/proposals": { "get": { "operationId": "listProposals", "summary": "List decision workspaces", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Opaque cursor returned in the previous response metadata." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "responses": { "200": { "description": "Latest tenant-isolated aggregate versions", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/ProposalWorkspace" } } } ] } }, "meta": { "type": "object", "additionalProperties": false, "required": [ "count", "hasMore" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string" } } } } } } } } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "proposals:read" ] } ], "x-klineo-required-service-scope": "proposals:read" }, "post": { "operationId": "createProposals", "summary": "Create a decision packet with zero server-recorded approvals", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "payload", "reason" ], "properties": { "payload": { "$ref": "#/components/schemas/ProposalWorkspaceInput" }, "status": { "$ref": "#/components/schemas/OperatingSystemRecordStatus" }, "evidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "maxItems": 256 }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Append-only proposal created; approvals are admitted only through typed decision events", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/ProposalWorkspace" } } } ] } } } } } }, "400": { "description": "Request attempted derived approval or Safe fields, or failed validation" }, "409": { "description": "Immutable strategy-admission evidence is unavailable or superseded" } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "proposals:prepare" ] } ], "x-klineo-required-service-scope": "proposals:prepare" } }, "/proposals/{id}": { "get": { "operationId": "getProposals", "summary": "Get one decision workspaces aggregate", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Current immutable aggregate version", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/ProposalWorkspace" } } } ] } } } } }, "headers": { "ETag": { "required": true, "schema": { "type": "string" } } } }, "404": { "description": "Not found" } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "proposals:read" ] } ], "x-klineo-required-service-scope": "proposals:read" } }, "/launch-plans": { "get": { "operationId": "listLaunchPlans", "summary": "List launch plans", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Opaque cursor returned in the previous response metadata." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "responses": { "200": { "description": "Latest tenant-isolated aggregate versions", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/LaunchPlan" } } } ] } }, "meta": { "type": "object", "additionalProperties": false, "required": [ "count", "hasMore" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string" } } } } } } } } }, "security": [ { "sessionCookie": [] } ] }, "post": { "operationId": "createLaunchPlans", "summary": "Create launch plans", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LaunchPlanRequest" } } } }, "responses": { "201": { "description": "Append-only aggregate created", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/LaunchPlan" } } } ] } } } } } } }, "security": [ { "sessionCookie": [] } ] } }, "/launch-plans/{id}": { "get": { "operationId": "getLaunchPlans", "summary": "Get one launch plans aggregate", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Current immutable aggregate version", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/LaunchPlan" } } } ] } } } } }, "headers": { "ETag": { "required": true, "schema": { "type": "string" } } } }, "404": { "description": "Not found" } }, "security": [ { "sessionCookie": [] } ] } }, "/unlock-impacts": { "get": { "operationId": "listUnlockImpacts", "summary": "List unlock impact studies", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Opaque cursor returned in the previous response metadata." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "responses": { "200": { "description": "Latest tenant-isolated aggregate versions", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/UnlockImpact" } } } ] } }, "meta": { "type": "object", "additionalProperties": false, "required": [ "count", "hasMore" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string" } } } } } } } } }, "security": [ { "sessionCookie": [] } ] }, "post": { "operationId": "createUnlockImpacts", "summary": "Create a correlation-aware unlock study and queue four explicit downstream materializations", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnlockImpactRequest" } } } }, "responses": { "201": { "description": "Immutable unlock impact with p5/p50/p95 ranges, lineage events, and fenced jobs", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": false, "required": [ "id", "organizationId", "recordType", "version", "status", "payload", "artifactHash", "evidenceHashes", "createdBy", "reason", "requestId", "createdAt", "updatedAt", "resourceVersion", "downstream" ], "properties": { "id": { "type": "string" }, "organizationId": { "type": "string" }, "recordType": { "$ref": "#/components/schemas/OperatingSystemRecordType" }, "version": { "type": "integer", "minimum": 1 }, "status": { "$ref": "#/components/schemas/OperatingSystemRecordStatus" }, "payload": { "$ref": "#/components/schemas/UnlockImpact" }, "artifactHash": { "$ref": "#/components/schemas/Hash" }, "evidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" } }, "createdBy": { "type": "string" }, "reason": { "type": "string" }, "requestId": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "supersedesVersion": { "type": "integer", "minimum": 1 }, "resourceVersion": { "$ref": "#/components/schemas/Hash" }, "downstream": { "type": "object", "additionalProperties": false, "required": [ "events", "jobs" ], "properties": { "events": { "type": "array", "items": { "$ref": "#/components/schemas/OperatingSystemEvent" } }, "jobs": { "type": "array", "items": { "$ref": "#/components/schemas/OperatingSystemJob" } } } } } } } } } } } }, "security": [ { "sessionCookie": [] } ] } }, "/unlock-impacts/{id}": { "get": { "operationId": "getUnlockImpacts", "summary": "Get one unlock impact studies aggregate", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Current immutable aggregate version", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/UnlockImpact" } } } ] } } } } }, "headers": { "ETag": { "required": true, "schema": { "type": "string" } } } }, "404": { "description": "Not found" } }, "security": [ { "sessionCookie": [] } ] } }, "/scores": { "get": { "operationId": "listScores", "summary": "List market quality scores", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Opaque cursor returned in the previous response metadata." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "responses": { "200": { "description": "Latest tenant-isolated aggregate versions", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/MarketQualityScore" } } } ] } }, "meta": { "type": "object", "additionalProperties": false, "required": [ "count", "hasMore" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string" } } } } } } } } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "scores:read" ] } ], "x-klineo-required-service-scope": "scores:read" }, "post": { "operationId": "createScores", "summary": "Create market quality scores", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarketQualityRequest" } } } }, "responses": { "201": { "description": "Append-only aggregate created", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/MarketQualityScore" } } } ] } } } } } } }, "security": [ { "sessionCookie": [] } ] } }, "/scores/{id}": { "get": { "operationId": "getScores", "summary": "Get one market quality scores aggregate", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Current immutable aggregate version", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/MarketQualityScore" } } } ] } } } } }, "headers": { "ETag": { "required": true, "schema": { "type": "string" } } } }, "404": { "description": "Not found" } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "scores:read" ] } ], "x-klineo-required-service-scope": "scores:read" } }, "/attributions": { "get": { "operationId": "listAttributions", "summary": "List execution attributions", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Opaque cursor returned in the previous response metadata." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "responses": { "200": { "description": "Latest tenant-isolated aggregate versions", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/ExecutionAttribution" } } } ] } }, "meta": { "type": "object", "additionalProperties": false, "required": [ "count", "hasMore" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string" } } } } } } } } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "receipts:read" ] } ], "x-klineo-required-service-scope": "receipts:read" }, "post": { "operationId": "createAttributions", "summary": "Create execution attributions", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExecutionAttributionRequest" } } } }, "responses": { "201": { "description": "Append-only aggregate created", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/ExecutionAttribution" } } } ] } } } } } } }, "security": [ { "sessionCookie": [] } ] } }, "/attributions/{id}": { "get": { "operationId": "getAttributions", "summary": "Get one execution attributions aggregate", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Current immutable aggregate version", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/ExecutionAttribution" } } } ] } } } } }, "headers": { "ETag": { "required": true, "schema": { "type": "string" } } } }, "404": { "description": "Not found" } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "receipts:read" ] } ], "x-klineo-required-service-scope": "receipts:read" } }, "/anomalies": { "get": { "operationId": "listAnomalies", "summary": "List anomalies", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Opaque cursor returned in the previous response metadata." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "responses": { "200": { "description": "Latest tenant-isolated aggregate versions", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/Anomaly" } } } ] } }, "meta": { "type": "object", "additionalProperties": false, "required": [ "count", "hasMore" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string" } } } } } } } } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "alerts:read" ] } ], "x-klineo-required-service-scope": "alerts:read" }, "post": { "operationId": "createAnomalies", "summary": "Create anomalies", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AnomalyDetectionRequest" } } } }, "responses": { "201": { "description": "Append-only aggregate created", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/Anomaly" } } } ] } } } } } } }, "security": [ { "sessionCookie": [] } ] } }, "/anomalies/{id}": { "get": { "operationId": "getAnomalies", "summary": "Get one anomalies aggregate", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Current immutable aggregate version", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/Anomaly" } } } ] } } } } }, "headers": { "ETag": { "required": true, "schema": { "type": "string" } } } }, "404": { "description": "Not found" } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "alerts:read" ] } ], "x-klineo-required-service-scope": "alerts:read" } }, "/treasury-entries": { "get": { "operationId": "listTreasuryEntries", "summary": "List treasury ledger entries", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Opaque cursor returned in the previous response metadata." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "responses": { "200": { "description": "Latest tenant-isolated aggregate versions", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/TreasuryBucket" } } } ] } }, "meta": { "type": "object", "additionalProperties": false, "required": [ "count", "hasMore" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string" } } } } } } } } }, "security": [ { "sessionCookie": [] } ] }, "post": { "operationId": "createTreasuryEntries", "summary": "Append a fresh signed oracle-bound economic capital container", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "payload", "reason" ], "properties": { "payload": { "$ref": "#/components/schemas/TreasuryBucket" }, "status": { "$ref": "#/components/schemas/OperatingSystemRecordStatus" }, "evidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "maxItems": 256 }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Reconciled ledger entry", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/TreasuryBucket" } } } ] } } } } } }, "409": { "description": "Stale oracle generation or duplicate observation/container/obligation" } }, "security": [ { "sessionCookie": [] } ] } }, "/treasury-entries/{id}": { "get": { "operationId": "getTreasuryEntries", "summary": "Get one treasury ledger entries aggregate", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Current immutable aggregate version", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/TreasuryBucket" } } } ] } } } } }, "headers": { "ETag": { "required": true, "schema": { "type": "string" } } } }, "404": { "description": "Not found" } }, "security": [ { "sessionCookie": [] } ] } }, "/capital-requirements": { "get": { "operationId": "listCapitalRequirements", "summary": "List capital requirement studies", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Opaque cursor returned in the previous response metadata." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "responses": { "200": { "description": "Latest tenant-isolated aggregate versions", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/CapitalRequirementStudy" } } } ] } }, "meta": { "type": "object", "additionalProperties": false, "required": [ "count", "hasMore" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string" } } } } } } } } }, "security": [ { "sessionCookie": [] } ] }, "post": { "operationId": "createCapitalRequirements", "summary": "Create capital requirement studies", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CapitalRequirementRequest" } } } }, "responses": { "201": { "description": "Append-only aggregate created", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/CapitalRequirementStudy" } } } ] } } } } } } }, "security": [ { "sessionCookie": [] } ] } }, "/capital-requirements/{id}": { "get": { "operationId": "getCapitalRequirements", "summary": "Get one capital requirement studies aggregate", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Current immutable aggregate version", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/CapitalRequirementStudy" } } } ] } } } } }, "headers": { "ETag": { "required": true, "schema": { "type": "string" } } } }, "404": { "description": "Not found" } }, "security": [ { "sessionCookie": [] } ] } }, "/treasury-stress-tests": { "get": { "operationId": "listTreasuryStressTests", "summary": "List treasury stress studies", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Opaque cursor returned in the previous response metadata." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "responses": { "200": { "description": "Latest tenant-isolated aggregate versions", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/TreasuryStressStudy" } } } ] } }, "meta": { "type": "object", "additionalProperties": false, "required": [ "count", "hasMore" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string" } } } } } } } } }, "security": [ { "sessionCookie": [] } ] }, "post": { "operationId": "createTreasuryStressTests", "summary": "Run all seven deterministic shocks using the server-side ledger, launch unlocks, and current policy", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TreasuryStressRequest" } } } }, "responses": { "201": { "description": "Immutable seven-shock stress suite with policy-valid mitigations only", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/TreasuryStressStudy" } } } ] } } } } } }, "409": { "description": "Required reconciled server evidence unavailable" } }, "security": [ { "sessionCookie": [] } ] } }, "/treasury-stress-tests/{id}": { "get": { "operationId": "getTreasuryStressTests", "summary": "Get one treasury stress studies aggregate", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Current immutable aggregate version", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/TreasuryStressStudy" } } } ] } } } } }, "headers": { "ETag": { "required": true, "schema": { "type": "string" } } } }, "404": { "description": "Not found" } }, "security": [ { "sessionCookie": [] } ] } }, "/venues": { "get": { "operationId": "listVenues", "summary": "List venue profiles", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Opaque cursor returned in the previous response metadata." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "responses": { "200": { "description": "Latest tenant-isolated aggregate versions", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/VenueProfile" } } } ] } }, "meta": { "type": "object", "additionalProperties": false, "required": [ "count", "hasMore" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string" } } } } } } } } }, "security": [ { "sessionCookie": [] } ] }, "post": { "operationId": "createVenues", "summary": "Create venue profiles", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "payload", "reason" ], "properties": { "payload": { "$ref": "#/components/schemas/VenueProfile" }, "status": { "$ref": "#/components/schemas/OperatingSystemRecordStatus" }, "evidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "maxItems": 256 }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Append-only aggregate created", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/VenueProfile" } } } ] } } } } } } }, "security": [ { "sessionCookie": [] } ] } }, "/venues/{id}": { "get": { "operationId": "getVenues", "summary": "Get one venue profiles aggregate", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Current immutable aggregate version", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/VenueProfile" } } } ] } } } } }, "headers": { "ETag": { "required": true, "schema": { "type": "string" } } } }, "404": { "description": "Not found" } }, "security": [ { "sessionCookie": [] } ] }, "patch": { "operationId": "supersedeVenues", "summary": "Supersede validation-only read-profile metadata; write adapters require a separate signed release", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "reason" ], "properties": { "payload": { "$ref": "#/components/schemas/VenueProfile" }, "status": { "type": "string", "enum": [ "DRAFT", "VALIDATED", "PAUSED", "REVOKED" ] }, "evidenceHashes": { "type": "array", "maxItems": 256, "items": { "$ref": "#/components/schemas/Hash" } }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "200": { "description": "Append-only bounded supersession accepted with deterministic evidence", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/VenueProfile" } } } ] } } } } } }, "400": { "description": "Payload or safety transition is outside this bounded operation" }, "409": { "description": "Typed authority workflow is required" }, "412": { "description": "Strong precondition failed" } }, "security": [ { "sessionCookie": [] } ] } }, "/venue-observations": { "get": { "operationId": "listVenueObservations", "summary": "List venue observations", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Opaque cursor returned in the previous response metadata." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "responses": { "200": { "description": "Latest tenant-isolated aggregate versions", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/VenueObservation" } } } ] } }, "meta": { "type": "object", "additionalProperties": false, "required": [ "count", "hasMore" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string" } } } } } } } } }, "security": [ { "sessionCookie": [] } ] } }, "/venue-observations/{id}": { "get": { "operationId": "getVenueObservations", "summary": "Get one venue observations aggregate", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Current immutable aggregate version", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/VenueObservation" } } } ] } } } } }, "headers": { "ETag": { "required": true, "schema": { "type": "string" } } } }, "404": { "description": "Not found" } }, "security": [ { "sessionCookie": [] } ] } }, "/allocation-plans": { "get": { "operationId": "listAllocationPlans", "summary": "List multi-venue allocation plans", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Opaque cursor returned in the previous response metadata." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "responses": { "200": { "description": "Latest tenant-isolated aggregate versions", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/AllocationPlan" } } } ] } }, "meta": { "type": "object", "additionalProperties": false, "required": [ "count", "hasMore" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string" } } } } } } } } }, "security": [ { "sessionCookie": [] } ] }, "post": { "operationId": "createAllocationPlans", "summary": "Create multi-venue allocation plans", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AllocationRequest" } } } }, "responses": { "201": { "description": "Append-only aggregate created", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/AllocationPlan" } } } ] } } } } } } }, "security": [ { "sessionCookie": [] } ] } }, "/allocation-plans/{id}": { "get": { "operationId": "getAllocationPlans", "summary": "Get one multi-venue allocation plans aggregate", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Current immutable aggregate version", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/AllocationPlan" } } } ] } } } } }, "headers": { "ETag": { "required": true, "schema": { "type": "string" } } } }, "404": { "description": "Not found" } }, "security": [ { "sessionCookie": [] } ] } }, "/migration-plans": { "get": { "operationId": "listMigrationPlans", "summary": "List liquidity migration plans", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Opaque cursor returned in the previous response metadata." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "responses": { "200": { "description": "Latest tenant-isolated aggregate versions", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/MigrationPlan" } } } ] } }, "meta": { "type": "object", "additionalProperties": false, "required": [ "count", "hasMore" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string" } } } } } } } } }, "security": [ { "sessionCookie": [] } ] }, "post": { "operationId": "createMigrationPlans", "summary": "Create liquidity migration plans", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MigrationRequest" } } } }, "responses": { "201": { "description": "Append-only aggregate created", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/MigrationPlan" } } } ] } } } } } } }, "security": [ { "sessionCookie": [] } ] } }, "/migration-plans/{id}": { "get": { "operationId": "getMigrationPlans", "summary": "Get one liquidity migration plans aggregate", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Current immutable aggregate version", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/MigrationPlan" } } } ] } } } } }, "headers": { "ETag": { "required": true, "schema": { "type": "string" } } } }, "404": { "description": "Not found" } }, "security": [ { "sessionCookie": [] } ] } }, "/autonomy-policies": { "get": { "operationId": "listAutonomyPolicies", "summary": "List autonomy policies", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Opaque cursor returned in the previous response metadata." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "responses": { "200": { "description": "Latest tenant-isolated aggregate versions", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/AutonomyPolicy" } } } ] } }, "meta": { "type": "object", "additionalProperties": false, "required": [ "count", "hasMore" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string" } } } } } } } } }, "security": [ { "sessionCookie": [] } ] }, "post": { "operationId": "createAutonomyPolicies", "summary": "Create or expand autonomy using server-reconciled exact v2 Safe-envelope evidence", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": false, "schema": { "type": "string", "pattern": "^\"[^\"\\\\\r\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "payload", "reason" ], "properties": { "payload": { "$ref": "#/components/schemas/AutonomyPolicyInput" }, "status": { "$ref": "#/components/schemas/OperatingSystemRecordStatus" }, "evidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "maxItems": 256 }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Policy admitted with server-derived approval time and Safe transaction hash where authority expands", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "oneOf": [ { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/AutonomyPolicy" } } } ] }, { "type": "object", "additionalProperties": false, "required": [ "policy", "safeAuthorityEvidence" ], "properties": { "policy": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/AutonomyPolicy" } } } ] }, "safeAuthorityEvidence": { "$ref": "#/components/schemas/OperatingSystemEvent" } } } ] } } } } } }, "400": { "description": "Caller supplied derived Safe proof fields or policy validation failed" }, "401": { "description": "Authority expansion requires recent interactive reauthentication" }, "409": { "description": "Signed release or exact finalized/reconciled v2 Safe envelope is unavailable" } }, "security": [ { "sessionCookie": [] } ], "x-klineo-if-match-required-when": "A current policy already exists for payload.vaultId." } }, "/autonomy-policies/{id}": { "get": { "operationId": "getAutonomyPolicies", "summary": "Get one autonomy policies aggregate", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Current immutable aggregate version", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/AutonomyPolicy" } } } ] } } } } }, "headers": { "ETag": { "required": true, "schema": { "type": "string" } } } }, "404": { "description": "Not found" } }, "security": [ { "sessionCookie": [] } ] }, "patch": { "operationId": "supersedeAutonomyPolicies", "summary": "Immediately pause, revoke, or narrow policy authority; expansion uses the typed Safe workflow", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "reason" ], "properties": { "payload": { "$ref": "#/components/schemas/AutonomyPolicy" }, "status": { "type": "string", "enum": [ "ACTIVE", "PAUSED", "REVOKED" ] }, "evidenceHashes": { "type": "array", "maxItems": 256, "items": { "$ref": "#/components/schemas/Hash" } }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "200": { "description": "Append-only bounded supersession accepted with deterministic evidence", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/AutonomyPolicy" } } } ] } } } } } }, "400": { "description": "Payload or safety transition is outside this bounded operation" }, "409": { "description": "Typed authority workflow is required" }, "412": { "description": "Strong precondition failed" } }, "security": [ { "sessionCookie": [] } ] } }, "/policy-intent-drafts": { "get": { "operationId": "listPolicyIntentDrafts", "summary": "List natural-language policy drafts", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Opaque cursor returned in the previous response metadata." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "responses": { "200": { "description": "Latest tenant-isolated aggregate versions", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/PolicyIntentDraft" } } } ] } }, "meta": { "type": "object", "additionalProperties": false, "required": [ "count", "hasMore" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string" } } } } } } } } }, "security": [ { "sessionCookie": [] } ] }, "post": { "operationId": "createPolicyIntentDrafts", "summary": "Create natural-language policy drafts", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PolicyExtractRequest" } } } }, "responses": { "201": { "description": "Append-only aggregate created", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/PolicyDraftResult" } } } } } } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "policies:compile" ] } ], "x-klineo-required-service-scope": "policies:compile" } }, "/policy-intent-drafts/{id}": { "get": { "operationId": "getPolicyIntentDrafts", "summary": "Get one natural-language policy drafts aggregate", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Current immutable aggregate version", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/PolicyIntentDraft" } } } ] } } } } }, "headers": { "ETag": { "required": true, "schema": { "type": "string" } } } }, "404": { "description": "Not found" } }, "security": [ { "sessionCookie": [] } ] } }, "/quote-sets": { "get": { "operationId": "listQuoteSets", "summary": "List protected execution quote sets", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Opaque cursor returned in the previous response metadata." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "responses": { "200": { "description": "Latest tenant-isolated aggregate versions", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/ProtectedExecutionQuoteSet" } } } ] } }, "meta": { "type": "object", "additionalProperties": false, "required": [ "count", "hasMore" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string" } } } } } } } } }, "security": [ { "sessionCookie": [] } ] }, "post": { "operationId": "admitProtectedExecutionQuoteSet", "summary": "Append signed provider quotes to an immutable policy-bound quote request", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^\"[^\"\\\\\r\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "quoteRequestId", "quotes", "unavailableReasons", "reason" ], "properties": { "quoteRequestId": { "type": "string" }, "quotes": { "type": "array", "maxItems": 64, "items": { "$ref": "#/components/schemas/ProtectedExecutionQuote" } }, "unavailableReasons": { "type": "array", "maxItems": 64, "items": { "type": "string" } }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Current provider generations and quote signatures verified", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/ProtectedExecutionQuoteSet" } } } ] } } } } } }, "412": { "description": "Quote request changed" } }, "security": [ { "sessionCookie": [] } ] } }, "/quote-sets/{id}": { "get": { "operationId": "getQuoteSets", "summary": "Get one protected execution quote sets aggregate", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Current immutable aggregate version", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/ProtectedExecutionQuoteSet" } } } ] } } } } }, "headers": { "ETag": { "required": true, "schema": { "type": "string" } } } }, "404": { "description": "Not found" } }, "security": [ { "sessionCookie": [] } ] } }, "/protected-execution-plans": { "get": { "operationId": "listProtectedExecutionPlans", "summary": "List protected execution plans", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Opaque cursor returned in the previous response metadata." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "responses": { "200": { "description": "Latest tenant-isolated aggregate versions", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/ProtectedExecutionPlan" } } } ] } }, "meta": { "type": "object", "additionalProperties": false, "required": [ "count", "hasMore" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string" } } } } } } } } }, "security": [ { "sessionCookie": [] } ] }, "post": { "operationId": "prepareProtectedExecutionPlan", "summary": "Prepare typed child legs under the quote request current immutable policy binding", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "quoteSetId", "childLegCount", "reason" ], "properties": { "quoteSetId": { "type": "string", "minLength": 3, "maxLength": 160 }, "childLegCount": { "type": "integer", "minimum": 1, "maximum": 32 }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Non-broadcast typed plan, or explicit PAUSED state when protected liquidity is unavailable", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": false, "required": [ "id", "organizationId", "recordType", "version", "status", "payload", "artifactHash", "evidenceHashes", "createdBy", "reason", "requestId", "createdAt", "updatedAt", "resourceVersion", "stateHash", "publicMempoolFallbackDerivedFromPolicy", "executionBroadcast" ], "properties": { "id": { "type": "string" }, "organizationId": { "type": "string" }, "recordType": { "$ref": "#/components/schemas/OperatingSystemRecordType" }, "version": { "type": "integer", "minimum": 1 }, "status": { "$ref": "#/components/schemas/OperatingSystemRecordStatus" }, "payload": { "$ref": "#/components/schemas/ProtectedExecutionPlan" }, "artifactHash": { "$ref": "#/components/schemas/Hash" }, "evidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" } }, "createdBy": { "type": "string" }, "reason": { "type": "string" }, "requestId": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "supersedesVersion": { "type": "integer", "minimum": 1 }, "resourceVersion": { "$ref": "#/components/schemas/Hash" }, "stateHash": { "$ref": "#/components/schemas/Hash" }, "publicMempoolFallbackDerivedFromPolicy": { "const": true }, "executionBroadcast": { "const": false } } } } } } } } }, "security": [ { "sessionCookie": [] } ] } }, "/protected-execution-plans/{id}": { "get": { "operationId": "getProtectedExecutionPlans", "summary": "Get one protected execution plans aggregate", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Current immutable aggregate version", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/ProtectedExecutionPlan" } } } ] } } } } }, "headers": { "ETag": { "required": true, "schema": { "type": "string" } } } }, "404": { "description": "Not found" } }, "security": [ { "sessionCookie": [] } ] } }, "/developer-credentials": { "get": { "operationId": "listDeveloperCredentials", "summary": "List developer credentials", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Opaque cursor returned in the previous response metadata." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "responses": { "200": { "description": "Latest tenant-isolated aggregate versions", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/DeveloperCredential" } } } ] } }, "meta": { "type": "object", "additionalProperties": false, "required": [ "count", "hasMore" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string" } } } } } } } } }, "security": [ { "sessionCookie": [] } ] }, "post": { "operationId": "createDeveloperCredentials", "summary": "Create a hashed developer credential and return its secret once", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperCredentialRequest" } } } }, "responses": { "201": { "description": "Secret returned once; durable idempotency state contains only resource metadata", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": false, "required": [ "credential", "secret", "secretReturnedOnce" ], "properties": { "credential": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/DeveloperCredential" } } } ] }, "secret": { "type": "string" }, "secretReturnedOnce": { "const": true } } } } } } } }, "409": { "description": "Identical retry cannot replay the already-returned secret" } }, "security": [ { "sessionCookie": [] } ] } }, "/developer-credentials/{id}": { "get": { "operationId": "getDeveloperCredentials", "summary": "Get one developer credentials aggregate", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Current immutable aggregate version", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/DeveloperCredential" } } } ] } } } } }, "headers": { "ETag": { "required": true, "schema": { "type": "string" } } } }, "404": { "description": "Not found" } }, "security": [ { "sessionCookie": [] } ] }, "patch": { "operationId": "supersedeDeveloperCredentials", "summary": "Immediately revoke a developer credential", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "reason" ], "properties": { "status": { "type": "string", "enum": [ "REVOKED" ] }, "evidenceHashes": { "type": "array", "maxItems": 256, "items": { "$ref": "#/components/schemas/Hash" } }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "200": { "description": "Append-only bounded supersession accepted with deterministic evidence", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/DeveloperCredential" } } } ] } } } } } }, "400": { "description": "Payload or safety transition is outside this bounded operation" }, "409": { "description": "Typed authority workflow is required" }, "412": { "description": "Strong precondition failed" } }, "security": [ { "sessionCookie": [] } ] } }, "/webhooks": { "get": { "operationId": "listWebhooks", "summary": "List webhook subscriptions", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Opaque cursor returned in the previous response metadata." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "responses": { "200": { "description": "Latest tenant-isolated aggregate versions", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/WebhookSubscription" } } } ] } }, "meta": { "type": "object", "additionalProperties": false, "required": [ "count", "hasMore" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string" } } } } } } } } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "webhooks:manage" ] } ], "x-klineo-required-service-scope": "webhooks:manage" }, "post": { "operationId": "createWebhooks", "summary": "Create a signed webhook and return its signing secret once", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookRequest" } } } }, "responses": { "201": { "description": "Signing secret returned once; durable idempotency state contains only resource metadata", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": false, "required": [ "subscription", "signingSecret", "signatureInput", "secretReturnedOnce" ], "properties": { "subscription": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/WebhookSubscription" } } } ] }, "signingSecret": { "type": "string" }, "signatureInput": { "const": "timestamp.deliveryId.body" }, "secretReturnedOnce": { "const": true } } } } } } } }, "409": { "description": "Identical retry cannot replay the already-returned signing secret" } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "webhooks:manage" ] } ], "x-klineo-required-service-scope": "webhooks:manage" } }, "/webhooks/{id}": { "get": { "operationId": "getWebhooks", "summary": "Get one webhook subscriptions aggregate", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Current immutable aggregate version", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/WebhookSubscription" } } } ] } } } } }, "headers": { "ETag": { "required": true, "schema": { "type": "string" } } } }, "404": { "description": "Not found" } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "webhooks:manage" ] } ], "x-klineo-required-service-scope": "webhooks:manage" }, "patch": { "operationId": "supersedeWebhooks", "summary": "Immediately pause or revoke a webhook subscription", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "reason" ], "properties": { "status": { "type": "string", "enum": [ "PAUSED", "REVOKED" ] }, "evidenceHashes": { "type": "array", "maxItems": 256, "items": { "$ref": "#/components/schemas/Hash" } }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "200": { "description": "Append-only bounded supersession accepted with deterministic evidence", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/WebhookSubscription" } } } ] } } } } } }, "400": { "description": "Payload or safety transition is outside this bounded operation" }, "409": { "description": "Typed authority workflow is required" }, "412": { "description": "Strong precondition failed" } }, "security": [ { "sessionCookie": [] } ] } }, "/strategy-packages": { "get": { "operationId": "listStrategyPackages", "summary": "List curated strategy packages", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Opaque cursor returned in the previous response metadata." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "responses": { "200": { "description": "Latest tenant-isolated aggregate versions", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/StrategyPackage" } } } ] } }, "meta": { "type": "object", "additionalProperties": false, "required": [ "count", "hasMore" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string" } } } } } } } } }, "security": [ { "sessionCookie": [] } ] }, "post": { "operationId": "createStrategyPackageCandidate", "summary": "Create an immutable declarative candidate restricted to Digital Twin use", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "payload", "reason" ], "properties": { "payload": { "$ref": "#/components/schemas/StrategyPackageCandidate" }, "evidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "maxItems": 256 }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Candidate with server-derived package content hash and no network, signing, or activation surface", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/StrategyPackage" } } } ] } } } } } } }, "security": [ { "sessionCookie": [] } ] } }, "/strategy-packages/{id}": { "get": { "operationId": "getStrategyPackages", "summary": "Get one curated strategy packages aggregate", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Current immutable aggregate version", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/StrategyPackage" } } } ] } } } } }, "headers": { "ETag": { "required": true, "schema": { "type": "string" } } } }, "404": { "description": "Not found" } }, "security": [ { "sessionCookie": [] } ] } }, "/partners": { "get": { "operationId": "listPartners", "summary": "List white-label partner tenants", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Opaque cursor returned in the previous response metadata." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "responses": { "200": { "description": "Latest tenant-isolated aggregate versions", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/PartnerTenant" } } } ] } }, "meta": { "type": "object", "additionalProperties": false, "required": [ "count", "hasMore" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string" } } } } } } }, "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } } }, "security": [ { "sessionCookie": [] } ] }, "post": { "operationId": "createVerifiedPartnerTenant", "summary": "Bind brand configuration to fresh signed exact-domain verifier evidence", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "payload", "reason" ], "properties": { "payload": { "$ref": "#/components/schemas/PartnerTenantCreate" }, "evidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "maxItems": 256 }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Host-unique partner configuration bound to current verifier generations", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/PartnerTenant" } } } ] } } } } }, "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "409": { "description": "Host already bound", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } } }, "security": [ { "sessionCookie": [] } ] } }, "/partners/{id}": { "get": { "operationId": "getPartners", "summary": "Get one white-label partner tenants aggregate", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Current immutable aggregate version", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/PartnerTenant" } } } ] } } } } }, "headers": { "ETag": { "required": true, "schema": { "type": "string" } }, "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "404": { "description": "Not found", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } } }, "security": [ { "sessionCookie": [] } ] }, "patch": { "operationId": "updatePartnerConfiguration", "summary": "Append an explicitly reviewed partner generation after current domain verification", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^\"[^\"\\\\\r\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "payload", "reason" ], "properties": { "payload": { "$ref": "#/components/schemas/PartnerTenantCreate" }, "evidenceHashes": { "type": "array", "maxItems": 256, "items": { "$ref": "#/components/schemas/Hash" } }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "200": { "description": "Append-only active configuration generation; existing issuer consent requires regrant", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/PartnerTenant" } } } ] } } } } }, "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "409": { "description": "Domain already bound or configuration lifecycle conflict", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "412": { "description": "Selected partner configuration changed", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } } }, "security": [ { "sessionCookie": [] } ] } }, "/market-maker-mandates": { "get": { "operationId": "listMarketMakerMandates", "summary": "List market-maker mandates", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Opaque cursor returned in the previous response metadata." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "responses": { "200": { "description": "Latest tenant-isolated aggregate versions", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/MarketMakerMandate" } } } ] } }, "meta": { "type": "object", "additionalProperties": false, "required": [ "count", "hasMore" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string" } } } } } } } } }, "security": [ { "sessionCookie": [] } ] }, "post": { "operationId": "createMarketMakerMandate", "summary": "Create a monitoring-only market-maker mandate with an AMM comparison benchmark", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "payload", "reason" ], "properties": { "payload": { "$ref": "#/components/schemas/MarketMakerMandate" }, "status": { "$ref": "#/components/schemas/OperatingSystemRecordStatus" }, "evidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "maxItems": 256 }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Mandate and deterministic monitoring-only comparison", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": false, "required": [ "mandate", "oversight" ], "properties": { "mandate": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/MarketMakerMandate" } } } ] }, "oversight": { "$ref": "#/components/schemas/MarketMakerOversight" } } } } } } } } }, "security": [ { "sessionCookie": [] } ] } }, "/market-maker-mandates/{id}": { "get": { "operationId": "getMarketMakerMandates", "summary": "Get one market-maker mandates aggregate", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Current immutable aggregate version", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/MarketMakerMandate" } } } ] } } } } }, "headers": { "ETag": { "required": true, "schema": { "type": "string" } } } }, "404": { "description": "Not found" } }, "security": [ { "sessionCookie": [] } ] }, "patch": { "operationId": "supersedeMarketMakerMandates", "summary": "Pause or revoke a mandate without replacing signed economics", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "reason" ], "properties": { "status": { "type": "string", "enum": [ "PAUSED", "REVOKED" ] }, "evidenceHashes": { "type": "array", "maxItems": 256, "items": { "$ref": "#/components/schemas/Hash" } }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "200": { "description": "Append-only bounded supersession accepted with deterministic evidence", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/MarketMakerMandate" } } } ] } } } } } }, "400": { "description": "Payload or safety transition is outside this bounded operation" }, "409": { "description": "Typed authority workflow is required" }, "412": { "description": "Strong precondition failed" } }, "security": [ { "sessionCookie": [] } ] } }, "/incentive-programs": { "get": { "operationId": "listIncentivePrograms", "summary": "List incentive programs", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Opaque cursor returned in the previous response metadata." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "responses": { "200": { "description": "Latest tenant-isolated aggregate versions", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/IncentiveProgram" } } } ] } }, "meta": { "type": "object", "additionalProperties": false, "required": [ "count", "hasMore" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string" } } } } } } } } }, "security": [ { "sessionCookie": [] } ] }, "post": { "operationId": "optimizeIncentiveProgram", "summary": "Measure an incentive program against frozen baseline evidence and prepare a non-executing review workflow", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "payload", "reason" ], "properties": { "payload": { "$ref": "#/components/schemas/IncentiveProgram" }, "status": { "$ref": "#/components/schemas/OperatingSystemRecordStatus" }, "evidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "maxItems": 256 }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Optimization plus operational-proposal or gated typed-adapter review evidence; no execution occurs", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/IncentiveOptimizationResult" } } } } } }, "400": { "description": "Baseline, confidence, or adapter evidence failed closed" } }, "security": [ { "sessionCookie": [] } ] } }, "/incentive-programs/{id}": { "get": { "operationId": "getIncentivePrograms", "summary": "Get one incentive programs aggregate", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Current immutable aggregate version", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/IncentiveProgram" } } } ] } } } } }, "headers": { "ETag": { "required": true, "schema": { "type": "string" } } } }, "404": { "description": "Not found" } }, "security": [ { "sessionCookie": [] } ] }, "patch": { "operationId": "supersedeIncentivePrograms", "summary": "Revoke an incentive-program result without replacing its evidence", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "reason" ], "properties": { "status": { "type": "string", "enum": [ "REVOKED" ] }, "evidenceHashes": { "type": "array", "maxItems": 256, "items": { "$ref": "#/components/schemas/Hash" } }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "200": { "description": "Append-only bounded supersession accepted with deterministic evidence", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/IncentiveProgram" } } } ] } } } } } }, "400": { "description": "Payload or safety transition is outside this bounded operation" }, "409": { "description": "Typed authority workflow is required" }, "412": { "description": "Strong precondition failed" } }, "security": [ { "sessionCookie": [] } ] } }, "/passports": { "get": { "operationId": "listPassports", "summary": "List liquidity passports", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Opaque cursor returned in the previous response metadata." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "responses": { "200": { "description": "Latest tenant-isolated aggregate versions", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/LiquidityPassport" } } } ] } }, "meta": { "type": "object", "additionalProperties": false, "required": [ "count", "hasMore" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string" } } } } } } } } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "proof:read" ] } ], "x-klineo-required-service-scope": "proof:read" }, "post": { "operationId": "publishLiquidityPassport", "summary": "Publish issuer-signed claims recomputed from exact current server evidence", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": false, "schema": { "type": "string", "pattern": "^\"[^\"\\\\\r\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "payload", "reason" ], "properties": { "payload": { "type": "object", "additionalProperties": false, "required": [ "passportVersion", "artifactRendererVersion", "signatureAlgorithm", "signerProviderId", "signerKeyResourceVersion", "slug", "vaultId", "issuerName", "generatedAt", "validUntil", "usableDepthByTradeSize", "historicalReliabilityPips", "policyCompliancePips", "reconciledPositionCount", "majorIncidentCount", "dataFreshnessSeconds", "disclosure", "reportHashes", "sourceBindings", "contentHash", "signature", "marketQualityScoreId" ], "properties": { "passportVersion": { "const": "liquidity-passport-v1" }, "artifactRendererVersion": { "type": "string", "enum": [ "liquidity-passport-artifacts-v1", "liquidity-passport-artifacts-v2" ] }, "signatureAlgorithm": { "const": "Ed25519" }, "signerProviderId": { "type": "string" }, "signerKeyResourceVersion": { "$ref": "#/components/schemas/Hash" }, "slug": { "type": "string" }, "vaultId": { "type": "string" }, "issuerName": { "type": "string" }, "reportBrand": { "type": "object", "additionalProperties": false, "required": [ "partnerId", "name", "accentColor", "sourceBinding" ], "properties": { "partnerId": { "type": "string" }, "name": { "type": "string" }, "accentColor": { "type": "string", "pattern": "^#[0-9a-fA-F]{6}$" }, "logoContentHash": { "$ref": "#/components/schemas/Hash" }, "sourceBinding": { "type": "object", "additionalProperties": false, "required": [ "partnerOrganizationId", "partnerConfigurationResourceVersion", "partnerConfigurationArtifactHash", "consentId", "consentResourceVersion", "consentArtifactHash" ], "properties": { "partnerOrganizationId": { "type": "string" }, "partnerConfigurationResourceVersion": { "$ref": "#/components/schemas/Hash" }, "partnerConfigurationArtifactHash": { "$ref": "#/components/schemas/Hash" }, "consentId": { "type": "string" }, "consentResourceVersion": { "$ref": "#/components/schemas/Hash" }, "consentArtifactHash": { "$ref": "#/components/schemas/Hash" } } } } }, "generatedAt": { "type": "string", "format": "date-time" }, "validUntil": { "type": "string", "format": "date-time" }, "usableDepthByTradeSize": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "tradeSizeQuote", "buySlippagePips", "sellSlippagePips" ], "properties": { "tradeSizeQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "buySlippagePips": { "$ref": "#/components/schemas/Pips" }, "sellSlippagePips": { "$ref": "#/components/schemas/Pips" } } }, "minItems": 1 }, "historicalReliabilityPips": { "$ref": "#/components/schemas/Pips" }, "policyCompliancePips": { "anyOf": [ { "$ref": "#/components/schemas/Pips" }, { "type": "null" } ] }, "policyLimits": { "type": "object", "additionalProperties": false, "required": [ "level", "maximumAmountPerTransaction", "maximumDailyTurnover", "maximumSlippagePips", "approvedContracts", "approvedAssets", "approvedAdapterIds", "minimumSecondsBetweenActions", "oracleMaximumAgeSeconds", "expiresAt", "controlEpoch", "publicMempoolFallbackAllowed" ], "properties": { "level": { "type": "integer", "enum": [ 0, 1, 2, 3, 4 ] }, "maximumAmountPerTransaction": { "$ref": "#/components/schemas/AtomicAmount" }, "maximumDailyTurnover": { "$ref": "#/components/schemas/AtomicAmount" }, "maximumSlippagePips": { "$ref": "#/components/schemas/Pips" }, "approvedContracts": { "type": "array", "items": { "$ref": "#/components/schemas/Address" }, "maxItems": 256 }, "approvedAssets": { "type": "array", "items": { "$ref": "#/components/schemas/Address" }, "maxItems": 256 }, "approvedAdapterIds": { "type": "array", "items": { "type": "string" }, "maxItems": 256 }, "minimumSecondsBetweenActions": { "type": "integer", "minimum": 0, "maximum": 31536000 }, "minimumPriceX18": { "$ref": "#/components/schemas/AtomicAmount" }, "maximumPriceX18": { "$ref": "#/components/schemas/AtomicAmount" }, "oracleMaximumAgeSeconds": { "type": "integer", "minimum": 1, "maximum": 86400 }, "expiresAt": { "type": "string", "format": "date-time" }, "controlEpoch": { "$ref": "#/components/schemas/AtomicAmount" }, "publicMempoolFallbackAllowed": { "type": "boolean" } } }, "reconciledPositionCount": { "type": "integer", "minimum": 0 }, "majorIncidentCount": { "type": "integer", "minimum": 0 }, "treasuryOwnedLiquidityQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "rentedLiquidityQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "incidentDetails": { "type": "object", "additionalProperties": false, "required": [ "v1IncidentEvidenceHashes", "anomalies" ], "properties": { "v1IncidentEvidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "maxItems": 256 }, "anomalies": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "detectorVersion", "kind", "severity", "artifactHash" ], "properties": { "detectorVersion": { "const": "robust-mad-v1" }, "kind": { "type": "string", "enum": [ "LIQUIDITY_DISAPPEARANCE", "ONE_SIDED_FLOW", "INACTIVE_RANGE", "STABLECOIN_DEPEG", "ORACLE_DISAGREEMENT", "INVENTORY_ACCUMULATION", "EXCESSIVE_TURNOVER", "MANIPULATION_INDICATOR", "SIMULATED_REALIZED_DIVERGENCE" ] }, "severity": { "type": "string", "enum": [ "INFO", "WARNING", "CRITICAL" ] }, "artifactHash": { "$ref": "#/components/schemas/Hash" } } }, "maxItems": 256 } } }, "externalManagerExposureQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "externalManagerNames": { "type": "array", "items": { "type": "string" } }, "dataFreshnessSeconds": { "type": "integer", "minimum": 0 }, "disclosure": { "type": "object", "additionalProperties": false, "required": [ "showTreasuryOwnership", "showExternalManagerNames", "showIncidentDetails", "showPolicyLimits" ], "properties": { "showTreasuryOwnership": { "type": "boolean" }, "showExternalManagerNames": { "type": "boolean" }, "showIncidentDetails": { "type": "boolean" }, "showPolicyLimits": { "type": "boolean" } } }, "reportHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "minItems": 1, "maxItems": 128 }, "sourceBindings": { "$ref": "#/components/schemas/LiquidityPassportSourceBindings" }, "resultsRegistryProviderId": { "type": "string" }, "resultsRegistryProviderResourceVersion": { "$ref": "#/components/schemas/Hash" }, "resultsRegistryProviderAttestationHash": { "$ref": "#/components/schemas/Hash" }, "resultsRegistryCommitmentHash": { "$ref": "#/components/schemas/Hash" }, "resultsRegistryReceipt": { "type": "object", "additionalProperties": false, "required": [ "receiptVersion", "providerId", "providerResourceVersion", "providerAttestationHash", "passportSubjectHash", "commitmentHash", "issuedAt", "signature" ], "properties": { "receiptVersion": { "const": "liquidity-passport-results-registry-receipt-v1" }, "providerId": { "type": "string" }, "providerResourceVersion": { "$ref": "#/components/schemas/Hash" }, "providerAttestationHash": { "$ref": "#/components/schemas/Hash" }, "passportSubjectHash": { "$ref": "#/components/schemas/Hash" }, "commitmentHash": { "$ref": "#/components/schemas/Hash" }, "issuedAt": { "type": "string", "format": "date-time" }, "signature": { "type": "string", "contentEncoding": "base64" } } }, "supersedesPassportHash": { "$ref": "#/components/schemas/Hash" }, "contentHash": { "$ref": "#/components/schemas/Hash" }, "signature": { "type": "string", "contentEncoding": "base64" }, "marketQualityScoreId": { "type": "string", "minLength": 3, "maxLength": 160 } } }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Source-grounded canonical passport and immutable report job", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": false, "required": [ "passport", "reportJob", "signedFormatsReady", "artifactState", "executionAuthorityGranted" ], "properties": { "passport": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/LiquidityPassport" } } } ] }, "reportJob": { "$ref": "#/components/schemas/OperatingSystemJob" }, "signedFormatsReady": { "type": "array", "items": { "type": "string", "enum": [ "JSON", "HTML", "PDF", "CSV" ] } }, "artifactState": { "const": "PENDING_IMMUTABLE_OBJECT_REGISTRATION" }, "executionAuthorityGranted": { "const": false } } } } } } } }, "409": { "description": "A numeric claim, freshness window, provider generation, or source binding differs" }, "412": { "description": "Superseded passport generation changed" } }, "security": [ { "sessionCookie": [] } ], "x-klineo-if-match-required-when": "A passport already exists for payload.slug." } }, "/passports/{id}": { "get": { "operationId": "getPassports", "summary": "Get one liquidity passports aggregate", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Current immutable aggregate version", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/LiquidityPassport" } } } ] } } } } }, "headers": { "ETag": { "required": true, "schema": { "type": "string" } } } }, "404": { "description": "Not found" } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "proof:read" ] } ], "x-klineo-required-service-scope": "proof:read" } }, "/openapi.json": { "get": { "operationId": "getOperatingSystemOpenApi", "summary": "Download the checked-in v2 OpenAPI contract", "responses": { "200": { "description": "OpenAPI 3.1 contract", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OpenApiDocument" } } } } } } }, "/status": { "get": { "operationId": "getOperatingSystemStatus", "summary": "Read fail-closed v2 service readiness", "responses": { "200": { "description": "Service and adapter readiness", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/OperatingSystemStatus" } } } } } }, "503": { "description": "PostgreSQL or v1 dependency unavailable" } } } }, "/oauth/token": { "post": { "operationId": "issueOperatingSystemOAuthToken", "summary": "Exchange OAuth client credentials for a scoped one-hour token", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "security": [ { "clientBasic": [] } ], "requestBody": { "required": true, "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "additionalProperties": false, "required": [ "grant_type" ], "properties": { "grant_type": { "const": "client_credentials" }, "scope": { "type": "string" } } } } } }, "responses": { "200": { "description": "Scoped bearer token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthTokenResponse" } } } }, "401": { "description": "Invalid or inactive OAuth client" } } } }, "/scores/{id}/activate": { "post": { "operationId": "activateMarketQualityScore", "summary": "Issuer-review and activate an available immutable analyst score draft", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^\"[^\"\\\\\r\n]+\"$" } } ], "responses": { "200": { "description": "Activated score and immutable issuer publication-review event", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": false, "required": [ "score", "review", "executionAuthorityGranted" ], "properties": { "score": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/MarketQualityScore" } } } ] }, "review": { "$ref": "#/components/schemas/OperatingSystemEvent" }, "executionAuthorityGranted": { "const": false } } } } } } } }, "409": { "description": "Score is unavailable or is not a current draft" }, "412": { "description": "Strong precondition failed" } }, "security": [ { "sessionCookie": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarketQualityScoreActivationRequest" } } } } } }, "/quote-requests": { "post": { "operationId": "createProtectedExecutionQuoteRequest", "summary": "Create a server-derived quote request bound to the current immutable AutonomyPolicy generation", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "vaultId", "chainId", "assetIn", "assetOut", "settlementContract", "settlementAdapterId", "amountIn", "maximumSlippagePips", "expiresAt", "providerIds", "reason" ], "properties": { "vaultId": { "type": "string" }, "chainId": { "type": "integer", "minimum": 1 }, "assetIn": { "$ref": "#/components/schemas/Address" }, "assetOut": { "$ref": "#/components/schemas/Address" }, "settlementContract": { "$ref": "#/components/schemas/Address" }, "settlementAdapterId": { "type": "string" }, "amountIn": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "maximumSlippagePips": { "$ref": "#/components/schemas/Pips" }, "expiresAt": { "type": "string", "format": "date-time" }, "providerIds": { "type": "array", "minItems": 1, "maxItems": 64, "items": { "type": "string" } }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Immutable draft request; public fallback is derived server-side", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": false, "required": [ "id", "organizationId", "recordType", "version", "status", "payload", "artifactHash", "evidenceHashes", "createdBy", "reason", "requestId", "createdAt", "updatedAt", "resourceVersion", "publicMempoolFallbackDerivedFromPolicy", "executable" ], "properties": { "id": { "type": "string" }, "organizationId": { "type": "string" }, "recordType": { "$ref": "#/components/schemas/OperatingSystemRecordType" }, "version": { "type": "integer", "minimum": 1 }, "status": { "$ref": "#/components/schemas/OperatingSystemRecordStatus" }, "payload": { "$ref": "#/components/schemas/ProtectedExecutionQuoteRequest" }, "artifactHash": { "$ref": "#/components/schemas/Hash" }, "evidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" } }, "createdBy": { "type": "string" }, "reason": { "type": "string" }, "requestId": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "supersedesVersion": { "type": "integer", "minimum": 1 }, "resourceVersion": { "$ref": "#/components/schemas/Hash" }, "publicMempoolFallbackDerivedFromPolicy": { "const": true }, "executable": { "const": false } } } } } } } } }, "security": [ { "sessionCookie": [] } ] } }, "/quote-requests/{id}/quotes": { "post": { "operationId": "admitProtectedExecutionQuotesForRequest", "summary": "Verify and append current-generation signed provider quotes", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^\"[^\"\\\\\r\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "quoteRequestId", "quotes", "unavailableReasons", "reason" ], "properties": { "quoteRequestId": { "type": "string" }, "quotes": { "type": "array", "maxItems": 64, "items": { "$ref": "#/components/schemas/ProtectedExecutionQuote" } }, "unavailableReasons": { "type": "array", "maxItems": 64, "items": { "type": "string" } }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Signed quote set appended", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/ProtectedExecutionQuoteSet" } } } ] } } } } } }, "412": { "description": "Quote request changed" } }, "security": [ { "sessionCookie": [] } ] } }, "/protected-execution-plans/{id}/state": { "get": { "operationId": "getProtectedExecutionPlanState", "summary": "Read materialized child-leg accounting and its deterministic state hash", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Typed append-only lifecycle state", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": false, "required": [ "plan", "stateHash" ], "properties": { "plan": { "$ref": "#/components/schemas/ProtectedExecutionPlan" }, "stateHash": { "$ref": "#/components/schemas/Hash" } } } } } } }, "headers": { "ETag": { "required": true, "schema": { "type": "string" } } } } }, "security": [ { "sessionCookie": [] } ] } }, "/protected-execution-plans/{id}/transitions": { "post": { "operationId": "appendProtectedExecutionLegTransition", "summary": "Request a server-verified typed lifecycle transition without accepting client evidence", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^\"[^\"\\\\\r\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "childLegId", "toStatus", "previousStateHash", "reason" ], "properties": { "childLegId": { "type": "string" }, "toStatus": { "type": "string", "enum": [ "SUBMITTED", "FINALIZED_RECONCILED", "PAUSED", "FAILED" ] }, "previousStateHash": { "$ref": "#/components/schemas/Hash" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Server-derived transition, immutable event, and conservation result", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": false, "required": [ "record", "transition", "stateHash", "inputConserved", "executionBroadcast" ], "properties": { "record": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/ProtectedExecutionPlan" } } } ] }, "transition": { "$ref": "#/components/schemas/OperatingSystemEvent" }, "stateHash": { "$ref": "#/components/schemas/Hash" }, "inputConserved": { "type": "boolean" }, "executionBroadcast": { "const": false } } } } } } } }, "400": { "description": "Client attempted to supply authority-bearing evidence" }, "409": { "description": "Release, Safe/action authorization, gateway, finality, or reconciliation is unavailable" }, "412": { "description": "Plan or state changed" } }, "security": [ { "sessionCookie": [] } ] } }, "/treasury-entries/{id}/refresh": { "post": { "operationId": "refreshTreasuryLedgerEntry", "summary": "Append a fresh signed observation for an existing immutable treasury container identity", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^\"[^\"\\\\\r\n]+\"$" } } ], "responses": { "200": { "description": "Refreshed active treasury-container generation", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/TreasuryBucket" } } } ] } } } } } }, "400": { "description": "Immutable identity changed or observation time regressed" }, "409": { "description": "Container is inactive or signed evidence is stale, duplicate, or unavailable" }, "412": { "description": "Strong precondition failed" } }, "security": [ { "sessionCookie": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TreasuryLedgerRefreshRequest" } } } } } }, "/treasury-entries/{id}/retire": { "post": { "operationId": "retireTreasuryLedgerEntry", "summary": "Append a revoked treasury-container generation with immutable retirement evidence", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^\"[^\"\\\\\r\n]+\"$" } } ], "responses": { "200": { "description": "Retired treasury-container generation", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/TreasuryBucket" } } } ] } } } } } }, "409": { "description": "Container is not active" }, "412": { "description": "Strong precondition failed" } }, "security": [ { "sessionCookie": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TreasuryLedgerRetirementRequest" } } } } } }, "/workspace": { "get": { "operationId": "getOperatingSystemWorkspace", "summary": "Get all release-train availability and aggregate counts", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Role-aware workspace", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/OperatingSystemWorkspace" } } } } } } }, "security": [ { "sessionCookie": [] } ] } }, "/vaults": { "get": { "operationId": "listQualifiedVaultsV2", "summary": "List tenant-isolated qualified vault metadata projected from authoritative v1 custody records", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Opaque cursor returned in the previous response metadata." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "responses": { "200": { "description": "Cursor-paginated vault projections", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/QualifiedVaultV2" } }, "meta": { "type": "object", "additionalProperties": false, "required": [ "count", "hasMore" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string" } } } } } } } } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "vaults:read" ] } ], "x-klineo-required-service-scope": "vaults:read" } }, "/vaults/{id}": { "get": { "operationId": "getQualifiedVaultV2", "summary": "Read one qualified vault and immutable deployment/control evidence", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Vault projection", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/QualifiedVaultV2" } } } } }, "headers": { "ETag": { "required": true, "schema": { "type": "string" } } } }, "404": { "description": "Not found" } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "vaults:read" ] } ], "x-klineo-required-service-scope": "vaults:read" } }, "/receipts": { "get": { "operationId": "listExecutionReceiptsV2", "summary": "List canonical inclusion, finality, reconciliation, and attribution receipts", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Opaque cursor returned in the previous response metadata." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "responses": { "200": { "description": "Cursor-paginated receipt projections", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/ExecutionReceiptV2" } }, "meta": { "type": "object", "additionalProperties": false, "required": [ "count", "hasMore" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string" } } } } } } } } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "receipts:read" ] } ], "x-klineo-required-service-scope": "receipts:read" } }, "/receipts/{id}": { "get": { "operationId": "getExecutionReceiptV2", "summary": "Read one canonical execution receipt projection", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Receipt projection", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/ExecutionReceiptV2" } } } } }, "headers": { "ETag": { "required": true, "schema": { "type": "string" } } } }, "404": { "description": "Not found or not yet included" } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "receipts:read" ] } ], "x-klineo-required-service-scope": "receipts:read" } }, "/alerts": { "get": { "operationId": "listAlertsV2", "summary": "List typed anomaly alerts with immutable evidence", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Opaque cursor returned in the previous response metadata." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "responses": { "200": { "description": "Cursor-paginated alerts", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/Anomaly" } } } ] } }, "meta": { "type": "object", "additionalProperties": false, "required": [ "count", "hasMore" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string" } } } } } } } } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "alerts:read" ] } ], "x-klineo-required-service-scope": "alerts:read" } }, "/proof": { "get": { "operationId": "listProofV2", "summary": "List signed passports and content-addressed proof artifacts", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Opaque cursor returned in the previous response metadata." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "responses": { "200": { "description": "Cursor-paginated proof resources", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/ProofResource" } }, "meta": { "type": "object", "additionalProperties": false, "required": [ "count", "hasMore" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string" } } } } } } } } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "proof:read" ] } ], "x-klineo-required-service-scope": "proof:read" } }, "/providers": { "get": { "operationId": "listOperatingSystemProviders", "summary": "List tenant-scoped signed provider registrations and health", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Provider registry", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/OperatingSystemProvider" } } } } } } } }, "security": [ { "sessionCookie": [] } ] }, "post": { "operationId": "putOperatingSystemProvider", "summary": "Register or rotate an attested provider generation", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": false, "schema": { "type": "string", "pattern": "^\"[^\"\\\\\r\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProviderRegistrationRequest" } } } }, "responses": { "201": { "description": "Provider generation registered", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/OperatingSystemProvider" } } } } } }, "412": { "description": "Existing provider generation changed" } }, "security": [ { "sessionCookie": [] } ], "x-klineo-if-match-required-when": "The providerId and capability generation already exists." } }, "/artifacts": { "get": { "operationId": "listOperatingSystemArtifacts", "summary": "List immutable object-storage lineage for reports and large evidence", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "recordType", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "recordId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Tenant-isolated content-addressed artifact lineage", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/OperatingSystemArtifact" } } } } } } } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "proof:read" ] } ], "x-klineo-required-service-scope": "proof:read" } }, "/treasury/summary": { "get": { "operationId": "getTreasurySummary", "summary": "Get reconciled treasury ledger summary", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Conserved treasury summary", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/TreasurySummary" } } } } } } }, "security": [ { "sessionCookie": [] } ] } }, "/market-map": { "get": { "operationId": "getUnifiedLiquidityMap", "summary": "Get the unified read-only/write-authority-aware venue map", "description": "Observations are included in totals only while their exact source venue-profile generation remains the current VALIDATED or ACTIVE generation; rotated, paused, or revoked lineage is returned as explicitly degraded and excluded.", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Venue map with profile-generation match state, availability, and exclusion warnings", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/UnifiedLiquidityMap" } } } } } } }, "security": [ { "sessionCookie": [] } ] } }, "/sandbox/studies": { "post": { "operationId": "runNonCustodialSandboxStudy", "summary": "Persist a deterministic non-custodial study with no execution authority", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SandboxSimulationStudyRequest" } } } }, "responses": { "201": { "description": "Sandbox study and immutable evidence", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": false, "required": [ "study", "sandbox", "custodyAuthorityGranted", "signingAuthorityGranted", "executionAuthorityGranted", "networkCodeExecuted" ], "properties": { "study": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/SimulationStudy" } } } ] }, "sandbox": { "const": true }, "custodyAuthorityGranted": { "const": false }, "signingAuthorityGranted": { "const": false }, "executionAuthorityGranted": { "const": false }, "networkCodeExecuted": { "const": false } } } } } } } } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "studies:write" ] } ], "x-klineo-required-service-scope": "studies:write" } }, "/studies/{id}/share-links": { "post": { "operationId": "createStudyShareLink", "summary": "Create a private expiring or issuer-approved public study link", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "201": { "description": "Revocable share link", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/StudyShare" } } } ] } } } } } }, "409": { "description": "Study is not completed or the permanent public slug is already claimed" } }, "security": [ { "sessionCookie": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StudyShareRequest" } } } } } }, "/study-shares/{id}/revoke": { "post": { "operationId": "revokeStudyShareLink", "summary": "Immediately revoke a private or public study share without deleting evidence", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^\"[^\"\\\\\r\n]+\"$" } } ], "responses": { "200": { "description": "Append-only revoked share version", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/StudyShare" } } } ] } } } } } }, "412": { "description": "Strong precondition failed" } }, "security": [ { "sessionCookie": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "reason" ], "properties": { "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } } } }, "/passports/{id}/revoke": { "post": { "operationId": "revokeLiquidityPassport", "summary": "Immediately revoke a published passport without deleting signed evidence", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^\"[^\"\\\\\r\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "reason" ], "properties": { "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "200": { "description": "Append-only revoked passport generation", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/LiquidityPassport" } } } ] } } } } } }, "409": { "description": "Passport is not active" }, "412": { "description": "Strong precondition failed" } }, "security": [ { "sessionCookie": [] } ] } }, "/studies/{id}/reports": { "post": { "operationId": "createSignedStudyReport", "summary": "Queue a signed JSON, PDF, and CSV report", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "202": { "description": "Fenced report job", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": false, "required": [ "job", "source" ], "properties": { "job": { "$ref": "#/components/schemas/OperatingSystemJob" }, "source": { "type": "object", "additionalProperties": false, "required": [ "id", "version", "artifactHash" ], "properties": { "id": { "type": "string", "minLength": 3, "maxLength": 160 }, "version": { "type": "integer", "minimum": 1 }, "artifactHash": { "$ref": "#/components/schemas/Hash" } } } } } } } } } } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "studies:write" ] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SignedStudyReportRequest" } } } }, "x-klineo-required-service-scope": "studies:write" } }, "/studies/{id}/report-jobs": { "get": { "operationId": "listStudyReportJobs", "summary": "List report job state and dead-letter evidence", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Report jobs", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/OperatingSystemJob" } } } } } } } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "studies:read" ] } ], "x-klineo-required-service-scope": "studies:read" } }, "/strategies/legacy-wrappers": { "post": { "operationId": "wrapLegacyStrategyDefinition", "summary": "Wrap immutable v1 Bootstrap, Maintain, or Diversify evidence in the declarative v2 schema", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "responses": { "201": { "description": "Validated compatibility definition without rewriting history", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": false, "required": [ "strategy", "compilation", "sourceArtifactHash", "proposalAuthorityGranted" ], "properties": { "strategy": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/StrategyDefinitionV2" } } } ] }, "compilation": { "$ref": "#/components/schemas/StrategyCompilation" }, "sourceArtifactHash": { "$ref": "#/components/schemas/Hash" }, "proposalAuthorityGranted": { "const": false } } } } } } } } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "strategies:validate" ] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "simulationId", "reason" ], "properties": { "simulationId": { "type": "string", "minLength": 3, "maxLength": 160 }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "x-klineo-required-service-scope": "strategies:validate" } }, "/strategies/{id}/proposal-admissions": { "post": { "operationId": "admitStrategyProposal", "summary": "Derive all eight proposal-admission checks from immutable server-side evidence", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^\"[^\"\\\\\r\n]+\"$" } } ], "responses": { "201": { "description": "Signed oracle-bound admission event", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": false, "required": [ "admission", "validation", "proposalAuthorityGranted" ], "properties": { "admission": { "$ref": "#/components/schemas/OperatingSystemEvent" }, "validation": { "$ref": "#/components/schemas/StrategyProposalAdmission" }, "proposalAuthorityGranted": { "const": false } } } } } } } }, "409": { "description": "One or more checks failed closed" } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "strategies:validate" ] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StrategyProposalAdmissionRequest" } } } }, "x-klineo-required-service-scope": "strategies:validate" } }, "/strategies/{id}/evidence": { "get": { "operationId": "getStrategyEvidence", "summary": "Read exact strategy admission events and their immutable study generations", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "resourceVersion", "in": "query", "required": true, "schema": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" } } ], "responses": { "200": { "description": "Read-only historical evidence; missing study generations remain null", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "strategy", "admissions", "executionAuthorityGranted" ], "properties": { "schemaVersion": { "const": "strategy-evidence-view-v1" }, "strategy": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/StrategyDefinitionV2" } } } ] }, "admissions": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "event", "study" ], "properties": { "event": { "$ref": "#/components/schemas/OperatingSystemEvent" }, "study": { "anyOf": [ { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/SimulationStudy" } } } ] }, { "type": "null" } ] } } } }, "executionAuthorityGranted": { "const": false } } } } } } } }, "404": { "description": "The exact strategy generation is unavailable to this organization" } }, "security": [ { "sessionCookie": [] } ] } }, "/incentive-programs/{id}/evidence": { "get": { "operationId": "getIncentiveEvidence", "summary": "Read optimization and preparation events bound to an exact incentive program generation", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "resourceVersion", "in": "query", "required": true, "schema": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" } } ], "responses": { "200": { "description": "Historical program evidence; unbound legacy events are counted without assigning them to a generation", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "program", "events", "unboundEventCount", "executionPerformed", "executionAuthorityGranted" ], "properties": { "schemaVersion": { "const": "incentive-evidence-view-v1" }, "program": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/IncentiveProgram" } } } ] }, "events": { "type": "array", "items": { "$ref": "#/components/schemas/OperatingSystemEvent" } }, "unboundEventCount": { "type": "integer", "minimum": 0 }, "executionPerformed": { "const": false }, "executionAuthorityGranted": { "const": false } } } } } } } }, "404": { "description": "The exact incentive program generation is unavailable to this organization" } }, "security": [ { "sessionCookie": [] } ] } }, "/strategy-packages/{id}/approve": { "post": { "operationId": "approveStrategyPackage", "summary": "Verify independent named reviews and a current signed strategy-registry generation", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^\"[^\"\\\\\r\n]+\"$" } } ], "responses": { "200": { "description": "Cryptographically approved package version", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/StrategyPackage" } } } ] } } } } } }, "400": { "description": "Review, registry, scope, freshness, or signature evidence invalid" } }, "security": [ { "sessionCookie": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StrategyPackageApprovalRequest" } } } } } }, "/strategy-packages/{id}/seed-strategy": { "post": { "operationId": "seedStrategyFromApprovedPackage", "summary": "Enter standard activation preparation only from a currently verifiable approved package", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^\"[^\"\\\\\r\n]+\"$" } } ], "responses": { "201": { "description": "Validated strategy definition with package lineage and no execution authority", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": false, "required": [ "strategy", "sourcePackageId", "sourcePackageVersion", "sourcePackageResourceVersion", "sourcePackageArtifactHash", "safetyEnvelopeHash", "executionAuthorityGranted", "standardProposalSimulationApprovalSafeFlowRequired" ], "properties": { "strategy": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/StrategyDefinitionV2" } } } ] }, "sourcePackageId": { "type": "string", "minLength": 3, "maxLength": 160 }, "sourcePackageVersion": { "type": "integer", "minimum": 1 }, "sourcePackageResourceVersion": { "$ref": "#/components/schemas/Hash" }, "sourcePackageArtifactHash": { "$ref": "#/components/schemas/Hash" }, "safetyEnvelopeHash": { "$ref": "#/components/schemas/Hash" }, "executionAuthorityGranted": { "const": false }, "standardProposalSimulationApprovalSafeFlowRequired": { "const": true } } } } } } } }, "409": { "description": "Package is candidate, revoked, or no longer current" } }, "security": [ { "sessionCookie": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StrategyPackageSeedRequest" } } } } } }, "/strategy-packages/{id}/revoke": { "post": { "operationId": "revokeStrategyPackage", "summary": "Immediately revoke activation eligibility while retaining evidence", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^\"[^\"\\\\\r\n]+\"$" } } ], "responses": { "200": { "description": "Append-only revoked package version", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/StrategyPackage" } } } ] } } } } } } }, "security": [ { "sessionCookie": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "reason" ], "properties": { "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } } } }, "/proposals/{id}/comments": { "get": { "operationId": "listProposalComments", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Append-only comments", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/OperatingSystemEvent" } } } } } } } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "proposals:read" ] } ], "x-klineo-required-service-scope": "proposals:read" }, "post": { "operationId": "appendProposalComment", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^\"[^\"\\\\\r\n]+\"$" } } ], "responses": { "201": { "description": "Comment appended; supersession binds the exact prior comment artifact on this proposal", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/OperatingSystemEvent" } } } } } } }, "security": [ { "sessionCookie": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProposalCommentRequest" } } } } } }, "/proposals/{id}/decisions": { "post": { "operationId": "decideProposal", "summary": "Append an internal approval or rejection to a current DRAFT/VALIDATED packet", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^\"[^\"\\\\\r\n]+\"$" } } ], "responses": { "200": { "description": "Superseding proposal and immutable packet-bound decision event", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/ProposalDecisionResult" } } } } } }, "409": { "description": "Packet is terminal, expired, or the actor already approved this packet" } }, "security": [ { "sessionCookie": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProposalDecisionRequest" } } } } } }, "/proposals/{id}/safe-submissions": { "post": { "operationId": "registerProposalSafeSubmission", "summary": "Resolve finalized/reconciled issuer-Safe evidence server-side for an exact typed controller action", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^\"[^\"\\\\\r\n]+\"$" } } ], "responses": { "200": { "description": "Server-verified Safe transaction evidence registered; no execution performed by this route", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/ProposalSafeSubmissionResult" } } } } } }, "409": { "description": "Typed intent, signed release, current Safe, gateway evidence, finality, or reconciliation is unavailable/mismatched" } }, "security": [ { "sessionCookie": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProposalSafeSubmissionRequest" } } } } } }, "/proposal-comparisons": { "post": { "operationId": "compareProposals", "summary": "Build an immutable comparison hash for two to eight decision packets", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Deterministic proposal comparison", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/ProposalComparison" } } } } } } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "proposals:prepare" ] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProposalComparisonRequest" } } } }, "x-klineo-required-service-scope": "proposals:prepare" } }, "/launch-plans/{id}/timeline-events": { "post": { "operationId": "appendLaunchTimelineEvent", "summary": "Append a PLANNED dependency-aware event; completion is available only through the approval route", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^\"[^\"\\\\\r\n]+\"$" } } ], "responses": { "201": { "description": "Planned timeline event appended", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/OperatingSystemEvent" } } } } } }, "400": { "description": "Caller attempted to inject completion or another lifecycle state" } }, "security": [ { "sessionCookie": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TimelineEventRequest" } } } } } }, "/launch-plans/{id}/timeline": { "get": { "operationId": "getLaunchTimeline", "summary": "Materialize dependency and completion state from immutable events", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Materialized launch timeline", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/LaunchTimeline" } } } } } } }, "security": [ { "sessionCookie": [] } ] } }, "/launch-plans/{id}/timeline-events/{eventId}/complete": { "post": { "operationId": "completeLaunchTimelineEvent", "summary": "Bind a completion receipt after every dependency completes", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "eventId", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^\"[^\"\\\\\r\n]+\"$" } } ], "responses": { "200": { "description": "Completion receipt event", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/OperatingSystemEvent" } } } } } }, "409": { "description": "Dependencies incomplete" } }, "security": [ { "sessionCookie": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TimelineCompletionRequest" } } } } } }, "/launch-plans/{id}/seed-workspace": { "post": { "operationId": "seedLaunchWorkspace", "summary": "Seed drafts, studies, policy, qualification, and a funding proposal without execution", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^\"[^\"\\\\\r\n]+\"$" } } ], "responses": { "201": { "description": "Immutable seeded workspace", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/LaunchWorkspaceSeed" } } } } } } }, "security": [ { "sessionCookie": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LaunchWorkspaceSeedRequest" } } } } } }, "/capital-requirements/{id}/seed-intent": { "post": { "operationId": "seedIssuerIntentFromCapitalStudy", "summary": "Create or append an issuer-intent version from a completed reproducible capital study", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": false, "schema": { "type": "string", "pattern": "^\"[^\"\\\\\r\n]+\"$" } } ], "responses": { "201": { "description": "Validated intent evidence; no execution authority", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/IssuerIntent" } } } ] } } } } } } }, "security": [ { "sessionCookie": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CapitalIntentSeedRequest" } } } }, "x-klineo-if-match-required-when": "targetIssuerIntentId is supplied." } }, "/capital-requirements/{id}/seed-launch-plan": { "post": { "operationId": "seedLaunchPlanFromCapitalStudy", "summary": "Create or append a launch-plan draft using deterministic capital-study outputs", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": false, "schema": { "type": "string", "pattern": "^\"[^\"\\\\\r\n]+\"$" } } ], "responses": { "201": { "description": "Draft launch plan; no activation or execution", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/LaunchPlan" } } } ] } } } } } } }, "security": [ { "sessionCookie": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CapitalLaunchSeedRequest" } } } }, "x-klineo-if-match-required-when": "targetLaunchPlanId is supplied." } }, "/capital-requirements/{id}/reservations": { "post": { "operationId": "reserveTreasuryFromCapitalStudy", "summary": "Append a signed offchain treasury reservation without moving funds", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "201": { "description": "Future-committed ledger container with signed oracle evidence", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/TreasuryBucket" } } } ] } } } } } }, "409": { "description": "Stale oracle generation or duplicate economic container" } }, "security": [ { "sessionCookie": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CapitalReservationRequest" } } } } } }, "/venues/{id}/index-jobs": { "post": { "operationId": "queueVenueIndex", "summary": "Queue signed RPC quorum and finality indexing for one exact current venue-profile generation", "description": "The job binds the profile record version, resource version, artifact hash, identity, adapter, controller venue, and asset-pair facts. Only current VALIDATED or ACTIVE profiles are accepted.", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "202": { "description": "Fenced generation-bound venue indexing job", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/OperatingSystemJob" } } } } } }, "409": { "description": "Profile is draft, paused, revoked, superseded, or otherwise not currently eligible" } }, "security": [ { "sessionCookie": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "reason" ], "properties": { "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } } } }, "/migration-plans/{id}/state": { "get": { "operationId": "getMigrationPlanState", "summary": "Materialize ordered forward and rollback state from immutable transition evidence", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Deterministic migration execution state", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/MigrationPlanStateResult" } } } } } }, "422": { "description": "Transition history fails closed" } }, "security": [ { "sessionCookie": [] } ] } }, "/migration-plans/{id}/transitions": { "post": { "operationId": "appendMigrationPlanTransition", "summary": "Request a server-verified action-specific migration lifecycle transition", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^\"[^\"\\\\\r\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MigrationTransitionRequest" } } } }, "responses": { "201": { "description": "Server-derived immutable transition and newly materialized state", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/MigrationTransitionResult" } } } } } }, "400": { "description": "Client attempted to supply authority-bearing evidence" }, "403": { "description": "Role has no migration execution authority" }, "409": { "description": "Preview plan, changed or revoked bound venue generation, or canonical gateway/Safe/finality/reconciliation evidence is unavailable" }, "412": { "description": "Plan or state precondition changed" }, "422": { "description": "Transition violates ordered finality/reconciliation rules" } }, "security": [ { "sessionCookie": [] } ] } }, "/policy-intent-drafts/{id}/compile": { "post": { "operationId": "compilePolicyIntent", "summary": "Deterministically compile a non-executable policy draft", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^\"[^\"\\\\\r\n]+\"$" } } ], "responses": { "200": { "description": "Exact deterministic interpretation", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/PolicyCompilationResult" } } } } } } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "policies:compile" ] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "reason" ], "properties": { "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "x-klineo-required-service-scope": "policies:compile" } }, "/policy-intent-drafts/structured": { "post": { "operationId": "createStructuredPolicyIntentDraft", "summary": "Create a deterministic typed policy draft without an AI provider", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StructuredPolicyRequest" } } } }, "responses": { "201": { "description": "Manual structured draft and exact compilation preview", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/PolicyDraftResult" } } } } } } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "policies:compile" ] } ], "x-klineo-required-service-scope": "policies:compile" } }, "/policy-checks": { "post": { "operationId": "checkAutonomyPolicy", "summary": "Validate a manually structured policy and persist non-executable evidence", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PolicyCheckRequest" } } } }, "responses": { "201": { "description": "Deterministic policy check and immutable evidence", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/PolicyCheckResult" } } } } } } }, "security": [ { "sessionCookie": [] }, { "serviceCredential": [ "policies:check" ] } ], "x-klineo-required-service-scope": "policies:check" } }, "/developer-credentials/{id}/rotate": { "post": { "operationId": "rotateDeveloperCredential", "summary": "Rotate a hashed API key or OAuth client secret", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^\"[^\"\\\\\r\n]+\"$" } } ], "responses": { "200": { "description": "New secret returned exactly once; prior secret revoked; durable idempotency is metadata-only", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": false, "required": [ "credential", "secret", "priorSecretRevoked", "secretReturnedOnce" ], "properties": { "credential": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/DeveloperCredential" } } } ] }, "secret": { "type": "string" }, "priorSecretRevoked": { "const": true }, "secretReturnedOnce": { "const": true } } } } } } } }, "409": { "description": "Identical retry cannot replay the already-returned replacement secret" } }, "security": [ { "sessionCookie": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "reason" ], "properties": { "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } } } }, "/partner-portfolios/{partnerId}": { "get": { "operationId": "getPartnerPortfolio", "summary": "Read issuer aggregates only where bilateral partner consent is active", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "partnerId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Privacy-reduced portfolio view", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/PartnerPortfolio" } } } } }, "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "403": { "description": "Partner role or issuer consent absent", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } } }, "security": [ { "sessionCookie": [] } ] } }, "/partner-consent-options": { "get": { "operationId": "getPartnerConsentOptions", "summary": "Review the current partner declarations for this explicitly assigned issuer", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "partnerId", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "partnerOrganizationId", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Current partner declarations and exact configuration generation", "headers": { "ETag": { "required": true, "schema": { "type": "string" } }, "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/PartnerConsentOptions" } } } } } }, "403": { "description": "Issuer assignment or authority absent", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } } }, "security": [ { "sessionCookie": [] } ] } }, "/partner-preparation-contexts/{partnerId}": { "get": { "operationId": "getPartnerPreparationContext", "summary": "Read the exact current actor-scoped consent for preparing an issuer packet", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "partnerId", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "issuerOrganizationId", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Current partner and consent generations", "headers": { "ETag": { "required": true, "schema": { "type": "string" } }, "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } }, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/PartnerPreparationContext" } } } } } }, "403": { "description": "Current bilateral preparation authority absent", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } } }, "security": [ { "sessionCookie": [] } ] } }, "/partner-preparation-receipts/{partnerId}": { "get": { "operationId": "getPartnerPreparationReceiptRecovery", "summary": "Recover the initiating partner actor's durable preparation receipt using its original operation key", "description": "Read-only recovery for the original authenticated actor and partner organization. Current organization membership, active partner configuration, named proposal-preparer declaration and active bilateral proposal-preparation grant are required. ACCEPTED requires a completed v2 Idempotency-Key-bound preparation operation with original HTTP 202 status and an immutable preparation event matching the actor, organization, partner and issuer target. Receipt consent and partner-generation metadata describe the committed event and may differ from the currently authorized consent. Missing, in-flight, failed, unsupported or unverifiable completions return UNRESOLVED. Neither state admits or retries a preparation. The response discloses no proposal packet or audit reason.", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "partnerId", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "issuerOrganizationId", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 }, "description": "The exact Idempotency-Key header used for the original preparation POST; never a new recovery operation key." } ], "responses": { "200": { "description": "Verified committed receipt or unresolved operation; never evidence that a new preparation is safe", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/PartnerPreparationReceiptRecovery" } } } } }, "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "400": { "description": "Missing or invalid original operation key or issuer target", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "401": { "description": "Interactive authentication required", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "403": { "description": "Current actor-scoped bilateral preparation authority absent", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } } }, "security": [ { "sessionCookie": [] } ] } }, "/partner-preparations": { "get": { "operationId": "listPartnerPreparations", "summary": "Read consent-bound partner packets awaiting or completed in issuer review", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Issuer-owned preparation inbox", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/PartnerPreparationInboxEntry" } } } } } }, "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } } }, "security": [ { "sessionCookie": [] } ] } }, "/partner-preparations/{eventId}/import": { "post": { "operationId": "importPartnerPreparation", "summary": "Import a current consent-bound partner packet as an approval-empty issuer proposal", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "eventId", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^\"[^\"\\\\\r\n]+\"$" } } ], "responses": { "200": { "description": "Issuer-owned proposal and immutable import decision", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/PartnerPreparationDecisionResult" } } } } }, "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "403": { "description": "Authority or current bilateral consent absent", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "409": { "description": "Preparation already decided or unavailable", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "412": { "description": "Consent generation changed", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } } }, "security": [ { "sessionCookie": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "reason" ], "properties": { "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } } } }, "/partner-preparations/{eventId}/decline": { "post": { "operationId": "declinePartnerPreparation", "summary": "Record an issuer decline of an exact current consent-bound partner packet", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "eventId", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^\"[^\"\\\\\r\n]+\"$" } } ], "responses": { "200": { "description": "Immutable decline decision without a proposal import", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/PartnerPreparationDecisionResult" } } } } }, "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "403": { "description": "Authority or current bilateral consent absent", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "409": { "description": "Preparation already decided or unavailable", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "412": { "description": "Consent generation changed", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } } }, "security": [ { "sessionCookie": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "reason" ], "properties": { "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } } } }, "/partner-preparation-status/{partnerId}/{eventId}": { "get": { "operationId": "getPartnerPreparationStatus", "summary": "Read partner-owned delivery and issuer review status for one exact packet", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "partnerId", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "eventId", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "issuerOrganizationId", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Reduced delivery and issuer decision state", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/PartnerPreparationStatus" } } } } }, "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "403": { "description": "Current partner actor or consent absent", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "404": { "description": "Preparation absent", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } } }, "security": [ { "sessionCookie": [] } ] } }, "/partner-domain-challenges": { "get": { "operationId": "listPartnerDomainChallenges", "summary": "List tenant-owned domain ownership and HTTPS onboarding challenges", "description": "Returns at most 1000 challenges, newest first, in the current organization and optionally the selected partner. To read older challenges, pass the last returned challenge ID as beforeChallengeId while retaining the same partner filter. A page with fewer than 1000 entries ends traversal. An unknown cursor or a cursor outside the current organization or selected partner returns an empty array without disclosing its existence. This directory read neither verifies domain ownership nor admits a partner configuration.", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "partnerId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 3, "maxLength": 160, "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "description": "Restrict challenges to this partner in the current organization." }, { "name": "beforeChallengeId", "in": "query", "required": false, "schema": { "type": "string", "format": "uuid" }, "description": "Last challenge ID from the preceding page; return only older challenges in the same organization and partner filter." } ], "responses": { "200": { "description": "Bounded domain challenge array in the current organization; no pagination metadata", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/PartnerDomainChallenge" }, "maxItems": 1000 } } } } }, "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "400": { "description": "Invalid partner ID or challenge cursor", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "403": { "description": "Current organization domain administration authority absent", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } } }, "security": [ { "sessionCookie": [] } ] }, "post": { "operationId": "createPartnerDomainChallenge", "summary": "Create an exact-host DNS ownership challenge for an approved domain verifier", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "responses": { "201": { "description": "Durable DNS TXT challenge and expiry", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/PartnerDomainChallenge" } } } } }, "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "503": { "description": "Approved signing provider unavailable", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } } }, "security": [ { "sessionCookie": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PartnerDomainChallengeCreateRequest" } } } } } }, "/partner-domain-challenges/{id}": { "get": { "operationId": "getPartnerDomainChallenge", "summary": "Read one tenant-owned domain onboarding challenge", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Current domain challenge", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/PartnerDomainChallenge" } } } } }, "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "404": { "description": "Challenge absent in this organization", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } } }, "security": [ { "sessionCookie": [] } ] } }, "/partner-domain-challenges/{id}/status": { "get": { "operationId": "getPartnerDomainStatus", "summary": "Check current DNS ownership, routing and HTTPS readiness", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Observed readiness with exact check time", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/PartnerDomainStatus" } } } } }, "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "404": { "description": "Challenge absent in this organization", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "503": { "description": "DNS or hostname provider unavailable", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } } }, "security": [ { "sessionCookie": [] } ] } }, "/partner-domain-challenges/{id}/verify": { "post": { "operationId": "verifyPartnerDomainChallenge", "summary": "Verify the exact DNS TXT response and obtain current signed domain evidence", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Verified challenge and signed evidence", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/PartnerDomainChallenge" } } } } }, "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "409": { "description": "DNS TXT response absent or challenge expired", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "412": { "description": "Challenge state changed concurrently", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "503": { "description": "DNS or approved signer unavailable", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } } }, "security": [ { "sessionCookie": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "reason" ], "properties": { "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } } } }, "/partner-domain-challenges/{id}/provision": { "post": { "operationId": "provisionPartnerDomainChallenge", "summary": "Provision a verified partner hostname through the configured HTTPS provider", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Current hostname provisioning state and required validation records", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/PartnerDomainChallenge" } } } } }, "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "409": { "description": "Current verified ownership absent", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "412": { "description": "Challenge state changed concurrently", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "503": { "description": "Hostname provisioning unavailable", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } } }, "security": [ { "sessionCookie": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "reason" ], "properties": { "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } } } }, "/partner-domain-challenges/{id}/revoke": { "post": { "operationId": "revokePartnerDomainChallenge", "summary": "Revoke an unbound domain challenge and remove its managed hostname", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Revoked challenge with signed evidence and hostname withdrawn", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/PartnerDomainChallenge" } } } } }, "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "409": { "description": "An active partner configuration still binds this domain", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "412": { "description": "Challenge state changed concurrently", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "503": { "description": "Managed hostname removal unavailable", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } } }, "security": [ { "sessionCookie": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "reason" ], "properties": { "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } } } }, "/partner-portfolios/{partnerId}/proposal-preparations": { "post": { "operationId": "preparePartnerProposal", "summary": "Prepare an issuer import packet through exact current bilateral consent without cross-tenant or Safe authority", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "partnerId", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^\"[^\"\\\\\r\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "issuerOrganizationId", "proposal", "reason" ], "properties": { "issuerOrganizationId": { "type": "string", "minLength": 3, "maxLength": 160 }, "proposal": { "$ref": "#/components/schemas/ProposalWorkspaceInput" }, "requestExternalDelivery": { "type": "boolean", "default": false }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "202": { "description": "Consent-mediated approval-empty issuer inbox packet prepared; optional configured external delivery queued", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/PartnerProposalPreparationResult" } } } } }, "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "400": { "description": "Prepared packet attempted derived approval/Safe fields or has invalid expiry", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "403": { "description": "Current bilateral actor-scoped consent is absent", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "409": { "description": "Requested external partner integration is unavailable", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "412": { "description": "Issuer consent or partner configuration generation changed", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } } }, "security": [ { "sessionCookie": [] } ] } }, "/partners/{id}/revoke": { "post": { "operationId": "revokePartnerTenant", "summary": "Immediately remove all host bindings for a partner configuration", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^\"[^\"\\\\\r\n]+\"$" } } ], "responses": { "200": { "description": "Append-only revoked partner version", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/PartnerTenant" } } } ] } } } } }, "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } } }, "security": [ { "sessionCookie": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "reason" ], "properties": { "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } } } }, "/partner-consents": { "get": { "operationId": "listPartnerConsents", "summary": "List the issuer tenant’s current bilateral consent records", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Tenant-isolated consent versions", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/PartnerIssuerConsent" } } } ] } } } } } }, "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } } }, "security": [ { "sessionCookie": [] } ] }, "post": { "operationId": "grantPartnerConsent", "summary": "Grant or regrant explicit actor-scoped bilateral access", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": false, "schema": { "type": "string", "pattern": "^\"[^\"\\\\\r\n]+\"$" } } ], "responses": { "201": { "description": "Append-only active issuer consent", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/PartnerIssuerConsent" } } } ] } } } } }, "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } }, "412": { "description": "Existing consent version changed", "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } } }, "security": [ { "sessionCookie": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PartnerConsentGrantRequest" } } } }, "x-klineo-if-match-required-when": "A consent already exists for partnerId." } }, "/partner-consents/{id}": { "get": { "operationId": "getPartnerConsent", "summary": "Read one issuer-owned partner consent", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Current consent version", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/PartnerIssuerConsent" } } } ] } } } } }, "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } }, "ETag": { "required": true, "schema": { "type": "string" } } } } }, "security": [ { "sessionCookie": [] } ] } }, "/partner-consents/{id}/revoke": { "post": { "operationId": "revokePartnerConsent", "summary": "Immediately revoke portfolio and proposal-preparation access", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^\"[^\"\\\\\r\n]+\"$" } } ], "responses": { "200": { "description": "Append-only revoked consent version", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/PartnerIssuerConsent" } } } ] } } } } }, "headers": { "Cache-Control": { "required": true, "schema": { "const": "private, no-store" } } } } }, "security": [ { "sessionCookie": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "reason" ], "properties": { "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } } } }, "/market-maker-mandates/{id}/observations": { "get": { "operationId": "listMarketMakerEvidence", "summary": "List provenance-preserving market-maker observations and reconciliation state", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Append-only market-maker evidence", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/OperatingSystemEvent" } } } } } } } }, "security": [ { "sessionCookie": [] } ] }, "post": { "operationId": "ingestMarketMakerEvidence", "summary": "Ingest a finalized onchain or signed API/file/exchange observation without custody authority", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } }, { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^\"[^\"\\\\\r\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarketMakerEvidenceRequest" } } } }, "responses": { "201": { "description": "Signed provenance and reconciliation event appended", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/MarketMakerEvidenceResult" } } } } } } }, "security": [ { "sessionCookie": [] } ] } }, "/jobs": { "get": { "operationId": "listOperatingSystemJobs", "summary": "List fenced worker jobs and dead-letter visibility", "parameters": [ { "name": "x-klineo-organization-id", "in": "header", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Worker job states", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/OperatingSystemJob" } } } } } } } }, "security": [ { "sessionCookie": [] } ] } }, "/public/passports/{slug}": { "get": { "operationId": "getPublicLiquidityPassport", "summary": "Verify an issuer-disclosed signed Liquidity Passport", "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Canonical public passport", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/PublicPassportResult" } } } } }, "headers": { "ETag": { "required": true, "schema": { "type": "string" } } } }, "404": { "description": "Not published, revoked, or expired" } } } }, "/public/passports/{slug}/formats/{format}": { "get": { "operationId": "downloadPublicLiquidityPassport", "summary": "Download deterministic signed JSON, HTML, PDF, or CSV", "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "format", "in": "path", "required": true, "schema": { "type": "string", "enum": [ "json", "html", "pdf", "csv" ] } } ], "responses": { "200": { "description": "Content-addressed passport artifact", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiquidityPassport" } }, "text/html": { "schema": { "type": "string", "format": "binary" } }, "application/pdf": { "schema": { "type": "string", "format": "binary" } }, "text/csv": { "schema": { "type": "string", "format": "binary" } } }, "headers": { "Content-Disposition": { "required": true, "schema": { "type": "string" } }, "X-KlineO-Passport-Hash": { "required": true, "schema": { "$ref": "#/components/schemas/Hash" } }, "X-KlineO-Artifact-Hash": { "required": true, "schema": { "$ref": "#/components/schemas/Hash" } }, "X-KlineO-Signature-Algorithm": { "required": true, "schema": { "const": "Ed25519" } }, "X-KlineO-Signer-Key-Version": { "required": true, "schema": { "$ref": "#/components/schemas/Hash" } } } }, "404": { "description": "Not published, revoked, expired, or trust anchor disabled" } } } }, "/public/passports/{slug}/verification-bundle": { "get": { "operationId": "downloadLiquidityPassportVerificationBundle", "summary": "Download canonical passport, trust anchor, artifact hashes, and registry commitment", "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Verification bundle", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiquidityPassportVerificationBundle" } } } }, "404": { "description": "Passport unavailable" } } } }, "/public/studies/{slug}": { "get": { "operationId": "getSharedSimulationStudy", "summary": "Read a non-revoked study share", "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Disclosed study artifact", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/SharedSimulationStudy" } } } } } }, "404": { "description": "Not published, revoked, or expired" } } } }, "/public/brands/current": { "get": { "operationId": "getVerifiedHostBrand", "summary": "Resolve a privacy-safe brand only for the exact verified request host", "responses": { "200": { "description": "Host-bound accessible brand tokens", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/PublicPartnerBrand" } } } } }, "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store" } } } }, "404": { "description": "No unique verified brand is bound to this host", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store" } } } } } } }, "/public/partner-brand/logo/{contentHash}": { "get": { "operationId": "getVerifiedPartnerBrandLogo", "summary": "Serve the exact current host-bound content-addressed PNG logo", "parameters": [ { "name": "contentHash", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Hash-verified immutable PNG logo", "content": { "image/png": { "schema": { "type": "string", "format": "binary" } } }, "headers": { "ETag": { "required": true, "schema": { "type": "string" } }, "Cache-Control": { "required": true, "schema": { "const": "no-store" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff" } }, "Cross-Origin-Resource-Policy": { "required": true, "schema": { "const": "same-origin" } } } }, "404": { "description": "No current verified host brand owns this exact logo hash" } } } } }, "components": { "securitySchemes": { "sessionCookie": { "type": "apiKey", "in": "cookie", "name": "__Host-klineo_session", "description": "Backend-owned secure session cookie in production. Local non-TLS development uses klineo_session." }, "clientBasic": { "type": "http", "scheme": "basic", "description": "OAuth client identifier and one-time-visible client secret." }, "serviceCredential": { "type": "oauth2", "flows": { "clientCredentials": { "tokenUrl": "/api/liquidity-studio/v2/oauth/token", "scopes": { "scores:read": "Read market-quality scores", "studies:read": "Read deterministic studies", "studies:write": "Run and report deterministic studies", "strategies:validate": "Validate declarative strategies", "policies:compile": "Compile typed policy drafts", "policies:check": "Check a policy without activation", "proposals:read": "Read decision packets", "proposals:prepare": "Prepare non-authoritative decision packets", "vaults:read": "Read qualified vault metadata", "receipts:read": "Read reconciled execution receipts", "proof:read": "Read signed proof resources", "alerts:read": "Read anomalies and alerts", "webhooks:manage": "Manage signed webhook subscriptions" } } } } }, "schemas": { "AtomicAmount": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$", "description": "Unsigned integer in the asset or quote atomic unit." }, "PositiveAtomicAmount": { "type": "string", "pattern": "^[1-9][0-9]*$", "description": "Strictly positive integer in the asset or quote atomic unit." }, "SignedAtomicAmount": { "type": "string", "pattern": "^-?(0|[1-9][0-9]*)$", "description": "Signed integer in the declared atomic unit." }, "Hash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "Address": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "Pips": { "type": "integer", "minimum": 0, "maximum": 1000000, "description": "Parts per million. 1,000,000 equals 100%." }, "OperatingSystemRecordStatus": { "type": "string", "enum": [ "DRAFT", "VALIDATED", "ACTIVE", "PAUSED", "COMPLETED", "EXPIRED", "REVOKED", "SUPERSEDED", "UNAVAILABLE" ] }, "OperatingSystemRecordType": { "type": "string", "enum": [ "ISSUER_INTENT", "SIMULATION_STUDY", "SIMULATION_SHARE", "STRATEGY_DEFINITION", "PROPOSAL_WORKSPACE", "LAUNCH_PLAN", "UNLOCK_IMPACT", "MARKET_QUALITY_SCORE", "EXECUTION_ATTRIBUTION", "ANOMALY", "TREASURY_LEDGER_ENTRY", "CAPITAL_REQUIREMENT_STUDY", "TREASURY_STRESS_TEST", "VENUE_PROFILE", "VENUE_OBSERVATION", "ALLOCATION_PLAN", "MIGRATION_PLAN", "AUTONOMY_POLICY", "POLICY_INTENT_DRAFT", "PROTECTED_EXECUTION_QUOTE_SET", "PROTECTED_EXECUTION_PLAN", "DEVELOPER_CREDENTIAL", "WEBHOOK_SUBSCRIPTION", "STRATEGY_PACKAGE", "PARTNER_TENANT", "PARTNER_CONSENT", "MARKET_MAKER_MANDATE", "INCENTIVE_PROGRAM", "LIQUIDITY_PASSPORT" ] }, "RecordEnvelope": { "type": "object", "additionalProperties": false, "required": [ "id", "organizationId", "recordType", "version", "status", "payload", "artifactHash", "evidenceHashes", "createdBy", "reason", "requestId", "createdAt", "updatedAt", "resourceVersion" ], "properties": { "id": { "type": "string" }, "organizationId": { "type": "string" }, "recordType": { "$ref": "#/components/schemas/OperatingSystemRecordType" }, "version": { "type": "integer", "minimum": 1 }, "status": { "$ref": "#/components/schemas/OperatingSystemRecordStatus" }, "payload": { "type": "object" }, "artifactHash": { "$ref": "#/components/schemas/Hash" }, "evidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" } }, "createdBy": { "type": "string" }, "reason": { "type": "string" }, "requestId": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "supersedesVersion": { "type": "integer", "minimum": 1 }, "resourceVersion": { "$ref": "#/components/schemas/Hash" } } }, "IssuerIntentDuration": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "kind", "endsAt" ], "properties": { "kind": { "const": "UNTIL" }, "endsAt": { "type": "string", "format": "date-time" } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "days" ], "properties": { "kind": { "const": "ROLLING" }, "days": { "type": "integer", "minimum": 1, "maximum": 3650 } } } ] }, "IssuerIntent": { "type": "object", "additionalProperties": false, "required": [ "name", "quoteSymbol", "targetTradeSizeQuote", "maximumSlippagePips", "executableDepthQuote", "executableDepthBandPips", "treasuryReservePips", "capitalCeilingQuote", "maximumDailyTurnoverPips", "acceptableVolatilityPips", "duration", "prohibitedBehaviors" ], "properties": { "name": { "type": "string" }, "vaultId": { "type": "string" }, "quoteSymbol": { "type": "string" }, "targetTradeSizeQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "maximumSlippagePips": { "type": "integer", "minimum": 1, "maximum": 1000000, "description": "Strictly positive parts per million. 1,000,000 equals 100%." }, "executableDepthQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "executableDepthBandPips": { "type": "integer", "minimum": 1, "maximum": 1000000, "description": "Strictly positive parts per million. 1,000,000 equals 100%." }, "treasuryReservePips": { "$ref": "#/components/schemas/Pips" }, "minimumPriceX18": { "$ref": "#/components/schemas/AtomicAmount" }, "capitalCeilingQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "maximumDailyTurnoverPips": { "$ref": "#/components/schemas/Pips" }, "acceptableVolatilityPips": { "$ref": "#/components/schemas/Pips" }, "duration": { "$ref": "#/components/schemas/IssuerIntentDuration" }, "prohibitedBehaviors": { "type": "array", "items": { "type": "string" } } } }, "LiquidityPlan": { "type": "object", "additionalProperties": false, "required": [ "kind", "requiredCapitalQuote", "deployableCapitalQuote", "stableReserveQuote", "emergencyReserveQuote", "rangeWidthPips", "expectedSlippagePips", "expectedFeeIncomeLowQuote", "expectedFeeIncomeHighQuote", "inventoryExposurePips", "maximumDailyTurnoverPips", "satisfiesIntent", "reasons" ], "properties": { "kind": { "type": "string", "enum": [ "CURRENT", "RECOMMENDED", "CONSERVATIVE", "CAPITAL_EFFICIENT", "EMERGENCY" ] }, "requiredCapitalQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "deployableCapitalQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "stableReserveQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "emergencyReserveQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "rangeWidthPips": { "$ref": "#/components/schemas/Pips" }, "expectedSlippagePips": { "$ref": "#/components/schemas/Pips" }, "expectedFeeIncomeLowQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "expectedFeeIncomeHighQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "inventoryExposurePips": { "$ref": "#/components/schemas/Pips" }, "maximumDailyTurnoverPips": { "$ref": "#/components/schemas/Pips" }, "satisfiesIntent": { "type": "boolean" }, "reasons": { "type": "array", "items": { "type": "string" } } } }, "LiquidityPlanVariant": { "type": "object", "additionalProperties": false, "required": [ "kind", "requiredCapitalQuote", "deployableCapitalQuote", "stableReserveQuote", "emergencyReserveQuote", "rangeWidthPips", "expectedSlippagePips", "expectedFeeIncomeLowQuote", "expectedFeeIncomeHighQuote", "inventoryExposurePips", "maximumDailyTurnoverPips", "satisfiesIntent", "reasons" ], "properties": { "kind": { "type": "string", "enum": [ "CURRENT", "RECOMMENDED", "CONSERVATIVE", "CAPITAL_EFFICIENT", "EMERGENCY" ] }, "requiredCapitalQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "deployableCapitalQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "stableReserveQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "emergencyReserveQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "rangeWidthPips": { "$ref": "#/components/schemas/Pips" }, "expectedSlippagePips": { "$ref": "#/components/schemas/Pips" }, "expectedFeeIncomeLowQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "expectedFeeIncomeHighQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "inventoryExposurePips": { "$ref": "#/components/schemas/Pips" }, "maximumDailyTurnoverPips": { "$ref": "#/components/schemas/Pips" }, "satisfiesIntent": { "type": "boolean" }, "reasons": { "type": "array", "items": { "type": "string" } } } }, "CapitalRequirementStudy": { "type": "object", "additionalProperties": false, "required": [ "calculationVersion", "intent", "minimumCapitalQuote", "recommendedRangeWidthPips", "requiredStableReserveQuote", "expectedFeeIncomeLowQuote", "expectedFeeIncomeHighQuote", "inventoryExposurePips", "confidencePips", "variants", "assumptions" ], "properties": { "calculationVersion": { "type": "string", "enum": [ "capital-requirement-v1", "capital-requirement-v2" ] }, "intent": { "$ref": "#/components/schemas/IssuerIntent" }, "minimumCapitalQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "recommendedRangeWidthPips": { "$ref": "#/components/schemas/Pips" }, "requiredStableReserveQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "expectedFeeIncomeLowQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "expectedFeeIncomeHighQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "inventoryExposurePips": { "$ref": "#/components/schemas/Pips" }, "confidencePips": { "$ref": "#/components/schemas/Pips" }, "variants": { "type": "array", "items": { "$ref": "#/components/schemas/LiquidityPlanVariant" }, "minItems": 5, "maxItems": 5 }, "assumptions": { "type": "array", "items": { "type": "string" } } } }, "UnlockTranche": { "type": "object", "additionalProperties": false, "required": [ "id", "unlocksAt", "tokenAmount", "recipientCategory", "expectedSaleParticipationPips", "confidencePips" ], "properties": { "id": { "type": "string", "minLength": 3, "maxLength": 153, "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,152}$" }, "unlocksAt": { "type": "string", "format": "date-time" }, "tokenAmount": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "recipientCategory": { "type": "string", "enum": [ "TEAM", "INVESTOR", "COMMUNITY", "TREASURY", "ECOSYSTEM", "OTHER" ] }, "expectedSaleParticipationPips": { "$ref": "#/components/schemas/Pips" }, "confidencePips": { "$ref": "#/components/schemas/Pips" }, "correlationGroup": { "type": "string" }, "evidenceHash": { "$ref": "#/components/schemas/Hash" } } }, "UnlockImpactSourceObservation": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "observationId", "chainId", "venueId", "assetMappingId", "tokenPriceX18", "tokenDecimals", "quoteDecimals", "currentUsableDepthQuote", "currentStableReserveQuote", "observedAt", "providerId", "providerResourceVersion", "providerAttestationHash", "payloadHash", "signature" ], "properties": { "schemaVersion": { "const": "unlock-impact-source-observation-v1" }, "observationId": { "type": "string" }, "chainId": { "type": "integer", "minimum": 1 }, "venueId": { "type": "string" }, "assetMappingId": { "type": "string" }, "tokenPriceX18": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "tokenDecimals": { "type": "integer", "minimum": 0, "maximum": 36 }, "quoteDecimals": { "type": "integer", "minimum": 0, "maximum": 36 }, "currentUsableDepthQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "currentStableReserveQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "observedAt": { "type": "string", "format": "date-time" }, "providerId": { "type": "string" }, "providerResourceVersion": { "$ref": "#/components/schemas/Hash" }, "providerAttestationHash": { "$ref": "#/components/schemas/Hash" }, "payloadHash": { "$ref": "#/components/schemas/Hash" }, "signature": { "type": "string", "contentEncoding": "base64" } } }, "UnlockImpact": { "type": "object", "additionalProperties": false, "required": [ "calculationVersion", "unlockIds", "expectedSellPressureToken", "expectedSellPressureQuote", "usableDepthAfterQuote", "expectedPriceImpactPips", "requiredStableReserveQuote", "recommendedRangeShiftPips", "treasuryRiskPips", "confidencePips", "warnings" ], "properties": { "calculationVersion": { "type": "string", "enum": [ "unlock-impact-v1", "unlock-impact-v2" ] }, "unlockIds": { "type": "array", "items": { "type": "string" } }, "sourceLaunchPlanId": { "type": "string" }, "sourceObservation": { "$ref": "#/components/schemas/UnlockImpactSourceObservation" }, "inputHash": { "$ref": "#/components/schemas/Hash" }, "inputSnapshot": { "$ref": "#/components/schemas/UnlockImpactInputSnapshot" }, "correlationGroups": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "groupId", "unlockIds", "totalUnlockedToken", "confidencePips", "sellPressureTokenRange" ], "properties": { "groupId": { "type": "string" }, "unlockIds": { "type": "array", "items": { "type": "string" } }, "totalUnlockedToken": { "$ref": "#/components/schemas/AtomicAmount" }, "confidencePips": { "$ref": "#/components/schemas/Pips" }, "sellPressureTokenRange": { "type": "object", "additionalProperties": false, "required": [ "p5", "p50", "p95" ], "properties": { "p5": { "$ref": "#/components/schemas/AtomicAmount" }, "p50": { "$ref": "#/components/schemas/AtomicAmount" }, "p95": { "$ref": "#/components/schemas/AtomicAmount" } } } } } }, "sellPressureTokenRange": { "type": "object", "additionalProperties": false, "required": [ "p5", "p50", "p95" ], "properties": { "p5": { "$ref": "#/components/schemas/AtomicAmount" }, "p50": { "$ref": "#/components/schemas/AtomicAmount" }, "p95": { "$ref": "#/components/schemas/AtomicAmount" } } }, "sellPressureQuoteRange": { "type": "object", "additionalProperties": false, "required": [ "p5", "p50", "p95" ], "properties": { "p5": { "$ref": "#/components/schemas/AtomicAmount" }, "p50": { "$ref": "#/components/schemas/AtomicAmount" }, "p95": { "$ref": "#/components/schemas/AtomicAmount" } } }, "priceImpactPipsRange": { "type": "object", "additionalProperties": false, "required": [ "p5", "p50", "p95" ], "properties": { "p5": { "$ref": "#/components/schemas/Pips" }, "p50": { "$ref": "#/components/schemas/Pips" }, "p95": { "$ref": "#/components/schemas/Pips" } } }, "expectedSellPressureToken": { "$ref": "#/components/schemas/AtomicAmount" }, "expectedSellPressureQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "usableDepthAfterQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "expectedPriceImpactPips": { "$ref": "#/components/schemas/Pips" }, "requiredStableReserveQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "recommendedRangeShiftPips": { "type": "integer" }, "treasuryRiskPips": { "$ref": "#/components/schemas/Pips" }, "confidencePips": { "$ref": "#/components/schemas/Pips" }, "warnings": { "type": "array", "items": { "type": "string" } } } }, "ScenarioDefinition": { "type": "object", "additionalProperties": false, "required": [ "id", "name", "kind", "driftPipsPerStep", "volatilityPipsPerStep", "liquidityWithdrawalPips", "oneSidedFlowPips", "gasIncreasePips", "unlocks" ], "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "kind": { "type": "string", "enum": [ "HISTORICAL_REPLAY", "BULL", "BEAR", "SIDEWAYS", "LIQUIDITY_CRISIS", "TOKEN_UNLOCK", "LARGE_BUYER", "LARGE_SELLER", "LIQUIDITY_WITHDRAWAL", "GAS_SPIKE", "ORACLE_OUTAGE", "COMBINED" ] }, "driftPipsPerStep": { "type": "integer", "minimum": -1000000, "maximum": 1000000 }, "volatilityPipsPerStep": { "$ref": "#/components/schemas/Pips" }, "liquidityWithdrawalPips": { "$ref": "#/components/schemas/Pips" }, "oneSidedFlowPips": { "$ref": "#/components/schemas/Pips" }, "gasIncreasePips": { "$ref": "#/components/schemas/Pips" }, "oracleOutageStep": { "type": "integer", "minimum": 0, "maximum": 364 }, "historicalReturnPips": { "type": "array", "items": { "type": "integer", "minimum": -1000000, "maximum": 1000000 }, "minItems": 1, "maxItems": 365 }, "protocolFeePips": { "$ref": "#/components/schemas/Pips" }, "platformFeePips": { "$ref": "#/components/schemas/Pips" }, "unlocks": { "type": "array", "items": { "$ref": "#/components/schemas/UnlockTranche" }, "maxItems": 256 } } }, "DistributionPercentiles": { "type": "object", "additionalProperties": false, "required": [ "p5", "p25", "p50", "p75", "p95" ], "properties": { "p5": { "$ref": "#/components/schemas/SignedAtomicAmount" }, "p25": { "$ref": "#/components/schemas/SignedAtomicAmount" }, "p50": { "$ref": "#/components/schemas/SignedAtomicAmount" }, "p75": { "$ref": "#/components/schemas/SignedAtomicAmount" }, "p95": { "$ref": "#/components/schemas/SignedAtomicAmount" } } }, "PipsPercentiles": { "type": "object", "additionalProperties": false, "required": [ "p5", "p25", "p50", "p75", "p95" ], "properties": { "p5": { "$ref": "#/components/schemas/Pips" }, "p25": { "$ref": "#/components/schemas/Pips" }, "p50": { "$ref": "#/components/schemas/Pips" }, "p75": { "$ref": "#/components/schemas/Pips" }, "p95": { "$ref": "#/components/schemas/Pips" } } }, "SimulationStudySourceLineage": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "sourceKind", "publicationEligibility", "studyInputHash", "publicationAdmissionHash" ], "properties": { "schemaVersion": { "const": "simulation-study-source-lineage-v1" }, "sourceKind": { "type": "string", "enum": [ "ISSUER_INTENT", "LAUNCH_PLAN", "SANDBOX" ] }, "publicationEligibility": { "type": "string", "enum": [ "ELIGIBLE", "INELIGIBLE_UNBOUND", "INELIGIBLE_SANDBOX" ] }, "vaultId": { "type": "string" }, "issuerIntentId": { "type": "string" }, "issuerIntentVersion": { "type": "integer", "minimum": 1 }, "issuerIntentResourceVersion": { "$ref": "#/components/schemas/Hash" }, "issuerIntentArtifactHash": { "$ref": "#/components/schemas/Hash" }, "studyInputHash": { "$ref": "#/components/schemas/Hash" }, "publicationAdmissionHash": { "$ref": "#/components/schemas/Hash" } } }, "SimulationStudyInputSnapshot": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "engineVersion", "seed", "pathCount", "stepCount", "targetTradeSizeQuote", "startingPortfolioQuote", "startingDepthQuote", "startingInventoryPips", "scenario", "variants" ], "properties": { "schemaVersion": { "const": "simulation-study-input-snapshot-v1" }, "engineVersion": { "const": "digital-twin-pcg64-fixed-v2" }, "seed": { "type": "string" }, "pathCount": { "type": "integer", "enum": [ 2000, 10000 ] }, "stepCount": { "type": "integer", "minimum": 1, "maximum": 365 }, "targetTradeSizeQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "startingPortfolioQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "startingDepthQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "startingInventoryPips": { "$ref": "#/components/schemas/Pips" }, "scenario": { "$ref": "#/components/schemas/ScenarioDefinition" }, "variants": { "type": "array", "items": { "$ref": "#/components/schemas/LiquidityPlanVariant" }, "minItems": 5, "maxItems": 5 } } }, "DisclosedSimulationStudyInputSnapshot": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "engineVersion", "seed", "pathCount", "stepCount", "targetTradeSizeQuote", "startingPortfolioQuote", "startingDepthQuote", "startingInventoryPips", "scenario", "variants" ], "properties": { "schemaVersion": { "const": "simulation-study-input-snapshot-v1" }, "engineVersion": { "const": "digital-twin-pcg64-fixed-v2" }, "seed": { "type": "string" }, "pathCount": { "type": "integer", "enum": [ 2000, 10000 ] }, "stepCount": { "type": "integer", "minimum": 1, "maximum": 365 }, "targetTradeSizeQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "startingPortfolioQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "startingDepthQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "startingInventoryPips": { "$ref": "#/components/schemas/Pips" }, "scenario": { "type": "object", "additionalProperties": false, "required": [ "id", "name", "kind", "driftPipsPerStep", "volatilityPipsPerStep", "liquidityWithdrawalPips", "oneSidedFlowPips", "gasIncreasePips" ], "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "kind": { "type": "string", "enum": [ "HISTORICAL_REPLAY", "BULL", "BEAR", "SIDEWAYS", "LIQUIDITY_CRISIS", "TOKEN_UNLOCK", "LARGE_BUYER", "LARGE_SELLER", "LIQUIDITY_WITHDRAWAL", "GAS_SPIKE", "ORACLE_OUTAGE", "COMBINED" ] }, "driftPipsPerStep": { "type": "integer", "minimum": -1000000, "maximum": 1000000 }, "volatilityPipsPerStep": { "$ref": "#/components/schemas/Pips" }, "liquidityWithdrawalPips": { "$ref": "#/components/schemas/Pips" }, "oneSidedFlowPips": { "$ref": "#/components/schemas/Pips" }, "gasIncreasePips": { "$ref": "#/components/schemas/Pips" }, "oracleOutageStep": { "type": "integer", "minimum": 0, "maximum": 364 }, "historicalReturnPips": { "type": "array", "items": { "type": "integer", "minimum": -1000000, "maximum": 1000000 }, "minItems": 1, "maxItems": 365 }, "protocolFeePips": { "$ref": "#/components/schemas/Pips" }, "platformFeePips": { "$ref": "#/components/schemas/Pips" }, "unlocks": { "type": "array", "items": { "$ref": "#/components/schemas/UnlockTranche" }, "maxItems": 256 } } }, "variants": { "type": "array", "items": { "$ref": "#/components/schemas/LiquidityPlanVariant" }, "minItems": 5, "maxItems": 5 } } }, "DisclosedSimulationStudy": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "engineVersion", "seed", "pathCount", "stepCount", "scenario", "variants", "recommendedVariant", "warnings", "replayCompleteness", "inputHash", "disclosureApplied" ], "properties": { "engineVersion": { "const": "digital-twin-pcg64-fixed-v1" }, "seed": { "type": "string" }, "pathCount": { "type": "integer", "enum": [ 2000, 10000 ] }, "stepCount": { "type": "integer", "minimum": 1, "maximum": 365 }, "scenario": { "type": "object", "additionalProperties": false, "required": [ "id", "name", "kind", "driftPipsPerStep", "volatilityPipsPerStep", "liquidityWithdrawalPips", "oneSidedFlowPips", "gasIncreasePips" ], "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "kind": { "type": "string", "enum": [ "HISTORICAL_REPLAY", "BULL", "BEAR", "SIDEWAYS", "LIQUIDITY_CRISIS", "TOKEN_UNLOCK", "LARGE_BUYER", "LARGE_SELLER", "LIQUIDITY_WITHDRAWAL", "GAS_SPIKE", "ORACLE_OUTAGE", "COMBINED" ] }, "driftPipsPerStep": { "type": "integer", "minimum": -1000000, "maximum": 1000000 }, "volatilityPipsPerStep": { "$ref": "#/components/schemas/Pips" }, "liquidityWithdrawalPips": { "$ref": "#/components/schemas/Pips" }, "oneSidedFlowPips": { "$ref": "#/components/schemas/Pips" }, "gasIncreasePips": { "$ref": "#/components/schemas/Pips" }, "oracleOutageStep": { "type": "integer", "minimum": 0, "maximum": 364 }, "historicalReturnPips": { "type": "array", "items": { "type": "integer", "minimum": -1000000, "maximum": 1000000 }, "minItems": 1, "maxItems": 365 }, "protocolFeePips": { "$ref": "#/components/schemas/Pips" }, "platformFeePips": { "$ref": "#/components/schemas/Pips" }, "unlocks": { "type": "array", "items": { "$ref": "#/components/schemas/UnlockTranche" }, "maxItems": 256 } } }, "variants": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "variant", "endingValueQuote", "slippagePips", "drawdownPips", "turnoverQuote", "gasCostQuote", "feeIncomeQuote", "protocolFeesQuote", "platformFeesQuote", "inventoryPips", "minimumDepthQuote", "reserveBreachProbabilityPips" ], "properties": { "variant": { "type": "string", "enum": [ "CURRENT", "RECOMMENDED", "CONSERVATIVE", "CAPITAL_EFFICIENT", "EMERGENCY" ] }, "endingValueQuote": { "$ref": "#/components/schemas/DistributionPercentiles" }, "slippagePips": { "$ref": "#/components/schemas/PipsPercentiles" }, "drawdownPips": { "$ref": "#/components/schemas/PipsPercentiles" }, "turnoverQuote": { "$ref": "#/components/schemas/DistributionPercentiles" }, "gasCostQuote": { "$ref": "#/components/schemas/DistributionPercentiles" }, "feeIncomeQuote": { "$ref": "#/components/schemas/DistributionPercentiles" }, "protocolFeesQuote": { "$ref": "#/components/schemas/DistributionPercentiles" }, "platformFeesQuote": { "$ref": "#/components/schemas/DistributionPercentiles" }, "inventoryPips": { "$ref": "#/components/schemas/PipsPercentiles" }, "minimumDepthQuote": { "$ref": "#/components/schemas/DistributionPercentiles" }, "reserveBreachProbabilityPips": { "$ref": "#/components/schemas/Pips" }, "drivers": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "driver", "impactQuote", "evidence", "method" ], "properties": { "driver": { "type": "string", "enum": [ "PRICE_PATH", "VOLATILITY", "FLOW", "LIQUIDITY", "UNLOCK", "GAS", "RESERVE" ] }, "impactQuote": { "$ref": "#/components/schemas/SignedAtomicAmount" }, "evidence": { "type": "string" }, "method": { "const": "DETERMINISTIC_COUNTERFACTUAL_DELTA_V1" } } } } } }, "minItems": 5, "maxItems": 5 }, "recommendedVariant": { "type": "string", "enum": [ "CURRENT", "RECOMMENDED", "CONSERVATIVE", "CAPITAL_EFFICIENT", "EMERGENCY" ] }, "warnings": { "type": "array", "items": { "type": "string" } }, "replayCompleteness": { "const": "HISTORICAL_V1_INPUT_SNAPSHOT_UNAVAILABLE" }, "inputHash": { "oneOf": [ { "$ref": "#/components/schemas/Hash" }, { "type": "null" } ] }, "sourceLineage": { "$ref": "#/components/schemas/SimulationStudySourceLineage" }, "treasury": { "type": "object", "additionalProperties": false, "required": [ "unlocks" ], "properties": { "unlocks": { "type": "array", "items": { "$ref": "#/components/schemas/UnlockTranche" }, "maxItems": 256 } } }, "policy": { "type": "object", "additionalProperties": false, "required": [ "availability" ], "properties": { "availability": { "const": "NOT_ATTACHED_TO_STUDY" } } }, "disclosureApplied": { "type": "object", "additionalProperties": false, "required": [ "drivers", "treasury", "policy" ], "properties": { "drivers": { "type": "boolean" }, "treasury": { "type": "boolean" }, "policy": { "type": "boolean" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "engineVersion", "seed", "pathCount", "stepCount", "scenario", "variants", "recommendedVariant", "warnings", "replayCompleteness", "inputHash", "inputSnapshot", "sourceLineage", "disclosureApplied" ], "properties": { "engineVersion": { "const": "digital-twin-pcg64-fixed-v2" }, "seed": { "type": "string" }, "pathCount": { "type": "integer", "enum": [ 2000, 10000 ] }, "stepCount": { "type": "integer", "minimum": 1, "maximum": 365 }, "scenario": { "type": "object", "additionalProperties": false, "required": [ "id", "name", "kind", "driftPipsPerStep", "volatilityPipsPerStep", "liquidityWithdrawalPips", "oneSidedFlowPips", "gasIncreasePips" ], "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "kind": { "type": "string", "enum": [ "HISTORICAL_REPLAY", "BULL", "BEAR", "SIDEWAYS", "LIQUIDITY_CRISIS", "TOKEN_UNLOCK", "LARGE_BUYER", "LARGE_SELLER", "LIQUIDITY_WITHDRAWAL", "GAS_SPIKE", "ORACLE_OUTAGE", "COMBINED" ] }, "driftPipsPerStep": { "type": "integer", "minimum": -1000000, "maximum": 1000000 }, "volatilityPipsPerStep": { "$ref": "#/components/schemas/Pips" }, "liquidityWithdrawalPips": { "$ref": "#/components/schemas/Pips" }, "oneSidedFlowPips": { "$ref": "#/components/schemas/Pips" }, "gasIncreasePips": { "$ref": "#/components/schemas/Pips" }, "oracleOutageStep": { "type": "integer", "minimum": 0, "maximum": 364 }, "historicalReturnPips": { "type": "array", "items": { "type": "integer", "minimum": -1000000, "maximum": 1000000 }, "minItems": 1, "maxItems": 365 }, "protocolFeePips": { "$ref": "#/components/schemas/Pips" }, "platformFeePips": { "$ref": "#/components/schemas/Pips" }, "unlocks": { "type": "array", "items": { "$ref": "#/components/schemas/UnlockTranche" }, "maxItems": 256 } } }, "variants": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "variant", "endingValueQuote", "slippagePips", "drawdownPips", "turnoverQuote", "gasCostQuote", "feeIncomeQuote", "protocolFeesQuote", "platformFeesQuote", "inventoryPips", "minimumDepthQuote", "reserveBreachProbabilityPips" ], "properties": { "variant": { "type": "string", "enum": [ "CURRENT", "RECOMMENDED", "CONSERVATIVE", "CAPITAL_EFFICIENT", "EMERGENCY" ] }, "endingValueQuote": { "$ref": "#/components/schemas/DistributionPercentiles" }, "slippagePips": { "$ref": "#/components/schemas/PipsPercentiles" }, "drawdownPips": { "$ref": "#/components/schemas/PipsPercentiles" }, "turnoverQuote": { "$ref": "#/components/schemas/DistributionPercentiles" }, "gasCostQuote": { "$ref": "#/components/schemas/DistributionPercentiles" }, "feeIncomeQuote": { "$ref": "#/components/schemas/DistributionPercentiles" }, "protocolFeesQuote": { "$ref": "#/components/schemas/DistributionPercentiles" }, "platformFeesQuote": { "$ref": "#/components/schemas/DistributionPercentiles" }, "inventoryPips": { "$ref": "#/components/schemas/PipsPercentiles" }, "minimumDepthQuote": { "$ref": "#/components/schemas/DistributionPercentiles" }, "reserveBreachProbabilityPips": { "$ref": "#/components/schemas/Pips" }, "drivers": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "driver", "impactQuote", "evidence", "method" ], "properties": { "driver": { "type": "string", "enum": [ "PRICE_PATH", "VOLATILITY", "FLOW", "LIQUIDITY", "UNLOCK", "GAS", "RESERVE" ] }, "impactQuote": { "$ref": "#/components/schemas/SignedAtomicAmount" }, "evidence": { "type": "string" }, "method": { "const": "DETERMINISTIC_COUNTERFACTUAL_DELTA_V1" } } } } } }, "minItems": 5, "maxItems": 5 }, "recommendedVariant": { "type": "string", "enum": [ "CURRENT", "RECOMMENDED", "CONSERVATIVE", "CAPITAL_EFFICIENT", "EMERGENCY" ] }, "warnings": { "type": "array", "items": { "type": "string" } }, "replayCompleteness": { "const": "COMPLETE_INPUT_SNAPSHOT" }, "inputHash": { "$ref": "#/components/schemas/Hash" }, "inputSnapshot": { "$ref": "#/components/schemas/DisclosedSimulationStudyInputSnapshot" }, "sourceLineage": { "$ref": "#/components/schemas/SimulationStudySourceLineage" }, "treasury": { "type": "object", "additionalProperties": false, "required": [ "unlocks" ], "properties": { "unlocks": { "type": "array", "items": { "$ref": "#/components/schemas/UnlockTranche" }, "maxItems": 256 } } }, "policy": { "type": "object", "additionalProperties": false, "required": [ "availability" ], "properties": { "availability": { "const": "NOT_ATTACHED_TO_STUDY" } } }, "disclosureApplied": { "type": "object", "additionalProperties": false, "required": [ "drivers", "treasury", "policy" ], "properties": { "drivers": { "type": "boolean" }, "treasury": { "type": "boolean" }, "policy": { "type": "boolean" } } } } } ] }, "SimulationStudy": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "engineVersion", "seed", "pathCount", "stepCount", "scenario", "variants", "recommendedVariant", "warnings" ], "properties": { "engineVersion": { "const": "digital-twin-pcg64-fixed-v1" }, "seed": { "type": "string" }, "pathCount": { "type": "integer", "enum": [ 2000, 10000 ] }, "stepCount": { "type": "integer", "minimum": 1, "maximum": 365 }, "scenario": { "$ref": "#/components/schemas/ScenarioDefinition" }, "variants": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "variant", "endingValueQuote", "slippagePips", "drawdownPips", "turnoverQuote", "gasCostQuote", "feeIncomeQuote", "protocolFeesQuote", "platformFeesQuote", "inventoryPips", "minimumDepthQuote", "reserveBreachProbabilityPips", "drivers" ], "properties": { "variant": { "type": "string", "enum": [ "CURRENT", "RECOMMENDED", "CONSERVATIVE", "CAPITAL_EFFICIENT", "EMERGENCY" ] }, "endingValueQuote": { "$ref": "#/components/schemas/DistributionPercentiles" }, "slippagePips": { "$ref": "#/components/schemas/PipsPercentiles" }, "drawdownPips": { "$ref": "#/components/schemas/PipsPercentiles" }, "turnoverQuote": { "$ref": "#/components/schemas/DistributionPercentiles" }, "gasCostQuote": { "$ref": "#/components/schemas/DistributionPercentiles" }, "feeIncomeQuote": { "$ref": "#/components/schemas/DistributionPercentiles" }, "protocolFeesQuote": { "$ref": "#/components/schemas/DistributionPercentiles" }, "platformFeesQuote": { "$ref": "#/components/schemas/DistributionPercentiles" }, "inventoryPips": { "$ref": "#/components/schemas/PipsPercentiles" }, "minimumDepthQuote": { "$ref": "#/components/schemas/DistributionPercentiles" }, "reserveBreachProbabilityPips": { "$ref": "#/components/schemas/Pips" }, "drivers": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "driver", "impactQuote", "evidence", "method" ], "properties": { "driver": { "type": "string", "enum": [ "PRICE_PATH", "VOLATILITY", "FLOW", "LIQUIDITY", "UNLOCK", "GAS", "RESERVE" ] }, "impactQuote": { "$ref": "#/components/schemas/SignedAtomicAmount" }, "evidence": { "type": "string" }, "method": { "const": "DETERMINISTIC_COUNTERFACTUAL_DELTA_V1" } } } } } }, "minItems": 5, "maxItems": 5 }, "recommendedVariant": { "type": "string", "enum": [ "CURRENT", "RECOMMENDED", "CONSERVATIVE", "CAPITAL_EFFICIENT", "EMERGENCY" ] }, "warnings": { "type": "array", "items": { "type": "string" } }, "sourceLineage": { "$ref": "#/components/schemas/SimulationStudySourceLineage" } } }, { "type": "object", "additionalProperties": false, "required": [ "engineVersion", "seed", "pathCount", "stepCount", "scenario", "variants", "recommendedVariant", "warnings", "inputSnapshot", "sourceLineage" ], "properties": { "engineVersion": { "const": "digital-twin-pcg64-fixed-v2" }, "seed": { "type": "string" }, "pathCount": { "type": "integer", "enum": [ 2000, 10000 ] }, "stepCount": { "type": "integer", "minimum": 1, "maximum": 365 }, "scenario": { "$ref": "#/components/schemas/ScenarioDefinition" }, "variants": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "variant", "endingValueQuote", "slippagePips", "drawdownPips", "turnoverQuote", "gasCostQuote", "feeIncomeQuote", "protocolFeesQuote", "platformFeesQuote", "inventoryPips", "minimumDepthQuote", "reserveBreachProbabilityPips", "drivers" ], "properties": { "variant": { "type": "string", "enum": [ "CURRENT", "RECOMMENDED", "CONSERVATIVE", "CAPITAL_EFFICIENT", "EMERGENCY" ] }, "endingValueQuote": { "$ref": "#/components/schemas/DistributionPercentiles" }, "slippagePips": { "$ref": "#/components/schemas/PipsPercentiles" }, "drawdownPips": { "$ref": "#/components/schemas/PipsPercentiles" }, "turnoverQuote": { "$ref": "#/components/schemas/DistributionPercentiles" }, "gasCostQuote": { "$ref": "#/components/schemas/DistributionPercentiles" }, "feeIncomeQuote": { "$ref": "#/components/schemas/DistributionPercentiles" }, "protocolFeesQuote": { "$ref": "#/components/schemas/DistributionPercentiles" }, "platformFeesQuote": { "$ref": "#/components/schemas/DistributionPercentiles" }, "inventoryPips": { "$ref": "#/components/schemas/PipsPercentiles" }, "minimumDepthQuote": { "$ref": "#/components/schemas/DistributionPercentiles" }, "reserveBreachProbabilityPips": { "$ref": "#/components/schemas/Pips" }, "drivers": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "driver", "impactQuote", "evidence", "method" ], "properties": { "driver": { "type": "string", "enum": [ "PRICE_PATH", "VOLATILITY", "FLOW", "LIQUIDITY", "UNLOCK", "GAS", "RESERVE" ] }, "impactQuote": { "$ref": "#/components/schemas/SignedAtomicAmount" }, "evidence": { "type": "string" }, "method": { "const": "DETERMINISTIC_COUNTERFACTUAL_DELTA_V1" } } } } } }, "minItems": 5, "maxItems": 5 }, "recommendedVariant": { "type": "string", "enum": [ "CURRENT", "RECOMMENDED", "CONSERVATIVE", "CAPITAL_EFFICIENT", "EMERGENCY" ] }, "warnings": { "type": "array", "items": { "type": "string" } }, "inputSnapshot": { "$ref": "#/components/schemas/SimulationStudyInputSnapshot" }, "sourceLineage": { "$ref": "#/components/schemas/SimulationStudySourceLineage" } } }, { "type": "object", "additionalProperties": false, "required": [ "engineVersion", "seed", "pathCount", "stepCount", "scenario", "variants", "recommendedVariant", "warnings", "state", "inputHash", "inputSnapshot", "sourceLineage" ], "properties": { "engineVersion": { "const": "digital-twin-pcg64-fixed-v2" }, "seed": { "type": "string" }, "pathCount": { "const": 10000 }, "stepCount": { "type": "integer", "minimum": 1, "maximum": 365 }, "scenario": { "$ref": "#/components/schemas/ScenarioDefinition" }, "variants": { "type": "array", "maxItems": 0, "items": {} }, "recommendedVariant": { "type": "null" }, "warnings": { "type": "array", "items": { "type": "string" } }, "state": { "const": "QUEUED" }, "inputHash": { "$ref": "#/components/schemas/Hash" }, "inputSnapshot": { "$ref": "#/components/schemas/SimulationStudyInputSnapshot" }, "sourceLineage": { "$ref": "#/components/schemas/SimulationStudySourceLineage" } } } ] }, "StrategyPackageSafetyEnvelope": { "type": "object", "additionalProperties": false, "required": [ "supportedAssetIds", "supportedVenueIds", "maximumCapitalQuote", "riskClass", "failureConditions", "safetyEnvelopeHash" ], "properties": { "supportedAssetIds": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 64 }, "supportedVenueIds": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 64 }, "maximumCapitalQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "riskClass": { "type": "string", "enum": [ "LOW", "MODERATE", "HIGH", "EXPERIMENTAL" ] }, "failureConditions": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 64 }, "safetyEnvelopeHash": { "$ref": "#/components/schemas/Hash" } } }, "StrategyPackageSourceLineage": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "sourcePackageId", "sourcePackageVersion", "sourcePackageResourceVersion", "sourcePackageArtifactHash", "sourcePackageSemanticVersion", "sourcePackageContentHash", "compilerHash", "approvalRegistryEvidenceHash", "supportedAssetIds", "supportedVenueIds", "maximumCapitalQuote", "riskClass", "failureConditions", "safetyEnvelopeHash" ], "properties": { "schemaVersion": { "const": "strategy-package-source-lineage-v1" }, "sourcePackageId": { "type": "string" }, "sourcePackageVersion": { "type": "integer", "minimum": 1 }, "sourcePackageResourceVersion": { "$ref": "#/components/schemas/Hash" }, "sourcePackageArtifactHash": { "$ref": "#/components/schemas/Hash" }, "sourcePackageSemanticVersion": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:-[a-zA-Z0-9.-]+)?$" }, "sourcePackageContentHash": { "$ref": "#/components/schemas/Hash" }, "compilerHash": { "$ref": "#/components/schemas/Hash" }, "approvalRegistryEvidenceHash": { "$ref": "#/components/schemas/Hash" }, "supportedAssetIds": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 64 }, "supportedVenueIds": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 64 }, "maximumCapitalQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "riskClass": { "type": "string", "enum": [ "LOW", "MODERATE", "HIGH", "EXPERIMENTAL" ] }, "failureConditions": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 64 }, "safetyEnvelopeHash": { "$ref": "#/components/schemas/Hash" } } }, "StrategyDefinitionV2Input": { "type": "object", "additionalProperties": false, "required": [ "name", "family", "compilerVersion", "sleeves", "triggers", "cooldownSeconds", "maximumDailyTurnoverPips", "capitalLimitQuote", "oracleMaximumAgeSeconds", "worstCaseLossLimitPips" ], "properties": { "name": { "type": "string" }, "family": { "type": "string", "enum": [ "BOOTSTRAP", "MAINTAIN", "DIVERSIFY", "COMPOSED" ] }, "compilerVersion": { "const": "strategy-dsl-v1" }, "sleeves": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "id", "kind", "allocationPips", "lowerPriceOffsetPips", "upperPriceOffsetPips", "minimumCapitalQuote", "maximumCapitalQuote", "enabled" ], "properties": { "id": { "type": "string" }, "kind": { "type": "string", "enum": [ "CORE_LIQUIDITY", "DEFENSIVE_DOWNSIDE", "UPSIDE_SELLING", "STABLE_RESERVE", "EMERGENCY_RESERVE" ] }, "allocationPips": { "$ref": "#/components/schemas/Pips" }, "lowerPriceOffsetPips": { "type": "integer" }, "upperPriceOffsetPips": { "type": "integer" }, "minimumCapitalQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "maximumCapitalQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "enabled": { "type": "boolean" } } }, "minItems": 1 }, "triggers": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "id", "metric", "operator", "threshold", "response" ], "properties": { "id": { "type": "string" }, "metric": { "type": "string", "enum": [ "PRICE", "INVENTORY", "DEPTH", "VOLATILITY", "ORACLE_HEALTH", "TIME" ] }, "operator": { "type": "string", "enum": [ "LT", "LTE", "GT", "GTE", "EQ" ] }, "threshold": { "type": "string" }, "response": { "type": "string", "enum": [ "RECOMMEND", "PREPARE", "TIGHTEN", "PAUSE" ] } } } }, "cooldownSeconds": { "type": "integer", "minimum": 0 }, "maximumDailyTurnoverPips": { "$ref": "#/components/schemas/Pips" }, "minimumPriceX18": { "$ref": "#/components/schemas/AtomicAmount" }, "capitalLimitQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "oracleMaximumAgeSeconds": { "type": "integer", "minimum": 1 }, "worstCaseLossLimitPips": { "$ref": "#/components/schemas/Pips" }, "legacyStrategyVersion": { "type": "string" } } }, "StrategyDefinitionV2": { "type": "object", "additionalProperties": false, "required": [ "name", "family", "compilerVersion", "sleeves", "triggers", "cooldownSeconds", "maximumDailyTurnoverPips", "capitalLimitQuote", "oracleMaximumAgeSeconds", "worstCaseLossLimitPips" ], "properties": { "name": { "type": "string" }, "family": { "type": "string", "enum": [ "BOOTSTRAP", "MAINTAIN", "DIVERSIFY", "COMPOSED" ] }, "compilerVersion": { "const": "strategy-dsl-v1" }, "sleeves": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "id", "kind", "allocationPips", "lowerPriceOffsetPips", "upperPriceOffsetPips", "minimumCapitalQuote", "maximumCapitalQuote", "enabled" ], "properties": { "id": { "type": "string" }, "kind": { "type": "string", "enum": [ "CORE_LIQUIDITY", "DEFENSIVE_DOWNSIDE", "UPSIDE_SELLING", "STABLE_RESERVE", "EMERGENCY_RESERVE" ] }, "allocationPips": { "$ref": "#/components/schemas/Pips" }, "lowerPriceOffsetPips": { "type": "integer" }, "upperPriceOffsetPips": { "type": "integer" }, "minimumCapitalQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "maximumCapitalQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "enabled": { "type": "boolean" } } }, "minItems": 1 }, "triggers": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "id", "metric", "operator", "threshold", "response" ], "properties": { "id": { "type": "string" }, "metric": { "type": "string", "enum": [ "PRICE", "INVENTORY", "DEPTH", "VOLATILITY", "ORACLE_HEALTH", "TIME" ] }, "operator": { "type": "string", "enum": [ "LT", "LTE", "GT", "GTE", "EQ" ] }, "threshold": { "type": "string" }, "response": { "type": "string", "enum": [ "RECOMMEND", "PREPARE", "TIGHTEN", "PAUSE" ] } } } }, "cooldownSeconds": { "type": "integer", "minimum": 0 }, "maximumDailyTurnoverPips": { "$ref": "#/components/schemas/Pips" }, "minimumPriceX18": { "$ref": "#/components/schemas/AtomicAmount" }, "capitalLimitQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "oracleMaximumAgeSeconds": { "type": "integer", "minimum": 1 }, "worstCaseLossLimitPips": { "$ref": "#/components/schemas/Pips" }, "legacyStrategyVersion": { "type": "string" }, "sourcePackage": { "$ref": "#/components/schemas/StrategyPackageSourceLineage" } } }, "StrategyProposalAdmission": { "type": "object", "additionalProperties": false, "required": [ "admissionVersion", "strategyDefinitionId", "strategyDefinitionVersion", "strategyDefinitionResourceVersion", "strategyDefinitionArtifactHash", "issuerIntentId", "issuerIntentVersion", "issuerIntentResourceVersion", "issuerIntentArtifactHash", "simulationStudyId", "simulationStudyVersion", "simulationStudyResourceVersion", "simulationStudyArtifactHash", "policyIntentDraftId", "policyIntentDraftVersion", "policyIntentDraftResourceVersion", "policyIntentDraftArtifactHash", "oracleProviderId", "oracleProviderResourceVersion", "oracleProviderAttestationHash", "oracleObservation", "checks", "valid", "validatedAt", "validUntil", "evidenceHashes" ], "properties": { "admissionVersion": { "const": "strategy-proposal-admission-v1" }, "strategyDefinitionId": { "type": "string" }, "strategyDefinitionVersion": { "type": "integer", "minimum": 1 }, "strategyDefinitionResourceVersion": { "$ref": "#/components/schemas/Hash" }, "strategyDefinitionArtifactHash": { "$ref": "#/components/schemas/Hash" }, "issuerIntentId": { "type": "string" }, "issuerIntentVersion": { "type": "integer", "minimum": 1 }, "issuerIntentResourceVersion": { "$ref": "#/components/schemas/Hash" }, "issuerIntentArtifactHash": { "$ref": "#/components/schemas/Hash" }, "simulationStudyId": { "type": "string" }, "simulationStudyVersion": { "type": "integer", "minimum": 1 }, "simulationStudyResourceVersion": { "$ref": "#/components/schemas/Hash" }, "simulationStudyArtifactHash": { "$ref": "#/components/schemas/Hash" }, "policyIntentDraftId": { "type": "string" }, "policyIntentDraftVersion": { "type": "integer", "minimum": 1 }, "policyIntentDraftResourceVersion": { "$ref": "#/components/schemas/Hash" }, "policyIntentDraftArtifactHash": { "$ref": "#/components/schemas/Hash" }, "oracleProviderId": { "type": "string" }, "oracleProviderResourceVersion": { "$ref": "#/components/schemas/Hash" }, "oracleProviderAttestationHash": { "$ref": "#/components/schemas/Hash" }, "oracleObservation": { "type": "object", "additionalProperties": false, "required": [ "observedAt", "payloadHash", "signature" ], "properties": { "observedAt": { "type": "string", "format": "date-time" }, "payloadHash": { "$ref": "#/components/schemas/Hash" }, "signature": { "type": "string" } } }, "checks": { "type": "object", "additionalProperties": false, "required": [ "ALLOCATION", "RANGE", "LIQUIDITY", "RESERVE", "ORACLE", "POLICY", "WORST_CASE", "COMPLETED_SIMULATION" ], "properties": { "ALLOCATION": { "type": "object", "additionalProperties": false, "required": [ "passed", "evidence" ], "properties": { "passed": { "type": "boolean" }, "evidence": { "type": "string" } } }, "RANGE": { "type": "object", "additionalProperties": false, "required": [ "passed", "evidence" ], "properties": { "passed": { "type": "boolean" }, "evidence": { "type": "string" } } }, "LIQUIDITY": { "type": "object", "additionalProperties": false, "required": [ "passed", "evidence" ], "properties": { "passed": { "type": "boolean" }, "evidence": { "type": "string" } } }, "RESERVE": { "type": "object", "additionalProperties": false, "required": [ "passed", "evidence" ], "properties": { "passed": { "type": "boolean" }, "evidence": { "type": "string" } } }, "ORACLE": { "type": "object", "additionalProperties": false, "required": [ "passed", "evidence" ], "properties": { "passed": { "type": "boolean" }, "evidence": { "type": "string" } } }, "POLICY": { "type": "object", "additionalProperties": false, "required": [ "passed", "evidence" ], "properties": { "passed": { "type": "boolean" }, "evidence": { "type": "string" } } }, "WORST_CASE": { "type": "object", "additionalProperties": false, "required": [ "passed", "evidence" ], "properties": { "passed": { "type": "boolean" }, "evidence": { "type": "string" } } }, "COMPLETED_SIMULATION": { "type": "object", "additionalProperties": false, "required": [ "passed", "evidence" ], "properties": { "passed": { "type": "boolean" }, "evidence": { "type": "string" } } } } }, "valid": { "type": "boolean" }, "validatedAt": { "type": "string", "format": "date-time" }, "validUntil": { "type": "string", "format": "date-time" }, "evidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" } }, "sourcePackage": { "$ref": "#/components/schemas/StrategyPackageSourceLineage" } } }, "ProposalWorkspace": { "type": "object", "additionalProperties": false, "required": [ "proposalId", "title", "rationale", "expectedImprovementQuote", "maximumDownsideQuote", "costOfNoActionQuote", "exactTokenFlows", "beforeDepthQuote", "afterDepthQuote", "simulationStudyId", "strategyDefinitionId", "strategyValidationEventId", "strategyValidationArtifactHash", "alternatives", "internalApprovalsRequired", "internalApprovals", "expiresAt" ], "properties": { "proposalId": { "type": "string" }, "title": { "type": "string" }, "rationale": { "type": "string" }, "trigger": { "type": "string", "minLength": 3, "maxLength": 500, "description": "User-authored proposal context, not verified source evidence. Whitespace is trimmed on input." }, "expectedImprovementQuote": { "$ref": "#/components/schemas/SignedAtomicAmount" }, "maximumDownsideQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "costOfNoActionQuote": { "$ref": "#/components/schemas/SignedAtomicAmount" }, "exactTokenFlows": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "token", "amount", "destination" ], "properties": { "token": { "$ref": "#/components/schemas/Address" }, "amount": { "$ref": "#/components/schemas/SignedAtomicAmount" }, "destination": { "$ref": "#/components/schemas/Address" } } } }, "beforeDepthQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "afterDepthQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "simulationStudyId": { "type": "string" }, "strategyDefinitionId": { "type": "string" }, "strategyValidationEventId": { "type": "string" }, "strategyValidationArtifactHash": { "$ref": "#/components/schemas/Hash" }, "alternatives": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "label", "outcomeQuote", "selected" ], "properties": { "label": { "type": "string" }, "outcomeQuote": { "$ref": "#/components/schemas/SignedAtomicAmount" }, "selected": { "type": "boolean" } } } }, "internalApprovalsRequired": { "type": "integer", "minimum": 0, "maximum": 20 }, "internalApprovals": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "actorId", "approvedAt", "evidenceHash" ], "properties": { "actorId": { "type": "string" }, "approvedAt": { "type": "string", "format": "date-time" }, "evidenceHash": { "$ref": "#/components/schemas/Hash" } } } }, "expiresAt": { "type": "string", "format": "date-time" }, "safeTransactionIntent": { "$ref": "#/components/schemas/ProposalSafeTransactionIntent" }, "safeTransactionHash": { "$ref": "#/components/schemas/Hash" } } }, "ProposalWorkspaceInput": { "type": "object", "additionalProperties": false, "required": [ "proposalId", "title", "rationale", "expectedImprovementQuote", "maximumDownsideQuote", "costOfNoActionQuote", "exactTokenFlows", "beforeDepthQuote", "afterDepthQuote", "simulationStudyId", "strategyDefinitionId", "strategyValidationEventId", "strategyValidationArtifactHash", "alternatives", "internalApprovalsRequired", "expiresAt" ], "properties": { "proposalId": { "type": "string" }, "title": { "type": "string" }, "rationale": { "type": "string" }, "trigger": { "type": "string", "minLength": 3, "maxLength": 500, "description": "User-authored proposal context, not verified source evidence. Whitespace is trimmed on input." }, "expectedImprovementQuote": { "$ref": "#/components/schemas/SignedAtomicAmount" }, "maximumDownsideQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "costOfNoActionQuote": { "$ref": "#/components/schemas/SignedAtomicAmount" }, "exactTokenFlows": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "token", "amount", "destination" ], "properties": { "token": { "$ref": "#/components/schemas/Address" }, "amount": { "$ref": "#/components/schemas/SignedAtomicAmount" }, "destination": { "$ref": "#/components/schemas/Address" } } } }, "beforeDepthQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "afterDepthQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "simulationStudyId": { "type": "string" }, "strategyDefinitionId": { "type": "string" }, "strategyValidationEventId": { "type": "string" }, "strategyValidationArtifactHash": { "$ref": "#/components/schemas/Hash" }, "alternatives": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "label", "outcomeQuote", "selected" ], "properties": { "label": { "type": "string" }, "outcomeQuote": { "$ref": "#/components/schemas/SignedAtomicAmount" }, "selected": { "type": "boolean" } } } }, "internalApprovalsRequired": { "type": "integer", "minimum": 0, "maximum": 20 }, "expiresAt": { "type": "string", "format": "date-time" }, "safeTransactionIntent": { "$ref": "#/components/schemas/ProposalSafeTransactionIntent" } } }, "LaunchTimelineEvent": { "type": "object", "additionalProperties": false, "required": [ "id", "kind", "scheduledAt", "reviewOwnerId", "dependsOn", "requiresReview", "status", "evidenceHashes" ], "properties": { "id": { "type": "string" }, "kind": { "type": "string", "enum": [ "PRE_LAUNCH_SIMULATION", "INITIAL_FUNDING", "TGE", "FIRST_24_HOURS", "FIRST_7_DAYS", "MAINTENANCE_TRANSITION", "EXCHANGE_LISTING", "INCENTIVE_CHANGE", "TOKEN_UNLOCK", "TREASURY_DIVERSIFICATION" ] }, "scheduledAt": { "type": "string", "format": "date-time" }, "reviewOwnerId": { "type": "string" }, "dependsOn": { "type": "array", "items": { "type": "string" } }, "requiresReview": { "type": "boolean" }, "status": { "type": "string", "enum": [ "PLANNED", "READY", "IN_REVIEW", "COMPLETED", "BLOCKED", "CANCELLED" ] }, "evidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" } }, "recommendationTrigger": { "type": "string" }, "reminderLeadSeconds": { "type": "integer", "minimum": 60 }, "completedAt": { "type": "string", "format": "date-time" }, "completionReceiptHash": { "$ref": "#/components/schemas/Hash" } } }, "LaunchTimelineEventCreate": { "type": "object", "additionalProperties": false, "required": [ "id", "kind", "scheduledAt", "reviewOwnerId", "dependsOn", "requiresReview", "status", "evidenceHashes" ], "properties": { "id": { "type": "string" }, "kind": { "type": "string", "enum": [ "PRE_LAUNCH_SIMULATION", "INITIAL_FUNDING", "TGE", "FIRST_24_HOURS", "FIRST_7_DAYS", "MAINTENANCE_TRANSITION", "EXCHANGE_LISTING", "INCENTIVE_CHANGE", "TOKEN_UNLOCK", "TREASURY_DIVERSIFICATION" ] }, "scheduledAt": { "type": "string", "format": "date-time" }, "reviewOwnerId": { "type": "string" }, "dependsOn": { "type": "array", "items": { "type": "string" } }, "requiresReview": { "type": "boolean" }, "status": { "const": "PLANNED" }, "evidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" } }, "recommendationTrigger": { "type": "string" }, "reminderLeadSeconds": { "type": "integer", "minimum": 60 } } }, "LaunchPlan": { "type": "object", "additionalProperties": false, "required": [ "calculationVersion", "inputSnapshot", "inputHash", "name", "tokenSupply", "treasuryAllocation", "launchValuationQuote", "liquidityBudgetQuote", "expectedInitialDemandQuote", "targetTradeSizeQuote", "maximumInitialSlippagePips", "acceptableInitialVolatilityPips", "initialPriceX18", "unlocks", "recommendedInitialLiquidityQuote", "initialPriceLowerX18", "initialPriceUpperX18", "requiredReserveQuote", "bootstrapPhases", "maintenanceTransition", "emergencyPlaybook", "timeline" ], "properties": { "calculationVersion": { "const": "launch-plan-v2" }, "inputSnapshot": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "name", "tokenSupply", "treasuryAllocation", "launchValuationQuote", "liquidityBudgetQuote", "expectedInitialDemandQuote", "targetTradeSizeQuote", "maximumInitialSlippagePips", "acceptableInitialVolatilityPips", "initialPriceX18", "unlocks", "reviewOwnerId", "launchAt" ], "properties": { "schemaVersion": { "const": "launch-plan-input-v1" }, "name": { "type": "string", "minLength": 3, "maxLength": 160 }, "tokenSupply": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "treasuryAllocation": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "launchValuationQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "liquidityBudgetQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "expectedInitialDemandQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "targetTradeSizeQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "maximumInitialSlippagePips": { "type": "integer", "minimum": 1, "maximum": 1000000, "description": "Strictly positive parts per million. 1,000,000 equals 100%." }, "acceptableInitialVolatilityPips": { "$ref": "#/components/schemas/Pips" }, "initialPriceX18": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "unlocks": { "type": "array", "items": { "$ref": "#/components/schemas/UnlockTranche" }, "maxItems": 256 }, "reviewOwnerId": { "type": "string", "format": "uuid" }, "launchAt": { "type": "string", "format": "date-time" } } }, "inputHash": { "$ref": "#/components/schemas/Hash" }, "name": { "type": "string", "minLength": 3, "maxLength": 160 }, "tokenSupply": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "treasuryAllocation": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "launchValuationQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "liquidityBudgetQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "expectedInitialDemandQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "targetTradeSizeQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "maximumInitialSlippagePips": { "type": "integer", "minimum": 1, "maximum": 1000000, "description": "Strictly positive parts per million. 1,000,000 equals 100%." }, "acceptableInitialVolatilityPips": { "$ref": "#/components/schemas/Pips" }, "initialPriceX18": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "unlocks": { "type": "array", "items": { "$ref": "#/components/schemas/UnlockTranche" }, "maxItems": 256 }, "recommendedInitialLiquidityQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "initialPriceLowerX18": { "$ref": "#/components/schemas/AtomicAmount" }, "initialPriceUpperX18": { "$ref": "#/components/schemas/AtomicAmount" }, "requiredReserveQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "bootstrapPhases": { "type": "array", "items": { "type": "string" } }, "maintenanceTransition": { "type": "array", "items": { "type": "string" } }, "emergencyPlaybook": { "type": "array", "items": { "type": "string" } }, "timeline": { "type": "array", "items": { "$ref": "#/components/schemas/LaunchTimelineEvent" }, "minItems": 6, "maxItems": 262 } } }, "UnlockImpactLaunchBinding": { "type": "object", "additionalProperties": false, "required": [ "id", "version", "resourceVersion", "artifactHash" ], "properties": { "id": { "type": "string" }, "version": { "type": "integer", "minimum": 1 }, "resourceVersion": { "$ref": "#/components/schemas/Hash" }, "artifactHash": { "$ref": "#/components/schemas/Hash" } } }, "UnlockImpactInputSnapshot": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "unlocks", "sourceLaunchPlan", "sourceObservation" ], "properties": { "schemaVersion": { "const": "unlock-impact-input-snapshot-v1" }, "unlocks": { "type": "array", "items": { "$ref": "#/components/schemas/UnlockTranche" }, "minItems": 1, "maxItems": 256 }, "sourceLaunchPlan": { "oneOf": [ { "$ref": "#/components/schemas/UnlockImpactLaunchBinding" }, { "type": "null" } ] }, "sourceObservation": { "$ref": "#/components/schemas/UnlockImpactSourceObservation" } } }, "MarketQualityObservationMetrics": { "type": "object", "additionalProperties": false, "required": [ "targetTradeSizeQuote", "spreadPips", "concentrationPips", "volatilityImpactPips", "inventoryRiskPips", "imbalancePips", "recoverySeconds", "recoveryTargetSeconds" ], "properties": { "targetTradeSizeQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "spreadPips": { "$ref": "#/components/schemas/Pips" }, "concentrationPips": { "$ref": "#/components/schemas/Pips" }, "volatilityImpactPips": { "$ref": "#/components/schemas/Pips" }, "inventoryRiskPips": { "$ref": "#/components/schemas/Pips" }, "imbalancePips": { "$ref": "#/components/schemas/Pips" }, "recoverySeconds": { "type": "integer", "minimum": 0, "maximum": 86400 }, "recoveryTargetSeconds": { "type": "integer", "minimum": 1, "maximum": 86400 } } }, "MarketQualityRawMetrics": { "type": "object", "additionalProperties": false, "required": [], "properties": { "targetTradeSizeQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "usableDepthQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "deployedCapitalQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "activeCapitalQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "slippagePips": { "$ref": "#/components/schemas/Pips" }, "spreadPips": { "$ref": "#/components/schemas/Pips" }, "concentrationPips": { "$ref": "#/components/schemas/Pips" }, "volatilityImpactPips": { "$ref": "#/components/schemas/Pips" }, "inventoryRiskPips": { "$ref": "#/components/schemas/Pips" }, "imbalancePips": { "$ref": "#/components/schemas/Pips" }, "recoverySeconds": { "type": "integer", "minimum": 0, "maximum": 86400 }, "recoveryTargetSeconds": { "type": "integer", "minimum": 1, "maximum": 86400 }, "reliabilityPips": { "$ref": "#/components/schemas/Pips" } } }, "MarketQualityVenueSourceBinding": { "type": "object", "additionalProperties": false, "required": [ "recordId", "observationId", "version", "resourceVersion", "artifactHash", "evidenceHash", "sourceProfileArtifactHash", "providerPayloadHash", "capturedAt" ], "properties": { "recordId": { "type": "string" }, "observationId": { "type": "string" }, "version": { "type": "integer", "minimum": 1 }, "resourceVersion": { "$ref": "#/components/schemas/Hash" }, "artifactHash": { "$ref": "#/components/schemas/Hash" }, "evidenceHash": { "$ref": "#/components/schemas/Hash" }, "sourceProfileArtifactHash": { "$ref": "#/components/schemas/Hash" }, "providerPayloadHash": { "$ref": "#/components/schemas/Hash" }, "capturedAt": { "type": "string", "format": "date-time" } } }, "MarketQualityExecutionSourceBinding": { "type": "object", "additionalProperties": false, "required": [ "recordId", "proposalId", "version", "resourceVersion", "artifactHash", "finalizedAt" ], "properties": { "recordId": { "type": "string" }, "proposalId": { "type": "string" }, "version": { "type": "integer", "minimum": 1 }, "resourceVersion": { "$ref": "#/components/schemas/Hash" }, "artifactHash": { "$ref": "#/components/schemas/Hash" }, "finalizedAt": { "type": "string", "format": "date-time" } } }, "MarketQualityCohortSourceBinding": { "type": "object", "additionalProperties": false, "required": [ "providerId", "providerResourceVersion", "providerAttestationHash", "cohortDefinitionId", "cohortDefinitionHash", "observedAt", "issuers", "signature", "evidenceHash" ], "properties": { "providerId": { "type": "string" }, "providerResourceVersion": { "$ref": "#/components/schemas/Hash" }, "providerAttestationHash": { "$ref": "#/components/schemas/Hash" }, "cohortDefinitionId": { "type": "string" }, "cohortDefinitionHash": { "$ref": "#/components/schemas/Hash" }, "observedAt": { "type": "string", "format": "date-time" }, "issuers": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "issuerCommitmentHash", "score", "eligibilityEvidenceHash" ], "properties": { "issuerCommitmentHash": { "$ref": "#/components/schemas/Hash" }, "score": { "type": "integer", "minimum": 0, "maximum": 100 }, "eligibilityEvidenceHash": { "$ref": "#/components/schemas/Hash" } } }, "minItems": 10, "maxItems": 10000 }, "signature": { "type": "string", "contentEncoding": "base64" }, "evidenceHash": { "$ref": "#/components/schemas/Hash" } } }, "MarketQualityVaultSourceBinding": { "type": "object", "additionalProperties": false, "required": [ "vaultId", "qualificationArtifactHash", "poolAddress", "projectToken", "quoteToken", "venueId", "chainId" ], "properties": { "vaultId": { "type": "string" }, "qualificationArtifactHash": { "$ref": "#/components/schemas/Hash" }, "poolAddress": { "$ref": "#/components/schemas/Address" }, "projectToken": { "$ref": "#/components/schemas/Address" }, "quoteToken": { "$ref": "#/components/schemas/Address" }, "venueId": { "type": "string" }, "chainId": { "type": "integer", "minimum": 1 } } }, "MarketQualityPriorScoreSourceBinding": { "type": "object", "additionalProperties": false, "required": [ "recordId", "version", "resourceVersion", "artifactHash", "capturedAt", "componentScoresHash" ], "properties": { "recordId": { "type": "string" }, "version": { "type": "integer", "minimum": 1 }, "resourceVersion": { "$ref": "#/components/schemas/Hash" }, "artifactHash": { "$ref": "#/components/schemas/Hash" }, "capturedAt": { "type": "string", "format": "date-time" }, "componentScoresHash": { "$ref": "#/components/schemas/Hash" } } }, "MarketQualitySourceBindings": { "type": "object", "additionalProperties": false, "required": [ "vault", "venueObservations", "executionAttributions" ], "properties": { "vault": { "$ref": "#/components/schemas/MarketQualityVaultSourceBinding" }, "venueObservations": { "type": "array", "items": { "$ref": "#/components/schemas/MarketQualityVenueSourceBinding" }, "minItems": 1, "maxItems": 64 }, "executionAttributions": { "type": "array", "items": { "$ref": "#/components/schemas/MarketQualityExecutionSourceBinding" }, "maxItems": 64 }, "cohortEvidence": { "$ref": "#/components/schemas/MarketQualityCohortSourceBinding" }, "priorScore": { "$ref": "#/components/schemas/MarketQualityPriorScoreSourceBinding" } } }, "MarketQualityScore": { "type": "object", "additionalProperties": false, "required": [ "scoreVersion", "vaultId", "capturedAt", "availability", "coveragePips", "components", "changeDrivers", "improvements" ], "properties": { "scoreVersion": { "type": "string", "enum": [ "market-quality-score-v1", "market-quality-score-v2" ] }, "vaultId": { "type": "string" }, "capturedAt": { "type": "string", "format": "date-time" }, "rawMetrics": { "$ref": "#/components/schemas/MarketQualityRawMetrics" }, "sourceBindings": { "$ref": "#/components/schemas/MarketQualitySourceBindings" }, "inputHash": { "$ref": "#/components/schemas/Hash" }, "availability": { "type": "string", "enum": [ "AVAILABLE", "UNAVAILABLE" ] }, "score": { "type": "integer", "minimum": 0, "maximum": 100 }, "coveragePips": { "$ref": "#/components/schemas/Pips" }, "components": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "component", "weightPips", "evidenceHashes" ], "properties": { "component": { "type": "string", "enum": [ "SLIPPAGE", "USABLE_DEPTH", "SPREAD", "CAPITAL_EFFICIENCY", "CONCENTRATION", "VOLATILITY_RESISTANCE", "INVENTORY_RISK", "IMBALANCE", "PRICE_RECOVERY", "RELIABILITY" ] }, "weightPips": { "$ref": "#/components/schemas/Pips" }, "score": { "type": "integer", "minimum": 0, "maximum": 100 }, "evidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" } } } } }, "changeDrivers": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "component", "delta" ], "properties": { "component": { "type": "string", "enum": [ "SLIPPAGE", "USABLE_DEPTH", "SPREAD", "CAPITAL_EFFICIENCY", "CONCENTRATION", "VOLATILITY_RESISTANCE", "INVENTORY_RISK", "IMBALANCE", "PRICE_RECOVERY", "RELIABILITY" ] }, "delta": { "type": "integer" } } } }, "improvements": { "type": "array", "items": { "type": "string" } }, "peerBenchmark": { "type": "object", "additionalProperties": false, "required": [ "cohortDefinition", "cohortSize", "percentile" ], "properties": { "cohortDefinition": { "type": "string" }, "cohortSize": { "type": "integer", "minimum": 10 }, "percentile": { "type": "integer", "minimum": 0, "maximum": 100 } } }, "unavailableReason": { "type": "string" } } }, "ExecutionAttribution": { "type": "object", "additionalProperties": false, "required": [ "attributionVersion", "proposalId", "transactionHash", "finalizedAt", "observationHorizonsComplete", "sourceSimulationStudyId", "frozenForecastArtifactHash", "finalityEvidenceHash", "reconciliationEvidenceHash", "observationHorizons", "metrics", "adverseSelectionQuote", "noActionCounterfactualQuote", "realizedOutcomeQuote", "calibrationResidualHash", "evidenceHashes" ], "properties": { "attributionVersion": { "const": "execution-attribution-v1" }, "proposalId": { "type": "string" }, "transactionHash": { "$ref": "#/components/schemas/Hash" }, "finalizedAt": { "type": "string", "format": "date-time" }, "observationHorizonsComplete": { "type": "boolean" }, "sourceSimulationStudyId": { "type": "string" }, "frozenForecastArtifactHash": { "$ref": "#/components/schemas/Hash" }, "finalityEvidenceHash": { "$ref": "#/components/schemas/Hash" }, "reconciliationEvidenceHash": { "$ref": "#/components/schemas/Hash" }, "observationHorizons": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "kind", "endedAt", "evidenceHash" ], "properties": { "kind": { "type": "string", "enum": [ "IMMEDIATE", "ADVERSE_SELECTION", "RECOVERY" ] }, "endedAt": { "type": "string", "format": "date-time" }, "evidenceHash": { "$ref": "#/components/schemas/Hash" } } } }, "metrics": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "metric", "predicted", "realized", "residual", "unit" ], "properties": { "metric": { "type": "string", "enum": [ "SLIPPAGE", "FEES", "GAS", "INVENTORY", "CAPITAL_EFFICIENCY", "PRICE_MOVEMENT" ] }, "predicted": { "$ref": "#/components/schemas/SignedAtomicAmount" }, "realized": { "$ref": "#/components/schemas/SignedAtomicAmount" }, "residual": { "$ref": "#/components/schemas/SignedAtomicAmount" }, "unit": { "type": "string", "enum": [ "QUOTE_ATOMIC", "TOKEN_ATOMIC", "PIPS" ] } } } }, "adverseSelectionQuote": { "$ref": "#/components/schemas/SignedAtomicAmount" }, "noActionCounterfactualQuote": { "$ref": "#/components/schemas/SignedAtomicAmount" }, "realizedOutcomeQuote": { "$ref": "#/components/schemas/SignedAtomicAmount" }, "calibrationResidualHash": { "$ref": "#/components/schemas/Hash" }, "evidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" } } } }, "Anomaly": { "type": "object", "additionalProperties": false, "required": [ "detectorVersion", "subject", "evaluatedAt", "currentObservation", "kind", "detected", "severity", "median", "medianAbsoluteDeviation", "deviationMultiplesPips", "coveragePips", "explanation", "responses", "evidenceHashes" ], "properties": { "detectorVersion": { "const": "robust-mad-v1" }, "subject": { "type": "object", "additionalProperties": false, "required": [ "kind", "vaultId" ], "properties": { "kind": { "const": "VAULT" }, "vaultId": { "type": "string" } } }, "evaluatedAt": { "type": "string", "format": "date-time" }, "currentObservation": { "type": "object", "additionalProperties": false, "required": [ "capturedAt", "value", "evidenceHash" ], "properties": { "capturedAt": { "type": "string", "format": "date-time" }, "value": { "$ref": "#/components/schemas/SignedAtomicAmount" }, "evidenceHash": { "$ref": "#/components/schemas/Hash" } } }, "inputHash": { "$ref": "#/components/schemas/Hash" }, "derivationHash": { "$ref": "#/components/schemas/Hash" }, "sourceProvider": { "type": "object", "additionalProperties": false, "required": [ "providerId", "providerResourceVersion", "providerAttestationHash", "observedAt", "payloadHash", "signature" ], "properties": { "providerId": { "type": "string" }, "providerResourceVersion": { "$ref": "#/components/schemas/Hash" }, "providerAttestationHash": { "$ref": "#/components/schemas/Hash" }, "observedAt": { "type": "string", "format": "date-time" }, "payloadHash": { "$ref": "#/components/schemas/Hash" }, "signature": { "type": "string", "contentEncoding": "base64" } } }, "kind": { "type": "string", "enum": [ "LIQUIDITY_DISAPPEARANCE", "ONE_SIDED_FLOW", "INACTIVE_RANGE", "STABLECOIN_DEPEG", "ORACLE_DISAGREEMENT", "INVENTORY_ACCUMULATION", "EXCESSIVE_TURNOVER", "MANIPULATION_INDICATOR", "SIMULATED_REALIZED_DIVERGENCE" ] }, "detected": { "type": "boolean" }, "severity": { "type": "string", "enum": [ "INFO", "WARNING", "CRITICAL" ] }, "median": { "$ref": "#/components/schemas/SignedAtomicAmount" }, "medianAbsoluteDeviation": { "$ref": "#/components/schemas/AtomicAmount" }, "deviationMultiplesPips": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "coveragePips": { "$ref": "#/components/schemas/Pips" }, "explanation": { "type": "string" }, "responses": { "type": "array", "items": { "type": "string", "enum": [ "MONITOR", "TIGHTEN_POLICY", "PREPARE_REBALANCE", "PROTECT_RESERVE", "PAUSE" ] }, "minItems": 1, "maxItems": 5 }, "evidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "maxItems": 256 } } }, "TreasuryBucket": { "type": "object", "additionalProperties": false, "required": [ "entryId", "bucket", "state", "asset", "amountAtomic", "valueQuote", "sourceKind", "sourceId", "sourceObservationId", "capitalContainerId", "custodyLocationId", "obligationIds", "futureCommittedValueQuote", "oracleSourceId", "oracleProviderResourceVersion", "oracleAttestationHash", "oracleEvidenceHash", "oracleSignature", "oracleObservedAt", "oracleMaximumAgeSeconds", "oracleConfidencePips", "bridgeHaircutPips", "counterpartyHaircutPips", "effectiveAt", "evidenceHash", "reconciliationEvidenceHash" ], "properties": { "entryId": { "type": "string" }, "bucket": { "type": "string", "enum": [ "OPERATING_RESERVE", "EMERGENCY_RESERVE", "LIQUIDITY_CAPITAL", "DIVERSIFICATION_CAPITAL", "INCENTIVE_BUDGET", "STRATEGIC_RESERVE" ] }, "state": { "type": "string", "enum": [ "AVAILABLE", "DEPLOYED", "LOCKED", "AT_RISK", "FEE_GENERATING", "FUTURE_COMMITTED" ] }, "asset": { "$ref": "#/components/schemas/Address" }, "amountAtomic": { "$ref": "#/components/schemas/AtomicAmount" }, "valueQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "sourceKind": { "type": "string", "enum": [ "SAFE", "VAULT", "EXTERNAL_MANAGER", "SIGNED_OBLIGATION" ] }, "sourceId": { "type": "string" }, "sourceObservationId": { "type": "string" }, "capitalContainerId": { "type": "string" }, "custodyLocationId": { "type": "string" }, "obligationIds": { "type": "array", "items": { "type": "string" } }, "futureCommittedValueQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "oracleSourceId": { "type": "string" }, "oracleProviderResourceVersion": { "$ref": "#/components/schemas/Hash" }, "oracleAttestationHash": { "$ref": "#/components/schemas/Hash" }, "oracleEvidenceHash": { "$ref": "#/components/schemas/Hash" }, "oracleSignature": { "type": "string", "contentEncoding": "base64" }, "oracleObservedAt": { "type": "string", "format": "date-time" }, "oracleMaximumAgeSeconds": { "type": "integer", "minimum": 1, "maximum": 86400 }, "oracleConfidencePips": { "$ref": "#/components/schemas/Pips" }, "bridgeHaircutPips": { "$ref": "#/components/schemas/Pips" }, "counterpartyHaircutPips": { "$ref": "#/components/schemas/Pips" }, "effectiveAt": { "type": "string", "format": "date-time" }, "evidenceHash": { "$ref": "#/components/schemas/Hash" }, "reconciliationEvidenceHash": { "$ref": "#/components/schemas/Hash" } } }, "TreasurySummary": { "type": "object", "additionalProperties": false, "required": [ "ledgerVersion", "capturedAt", "grossValueQuote", "riskAdjustedValueQuote", "futureCommittedValueQuote", "uncommittedValueQuote", "buckets", "assets", "containers", "duplicateSourceIds", "duplicateEconomicKeys", "staleEntryIds", "invalidEntryIds", "conservation", "complete", "warnings" ], "properties": { "ledgerVersion": { "type": "string", "enum": [ "treasury-ledger-v1", "treasury-ledger-v2" ] }, "capturedAt": { "type": "string", "format": "date-time" }, "grossValueQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "riskAdjustedValueQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "futureCommittedValueQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "uncommittedValueQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "buckets": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "bucket", "grossValueQuote", "riskAdjustedValueQuote", "futureCommittedValueQuote", "uncommittedValueQuote", "byState" ], "properties": { "bucket": { "type": "string", "enum": [ "OPERATING_RESERVE", "EMERGENCY_RESERVE", "LIQUIDITY_CAPITAL", "DIVERSIFICATION_CAPITAL", "INCENTIVE_BUDGET", "STRATEGIC_RESERVE" ] }, "grossValueQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "riskAdjustedValueQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "futureCommittedValueQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "uncommittedValueQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "byState": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/AtomicAmount" } } } } }, "assets": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "asset", "grossValueQuote", "riskAdjustedValueQuote", "futureCommittedValueQuote", "uncommittedValueQuote" ], "properties": { "asset": { "$ref": "#/components/schemas/Address" }, "grossValueQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "riskAdjustedValueQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "futureCommittedValueQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "uncommittedValueQuote": { "$ref": "#/components/schemas/AtomicAmount" } } } }, "containers": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "capitalContainerId", "custodyLocationId", "asset", "bucket", "state", "grossValueQuote", "futureCommittedValueQuote", "obligationIds", "sourceObservationId" ], "properties": { "capitalContainerId": { "type": "string" }, "custodyLocationId": { "type": "string" }, "asset": { "$ref": "#/components/schemas/Address" }, "bucket": { "type": "string" }, "state": { "type": "string" }, "grossValueQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "futureCommittedValueQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "obligationIds": { "type": "array", "items": { "type": "string" } }, "sourceObservationId": { "type": "string" } } } }, "duplicateSourceIds": { "type": "array", "items": { "type": "string" } }, "duplicateEconomicKeys": { "type": "array", "items": { "type": "string" } }, "staleEntryIds": { "type": "array", "items": { "type": "string" } }, "invalidEntryIds": { "type": "array", "items": { "type": "string" } }, "conservation": { "type": "object", "additionalProperties": false, "required": [ "bucketGrossValueQuote", "assetGrossValueQuote", "containerGrossValueQuote", "stateGrossValueQuote", "committedOverlayValueQuote", "conserved" ], "properties": { "bucketGrossValueQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "assetGrossValueQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "containerGrossValueQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "stateGrossValueQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "committedOverlayValueQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "conserved": { "type": "boolean" }, "evidenceHash": { "$ref": "#/components/schemas/Hash" } } }, "complete": { "type": "boolean" }, "warnings": { "type": "array", "items": { "type": "string" } } } }, "TreasuryStressStudy": { "type": "object", "additionalProperties": false, "required": [ "stressSuiteVersion", "evaluatedAt", "launchPlanId", "vaultId", "policyControlEpoch", "policyLevel", "ledgerEvidenceHashes", "unlockScheduleHash", "unlockImpactId", "unlockImpactResourceVersion", "unlockImpactArtifactHash", "policyArtifactHash", "results", "allSevenShocksApplied", "executionAuthorityGranted" ], "properties": { "stressSuiteVersion": { "const": "treasury-stress-suite-v1" }, "evaluatedAt": { "type": "string", "format": "date-time" }, "launchPlanId": { "type": "string" }, "vaultId": { "type": "string" }, "policyControlEpoch": { "$ref": "#/components/schemas/AtomicAmount" }, "policyLevel": { "type": "integer", "enum": [ 0, 1, 2, 3, 4 ] }, "ledgerEvidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" } }, "unlockScheduleHash": { "$ref": "#/components/schemas/Hash" }, "unlockImpactId": { "type": "string" }, "unlockImpactResourceVersion": { "$ref": "#/components/schemas/Hash" }, "unlockImpactArtifactHash": { "$ref": "#/components/schemas/Hash" }, "policyArtifactHash": { "$ref": "#/components/schemas/Hash" }, "results": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "stressVersion", "kind", "startingRiskAdjustedValueQuote", "stressedRiskAdjustedValueQuote", "lossQuote", "reserveSufficient", "runwayDays", "bucketBreaches", "liquidationCostQuote", "mitigations" ], "properties": { "stressVersion": { "type": "string", "enum": [ "treasury-stress-v1", "treasury-stress-v2" ] }, "kind": { "type": "string", "enum": [ "TOKEN_PRICE_FALL_50", "STABLECOIN_DEPEG", "MAJOR_HOLDER_SELL", "LP_WITHDRAWAL", "EXCHANGE_DELISTING", "RUNWAY_DETERIORATION", "SIMULTANEOUS_UNLOCKS" ] }, "startingRiskAdjustedValueQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "stressedRiskAdjustedValueQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "lossQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "reserveSufficient": { "type": "boolean" }, "runwayDays": { "type": "integer" }, "bucketBreaches": { "type": "array", "items": { "type": "string" } }, "liquidationCostQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "mitigations": { "type": "array", "items": { "type": "string" } }, "policyLevel": { "type": "integer", "enum": [ 0, 1, 2, 3, 4 ] }, "shockMagnitudePips": { "$ref": "#/components/schemas/Pips" }, "unlockSellPressureQuote": { "$ref": "#/components/schemas/AtomicAmount" } } } }, "allSevenShocksApplied": { "const": true }, "executionAuthorityGranted": { "const": false } } }, "VenueProfile": { "type": "object", "additionalProperties": false, "required": [ "venueId", "chainId", "name", "kind", "writeAuthority", "finalityBlocks", "reliabilityPips", "exitCostPips", "attestationHash" ], "properties": { "venueId": { "type": "string" }, "chainId": { "type": "integer", "minimum": 1 }, "name": { "type": "string" }, "kind": { "type": "string", "enum": [ "BDEX_V3", "EVM_V3", "EXTERNAL_MANAGER", "TREASURY_RESERVE" ] }, "writeAuthority": { "type": "string", "enum": [ "AUDITED_TYPED_ADAPTER", "READ_ONLY" ] }, "factoryAddress": { "$ref": "#/components/schemas/Address" }, "adapterRegistryAddress": { "$ref": "#/components/schemas/Address" }, "adapterAddress": { "$ref": "#/components/schemas/Address" }, "asset0": { "$ref": "#/components/schemas/Address" }, "asset1": { "$ref": "#/components/schemas/Address" }, "adapterRuntimeHash": { "$ref": "#/components/schemas/Hash" }, "controllerVenueId": { "$ref": "#/components/schemas/Hash" }, "poolHealthGuardAddress": { "$ref": "#/components/schemas/Address" }, "maximumTwapDeviationPips": { "$ref": "#/components/schemas/Pips" }, "maximumPositionWidthTicks": { "type": "integer", "minimum": 1, "maximum": 1774544 }, "allowedActions": { "type": "array", "items": { "type": "boolean" }, "minItems": 7, "maxItems": 7 }, "finalityBlocks": { "type": "integer", "minimum": 1, "maximum": 10000 }, "reliabilityPips": { "$ref": "#/components/schemas/Pips" }, "exitCostPips": { "$ref": "#/components/schemas/Pips" }, "attestationHash": { "$ref": "#/components/schemas/Hash" } } }, "VenueRpcQuorumAttestation": { "type": "object", "additionalProperties": false, "required": [ "providerId", "providerKeyResourceVersion", "providerAttestationHash", "memberId", "endpointId", "chainId", "chainGenesisHash", "finalizedBlockNumber", "finalizedBlockHash", "observationFactsHash", "observedAt", "signature" ], "properties": { "providerId": { "type": "string" }, "providerKeyResourceVersion": { "$ref": "#/components/schemas/Hash" }, "providerAttestationHash": { "$ref": "#/components/schemas/Hash" }, "memberId": { "type": "string" }, "endpointId": { "type": "string" }, "chainId": { "type": "integer", "minimum": 1 }, "chainGenesisHash": { "$ref": "#/components/schemas/Hash" }, "finalizedBlockNumber": { "$ref": "#/components/schemas/AtomicAmount" }, "finalizedBlockHash": { "$ref": "#/components/schemas/Hash" }, "observationFactsHash": { "$ref": "#/components/schemas/Hash" }, "observedAt": { "type": "string", "format": "date-time" }, "signature": { "type": "string" } } }, "VenueRpcQuorumVerification": { "type": "object", "additionalProperties": false, "required": [ "verifierVersion", "status", "verifiedAt", "providerIds", "memberIds", "endpointIds", "chainId", "chainGenesisHash", "finalizedBlockNumber", "finalizedBlockHash", "observationFactsHash", "agreementHash", "failureReasons" ], "properties": { "verifierVersion": { "type": "string", "enum": [ "external-evm-rpc-quorum-v1", "onchain-market-maker-rpc-quorum-v1" ] }, "status": { "type": "string", "enum": [ "VERIFIED", "UNVERIFIED" ] }, "verifiedAt": { "type": "string", "format": "date-time" }, "providerIds": { "type": "array", "items": { "type": "string" } }, "memberIds": { "type": "array", "items": { "type": "string" } }, "endpointIds": { "type": "array", "items": { "type": "string" } }, "chainId": { "type": "integer", "minimum": 1 }, "chainGenesisHash": { "$ref": "#/components/schemas/Hash" }, "finalizedBlockNumber": { "$ref": "#/components/schemas/AtomicAmount" }, "finalizedBlockHash": { "$ref": "#/components/schemas/Hash" }, "observationFactsHash": { "$ref": "#/components/schemas/Hash" }, "agreementHash": { "$ref": "#/components/schemas/Hash" }, "failureReasons": { "type": "array", "items": { "type": "string", "enum": [ "INSUFFICIENT_ATTESTATIONS", "DUPLICATE_PROVIDER", "DUPLICATE_MEMBER", "DUPLICATE_ENDPOINT", "UNKNOWN_PROVIDER", "PROVIDER_NOT_HEALTHY", "PROVIDER_GENERATION_MISMATCH", "PROVIDER_ATTESTATION_MISMATCH", "PROVIDER_SCOPE_MISMATCH", "STALE_ATTESTATION", "FUTURE_ATTESTATION", "CHAIN_MISMATCH", "GENESIS_MISMATCH", "FINALIZED_BLOCK_MISMATCH", "OBSERVATION_FACTS_MISMATCH", "INVALID_SIGNATURE" ] } } } }, "ProviderGatewayResponse": { "type": "object", "additionalProperties": false, "required": [ "capability", "requestId", "attestationHash", "observedAt", "payloadHash", "payload", "signature" ], "properties": { "capability": { "type": "string" }, "requestId": { "type": "string" }, "attestationHash": { "$ref": "#/components/schemas/Hash" }, "observedAt": { "type": "string", "format": "date-time" }, "payloadHash": { "$ref": "#/components/schemas/Hash" }, "payload": { "type": "object" }, "signature": { "type": "string", "contentEncoding": "base64" } } }, "PersistedProviderGatewayEvidence": { "type": "object", "additionalProperties": false, "required": [ "providerId", "capability", "providerKeyResourceVersion", "providerAttestationHash", "providerPublicKeyFingerprint", "providerPublicKeySpkiBase64", "response" ], "properties": { "providerId": { "type": "string" }, "capability": { "type": "string" }, "providerKeyResourceVersion": { "$ref": "#/components/schemas/Hash" }, "providerAttestationHash": { "$ref": "#/components/schemas/Hash" }, "providerPublicKeyFingerprint": { "$ref": "#/components/schemas/Hash" }, "providerPublicKeySpkiBase64": { "type": "string", "contentEncoding": "base64" }, "response": { "$ref": "#/components/schemas/ProviderGatewayResponse" } } }, "ExternalVenueProviderEvidence": { "type": "object", "additionalProperties": false, "required": [ "capability", "providerId", "providerKeyResourceVersion", "providerPublicKeyFingerprint", "providerPublicKeySpkiBase64", "requestId", "observedAt", "attestationHash", "payloadHash", "signature" ], "properties": { "capability": { "const": "EXTERNAL_VENUE_INDEXING" }, "providerId": { "type": "string" }, "providerKeyResourceVersion": { "$ref": "#/components/schemas/Hash" }, "providerPublicKeyFingerprint": { "$ref": "#/components/schemas/Hash" }, "providerPublicKeySpkiBase64": { "type": "string", "contentEncoding": "base64" }, "requestId": { "type": "string" }, "observedAt": { "type": "string", "format": "date-time" }, "attestationHash": { "$ref": "#/components/schemas/Hash" }, "payloadHash": { "$ref": "#/components/schemas/Hash" }, "signature": { "type": "string", "contentEncoding": "base64" } } }, "VenueObservation": { "type": "object", "additionalProperties": false, "required": [ "observationId", "venueId", "assetMappingId", "deployedCapitalQuote", "activeCapitalQuote", "usableDepthQuote", "volumeQuote", "feesQuote", "slippagePips", "incentiveIncomeQuote", "fragmentationPips", "riskPips", "reliabilityPips", "bridgeHaircutPips", "capturedAt", "evidenceHash" ], "properties": { "observationId": { "type": "string" }, "vaultId": { "type": "string" }, "venueId": { "type": "string" }, "poolAddress": { "$ref": "#/components/schemas/Address" }, "feeTierPips": { "$ref": "#/components/schemas/Pips" }, "assetMappingId": { "type": "string" }, "deployedCapitalQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "activeCapitalQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "usableDepthQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "volumeQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "feesQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "slippagePips": { "$ref": "#/components/schemas/Pips" }, "incentiveIncomeQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "fragmentationPips": { "$ref": "#/components/schemas/Pips" }, "riskPips": { "$ref": "#/components/schemas/Pips" }, "reliabilityPips": { "$ref": "#/components/schemas/Pips" }, "bridgeHaircutPips": { "$ref": "#/components/schemas/Pips" }, "marketQualityMetrics": { "$ref": "#/components/schemas/MarketQualityObservationMetrics" }, "capturedAt": { "type": "string", "format": "date-time" }, "chainId": { "type": "integer", "minimum": 1 }, "chainGenesisHash": { "$ref": "#/components/schemas/Hash" }, "finalizedBlockNumber": { "$ref": "#/components/schemas/AtomicAmount" }, "finalizedBlockHash": { "$ref": "#/components/schemas/Hash" }, "finalityEvidenceHash": { "$ref": "#/components/schemas/Hash" }, "rpcQuorumAttestations": { "type": "array", "items": { "$ref": "#/components/schemas/VenueRpcQuorumAttestation" }, "maxItems": 8 }, "rpcQuorumVerification": { "$ref": "#/components/schemas/VenueRpcQuorumVerification" }, "providerEvidence": { "$ref": "#/components/schemas/ExternalVenueProviderEvidence" }, "sourceVenueProfile": { "$ref": "#/components/schemas/VenueProfileGenerationBinding" }, "evidenceHash": { "$ref": "#/components/schemas/Hash" } } }, "VenueAllocation": { "type": "object", "additionalProperties": false, "required": [ "venueId", "allocationPips", "capitalQuote", "compositeScore", "writeAuthority", "reasons" ], "properties": { "venueId": { "type": "string" }, "allocationPips": { "$ref": "#/components/schemas/Pips" }, "capitalQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "compositeScore": { "$ref": "#/components/schemas/Pips" }, "writeAuthority": { "type": "string", "enum": [ "AUDITED_TYPED_ADAPTER", "READ_ONLY" ] }, "reasons": { "type": "array", "items": { "type": "string" } } } }, "AllocationScoreVector": { "type": "object", "additionalProperties": false, "required": [ "executionQualityPips", "feeYieldPips", "usableDepthPips", "capitalEfficiencyPips", "riskAdjustedSafetyPips", "fragmentationResistancePips", "exitFlexibilityPips" ], "properties": { "executionQualityPips": { "$ref": "#/components/schemas/Pips" }, "feeYieldPips": { "$ref": "#/components/schemas/Pips" }, "usableDepthPips": { "$ref": "#/components/schemas/Pips" }, "capitalEfficiencyPips": { "$ref": "#/components/schemas/Pips" }, "riskAdjustedSafetyPips": { "$ref": "#/components/schemas/Pips" }, "fragmentationResistancePips": { "$ref": "#/components/schemas/Pips" }, "exitFlexibilityPips": { "$ref": "#/components/schemas/Pips" } } }, "AllocationPlanCandidate": { "type": "object", "additionalProperties": false, "required": [ "candidateId", "objective", "allocations", "scoreVector", "aggregateScorePips", "confidencePips", "executionClass" ], "properties": { "candidateId": { "type": "string" }, "objective": { "type": "string", "enum": [ "BALANCED", "EXECUTION_QUALITY", "CAPITAL_EFFICIENCY", "RISK_MINIMIZED", "EXIT_FLEXIBILITY" ] }, "allocations": { "type": "array", "items": { "$ref": "#/components/schemas/VenueAllocation" } }, "scoreVector": { "$ref": "#/components/schemas/AllocationScoreVector" }, "aggregateScorePips": { "$ref": "#/components/schemas/Pips" }, "confidencePips": { "$ref": "#/components/schemas/Pips" }, "executionClass": { "type": "string", "enum": [ "PREVIEW_ONLY", "BDEX_TYPED_EXECUTABLE" ] } } }, "AllocationPlan": { "type": "object", "additionalProperties": false, "required": [ "allocatorVersion", "intentName", "assetMappingId", "evaluatedAt", "totalCapitalQuote", "reservedCapitalQuote", "deployableCapitalQuote", "selectedCandidateId", "allocations", "paretoFrontier", "alternatives", "currentPlanScorePips", "expectedPlanScorePips", "expectedScoreImprovementPips", "confidencePips", "excludedVenues", "assumptions", "executionClass" ], "properties": { "allocatorVersion": { "const": "multi-venue-pareto-v1" }, "intentName": { "type": "string" }, "assetMappingId": { "type": "string" }, "evaluatedAt": { "type": "string", "format": "date-time" }, "totalCapitalQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "reservedCapitalQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "deployableCapitalQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "selectedCandidateId": { "type": "string" }, "allocations": { "type": "array", "items": { "$ref": "#/components/schemas/VenueAllocation" } }, "paretoFrontier": { "type": "array", "items": { "$ref": "#/components/schemas/AllocationPlanCandidate" } }, "alternatives": { "type": "array", "items": { "$ref": "#/components/schemas/AllocationPlanCandidate" } }, "currentPlanScorePips": { "$ref": "#/components/schemas/Pips" }, "expectedPlanScorePips": { "$ref": "#/components/schemas/Pips" }, "expectedScoreImprovementPips": { "type": "integer" }, "confidencePips": { "$ref": "#/components/schemas/Pips" }, "excludedVenues": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "venueId", "reasonCodes" ], "properties": { "venueId": { "type": "string" }, "reasonCodes": { "type": "array", "items": { "type": "string", "enum": [ "UNKNOWN_VENUE", "PROFILE_STATUS_INELIGIBLE", "TREASURY_RESERVE_PROTECTED", "NO_MATCHING_OBSERVATION", "STALE_OBSERVATION", "FUTURE_OBSERVATION", "MISSING_PROVIDER_EVIDENCE", "ATTESTATION_MISMATCH", "MISSING_FINALITY_EVIDENCE", "MISSING_RPC_QUORUM" ] } }, "observedProfileStatus": { "$ref": "#/components/schemas/OperatingSystemRecordStatus" }, "profileResourceVersion": { "$ref": "#/components/schemas/Hash" }, "profileArtifactHash": { "$ref": "#/components/schemas/Hash" } } } }, "assumptions": { "type": "array", "items": { "type": "string" } }, "executionClass": { "type": "string", "enum": [ "PREVIEW_ONLY", "BDEX_TYPED_EXECUTABLE" ] } } }, "ControllerVenueActionV2": { "type": "object", "additionalProperties": false, "required": [ "kind", "venueId", "asset0", "asset1", "assetIn", "assetOut", "amountIn", "minimumAmountOut", "amount0Max", "amount1Max", "amount0Min", "amount1Min", "positionId", "tickLower", "tickUpper", "liquidity", "sqrtPriceLimitX96", "deadline", "quoteHash" ], "properties": { "kind": { "type": "integer", "enum": [ 0, 1, 2, 3, 4, 5, 6 ] }, "venueId": { "$ref": "#/components/schemas/Hash" }, "asset0": { "$ref": "#/components/schemas/Address" }, "asset1": { "$ref": "#/components/schemas/Address" }, "assetIn": { "$ref": "#/components/schemas/Address" }, "assetOut": { "$ref": "#/components/schemas/Address" }, "amountIn": { "$ref": "#/components/schemas/AtomicAmount" }, "minimumAmountOut": { "$ref": "#/components/schemas/AtomicAmount" }, "amount0Max": { "$ref": "#/components/schemas/AtomicAmount" }, "amount1Max": { "$ref": "#/components/schemas/AtomicAmount" }, "amount0Min": { "$ref": "#/components/schemas/AtomicAmount" }, "amount1Min": { "$ref": "#/components/schemas/AtomicAmount" }, "positionId": { "$ref": "#/components/schemas/AtomicAmount" }, "tickLower": { "type": "integer", "minimum": -8388608, "maximum": 8388607 }, "tickUpper": { "type": "integer", "minimum": -8388608, "maximum": 8388607 }, "liquidity": { "$ref": "#/components/schemas/AtomicAmount" }, "sqrtPriceLimitX96": { "$ref": "#/components/schemas/AtomicAmount" }, "deadline": { "$ref": "#/components/schemas/AtomicAmount" }, "quoteHash": { "$ref": "#/components/schemas/Hash" } } }, "ControllerExecutionBindingV2": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "functionName", "controllerAddress", "adapterAddress", "action", "calldata", "calldataHash" ], "properties": { "schemaVersion": { "const": "scheduled-liquidity-controller-action-v2" }, "functionName": { "type": "string", "enum": [ "executeSafeAction", "executeAutopilotAction", "executeScheduledLeg" ] }, "controllerAddress": { "$ref": "#/components/schemas/Address" }, "adapterAddress": { "$ref": "#/components/schemas/Address" }, "action": { "$ref": "#/components/schemas/ControllerVenueActionV2" }, "actionId": { "$ref": "#/components/schemas/Hash" }, "planId": { "$ref": "#/components/schemas/Hash" }, "legIndex": { "type": "integer", "minimum": 0, "maximum": 4294967295 }, "proof": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" } }, "calldata": { "type": "string", "pattern": "^0x([0-9a-fA-F]{2})+$" }, "calldataHash": { "$ref": "#/components/schemas/Hash" } } }, "ProposalSafeTransactionIntent": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "chainId", "vaultId", "vaultAddress", "ownerSafe", "venueId", "controllerExecution" ], "properties": { "schemaVersion": { "const": "proposal-controller-safe-intent-v1" }, "chainId": { "type": "integer", "enum": [ 677, 968 ] }, "vaultId": { "type": "string" }, "vaultAddress": { "$ref": "#/components/schemas/Address" }, "ownerSafe": { "$ref": "#/components/schemas/Address" }, "venueId": { "type": "string" }, "controllerExecution": { "$ref": "#/components/schemas/ControllerExecutionBindingV2" } } }, "MigrationLegEconomicBindingV2": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "legId", "capitalQuote", "asset0", "asset1", "quoteAsset", "asset0Decimals", "asset1Decimals", "quoteDecimals", "asset0PriceQuoteX18", "asset1PriceQuoteX18", "expectedAmount0Atomic", "expectedAmount1Atomic", "valuationTolerancePips", "actionKind", "actionPositionId", "actionLiquidity", "actionAmount0Max", "actionAmount1Max", "actionAmount0Min", "actionAmount1Min", "controllerActionHash", "oracleProviderId", "oracleProviderResourceVersion", "oracleProviderAttestationHash", "maximumAgeSeconds", "observedAt", "payloadHash", "signature" ], "properties": { "schemaVersion": { "const": "migration-leg-economic-binding-v2" }, "legId": { "type": "string" }, "capitalQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "asset0": { "$ref": "#/components/schemas/Address" }, "asset1": { "$ref": "#/components/schemas/Address" }, "quoteAsset": { "$ref": "#/components/schemas/Address" }, "asset0Decimals": { "type": "integer", "minimum": 0, "maximum": 36 }, "asset1Decimals": { "type": "integer", "minimum": 0, "maximum": 36 }, "quoteDecimals": { "type": "integer", "minimum": 0, "maximum": 36 }, "asset0PriceQuoteX18": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "asset1PriceQuoteX18": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "expectedAmount0Atomic": { "$ref": "#/components/schemas/AtomicAmount" }, "expectedAmount1Atomic": { "$ref": "#/components/schemas/AtomicAmount" }, "valuationTolerancePips": { "type": "integer", "minimum": 0, "maximum": 50000 }, "actionKind": { "type": "integer", "enum": [ 1, 2, 3 ] }, "actionPositionId": { "$ref": "#/components/schemas/AtomicAmount" }, "actionLiquidity": { "$ref": "#/components/schemas/AtomicAmount" }, "actionAmount0Max": { "$ref": "#/components/schemas/AtomicAmount" }, "actionAmount1Max": { "$ref": "#/components/schemas/AtomicAmount" }, "actionAmount0Min": { "$ref": "#/components/schemas/AtomicAmount" }, "actionAmount1Min": { "$ref": "#/components/schemas/AtomicAmount" }, "controllerActionHash": { "$ref": "#/components/schemas/Hash" }, "oracleProviderId": { "type": "string" }, "oracleProviderResourceVersion": { "$ref": "#/components/schemas/Hash" }, "oracleProviderAttestationHash": { "$ref": "#/components/schemas/Hash" }, "maximumAgeSeconds": { "type": "integer", "minimum": 1, "maximum": 86400 }, "observedAt": { "type": "string", "format": "date-time" }, "payloadHash": { "$ref": "#/components/schemas/Hash" }, "signature": { "type": "string", "pattern": "^[A-Za-z0-9+/]{80,700}={0,2}$" } } }, "MigrationPlanLeg": { "type": "object", "additionalProperties": false, "required": [ "index", "legId", "route", "kind", "venueId", "capitalQuote", "minimumDepthAfterQuote", "maximumSlippagePips", "requiresPreviousLegFinalizedAndReconciled", "conditional" ], "properties": { "index": { "type": "integer", "minimum": 0 }, "legId": { "type": "string" }, "route": { "type": "string", "enum": [ "FORWARD", "ROLLBACK" ] }, "kind": { "type": "string", "enum": [ "WITHDRAW", "HOLD_CHECKPOINT", "DEPLOY", "VERIFY", "ROLLBACK_CHECKPOINT", "ROLLBACK_WITHDRAW_TARGET", "ROLLBACK_REDEPLOY_SOURCE", "ROLLBACK_VERIFY_SOURCE" ] }, "venueId": { "type": "string" }, "capitalQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "minimumDepthAfterQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "maximumSlippagePips": { "$ref": "#/components/schemas/Pips" }, "dependsOnLegId": { "type": "string" }, "requiresPreviousLegFinalizedAndReconciled": { "type": "boolean" }, "conditional": { "type": "boolean" }, "controllerExecution": { "$ref": "#/components/schemas/ControllerExecutionBindingV2" }, "economicBinding": { "$ref": "#/components/schemas/MigrationLegEconomicBindingV2" } } }, "VenueProfileGenerationBinding": { "type": "object", "additionalProperties": false, "required": [ "recordId", "recordVersion", "resourceVersion", "artifactHash", "status", "venueId", "chainId", "kind", "writeAuthority", "attestationHash" ], "properties": { "recordId": { "type": "string" }, "recordVersion": { "type": "integer", "minimum": 1 }, "resourceVersion": { "$ref": "#/components/schemas/Hash" }, "artifactHash": { "$ref": "#/components/schemas/Hash" }, "status": { "type": "string", "enum": [ "VALIDATED", "ACTIVE" ] }, "venueId": { "type": "string" }, "chainId": { "type": "integer", "minimum": 1 }, "kind": { "type": "string", "enum": [ "BDEX_V3", "EVM_V3", "EXTERNAL_MANAGER", "TREASURY_RESERVE" ] }, "writeAuthority": { "type": "string", "enum": [ "AUDITED_TYPED_ADAPTER", "READ_ONLY" ] }, "attestationHash": { "$ref": "#/components/schemas/Hash" }, "adapterRegistryAddress": { "$ref": "#/components/schemas/Address" }, "adapterAddress": { "$ref": "#/components/schemas/Address" }, "adapterRuntimeHash": { "$ref": "#/components/schemas/Hash" }, "controllerVenueId": { "$ref": "#/components/schemas/Hash" }, "asset0": { "$ref": "#/components/schemas/Address" }, "asset1": { "$ref": "#/components/schemas/Address" } } }, "MigrationVenueProfileBinding": { "$ref": "#/components/schemas/VenueProfileGenerationBinding" }, "MigrationPlan": { "type": "object", "additionalProperties": false, "required": [ "plannerVersion", "stateMachineVersion", "sourceVenueId", "targetVenueId", "sourceVenueBinding", "targetVenueBinding", "capitalQuote", "temporaryDepthReductionQuote", "expectedPriceImpactPips", "migrationCostQuote", "expectedMarketQualityImprovement", "executionClass", "legs", "rollbackLegs", "rollbackReason", "assumptions" ], "properties": { "plannerVersion": { "const": "liquidity-migration-v1" }, "stateMachineVersion": { "const": "liquidity-migration-state-v1" }, "executionVaultId": { "type": "string", "description": "Required for AUDITED_TYPED_ADAPTER plans and omitted for PREVIEW_ONLY plans.", "x-klineo-required-when": "executionClass is AUDITED_TYPED_ADAPTER" }, "sourceVenueId": { "type": "string" }, "targetVenueId": { "type": "string" }, "sourceVenueBinding": { "$ref": "#/components/schemas/MigrationVenueProfileBinding" }, "targetVenueBinding": { "$ref": "#/components/schemas/MigrationVenueProfileBinding" }, "capitalQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "temporaryDepthReductionQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "expectedPriceImpactPips": { "$ref": "#/components/schemas/Pips" }, "migrationCostQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "expectedMarketQualityImprovement": { "type": "integer" }, "executionClass": { "type": "string", "enum": [ "PREVIEW_ONLY", "AUDITED_TYPED_ADAPTER" ] }, "legs": { "type": "array", "items": { "$ref": "#/components/schemas/MigrationPlanLeg" } }, "rollbackLegs": { "type": "array", "items": { "$ref": "#/components/schemas/MigrationPlanLeg" } }, "rollbackReason": { "type": "string" }, "assumptions": { "type": "array", "items": { "type": "string" } } } }, "MigrationActionEnvelopeV2": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "actionIntentHash", "vaultId", "vaultAddress", "controllerAddress", "ownerSafe", "controllerCalldata", "controllerCalldataHash" ], "properties": { "schemaVersion": { "const": "migration-action-envelope-v2" }, "actionIntentHash": { "$ref": "#/components/schemas/Hash" }, "vaultId": { "type": "string" }, "vaultAddress": { "$ref": "#/components/schemas/Address" }, "controllerAddress": { "$ref": "#/components/schemas/Address" }, "ownerSafe": { "$ref": "#/components/schemas/Address" }, "controllerCalldata": { "type": "string", "pattern": "^0x(?:[0-9a-fA-F]{2})+$" }, "controllerCalldataHash": { "$ref": "#/components/schemas/Hash" } } }, "MigrationVaultGenerationBindingV2": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "vaultId", "updatedAt", "vaultAddress", "controllerAddress", "ownerSafe", "deploymentProvenanceHash", "deploymentBlockHash", "deploymentRuntimeHashes", "policyStateGeneration", "controlStateGeneration" ], "properties": { "schemaVersion": { "const": "migration-vault-generation-binding-v2" }, "vaultId": { "type": "string" }, "updatedAt": { "type": "string", "format": "date-time" }, "vaultAddress": { "$ref": "#/components/schemas/Address" }, "controllerAddress": { "$ref": "#/components/schemas/Address" }, "ownerSafe": { "$ref": "#/components/schemas/Address" }, "deploymentProvenanceHash": { "$ref": "#/components/schemas/Hash" }, "deploymentBlockHash": { "$ref": "#/components/schemas/Hash" }, "deploymentRuntimeHashes": { "type": "object", "additionalProperties": false, "required": [ "module", "vault", "policyManager", "oracleGuard", "executionController", "executionRiskEngine" ], "properties": { "module": { "$ref": "#/components/schemas/Hash" }, "vault": { "$ref": "#/components/schemas/Hash" }, "policyManager": { "$ref": "#/components/schemas/Hash" }, "oracleGuard": { "$ref": "#/components/schemas/Hash" }, "executionController": { "$ref": "#/components/schemas/Hash" }, "executionRiskEngine": { "$ref": "#/components/schemas/Hash" } } }, "policyStateGeneration": { "type": [ "string", "null" ] }, "controlStateGeneration": { "type": [ "string", "null" ] } } }, "OperatingSystemSubmissionReleaseRuntimeAuthorityV2": { "type": "object", "additionalProperties": false, "required": [ "releaseId", "chainId", "environment", "issuedAt", "expiresAt", "sourceCommit", "artifactDigest", "v1ReleaseDigest", "maximumAutonomyLevel", "emergencyState", "automatedExecution", "publicMempoolFallback", "bot968Live", "bot677Live", "namedCappedVaults", "externalEvmV3WriteAdaptersEnabled", "components", "enabledAdapterVenueIds", "enabledAdapterCaps" ], "properties": { "releaseId": { "$ref": "#/components/schemas/Hash" }, "chainId": { "type": "integer", "enum": [ 677, 968 ] }, "environment": { "type": "string", "enum": [ "testnet", "staging", "mainnet" ] }, "issuedAt": { "type": "string", "format": "date-time" }, "expiresAt": { "type": "string", "format": "date-time" }, "sourceCommit": { "$ref": "#/components/schemas/Hash" }, "artifactDigest": { "$ref": "#/components/schemas/Hash" }, "v1ReleaseDigest": { "$ref": "#/components/schemas/Hash" }, "maximumAutonomyLevel": { "type": "integer", "enum": [ 0, 1, 2, 3, 4 ] }, "emergencyState": { "type": "string", "enum": [ "NORMAL", "PAUSED" ] }, "automatedExecution": { "type": "boolean" }, "publicMempoolFallback": { "type": "boolean" }, "bot968Live": { "type": "boolean" }, "bot677Live": { "type": "boolean" }, "namedCappedVaults": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "vaultId", "name", "vaultAddress", "capitalCapAtomic", "evidenceHash" ], "properties": { "vaultId": { "type": "string" }, "name": { "type": "string" }, "vaultAddress": { "$ref": "#/components/schemas/Address" }, "capitalCapAtomic": { "$ref": "#/components/schemas/AtomicAmount" }, "evidenceHash": { "$ref": "#/components/schemas/Hash" } } } }, "externalEvmV3WriteAdaptersEnabled": { "const": false }, "components": { "type": "object", "additionalProperties": false, "required": [ "venueAdapterRegistryV2", "klineOPrivateVaultV2", "scheduledLiquidityControllerV2", "bdexV3AdapterV2" ], "properties": { "venueAdapterRegistryV2": { "type": "object", "additionalProperties": false, "required": [ "address", "runtimeCodeHash" ], "properties": { "address": { "$ref": "#/components/schemas/Address" }, "runtimeCodeHash": { "$ref": "#/components/schemas/Hash" } } }, "klineOPrivateVaultV2": { "type": "object", "additionalProperties": false, "required": [ "address", "runtimeCodeHash" ], "properties": { "address": { "$ref": "#/components/schemas/Address" }, "runtimeCodeHash": { "$ref": "#/components/schemas/Hash" } } }, "scheduledLiquidityControllerV2": { "type": "object", "additionalProperties": false, "required": [ "address", "runtimeCodeHash" ], "properties": { "address": { "$ref": "#/components/schemas/Address" }, "runtimeCodeHash": { "$ref": "#/components/schemas/Hash" } } }, "bdexV3AdapterV2": { "type": "object", "additionalProperties": false, "required": [ "address", "runtimeCodeHash" ], "properties": { "address": { "$ref": "#/components/schemas/Address" }, "runtimeCodeHash": { "$ref": "#/components/schemas/Hash" } } } } }, "enabledAdapterVenueIds": { "type": "array", "items": { "type": "string" } }, "enabledAdapterCaps": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "venueId", "perVenueCaps", "perAssetCaps" ], "properties": { "venueId": { "type": "string" }, "perVenueCaps": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "maximumPerActionQuote", "maximumDailyTurnoverQuote" ], "properties": { "maximumPerActionQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "maximumDailyTurnoverQuote": { "$ref": "#/components/schemas/AtomicAmount" } } } }, "perAssetCaps": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "asset", "maximumPerAction", "maximumDailyTurnover" ], "properties": { "asset": { "$ref": "#/components/schemas/Address" }, "maximumPerAction": { "$ref": "#/components/schemas/AtomicAmount" }, "maximumDailyTurnover": { "$ref": "#/components/schemas/AtomicAmount" } } } } } } } } }, "OperatingSystemSubmissionReleaseAuthorityV2": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "releaseId", "releaseDigest", "feature", "featureState", "cryptographicallyVerified", "authorityEnabled", "runtimeAuthority", "runtimeAuthorityHash" ], "properties": { "schemaVersion": { "const": "operating-system-submission-release-authority-v2" }, "releaseId": { "$ref": "#/components/schemas/Hash" }, "releaseDigest": { "$ref": "#/components/schemas/Hash" }, "feature": { "type": "string", "enum": [ "migrationPlanner", "protectedExecution" ] }, "featureState": { "const": "LIVE" }, "cryptographicallyVerified": { "const": true }, "authorityEnabled": { "const": true }, "runtimeAuthority": { "$ref": "#/components/schemas/OperatingSystemSubmissionReleaseRuntimeAuthorityV2" }, "runtimeAuthorityHash": { "$ref": "#/components/schemas/Hash" } } }, "MigrationActionIntentV2": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "releaseId", "chainId", "planId", "planRootHash", "route", "leg", "controllerExecution" ], "properties": { "schemaVersion": { "const": "migration-action-intent-v2" }, "releaseId": { "$ref": "#/components/schemas/Hash" }, "chainId": { "type": "integer", "enum": [ 677, 968 ] }, "planId": { "type": "string" }, "planRootHash": { "$ref": "#/components/schemas/Hash" }, "route": { "type": "string", "enum": [ "FORWARD", "ROLLBACK" ] }, "leg": { "$ref": "#/components/schemas/MigrationPlanLeg" }, "controllerExecution": { "$ref": "#/components/schemas/ControllerExecutionBindingV2" } } }, "MigrationSubmissionAuthorityV2": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "releaseAuthority", "actionIntent", "actionIntentHash", "actionEnvelope", "actionEnvelopeHash", "sourceVenueBinding", "targetVenueBinding", "vaultGeneration", "safeVerificationEvidenceHash", "minimumFinalityDepth", "authorizationTransactionHash" ], "properties": { "schemaVersion": { "const": "migration-submission-authority-v2" }, "releaseAuthority": { "$ref": "#/components/schemas/OperatingSystemSubmissionReleaseAuthorityV2" }, "actionIntent": { "$ref": "#/components/schemas/MigrationActionIntentV2" }, "actionIntentHash": { "$ref": "#/components/schemas/Hash" }, "actionEnvelope": { "$ref": "#/components/schemas/MigrationActionEnvelopeV2" }, "actionEnvelopeHash": { "$ref": "#/components/schemas/Hash" }, "sourceVenueBinding": { "$ref": "#/components/schemas/MigrationVenueProfileBinding" }, "targetVenueBinding": { "$ref": "#/components/schemas/MigrationVenueProfileBinding" }, "vaultGeneration": { "$ref": "#/components/schemas/MigrationVaultGenerationBindingV2" }, "safeVerificationEvidenceHash": { "$ref": "#/components/schemas/Hash" }, "minimumFinalityDepth": { "type": "integer", "minimum": 1 }, "authorizationTransactionHash": { "$ref": "#/components/schemas/Hash" } } }, "MigrationSkipTargetFactsV2": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "venueId", "controllerVenueId", "targetVenueProfileResourceVersion", "targetVenueProfileArtifactHash", "vaultId", "vaultUpdatedAt", "vaultGenerationHash", "factsBlockNumber", "factsBlockHash", "positionId", "positionExists", "positionLiquidityAtomic", "positionAmount0Atomic", "positionAmount1Atomic", "issuerControlledPositionCount", "issuerControlledLiquidityAtomic", "issuerControlledAmount0Atomic", "issuerControlledAmount1Atomic", "targetVenueAsset0BalanceAtomic", "targetVenueAsset1BalanceAtomic", "vaultAsset0BalanceAtomic", "vaultAsset1BalanceAtomic", "usableDepthAfterQuote", "issuerControlledDepthQuote" ], "properties": { "schemaVersion": { "const": "migration-skip-target-facts-v2" }, "venueId": { "type": "string" }, "controllerVenueId": { "$ref": "#/components/schemas/Hash" }, "targetVenueProfileResourceVersion": { "$ref": "#/components/schemas/Hash" }, "targetVenueProfileArtifactHash": { "$ref": "#/components/schemas/Hash" }, "vaultId": { "type": "string" }, "vaultUpdatedAt": { "type": "string", "format": "date-time" }, "vaultGenerationHash": { "$ref": "#/components/schemas/Hash" }, "factsBlockNumber": { "$ref": "#/components/schemas/AtomicAmount" }, "factsBlockHash": { "$ref": "#/components/schemas/Hash" }, "positionId": { "$ref": "#/components/schemas/AtomicAmount" }, "positionExists": { "type": "boolean" }, "positionLiquidityAtomic": { "$ref": "#/components/schemas/AtomicAmount" }, "positionAmount0Atomic": { "$ref": "#/components/schemas/AtomicAmount" }, "positionAmount1Atomic": { "$ref": "#/components/schemas/AtomicAmount" }, "issuerControlledPositionCount": { "type": "integer", "minimum": 0 }, "issuerControlledLiquidityAtomic": { "$ref": "#/components/schemas/AtomicAmount" }, "issuerControlledAmount0Atomic": { "$ref": "#/components/schemas/AtomicAmount" }, "issuerControlledAmount1Atomic": { "$ref": "#/components/schemas/AtomicAmount" }, "targetVenueAsset0BalanceAtomic": { "$ref": "#/components/schemas/AtomicAmount" }, "targetVenueAsset1BalanceAtomic": { "$ref": "#/components/schemas/AtomicAmount" }, "vaultAsset0BalanceAtomic": { "$ref": "#/components/schemas/AtomicAmount" }, "vaultAsset1BalanceAtomic": { "$ref": "#/components/schemas/AtomicAmount" }, "usableDepthAfterQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "issuerControlledDepthQuote": { "$ref": "#/components/schemas/AtomicAmount" } } }, "MigrationExecutionResultV2": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "executionSucceeded", "returnDataHash", "logsHash", "stateDeltaHash" ], "properties": { "schemaVersion": { "const": "migration-execution-result-v2" }, "executionSucceeded": { "type": "boolean" }, "returnDataHash": { "$ref": "#/components/schemas/Hash" }, "logsHash": { "$ref": "#/components/schemas/Hash" }, "stateDeltaHash": { "$ref": "#/components/schemas/Hash" } } }, "MigrationTransactionReceiptV2": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "actionEnvelopeHash", "submissionEvidenceHash", "transactionHash", "receiptStatus", "executionResult", "executionResultHash", "finalizedBlockNumber", "finalizedBlockHash", "finalizedAt", "finalityDepth", "finalityEvidenceHash" ], "properties": { "schemaVersion": { "const": "migration-transaction-receipt-v2" }, "actionEnvelopeHash": { "$ref": "#/components/schemas/Hash" }, "submissionEvidenceHash": { "$ref": "#/components/schemas/Hash" }, "transactionHash": { "$ref": "#/components/schemas/Hash" }, "receiptStatus": { "type": "integer", "enum": [ 0, 1 ] }, "executionResult": { "$ref": "#/components/schemas/MigrationExecutionResultV2" }, "executionResultHash": { "$ref": "#/components/schemas/Hash" }, "finalizedBlockNumber": { "$ref": "#/components/schemas/AtomicAmount" }, "finalizedBlockHash": { "$ref": "#/components/schemas/Hash" }, "finalizedAt": { "type": "string", "format": "date-time" }, "finalityDepth": { "type": "integer", "minimum": 1 }, "finalityEvidenceHash": { "$ref": "#/components/schemas/Hash" } } }, "MigrationSkipSnapshotBindingV2": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "actionIntentHash", "actionEnvelopeHash", "planId", "planRootHash", "previousStateHash", "priorLegStatus", "route", "legId", "legKind", "targetVenueBinding", "vaultGeneration", "actionEnvelope", "safeVerificationEvidenceHash", "minimumFinalityDepth" ], "properties": { "schemaVersion": { "const": "migration-skip-snapshot-binding-v2" }, "actionIntentHash": { "$ref": "#/components/schemas/Hash" }, "actionEnvelopeHash": { "$ref": "#/components/schemas/Hash" }, "planId": { "type": "string" }, "planRootHash": { "$ref": "#/components/schemas/Hash" }, "previousStateHash": { "$ref": "#/components/schemas/Hash" }, "priorLegStatus": { "const": "READY" }, "route": { "const": "ROLLBACK" }, "legId": { "type": "string" }, "legKind": { "const": "ROLLBACK_WITHDRAW_TARGET" }, "targetVenueBinding": { "$ref": "#/components/schemas/MigrationVenueProfileBinding" }, "vaultGeneration": { "$ref": "#/components/schemas/MigrationVaultGenerationBindingV2" }, "actionEnvelope": { "$ref": "#/components/schemas/MigrationActionEnvelopeV2" }, "safeVerificationEvidenceHash": { "$ref": "#/components/schemas/Hash" }, "minimumFinalityDepth": { "type": "integer", "minimum": 1 } } }, "MigrationSkipReconciliationSnapshotV2": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "snapshotBinding", "snapshotBindingHash", "targetFacts", "targetFactsHash", "actionUnnecessaryPredicate", "finalizedBlockNumber", "finalizedBlockHash", "finalizedAt", "finalityDepth", "finalityEvidenceHash", "reconciliationBlockNumber", "reconciliationBlockHash", "reconciledAt", "reconciliationStatus", "reconciliationEvidenceHash", "observedAt" ], "properties": { "schemaVersion": { "const": "migration-skip-reconciliation-snapshot-v2" }, "snapshotBinding": { "$ref": "#/components/schemas/MigrationSkipSnapshotBindingV2" }, "snapshotBindingHash": { "$ref": "#/components/schemas/Hash" }, "targetFacts": { "$ref": "#/components/schemas/MigrationSkipTargetFactsV2" }, "targetFactsHash": { "$ref": "#/components/schemas/Hash" }, "actionUnnecessaryPredicate": { "type": "object", "additionalProperties": false, "required": [ "predicateVersion", "result", "predicateHash" ], "properties": { "predicateVersion": { "const": "rollback-withdraw-target-unnecessary-v1" }, "result": { "const": true }, "predicateHash": { "$ref": "#/components/schemas/Hash" } } }, "finalizedBlockNumber": { "$ref": "#/components/schemas/AtomicAmount" }, "finalizedBlockHash": { "$ref": "#/components/schemas/Hash" }, "finalizedAt": { "type": "string", "format": "date-time" }, "finalityDepth": { "type": "integer", "minimum": 1 }, "finalityEvidenceHash": { "$ref": "#/components/schemas/Hash" }, "reconciliationBlockNumber": { "$ref": "#/components/schemas/AtomicAmount" }, "reconciliationBlockHash": { "$ref": "#/components/schemas/Hash" }, "reconciledAt": { "type": "string", "format": "date-time" }, "reconciliationStatus": { "const": "MATCHED" }, "reconciliationEvidenceHash": { "$ref": "#/components/schemas/Hash" }, "observedAt": { "type": "string", "format": "date-time" } } }, "MigrationPlanTransition": { "type": "object", "additionalProperties": false, "required": [ "sequence", "legId", "route", "fromStatus", "toStatus", "previousStateHash", "observedAt" ], "properties": { "sequence": { "type": "integer", "minimum": 1 }, "legId": { "type": "string" }, "route": { "type": "string", "enum": [ "FORWARD", "ROLLBACK" ] }, "fromStatus": { "type": "string", "enum": [ "BLOCKED", "READY", "SUBMITTED", "FINALIZED_RECONCILED", "FAILED_FINALIZED_RECONCILED", "SKIPPED_RECONCILED" ] }, "toStatus": { "type": "string", "enum": [ "SUBMITTED", "FINALIZED_RECONCILED", "FAILED_FINALIZED_RECONCILED", "SKIPPED_RECONCILED" ] }, "previousStateHash": { "$ref": "#/components/schemas/Hash" }, "observedAt": { "type": "string", "format": "date-time" }, "submissionEvidenceHash": { "$ref": "#/components/schemas/Hash" }, "transactionHash": { "$ref": "#/components/schemas/Hash" }, "submissionAuthority": { "$ref": "#/components/schemas/MigrationSubmissionAuthorityV2" }, "finalityEvidenceHash": { "$ref": "#/components/schemas/Hash" }, "reconciliationEvidenceHash": { "$ref": "#/components/schemas/Hash" }, "executionReceipt": { "$ref": "#/components/schemas/MigrationTransactionReceiptV2" }, "skipReconciliationSnapshot": { "$ref": "#/components/schemas/MigrationSkipReconciliationSnapshotV2" } } }, "MigrationPlanExecutionState": { "type": "object", "additionalProperties": false, "required": [ "stateMachineVersion", "status", "forwardLegs", "rollbackLegs", "transitionCount" ], "properties": { "stateMachineVersion": { "const": "liquidity-migration-state-v1" }, "status": { "type": "string", "enum": [ "READY", "IN_PROGRESS", "COMPLETED", "ABORTED_RECONCILED", "ROLLBACK_READY", "ROLLING_BACK", "ROLLED_BACK", "FAILED_CLOSED" ] }, "forwardLegs": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "legId", "route", "status" ], "properties": { "legId": { "type": "string" }, "route": { "type": "string", "enum": [ "FORWARD", "ROLLBACK" ] }, "status": { "type": "string", "enum": [ "BLOCKED", "READY", "SUBMITTED", "FINALIZED_RECONCILED", "FAILED_FINALIZED_RECONCILED", "SKIPPED_RECONCILED" ] }, "lastTransitionSequence": { "type": "integer", "minimum": 1 } } } }, "rollbackLegs": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "legId", "route", "status" ], "properties": { "legId": { "type": "string" }, "route": { "type": "string", "enum": [ "FORWARD", "ROLLBACK" ] }, "status": { "type": "string", "enum": [ "BLOCKED", "READY", "SUBMITTED", "FINALIZED_RECONCILED", "FAILED_FINALIZED_RECONCILED", "SKIPPED_RECONCILED" ] }, "lastTransitionSequence": { "type": "integer", "minimum": 1 } } } }, "transitionCount": { "type": "integer", "minimum": 0 } } }, "ControllerAssetLimitV2": { "type": "object", "additionalProperties": false, "required": [ "asset", "decimals", "maximumPerAction", "maximumDailyTurnover" ], "properties": { "asset": { "$ref": "#/components/schemas/Address" }, "decimals": { "type": "integer", "minimum": 0, "maximum": 36 }, "maximumPerAction": { "$ref": "#/components/schemas/AtomicAmount" }, "maximumDailyTurnover": { "$ref": "#/components/schemas/AtomicAmount" } } }, "ControllerVenueAssetLimitV2": { "type": "object", "additionalProperties": false, "required": [ "adapterId", "venueId", "asset", "decimals", "maximumPerAction", "maximumDailyTurnover" ], "properties": { "adapterId": { "type": "string" }, "venueId": { "$ref": "#/components/schemas/Hash" }, "asset": { "$ref": "#/components/schemas/Address" }, "decimals": { "type": "integer", "minimum": 0, "maximum": 36 }, "maximumPerAction": { "$ref": "#/components/schemas/AtomicAmount" }, "maximumDailyTurnover": { "$ref": "#/components/schemas/AtomicAmount" } } }, "ControllerAdapterPermissionV2": { "type": "object", "additionalProperties": false, "required": [ "adapterId", "adapter", "poolHealthGuard", "maximumTwapDeviationPips", "maximumPositionWidthTicks", "allowedActions" ], "properties": { "adapterId": { "type": "string" }, "adapter": { "$ref": "#/components/schemas/Address" }, "poolHealthGuard": { "$ref": "#/components/schemas/Address" }, "maximumTwapDeviationPips": { "type": "integer", "minimum": 1, "maximum": 999999 }, "maximumPositionWidthTicks": { "type": "integer", "minimum": 1, "maximum": 1774544 }, "allowedActions": { "type": "array", "items": { "type": "boolean" }, "minItems": 7, "maxItems": 7 } } }, "ControllerCriticalDetectorPermissionV2": { "type": "object", "additionalProperties": false, "required": [ "detectorId", "allowed" ], "properties": { "detectorId": { "$ref": "#/components/schemas/Hash" }, "allowed": { "type": "boolean" } } }, "ControllerPolicyBindingV2": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "executor", "guardian", "reconciler", "priceGuard", "floorBaseAsset", "floorQuoteAsset", "minimumReconciliationBlocks", "evidenceHash", "assetLimits", "venueLimits", "adapterPermissions", "criticalDetectors" ], "properties": { "schemaVersion": { "const": "scheduled-liquidity-controller-policy-v2" }, "executor": { "$ref": "#/components/schemas/Address" }, "guardian": { "$ref": "#/components/schemas/Address" }, "reconciler": { "$ref": "#/components/schemas/Address" }, "priceGuard": { "$ref": "#/components/schemas/Address" }, "floorBaseAsset": { "$ref": "#/components/schemas/Address" }, "floorQuoteAsset": { "$ref": "#/components/schemas/Address" }, "minimumReconciliationBlocks": { "type": "integer", "minimum": 1, "maximum": 65535 }, "evidenceHash": { "$ref": "#/components/schemas/Hash" }, "assetLimits": { "type": "array", "items": { "$ref": "#/components/schemas/ControllerAssetLimitV2" }, "minItems": 2, "maxItems": 64 }, "venueLimits": { "type": "array", "items": { "$ref": "#/components/schemas/ControllerVenueAssetLimitV2" }, "minItems": 2, "maxItems": 256 }, "adapterPermissions": { "type": "array", "items": { "$ref": "#/components/schemas/ControllerAdapterPermissionV2" }, "minItems": 1, "maxItems": 64 }, "criticalDetectors": { "type": "array", "items": { "$ref": "#/components/schemas/ControllerCriticalDetectorPermissionV2" }, "maxItems": 64 } } }, "ActivatedControllerPolicyV2": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "policyHash", "configuration", "assetLimits", "venueLimits", "adapters", "detectors" ], "properties": { "schemaVersion": { "const": "activated-controller-policy-v2" }, "policyHash": { "$ref": "#/components/schemas/Hash" }, "configuration": { "type": "object", "additionalProperties": false, "required": [ "level", "activationControlEpoch", "executor", "guardian", "reconciler", "priceGuard", "floorBaseAsset", "floorQuoteAsset", "cooldown", "maximumOracleAge", "expiresAtSeconds", "maximumSlippagePips", "minimumReconciliationBlocks", "priceFloorX18", "priceCeilingX18", "publicMempoolAllowed", "evidenceHash" ], "properties": { "level": { "type": "integer", "enum": [ 0, 1, 2, 3, 4 ] }, "activationControlEpoch": { "$ref": "#/components/schemas/AtomicAmount" }, "executor": { "$ref": "#/components/schemas/Address" }, "guardian": { "$ref": "#/components/schemas/Address" }, "reconciler": { "$ref": "#/components/schemas/Address" }, "priceGuard": { "$ref": "#/components/schemas/Address" }, "floorBaseAsset": { "$ref": "#/components/schemas/Address" }, "floorQuoteAsset": { "$ref": "#/components/schemas/Address" }, "cooldown": { "type": "integer", "minimum": 0 }, "maximumOracleAge": { "type": "integer", "minimum": 1 }, "expiresAtSeconds": { "$ref": "#/components/schemas/AtomicAmount" }, "maximumSlippagePips": { "$ref": "#/components/schemas/Pips" }, "minimumReconciliationBlocks": { "type": "integer", "minimum": 1 }, "priceFloorX18": { "$ref": "#/components/schemas/AtomicAmount" }, "priceCeilingX18": { "$ref": "#/components/schemas/AtomicAmount" }, "publicMempoolAllowed": { "type": "boolean" }, "evidenceHash": { "$ref": "#/components/schemas/Hash" } } }, "assetLimits": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "asset", "decimals", "maximumPerAction", "maximumDailyTurnover" ], "properties": { "asset": { "$ref": "#/components/schemas/Address" }, "decimals": { "type": "integer", "minimum": 0, "maximum": 36 }, "maximumPerAction": { "$ref": "#/components/schemas/AtomicAmount" }, "maximumDailyTurnover": { "$ref": "#/components/schemas/AtomicAmount" } } }, "minItems": 2, "maxItems": 64 }, "venueLimits": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "venueId", "asset", "decimals", "maximumPerAction", "maximumDailyTurnover" ], "properties": { "venueId": { "$ref": "#/components/schemas/Hash" }, "asset": { "$ref": "#/components/schemas/Address" }, "decimals": { "type": "integer", "minimum": 0, "maximum": 36 }, "maximumPerAction": { "$ref": "#/components/schemas/AtomicAmount" }, "maximumDailyTurnover": { "$ref": "#/components/schemas/AtomicAmount" } } }, "minItems": 2, "maxItems": 256 }, "adapters": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "adapter", "allowedActions" ], "properties": { "adapter": { "$ref": "#/components/schemas/Address" }, "allowedActions": { "type": "array", "items": { "type": "boolean" }, "minItems": 7, "maxItems": 7 } } }, "minItems": 1, "maxItems": 64 }, "detectors": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "detectorId", "allowed" ], "properties": { "detectorId": { "$ref": "#/components/schemas/Hash" }, "allowed": { "type": "boolean" } } }, "maxItems": 64 } } }, "AutonomyPolicy": { "type": "object", "additionalProperties": false, "required": [ "vaultId", "level", "emergencyPaused", "maximumAmountPerTransaction", "maximumDailyTurnover", "maximumSlippagePips", "approvedContracts", "approvedAssets", "approvedAdapterIds", "minimumSecondsBetweenActions", "oracleMaximumAgeSeconds", "expiresAt", "controlEpoch", "publicMempoolFallbackAllowed" ], "properties": { "vaultId": { "type": "string" }, "level": { "type": "integer", "enum": [ 0, 1, 2, 3, 4 ] }, "emergencyPaused": { "type": "boolean" }, "maximumAmountPerTransaction": { "$ref": "#/components/schemas/AtomicAmount" }, "maximumDailyTurnover": { "$ref": "#/components/schemas/AtomicAmount" }, "maximumSlippagePips": { "$ref": "#/components/schemas/Pips" }, "approvedContracts": { "type": "array", "items": { "$ref": "#/components/schemas/Address" } }, "approvedAssets": { "type": "array", "items": { "$ref": "#/components/schemas/Address" } }, "approvedAdapterIds": { "type": "array", "items": { "type": "string" } }, "minimumSecondsBetweenActions": { "type": "integer", "minimum": 0 }, "minimumPriceX18": { "$ref": "#/components/schemas/AtomicAmount" }, "maximumPriceX18": { "$ref": "#/components/schemas/AtomicAmount" }, "oracleMaximumAgeSeconds": { "type": "integer", "minimum": 1 }, "expiresAt": { "type": "string", "format": "date-time" }, "controlEpoch": { "$ref": "#/components/schemas/AtomicAmount" }, "publicMempoolFallbackAllowed": { "type": "boolean" }, "controllerBinding": { "$ref": "#/components/schemas/ControllerPolicyBindingV2" }, "activatedControllerPolicy": { "$ref": "#/components/schemas/ActivatedControllerPolicyV2" }, "approvedAt": { "type": "string", "format": "date-time" }, "safeTransactionHash": { "$ref": "#/components/schemas/Hash" } } }, "AutonomyPolicyInput": { "type": "object", "additionalProperties": false, "required": [ "vaultId", "level", "emergencyPaused", "maximumAmountPerTransaction", "maximumDailyTurnover", "maximumSlippagePips", "approvedContracts", "approvedAssets", "approvedAdapterIds", "minimumSecondsBetweenActions", "oracleMaximumAgeSeconds", "expiresAt", "controlEpoch", "publicMempoolFallbackAllowed" ], "properties": { "vaultId": { "type": "string" }, "level": { "type": "integer", "enum": [ 0, 1, 2, 3, 4 ] }, "emergencyPaused": { "type": "boolean" }, "maximumAmountPerTransaction": { "$ref": "#/components/schemas/AtomicAmount" }, "maximumDailyTurnover": { "$ref": "#/components/schemas/AtomicAmount" }, "maximumSlippagePips": { "$ref": "#/components/schemas/Pips" }, "approvedContracts": { "type": "array", "items": { "$ref": "#/components/schemas/Address" } }, "approvedAssets": { "type": "array", "items": { "$ref": "#/components/schemas/Address" } }, "approvedAdapterIds": { "type": "array", "items": { "type": "string" } }, "minimumSecondsBetweenActions": { "type": "integer", "minimum": 0 }, "minimumPriceX18": { "$ref": "#/components/schemas/AtomicAmount" }, "maximumPriceX18": { "$ref": "#/components/schemas/AtomicAmount" }, "oracleMaximumAgeSeconds": { "type": "integer", "minimum": 1 }, "expiresAt": { "type": "string", "format": "date-time" }, "controlEpoch": { "$ref": "#/components/schemas/AtomicAmount" }, "publicMempoolFallbackAllowed": { "type": "boolean" }, "controllerBinding": { "$ref": "#/components/schemas/ControllerPolicyBindingV2" } } }, "PolicyIntentDraft": { "type": "object", "additionalProperties": false, "required": [ "sourceText", "extractionProvider", "extractionModel", "clauses", "ambiguities", "conflicts", "normalizedAt" ], "properties": { "sourceText": { "type": "string" }, "extractionProvider": { "type": "string" }, "extractionModel": { "type": "string" }, "clauses": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "field", "operator", "value", "unit", "sourceStart", "sourceEnd", "confidencePips" ], "properties": { "field": { "type": "string", "enum": [ "EXECUTABLE_DEPTH_QUOTE", "PRICE_BAND_PIPS", "MAXIMUM_TREASURY_DEPLOYMENT_PIPS", "MAXIMUM_SLIPPAGE_PIPS", "MINIMUM_PRICE_X18", "MAXIMUM_DAILY_TURNOVER_PIPS", "COOLDOWN_SECONDS" ] }, "operator": { "type": "string", "enum": [ "EQ", "LTE", "GTE" ] }, "value": { "type": "string" }, "unit": { "type": "string", "enum": [ "QUOTE_ATOMIC", "QUOTE_WHOLE_UNITS", "PIPS", "PRICE_X18", "SECONDS" ] }, "sourceStart": { "type": "integer", "minimum": 0 }, "sourceEnd": { "type": "integer", "minimum": 0 }, "confidencePips": { "$ref": "#/components/schemas/Pips" } } } }, "ambiguities": { "type": "array", "items": { "type": "string" } }, "conflicts": { "type": "array", "items": { "type": "string" } }, "normalizedAt": { "type": "string", "format": "date-time" } } }, "ProtectedExecutionQuote": { "type": "object", "additionalProperties": false, "required": [ "quoteId", "requestId", "typedActionIntentHash", "providerId", "providerKeyResourceVersion", "providerAttestationHash", "routeKind", "amountIn", "amountOut", "gasCostQuote", "providerFeeQuote", "maximumSlippagePips", "expiresAt", "partialFillAllowed", "minimumFillAmount", "settlementAdapterId", "signature", "evidenceHash" ], "properties": { "quoteId": { "type": "string" }, "requestId": { "type": "string" }, "typedActionIntentHash": { "$ref": "#/components/schemas/Hash" }, "providerId": { "type": "string" }, "providerKeyResourceVersion": { "$ref": "#/components/schemas/Hash" }, "providerAttestationHash": { "$ref": "#/components/schemas/Hash" }, "routeKind": { "type": "string", "enum": [ "PRIVATE_AMM", "RFQ", "SOLVER", "PUBLIC_AMM" ] }, "amountIn": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "amountOut": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "gasCostQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "providerFeeQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "maximumSlippagePips": { "$ref": "#/components/schemas/Pips" }, "expiresAt": { "type": "string", "format": "date-time" }, "partialFillAllowed": { "type": "boolean" }, "minimumFillAmount": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "settlementAdapterId": { "type": "string" }, "signature": { "type": "string", "contentEncoding": "base64" }, "evidenceHash": { "$ref": "#/components/schemas/Hash" } } }, "ProtectedExecutionProviderBinding": { "type": "object", "additionalProperties": false, "required": [ "providerId", "capability", "providerKeyResourceVersion", "providerAttestationHash", "providerVenueScope" ], "properties": { "providerId": { "type": "string" }, "capability": { "type": "string", "enum": [ "PRIVATE_RELAY", "RFQ", "SOLVER", "RPC" ] }, "providerKeyResourceVersion": { "$ref": "#/components/schemas/Hash" }, "providerAttestationHash": { "$ref": "#/components/schemas/Hash" }, "providerVenueScope": { "type": "array", "items": { "type": "string" }, "minItems": 2, "maxItems": 128, "uniqueItems": true } } }, "ProtectedExecutionQuoteRequest": { "type": "object", "additionalProperties": false, "required": [ "requestId", "vaultId", "chainId", "assetIn", "assetOut", "costQuoteAsset", "settlementContract", "settlementAdapterId", "amountIn", "maximumSlippagePips", "expiresAt", "createdAt", "autonomyPolicyId", "autonomyPolicyResourceVersion", "autonomyPolicyArtifactHash", "controlEpoch", "publicMempoolFallbackAllowed", "typedActionIntentHash", "venueBinding", "providerBindings" ], "properties": { "requestId": { "type": "string" }, "vaultId": { "type": "string" }, "chainId": { "type": "integer", "minimum": 1 }, "assetIn": { "$ref": "#/components/schemas/Address" }, "assetOut": { "$ref": "#/components/schemas/Address" }, "costQuoteAsset": { "$ref": "#/components/schemas/Address" }, "settlementContract": { "$ref": "#/components/schemas/Address" }, "settlementAdapterId": { "type": "string" }, "amountIn": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "maximumSlippagePips": { "$ref": "#/components/schemas/Pips" }, "expiresAt": { "type": "string", "format": "date-time" }, "createdAt": { "type": "string", "format": "date-time" }, "autonomyPolicyId": { "type": "string" }, "autonomyPolicyResourceVersion": { "$ref": "#/components/schemas/Hash" }, "autonomyPolicyArtifactHash": { "$ref": "#/components/schemas/Hash" }, "controlEpoch": { "$ref": "#/components/schemas/AtomicAmount" }, "publicMempoolFallbackAllowed": { "type": "boolean" }, "typedActionIntentHash": { "$ref": "#/components/schemas/Hash" }, "venueBinding": { "$ref": "#/components/schemas/VenueProfileGenerationBinding" }, "providerBindings": { "type": "array", "items": { "$ref": "#/components/schemas/ProtectedExecutionProviderBinding" }, "minItems": 1, "maxItems": 64 } } }, "ProtectedExecutionQuoteSet": { "type": "object", "additionalProperties": false, "required": [ "requestId", "request", "amountIn", "publicMempoolFallbackAllowed", "quotes", "unavailableReasons" ], "properties": { "requestId": { "type": "string" }, "request": { "$ref": "#/components/schemas/ProtectedExecutionQuoteRequest" }, "amountIn": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "publicMempoolFallbackAllowed": { "type": "boolean" }, "quotes": { "type": "array", "items": { "$ref": "#/components/schemas/ProtectedExecutionQuote" }, "maxItems": 64 }, "selectedQuoteId": { "type": "string" }, "unavailableReasons": { "type": "array", "items": { "type": "string" } } } }, "ProtectedExecutionTypedAction": { "type": "object", "additionalProperties": false, "required": [ "actionType", "chainId", "vaultId", "settlementAdapterId", "settlementContract", "assetIn", "assetOut", "amountIn", "minimumAmountOut", "deadline", "quoteId", "childLegId", "policyControlEpoch" ], "properties": { "actionType": { "const": "SWAP_EXACT_INPUT_V2" }, "chainId": { "type": "integer", "minimum": 1 }, "vaultId": { "type": "string" }, "settlementAdapterId": { "type": "string" }, "settlementContract": { "$ref": "#/components/schemas/Address" }, "assetIn": { "$ref": "#/components/schemas/Address" }, "assetOut": { "$ref": "#/components/schemas/Address" }, "amountIn": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "minimumAmountOut": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "deadline": { "type": "string", "format": "date-time" }, "quoteId": { "type": "string" }, "childLegId": { "type": "string" }, "policyControlEpoch": { "$ref": "#/components/schemas/AtomicAmount" }, "controllerExecution": { "$ref": "#/components/schemas/ControllerExecutionBindingV2", "description": "Omitted for PREVIEW_ONLY plans; required by runtime admission for controller-executable plans.", "x-klineo-required-when": "parent ProtectedExecutionPlan.executionClass is CONTROLLER_TYPED_EXECUTABLE" } } }, "CanonicalEvmExecutionResultV1": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "executionSucceeded", "returnDataHash", "logsHash", "stateDeltaHash" ], "properties": { "schemaVersion": { "const": "canonical-evm-execution-result-v1" }, "executionSucceeded": { "type": "boolean" }, "returnDataHash": { "$ref": "#/components/schemas/Hash" }, "logsHash": { "$ref": "#/components/schemas/Hash" }, "stateDeltaHash": { "$ref": "#/components/schemas/Hash" } } }, "ProtectedExecutionActionEnvelopeV2": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "releaseId", "chainId", "planId", "planRootHash", "quoteRequestId", "quoteSetArtifactHash", "autonomyPolicyId", "autonomyPolicyResourceVersion", "autonomyPolicyArtifactHash", "controlEpoch", "childLegId", "vaultId", "vaultAddress", "controllerAddress", "ownerSafe", "typedAction", "typedActionHash", "controllerExecution", "controllerCalldata", "controllerCalldataHash" ], "properties": { "schemaVersion": { "const": "protected-execution-action-envelope-v2" }, "releaseId": { "$ref": "#/components/schemas/Hash" }, "chainId": { "type": "integer", "enum": [ 677, 968 ] }, "planId": { "type": "string" }, "planRootHash": { "$ref": "#/components/schemas/Hash" }, "quoteRequestId": { "type": "string" }, "quoteSetArtifactHash": { "$ref": "#/components/schemas/Hash" }, "autonomyPolicyId": { "type": "string" }, "autonomyPolicyResourceVersion": { "$ref": "#/components/schemas/Hash" }, "autonomyPolicyArtifactHash": { "$ref": "#/components/schemas/Hash" }, "controlEpoch": { "$ref": "#/components/schemas/AtomicAmount" }, "childLegId": { "type": "string" }, "vaultId": { "type": "string" }, "vaultAddress": { "$ref": "#/components/schemas/Address" }, "controllerAddress": { "$ref": "#/components/schemas/Address" }, "ownerSafe": { "$ref": "#/components/schemas/Address" }, "typedAction": { "$ref": "#/components/schemas/ProtectedExecutionTypedAction" }, "typedActionHash": { "$ref": "#/components/schemas/Hash" }, "controllerExecution": { "$ref": "#/components/schemas/ControllerExecutionBindingV2" }, "controllerCalldata": { "type": "string", "pattern": "^0x(?:[0-9a-fA-F]{2})+$" }, "controllerCalldataHash": { "$ref": "#/components/schemas/Hash" } } }, "ProtectedExecutionSubmissionAuthorityV2": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "releaseAuthority", "actionEnvelope", "actionEnvelopeHash", "policyArtifactHash", "activatedControllerPolicyHash", "venueBinding", "vaultGeneration", "safeVerificationEvidenceHash", "minimumFinalityDepth", "authorizationTransactionHash" ], "properties": { "schemaVersion": { "const": "protected-execution-submission-authority-v2" }, "releaseAuthority": { "$ref": "#/components/schemas/OperatingSystemSubmissionReleaseAuthorityV2" }, "actionEnvelope": { "$ref": "#/components/schemas/ProtectedExecutionActionEnvelopeV2" }, "actionEnvelopeHash": { "$ref": "#/components/schemas/Hash" }, "policyArtifactHash": { "$ref": "#/components/schemas/Hash" }, "activatedControllerPolicyHash": { "$ref": "#/components/schemas/Hash" }, "venueBinding": { "$ref": "#/components/schemas/VenueProfileGenerationBinding" }, "vaultGeneration": { "$ref": "#/components/schemas/MigrationVaultGenerationBindingV2" }, "safeVerificationEvidenceHash": { "$ref": "#/components/schemas/Hash" }, "minimumFinalityDepth": { "type": "integer", "minimum": 1 }, "authorizationTransactionHash": { "$ref": "#/components/schemas/Hash" } } }, "ProtectedExecutionTransactionReceiptV2": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "actionEnvelopeHash", "submissionEvidenceHash", "transactionHash", "receiptStatus", "executionResult", "executionResultHash", "finalizedBlockNumber", "finalizedBlockHash", "finalizedAt", "finalityDepth", "finalityEvidenceHash" ], "properties": { "schemaVersion": { "const": "protected-execution-transaction-receipt-v2" }, "actionEnvelopeHash": { "$ref": "#/components/schemas/Hash" }, "submissionEvidenceHash": { "$ref": "#/components/schemas/Hash" }, "transactionHash": { "$ref": "#/components/schemas/Hash" }, "receiptStatus": { "type": "integer", "enum": [ 0, 1 ] }, "executionResult": { "$ref": "#/components/schemas/CanonicalEvmExecutionResultV1" }, "executionResultHash": { "$ref": "#/components/schemas/Hash" }, "finalizedBlockNumber": { "$ref": "#/components/schemas/AtomicAmount" }, "finalizedBlockHash": { "$ref": "#/components/schemas/Hash" }, "finalizedAt": { "type": "string", "format": "date-time" }, "finalityDepth": { "type": "integer", "minimum": 1 }, "finalityEvidenceHash": { "$ref": "#/components/schemas/Hash" } } }, "ProtectedExecutionLegTransition": { "type": "object", "additionalProperties": false, "required": [ "sequence", "childLegId", "fromStatus", "toStatus", "previousStateHash", "observedAt" ], "properties": { "sequence": { "type": "integer", "minimum": 1 }, "childLegId": { "type": "string" }, "fromStatus": { "type": "string", "enum": [ "PREPARED", "SUBMITTED", "FINALIZED_RECONCILED", "PAUSED", "FAILED" ] }, "toStatus": { "type": "string", "enum": [ "SUBMITTED", "FINALIZED_RECONCILED", "PAUSED", "FAILED" ] }, "previousStateHash": { "$ref": "#/components/schemas/Hash" }, "observedAt": { "type": "string", "format": "date-time" }, "decodedTypedActionHash": { "$ref": "#/components/schemas/Hash" }, "controllerControlEpoch": { "$ref": "#/components/schemas/AtomicAmount" }, "controllerActivePolicyHash": { "$ref": "#/components/schemas/Hash" }, "submissionEvidenceHash": { "$ref": "#/components/schemas/Hash" }, "submissionAuthority": { "$ref": "#/components/schemas/ProtectedExecutionSubmissionAuthorityV2" }, "transactionHash": { "$ref": "#/components/schemas/Hash" }, "finalityEvidenceHash": { "$ref": "#/components/schemas/Hash" }, "reconciliationEvidenceHash": { "$ref": "#/components/schemas/Hash" }, "failureEvidenceHash": { "$ref": "#/components/schemas/Hash" }, "executionReceipt": { "$ref": "#/components/schemas/ProtectedExecutionTransactionReceiptV2" }, "consumedAmountIn": { "$ref": "#/components/schemas/AtomicAmount" }, "residualAmountIn": { "$ref": "#/components/schemas/AtomicAmount" }, "amountOutReceived": { "$ref": "#/components/schemas/AtomicAmount" } } }, "ProtectedExecutionPlan": { "type": "object", "additionalProperties": false, "required": [ "planId", "quoteRequestId", "quoteSetResourceVersion", "quoteSetArtifactHash", "autonomyPolicyId", "autonomyPolicyResourceVersion", "autonomyPolicyArtifactHash", "controlEpoch", "publicMempoolFallbackAllowed", "executionClass", "executionUnavailableReasons", "status", "netAmountOutQuote", "childLegs", "transitions", "totalInputAmount", "totalConsumedAmount", "totalResidualAmount", "totalUnresolvedAmount", "totalAmountOutReceived", "requiresSafeApproval" ], "properties": { "planId": { "type": "string" }, "quoteRequestId": { "type": "string" }, "quoteSetResourceVersion": { "$ref": "#/components/schemas/Hash" }, "quoteSetArtifactHash": { "$ref": "#/components/schemas/Hash" }, "autonomyPolicyId": { "type": "string" }, "autonomyPolicyResourceVersion": { "$ref": "#/components/schemas/Hash" }, "autonomyPolicyArtifactHash": { "$ref": "#/components/schemas/Hash" }, "controlEpoch": { "$ref": "#/components/schemas/AtomicAmount" }, "publicMempoolFallbackAllowed": { "type": "boolean" }, "executionClass": { "type": "string", "enum": [ "PREVIEW_ONLY", "CONTROLLER_TYPED_EXECUTABLE" ] }, "executionUnavailableReasons": { "type": "array", "items": { "type": "string" } }, "status": { "type": "string", "enum": [ "PREPARED", "IN_PROGRESS", "COMPLETED", "PAUSED", "FAILED_CLOSED" ] }, "selectedQuote": { "$ref": "#/components/schemas/ProtectedExecutionQuote" }, "netAmountOutQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "childLegs": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "childLegId", "index", "amountIn", "minimumAmountOut", "expiresAt", "state", "typedAction" ], "properties": { "childLegId": { "type": "string" }, "index": { "type": "integer", "minimum": 0 }, "amountIn": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "minimumAmountOut": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "expiresAt": { "type": "string", "format": "date-time" }, "state": { "type": "string", "enum": [ "PREPARED", "SUBMITTED", "FINALIZED_RECONCILED", "PAUSED", "FAILED" ] }, "typedAction": { "$ref": "#/components/schemas/ProtectedExecutionTypedAction" }, "typedActionHash": { "$ref": "#/components/schemas/Hash" }, "submissionEvidenceHash": { "$ref": "#/components/schemas/Hash" }, "transactionHash": { "$ref": "#/components/schemas/Hash" }, "finalityEvidenceHash": { "$ref": "#/components/schemas/Hash" }, "reconciliationEvidenceHash": { "$ref": "#/components/schemas/Hash" }, "failureEvidenceHash": { "$ref": "#/components/schemas/Hash" }, "executionReceipt": { "$ref": "#/components/schemas/ProtectedExecutionTransactionReceiptV2" }, "consumedAmountIn": { "$ref": "#/components/schemas/AtomicAmount" }, "residualAmountIn": { "$ref": "#/components/schemas/AtomicAmount" }, "amountOutReceived": { "$ref": "#/components/schemas/AtomicAmount" } } } }, "transitions": { "type": "array", "items": { "$ref": "#/components/schemas/ProtectedExecutionLegTransition" } }, "totalInputAmount": { "$ref": "#/components/schemas/AtomicAmount" }, "totalConsumedAmount": { "$ref": "#/components/schemas/AtomicAmount" }, "totalResidualAmount": { "$ref": "#/components/schemas/AtomicAmount" }, "totalUnresolvedAmount": { "$ref": "#/components/schemas/AtomicAmount" }, "totalAmountOutReceived": { "$ref": "#/components/schemas/AtomicAmount" }, "fallbackQuoteId": { "type": "string" }, "requiresSafeApproval": { "type": "boolean" }, "pauseReason": { "type": "string", "enum": [ "PRIVATE_EXECUTION_UNAVAILABLE", "QUOTE_EXPIRED", "POLICY_CHANGED" ] } } }, "StrategyPackage": { "type": "object", "additionalProperties": false, "required": [ "packageId", "publisherOrganizationId", "name", "version", "compilerVersion", "packageContentHash", "compilerHash", "definition", "supportedAssetIds", "supportedVenueIds", "riskClass", "performanceAssumptions", "historicalTests", "forkTests", "independentReviews", "maximumCapitalQuote", "failureConditions", "executionSurface", "activationEligibility", "status" ], "properties": { "packageId": { "type": "string" }, "publisherOrganizationId": { "type": "string" }, "name": { "type": "string" }, "version": { "type": "string" }, "compilerVersion": { "const": "strategy-dsl-v1" }, "packageContentHash": { "$ref": "#/components/schemas/Hash" }, "compilerHash": { "$ref": "#/components/schemas/Hash" }, "definition": { "$ref": "#/components/schemas/StrategyDefinitionV2Input" }, "supportedAssetIds": { "type": "array", "items": { "type": "string" } }, "supportedVenueIds": { "type": "array", "items": { "type": "string" } }, "riskClass": { "type": "string", "enum": [ "LOW", "MODERATE", "HIGH", "EXPERIMENTAL" ] }, "performanceAssumptions": { "type": "array", "items": { "type": "string" } }, "historicalTests": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "studyId", "datasetHash", "reportHash", "compilerHash", "passedAt", "passed" ], "properties": { "studyId": { "type": "string" }, "datasetHash": { "$ref": "#/components/schemas/Hash" }, "reportHash": { "$ref": "#/components/schemas/Hash" }, "compilerHash": { "$ref": "#/components/schemas/Hash" }, "passedAt": { "type": "string", "format": "date-time" }, "passed": { "const": true } } } }, "forkTests": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "testRunId", "chainId", "forkBlockNumber", "forkBlockHash", "rpcQuorumEvidenceHashes", "artifactHash", "compilerHash", "passedAt", "passed" ], "properties": { "testRunId": { "type": "string" }, "chainId": { "type": "integer", "minimum": 1 }, "forkBlockNumber": { "$ref": "#/components/schemas/AtomicAmount" }, "forkBlockHash": { "$ref": "#/components/schemas/Hash" }, "rpcQuorumEvidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" } }, "artifactHash": { "$ref": "#/components/schemas/Hash" }, "compilerHash": { "$ref": "#/components/schemas/Hash" }, "passedAt": { "type": "string", "format": "date-time" }, "passed": { "const": true } } } }, "independentReviews": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "reviewerIdentityId", "reviewerName", "reviewerOrganization", "reviewedPackageContentHash", "evidenceHash", "reviewedAt", "decision" ], "properties": { "reviewerIdentityId": { "type": "string" }, "reviewerName": { "type": "string" }, "reviewerOrganization": { "type": "string" }, "reviewedPackageContentHash": { "$ref": "#/components/schemas/Hash" }, "evidenceHash": { "$ref": "#/components/schemas/Hash" }, "reviewedAt": { "type": "string", "format": "date-time" }, "decision": { "const": "APPROVE" } } } }, "maximumCapitalQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "failureConditions": { "type": "array", "items": { "type": "string" } }, "approvalRegistryEvidence": { "type": "object", "additionalProperties": false, "required": [ "approvalId", "providerId", "providerKeyResourceVersion", "providerAttestationHash", "packageId", "packageVersion", "packageContentHash", "compilerHash", "reviewSetHash", "issuedAt", "validUntil", "signature" ], "properties": { "approvalId": { "type": "string" }, "providerId": { "type": "string" }, "providerKeyResourceVersion": { "$ref": "#/components/schemas/Hash" }, "providerAttestationHash": { "$ref": "#/components/schemas/Hash" }, "packageId": { "type": "string" }, "packageVersion": { "type": "string" }, "packageContentHash": { "$ref": "#/components/schemas/Hash" }, "compilerHash": { "$ref": "#/components/schemas/Hash" }, "reviewSetHash": { "$ref": "#/components/schemas/Hash" }, "issuedAt": { "type": "string", "format": "date-time" }, "validUntil": { "type": "string", "format": "date-time" }, "signature": { "type": "string" } } }, "executionSurface": { "const": "DECLARATIVE_NO_NETWORK_NO_SIGNING" }, "activationEligibility": { "type": "string", "enum": [ "DIGITAL_TWIN_ONLY", "ACTIVATION_WORKFLOW_ELIGIBLE", "REVOKED" ] }, "status": { "type": "string", "enum": [ "CANDIDATE", "APPROVED", "REVOKED" ] } } }, "PartnerLogoAsset": { "type": "object", "additionalProperties": false, "required": [ "mediaType", "contentBase64", "contentHash" ], "properties": { "mediaType": { "const": "image/png" }, "contentBase64": { "type": "string", "minLength": 1, "maxLength": 174764, "contentEncoding": "base64", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$" }, "contentHash": { "$ref": "#/components/schemas/Hash" } } }, "PartnerTenant": { "type": "object", "additionalProperties": false, "required": [ "partnerId", "name", "verifiedDomains", "domainVerifications", "domainVerificationHashes", "accentColor", "terminology", "issuerOrganizationIds", "portfolioReaderActorIds", "proposalPreparerActorIds", "reportBrandName" ], "properties": { "partnerId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "name": { "type": "string", "minLength": 2, "maxLength": 160, "pattern": "^[^\\u0000-\\u001f\\u007f]+$" }, "verifiedDomains": { "type": "array", "items": { "type": "string", "minLength": 3, "maxLength": 253 }, "minItems": 1, "maxItems": 32 }, "domainVerifications": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "domain", "providerId", "providerKeyResourceVersion", "providerAttestationHash", "challengeHash", "observedAt", "validUntil", "signature" ], "properties": { "domain": { "type": "string", "minLength": 3, "maxLength": 253, "pattern": "^(?=.{1,253}$)(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\\.)+[a-zA-Z]{2,63}$" }, "providerId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "providerKeyResourceVersion": { "$ref": "#/components/schemas/Hash" }, "providerAttestationHash": { "$ref": "#/components/schemas/Hash" }, "challengeHash": { "$ref": "#/components/schemas/Hash" }, "observedAt": { "type": "string", "format": "date-time" }, "validUntil": { "type": "string", "format": "date-time" }, "signature": { "type": "string", "pattern": "^[A-Za-z0-9+/]{80,700}={0,2}$" } } }, "minItems": 1, "maxItems": 32 }, "domainVerificationHashes": { "type": "object", "propertyNames": { "type": "string", "minLength": 3, "maxLength": 253 }, "additionalProperties": { "$ref": "#/components/schemas/Hash" } }, "logoAsset": { "$ref": "#/components/schemas/PartnerLogoAsset" }, "accentColor": { "type": "string", "pattern": "^#[0-9a-fA-F]{6}$" }, "terminology": { "type": "object", "maxProperties": 64, "propertyNames": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\u0000-\\u001f\\u007f]+$" }, "additionalProperties": { "type": "string", "minLength": 1, "maxLength": 120, "pattern": "^[^\\u0000-\\u001f\\u007f]+$" } }, "issuerOrganizationIds": { "type": "array", "items": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "maxItems": 1000 }, "portfolioReaderActorIds": { "type": "array", "items": { "type": "string", "format": "uuid" }, "maxItems": 1000 }, "proposalPreparerActorIds": { "type": "array", "items": { "type": "string", "format": "uuid" }, "maxItems": 1000 }, "reportBrandName": { "type": "string", "minLength": 2, "maxLength": 160, "pattern": "^[^\\u0000-\\u001f\\u007f]+$" }, "supportEmail": { "type": "string", "format": "email", "maxLength": 254 }, "contactName": { "type": "string", "minLength": 2, "maxLength": 160, "pattern": "^[^\\u0000-\\u001f\\u007f]+$" }, "description": { "type": "string", "minLength": 1, "maxLength": 280 } } }, "PartnerIssuerConsent": { "type": "object", "additionalProperties": false, "required": [ "consentId", "partnerId", "partnerOrganizationId", "issuerOrganizationId", "partnerConfigurationResourceVersion", "partnerConfigurationArtifactHash", "portfolioReaderActorIds", "proposalPreparerActorIds", "grantedAt", "state" ], "properties": { "consentId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "partnerId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "partnerOrganizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "issuerOrganizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "partnerConfigurationResourceVersion": { "$ref": "#/components/schemas/Hash" }, "partnerConfigurationArtifactHash": { "$ref": "#/components/schemas/Hash" }, "portfolioReaderActorIds": { "type": "array", "items": { "type": "string", "format": "uuid" }, "maxItems": 1000 }, "proposalPreparerActorIds": { "type": "array", "items": { "type": "string", "format": "uuid" }, "maxItems": 1000 }, "grantedAt": { "type": "string", "format": "date-time" }, "expiresAt": { "type": "string", "format": "date-time" }, "state": { "type": "string", "enum": [ "ACTIVE", "REVOKED" ] }, "revokedAt": { "type": "string", "format": "date-time" } } }, "MarketMakerMandate": { "type": "object", "additionalProperties": false, "required": [ "mandateId", "counterpartyName", "counterpartyIdentifier", "tokenLoanAtomic", "tokenLoanValueQuote", "stableAllocationQuote", "startsAt", "endsAt", "obligations", "reportedInventoryToken", "reportedInventoryQuote", "returnedToken", "returnedTokenValueQuote", "repaidQuote", "managerCapitalDeployedQuote", "grossReturnsQuote", "usableDepthQuote", "costQuote", "counterpartyExposureQuote", "counterpartyExposureLimitQuote", "ammBenchmark", "evidenceHashes" ], "properties": { "mandateId": { "type": "string" }, "counterpartyName": { "type": "string" }, "counterpartyIdentifier": { "type": "string" }, "tokenLoanAtomic": { "$ref": "#/components/schemas/AtomicAmount" }, "tokenLoanValueQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "stableAllocationQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "startsAt": { "type": "string", "format": "date-time" }, "endsAt": { "type": "string", "format": "date-time" }, "obligations": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "obligationId", "venueId", "minimumDepthQuote", "maximumSpreadPips", "minimumUptimePips" ], "properties": { "obligationId": { "type": "string" }, "venueId": { "type": "string" }, "minimumDepthQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "maximumSpreadPips": { "$ref": "#/components/schemas/Pips" }, "minimumUptimePips": { "$ref": "#/components/schemas/Pips" } } }, "minItems": 1, "maxItems": 64 }, "reportedInventoryToken": { "$ref": "#/components/schemas/AtomicAmount" }, "reportedInventoryQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "returnedToken": { "$ref": "#/components/schemas/AtomicAmount" }, "returnedTokenValueQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "repaidQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "managerCapitalDeployedQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "grossReturnsQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "usableDepthQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "costQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "counterpartyExposureQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "counterpartyExposureLimitQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "ammBenchmark": { "type": "object", "additionalProperties": false, "required": [ "capitalDeployedQuote", "usableDepthQuote", "observedSpreadPips", "costQuote", "reliabilityPips", "evidenceHashes" ], "properties": { "capitalDeployedQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "usableDepthQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "observedSpreadPips": { "$ref": "#/components/schemas/Pips" }, "costQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "reliabilityPips": { "$ref": "#/components/schemas/Pips" }, "evidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "minItems": 1, "maxItems": 128 } } }, "evidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "minItems": 1, "maxItems": 128 } } }, "MarketMakerEvidenceObservation": { "type": "object", "additionalProperties": false, "required": [ "observationId", "mandateId", "sourceKind", "observedAt", "sourceReferenceHash", "sourcePayloadHash", "providerId", "providerKeyResourceVersion", "providerAttestationHash", "signature", "balances", "capitalDeployedQuote", "usableDepthQuote", "observedSpreadPips", "observedUptimePips", "grossReturnsQuote", "feesPaidQuote", "returnedToken", "returnedTokenValueQuote", "repaidQuote", "counterpartyExposureQuote", "reconciliationStatus", "reconciliationEvidenceHashes", "evidenceHashes" ], "properties": { "observationId": { "type": "string" }, "mandateId": { "type": "string" }, "sourceKind": { "type": "string", "enum": [ "ONCHAIN_WALLET", "SIGNED_API", "SIGNED_FILE", "SIGNED_EXCHANGE" ] }, "observedAt": { "type": "string", "format": "date-time" }, "sourceReferenceHash": { "$ref": "#/components/schemas/Hash" }, "sourcePayloadHash": { "$ref": "#/components/schemas/Hash" }, "providerId": { "type": "string" }, "providerKeyResourceVersion": { "$ref": "#/components/schemas/Hash" }, "providerAttestationHash": { "$ref": "#/components/schemas/Hash" }, "signature": { "type": "string", "contentEncoding": "base64" }, "chainEvidence": { "type": "object", "additionalProperties": false, "required": [ "chainId", "chainGenesisHash", "blockNumber", "blockHash", "finality", "rpcQuorumAttestations" ], "properties": { "chainId": { "type": "integer", "minimum": 1 }, "chainGenesisHash": { "$ref": "#/components/schemas/Hash" }, "blockNumber": { "$ref": "#/components/schemas/AtomicAmount" }, "blockHash": { "$ref": "#/components/schemas/Hash" }, "finality": { "const": "FINALIZED" }, "rpcQuorumAttestations": { "type": "array", "items": { "$ref": "#/components/schemas/VenueRpcQuorumAttestation" }, "maxItems": 8 }, "rpcQuorumVerification": { "$ref": "#/components/schemas/VenueRpcQuorumVerification", "readOnly": true } } }, "balances": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "assetId", "amountAtomic", "valueQuote" ], "properties": { "assetId": { "type": "string" }, "amountAtomic": { "$ref": "#/components/schemas/AtomicAmount" }, "valueQuote": { "$ref": "#/components/schemas/AtomicAmount" } } }, "minItems": 1, "maxItems": 1000 }, "capitalDeployedQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "usableDepthQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "observedSpreadPips": { "$ref": "#/components/schemas/Pips" }, "observedUptimePips": { "$ref": "#/components/schemas/Pips" }, "grossReturnsQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "feesPaidQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "returnedToken": { "$ref": "#/components/schemas/AtomicAmount" }, "returnedTokenValueQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "repaidQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "counterpartyExposureQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "reconciliationStatus": { "type": "string", "enum": [ "PENDING", "MATCHED", "DISPUTED", "FINALIZED" ] }, "reconciliationEvidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "maxItems": 128 }, "evidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "minItems": 1, "maxItems": 256 } } }, "MarketMakerEvidenceObservationInput": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "observationId", "mandateId", "sourceKind", "observedAt", "sourceReferenceHash", "sourcePayloadHash", "providerId", "providerKeyResourceVersion", "providerAttestationHash", "signature", "balances", "capitalDeployedQuote", "usableDepthQuote", "observedSpreadPips", "observedUptimePips", "grossReturnsQuote", "feesPaidQuote", "returnedToken", "returnedTokenValueQuote", "repaidQuote", "counterpartyExposureQuote", "reconciliationStatus", "reconciliationEvidenceHashes", "evidenceHashes", "chainEvidence" ], "properties": { "observationId": { "type": "string" }, "mandateId": { "type": "string" }, "observedAt": { "type": "string", "format": "date-time" }, "sourceReferenceHash": { "$ref": "#/components/schemas/Hash" }, "sourcePayloadHash": { "$ref": "#/components/schemas/Hash" }, "providerId": { "type": "string" }, "providerKeyResourceVersion": { "$ref": "#/components/schemas/Hash" }, "providerAttestationHash": { "$ref": "#/components/schemas/Hash" }, "signature": { "type": "string", "contentEncoding": "base64" }, "balances": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "assetId", "amountAtomic", "valueQuote" ], "properties": { "assetId": { "type": "string" }, "amountAtomic": { "$ref": "#/components/schemas/AtomicAmount" }, "valueQuote": { "$ref": "#/components/schemas/AtomicAmount" } } }, "minItems": 1, "maxItems": 1000 }, "capitalDeployedQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "usableDepthQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "observedSpreadPips": { "$ref": "#/components/schemas/Pips" }, "observedUptimePips": { "$ref": "#/components/schemas/Pips" }, "grossReturnsQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "feesPaidQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "returnedToken": { "$ref": "#/components/schemas/AtomicAmount" }, "returnedTokenValueQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "repaidQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "counterpartyExposureQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "evidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "minItems": 1, "maxItems": 256 }, "sourceKind": { "const": "ONCHAIN_WALLET" }, "chainEvidence": { "type": "object", "additionalProperties": false, "required": [ "chainId", "chainGenesisHash", "blockNumber", "blockHash", "finality", "rpcQuorumAttestations" ], "properties": { "chainId": { "type": "integer", "minimum": 1 }, "chainGenesisHash": { "$ref": "#/components/schemas/Hash" }, "blockNumber": { "$ref": "#/components/schemas/AtomicAmount" }, "blockHash": { "$ref": "#/components/schemas/Hash" }, "finality": { "const": "FINALIZED" }, "rpcQuorumAttestations": { "type": "array", "items": { "$ref": "#/components/schemas/VenueRpcQuorumAttestation" }, "maxItems": 8 } } }, "reconciliationStatus": { "type": "string", "enum": [ "PENDING", "DISPUTED" ] }, "reconciliationEvidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "maxItems": 128 } } }, { "type": "object", "additionalProperties": false, "required": [ "observationId", "mandateId", "sourceKind", "observedAt", "sourceReferenceHash", "sourcePayloadHash", "providerId", "providerKeyResourceVersion", "providerAttestationHash", "signature", "balances", "capitalDeployedQuote", "usableDepthQuote", "observedSpreadPips", "observedUptimePips", "grossReturnsQuote", "feesPaidQuote", "returnedToken", "returnedTokenValueQuote", "repaidQuote", "counterpartyExposureQuote", "reconciliationStatus", "reconciliationEvidenceHashes", "evidenceHashes", "chainEvidence" ], "properties": { "observationId": { "type": "string" }, "mandateId": { "type": "string" }, "observedAt": { "type": "string", "format": "date-time" }, "sourceReferenceHash": { "$ref": "#/components/schemas/Hash" }, "sourcePayloadHash": { "$ref": "#/components/schemas/Hash" }, "providerId": { "type": "string" }, "providerKeyResourceVersion": { "$ref": "#/components/schemas/Hash" }, "providerAttestationHash": { "$ref": "#/components/schemas/Hash" }, "signature": { "type": "string", "contentEncoding": "base64" }, "balances": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "assetId", "amountAtomic", "valueQuote" ], "properties": { "assetId": { "type": "string" }, "amountAtomic": { "$ref": "#/components/schemas/AtomicAmount" }, "valueQuote": { "$ref": "#/components/schemas/AtomicAmount" } } }, "minItems": 1, "maxItems": 1000 }, "capitalDeployedQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "usableDepthQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "observedSpreadPips": { "$ref": "#/components/schemas/Pips" }, "observedUptimePips": { "$ref": "#/components/schemas/Pips" }, "grossReturnsQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "feesPaidQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "returnedToken": { "$ref": "#/components/schemas/AtomicAmount" }, "returnedTokenValueQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "repaidQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "counterpartyExposureQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "evidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "minItems": 1, "maxItems": 256 }, "sourceKind": { "const": "ONCHAIN_WALLET" }, "chainEvidence": { "type": "object", "additionalProperties": false, "required": [ "chainId", "chainGenesisHash", "blockNumber", "blockHash", "finality", "rpcQuorumAttestations" ], "properties": { "chainId": { "type": "integer", "minimum": 1 }, "chainGenesisHash": { "$ref": "#/components/schemas/Hash" }, "blockNumber": { "$ref": "#/components/schemas/AtomicAmount" }, "blockHash": { "$ref": "#/components/schemas/Hash" }, "finality": { "const": "FINALIZED" }, "rpcQuorumAttestations": { "type": "array", "items": { "$ref": "#/components/schemas/VenueRpcQuorumAttestation" }, "maxItems": 8 } } }, "reconciliationStatus": { "type": "string", "enum": [ "MATCHED", "FINALIZED" ] }, "reconciliationEvidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "minItems": 1, "maxItems": 128 } } }, { "type": "object", "additionalProperties": false, "required": [ "observationId", "mandateId", "sourceKind", "observedAt", "sourceReferenceHash", "sourcePayloadHash", "providerId", "providerKeyResourceVersion", "providerAttestationHash", "signature", "balances", "capitalDeployedQuote", "usableDepthQuote", "observedSpreadPips", "observedUptimePips", "grossReturnsQuote", "feesPaidQuote", "returnedToken", "returnedTokenValueQuote", "repaidQuote", "counterpartyExposureQuote", "reconciliationStatus", "reconciliationEvidenceHashes", "evidenceHashes" ], "properties": { "observationId": { "type": "string" }, "mandateId": { "type": "string" }, "observedAt": { "type": "string", "format": "date-time" }, "sourceReferenceHash": { "$ref": "#/components/schemas/Hash" }, "sourcePayloadHash": { "$ref": "#/components/schemas/Hash" }, "providerId": { "type": "string" }, "providerKeyResourceVersion": { "$ref": "#/components/schemas/Hash" }, "providerAttestationHash": { "$ref": "#/components/schemas/Hash" }, "signature": { "type": "string", "contentEncoding": "base64" }, "balances": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "assetId", "amountAtomic", "valueQuote" ], "properties": { "assetId": { "type": "string" }, "amountAtomic": { "$ref": "#/components/schemas/AtomicAmount" }, "valueQuote": { "$ref": "#/components/schemas/AtomicAmount" } } }, "minItems": 1, "maxItems": 1000 }, "capitalDeployedQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "usableDepthQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "observedSpreadPips": { "$ref": "#/components/schemas/Pips" }, "observedUptimePips": { "$ref": "#/components/schemas/Pips" }, "grossReturnsQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "feesPaidQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "returnedToken": { "$ref": "#/components/schemas/AtomicAmount" }, "returnedTokenValueQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "repaidQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "counterpartyExposureQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "evidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "minItems": 1, "maxItems": 256 }, "sourceKind": { "type": "string", "enum": [ "SIGNED_API", "SIGNED_FILE", "SIGNED_EXCHANGE" ] }, "reconciliationStatus": { "type": "string", "enum": [ "PENDING", "DISPUTED" ] }, "reconciliationEvidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "maxItems": 128 } } }, { "type": "object", "additionalProperties": false, "required": [ "observationId", "mandateId", "sourceKind", "observedAt", "sourceReferenceHash", "sourcePayloadHash", "providerId", "providerKeyResourceVersion", "providerAttestationHash", "signature", "balances", "capitalDeployedQuote", "usableDepthQuote", "observedSpreadPips", "observedUptimePips", "grossReturnsQuote", "feesPaidQuote", "returnedToken", "returnedTokenValueQuote", "repaidQuote", "counterpartyExposureQuote", "reconciliationStatus", "reconciliationEvidenceHashes", "evidenceHashes" ], "properties": { "observationId": { "type": "string" }, "mandateId": { "type": "string" }, "observedAt": { "type": "string", "format": "date-time" }, "sourceReferenceHash": { "$ref": "#/components/schemas/Hash" }, "sourcePayloadHash": { "$ref": "#/components/schemas/Hash" }, "providerId": { "type": "string" }, "providerKeyResourceVersion": { "$ref": "#/components/schemas/Hash" }, "providerAttestationHash": { "$ref": "#/components/schemas/Hash" }, "signature": { "type": "string", "contentEncoding": "base64" }, "balances": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "assetId", "amountAtomic", "valueQuote" ], "properties": { "assetId": { "type": "string" }, "amountAtomic": { "$ref": "#/components/schemas/AtomicAmount" }, "valueQuote": { "$ref": "#/components/schemas/AtomicAmount" } } }, "minItems": 1, "maxItems": 1000 }, "capitalDeployedQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "usableDepthQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "observedSpreadPips": { "$ref": "#/components/schemas/Pips" }, "observedUptimePips": { "$ref": "#/components/schemas/Pips" }, "grossReturnsQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "feesPaidQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "returnedToken": { "$ref": "#/components/schemas/AtomicAmount" }, "returnedTokenValueQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "repaidQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "counterpartyExposureQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "evidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "minItems": 1, "maxItems": 256 }, "sourceKind": { "type": "string", "enum": [ "SIGNED_API", "SIGNED_FILE", "SIGNED_EXCHANGE" ] }, "reconciliationStatus": { "type": "string", "enum": [ "MATCHED", "FINALIZED" ] }, "reconciliationEvidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "minItems": 1, "maxItems": 128 } } } ] }, "MarketMakerOversight": { "type": "object", "additionalProperties": false, "required": [ "oversightVersion", "mandateId", "reconciliationStatus", "outstandingTokenLoanAtomic", "outstandingTokenLoanValueQuote", "outstandingStableAllocationQuote", "reportedAssetValueQuote", "grossReturnsQuote", "netReturnsQuote", "counterpartyExposureQuote", "counterpartyRiskPips", "counterpartyExposureLimitBreached", "manager", "ammBenchmark", "managerDepthAdvantageQuote", "managerSpreadAdvantagePips", "managerCostPerDepthAdvantagePips", "managerCapitalEfficiencyAdvantagePips", "obligationAttainment", "provenanceHashes", "authorityBoundary", "custodyAuthorityGranted", "cexTradingAuthorityGranted" ], "properties": { "oversightVersion": { "const": "market-maker-oversight-v1" }, "mandateId": { "type": "string" }, "observationId": { "type": "string" }, "reconciliationStatus": { "type": "string", "enum": [ "PENDING", "MATCHED", "DISPUTED", "FINALIZED" ] }, "outstandingTokenLoanAtomic": { "$ref": "#/components/schemas/AtomicAmount" }, "outstandingTokenLoanValueQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "outstandingStableAllocationQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "reportedAssetValueQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "grossReturnsQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "netReturnsQuote": { "$ref": "#/components/schemas/SignedAtomicAmount" }, "counterpartyExposureQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "counterpartyRiskPips": { "$ref": "#/components/schemas/Pips" }, "counterpartyExposureLimitBreached": { "type": "boolean" }, "manager": { "type": "object", "additionalProperties": false, "required": [ "capitalDeployedQuote", "usableDepthQuote", "spreadPips", "costQuote", "costPerDepthPips", "capitalEfficiencyPips", "reliabilityPips" ], "properties": { "capitalDeployedQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "usableDepthQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "spreadPips": { "$ref": "#/components/schemas/Pips" }, "costQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "costPerDepthPips": { "$ref": "#/components/schemas/Pips" }, "capitalEfficiencyPips": { "$ref": "#/components/schemas/Pips" }, "reliabilityPips": { "$ref": "#/components/schemas/Pips" } } }, "ammBenchmark": { "type": "object", "additionalProperties": false, "required": [ "capitalDeployedQuote", "usableDepthQuote", "spreadPips", "costQuote", "costPerDepthPips", "capitalEfficiencyPips", "reliabilityPips" ], "properties": { "capitalDeployedQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "usableDepthQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "spreadPips": { "$ref": "#/components/schemas/Pips" }, "costQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "costPerDepthPips": { "$ref": "#/components/schemas/Pips" }, "capitalEfficiencyPips": { "$ref": "#/components/schemas/Pips" }, "reliabilityPips": { "$ref": "#/components/schemas/Pips" } } }, "managerDepthAdvantageQuote": { "$ref": "#/components/schemas/SignedAtomicAmount" }, "managerSpreadAdvantagePips": { "type": "integer" }, "managerCostPerDepthAdvantagePips": { "type": "integer" }, "managerCapitalEfficiencyAdvantagePips": { "type": "integer" }, "obligationAttainment": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "obligationId", "venueId", "depthAttainmentPips", "spreadAttained", "uptimeAttained", "slaAttained" ], "properties": { "obligationId": { "type": "string" }, "venueId": { "type": "string" }, "depthAttainmentPips": { "$ref": "#/components/schemas/Pips" }, "spreadAttained": { "type": "boolean" }, "uptimeAttained": { "type": "boolean" }, "slaAttained": { "type": "boolean" } } } }, "provenanceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" } }, "authorityBoundary": { "const": "MONITORING_ONLY" }, "custodyAuthorityGranted": { "const": false }, "cexTradingAuthorityGranted": { "const": false } } }, "IncentiveRecommendation": { "type": "string", "enum": [ "INCREASE", "REDUCE", "RETARGET", "CHANGE_POOL", "CHANGE_RANGES", "REPLACE_WITH_TREASURY_LIQUIDITY", "MAINTAIN" ] }, "IncentiveProgram": { "type": "object", "additionalProperties": false, "required": [ "programId", "venueId", "startsAt", "endsAt", "incentivesPaidQuote", "claimedRewardsQuote", "baseline", "observedLiquidityQuote", "observedVolumeQuote", "observedSlippagePips", "observedAt", "observationEvidenceHashes", "retainedLiquidityQuote", "retentionObservedAt", "retentionEvidenceHashes", "verifiedLiquidityDays", "confidencePips", "confidenceMethodology", "confidenceEvidenceHashes" ], "properties": { "programId": { "type": "string" }, "venueId": { "type": "string" }, "startsAt": { "type": "string", "format": "date-time" }, "endsAt": { "type": "string", "format": "date-time" }, "incentivesPaidQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "claimedRewardsQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "baseline": { "type": "object", "additionalProperties": false, "required": [ "baselineId", "method", "windowStartsAt", "windowEndsAt", "frozenAt", "liquidityQuote", "volumeQuote", "slippagePips", "evidenceHashes" ], "properties": { "baselineId": { "type": "string" }, "method": { "type": "string", "enum": [ "PRE_PROGRAM_WINDOW", "MATCHED_CONTROL", "FROZEN_COUNTERFACTUAL" ] }, "windowStartsAt": { "type": "string", "format": "date-time" }, "windowEndsAt": { "type": "string", "format": "date-time" }, "frozenAt": { "type": "string", "format": "date-time" }, "liquidityQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "volumeQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "slippagePips": { "$ref": "#/components/schemas/Pips" }, "evidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "minItems": 1, "maxItems": 128 } } }, "observedLiquidityQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "observedVolumeQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "observedSlippagePips": { "$ref": "#/components/schemas/Pips" }, "observedAt": { "type": "string", "format": "date-time" }, "observationEvidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "minItems": 1, "maxItems": 128 }, "retainedLiquidityQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "retentionObservedAt": { "type": "string", "format": "date-time" }, "retentionEvidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "minItems": 1, "maxItems": 128 }, "verifiedLiquidityDays": { "type": "integer", "minimum": 0, "maximum": 36500 }, "confidencePips": { "$ref": "#/components/schemas/Pips" }, "confidenceMethodology": { "type": "string" }, "confidenceEvidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "minItems": 1, "maxItems": 128 }, "requestedPoolId": { "type": "string" }, "requestedRangeId": { "type": "string" }, "adapterAuthorization": { "type": "object", "additionalProperties": false, "required": [ "adapterId", "venueId", "adapterAddress", "adapterRuntimeHash", "auditHash", "adapterManifestHash", "releasedManifestDigest", "providerId", "providerKeyResourceVersion", "providerAttestationHash", "issuedAt", "validUntil", "allowedRecommendations", "signature" ], "properties": { "adapterId": { "type": "string" }, "venueId": { "type": "string" }, "adapterAddress": { "$ref": "#/components/schemas/Address" }, "adapterRuntimeHash": { "$ref": "#/components/schemas/Hash" }, "auditHash": { "$ref": "#/components/schemas/Hash" }, "adapterManifestHash": { "$ref": "#/components/schemas/Hash" }, "releasedManifestDigest": { "$ref": "#/components/schemas/Hash" }, "providerId": { "type": "string" }, "providerKeyResourceVersion": { "$ref": "#/components/schemas/Hash" }, "providerAttestationHash": { "$ref": "#/components/schemas/Hash" }, "issuedAt": { "type": "string", "format": "date-time" }, "validUntil": { "type": "string", "format": "date-time" }, "allowedRecommendations": { "type": "array", "items": { "$ref": "#/components/schemas/IncentiveRecommendation" }, "minItems": 1, "maxItems": 7 }, "signature": { "type": "string", "contentEncoding": "base64" } } } } }, "IncentiveOptimization": { "type": "object", "additionalProperties": false, "required": [ "optimizerVersion", "programId", "incrementalLiquidityQuote", "incrementalVolumeQuote", "incrementalLiquidityRangeQuote", "incrementalVolumeRangeQuote", "slippageImprovementPips", "claimRatePips", "retentionPips", "costPerVerifiedLiquidityDayQuote", "mercenaryRiskPips", "recommendation", "baselineEvidenceHashes", "measurementEvidenceHashes", "confidenceEvidenceHashes", "reasons" ], "properties": { "optimizerVersion": { "const": "incentive-optimizer-v1" }, "programId": { "type": "string" }, "incrementalLiquidityQuote": { "$ref": "#/components/schemas/SignedAtomicAmount" }, "incrementalVolumeQuote": { "$ref": "#/components/schemas/SignedAtomicAmount" }, "incrementalLiquidityRangeQuote": { "type": "object", "additionalProperties": false, "required": [ "low", "high" ], "properties": { "low": { "$ref": "#/components/schemas/SignedAtomicAmount" }, "high": { "$ref": "#/components/schemas/SignedAtomicAmount" } } }, "incrementalVolumeRangeQuote": { "type": "object", "additionalProperties": false, "required": [ "low", "high" ], "properties": { "low": { "$ref": "#/components/schemas/SignedAtomicAmount" }, "high": { "$ref": "#/components/schemas/SignedAtomicAmount" } } }, "slippageImprovementPips": { "type": "integer" }, "claimRatePips": { "$ref": "#/components/schemas/Pips" }, "retentionPips": { "$ref": "#/components/schemas/Pips" }, "costPerVerifiedLiquidityDayQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "mercenaryRiskPips": { "$ref": "#/components/schemas/Pips" }, "recommendation": { "$ref": "#/components/schemas/IncentiveRecommendation" }, "baselineEvidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" } }, "measurementEvidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" } }, "confidenceEvidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" } }, "reasons": { "type": "array", "items": { "type": "string" } } } }, "LiquidityPassportRecordBinding": { "type": "object", "additionalProperties": false, "required": [ "recordId", "recordVersion", "resourceVersion", "artifactHash" ], "properties": { "recordId": { "type": "string" }, "recordVersion": { "type": "integer", "minimum": 1 }, "resourceVersion": { "$ref": "#/components/schemas/Hash" }, "artifactHash": { "$ref": "#/components/schemas/Hash" } } }, "LiquidityPassportSourceBindings": { "type": "object", "additionalProperties": false, "required": [ "marketQualityScore", "depthRows", "autonomyPolicy", "positionReconciliation", "incidents", "treasuryEntries", "marketMakerEvidence", "reportArtifacts" ], "properties": { "marketQualityScore": { "$ref": "#/components/schemas/LiquidityPassportRecordBinding" }, "depthRows": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "rowIndex", "sourceKind", "source", "sourceEvidenceHash" ], "properties": { "rowIndex": { "type": "integer", "minimum": 0, "maximum": 63 }, "sourceKind": { "type": "string", "enum": [ "VENUE_OBSERVATION", "SIMULATION_STUDY" ] }, "source": { "$ref": "#/components/schemas/LiquidityPassportRecordBinding" }, "venueProfile": { "$ref": "#/components/schemas/LiquidityPassportRecordBinding" }, "simulationVariant": { "type": "string", "enum": [ "CURRENT", "RECOMMENDED", "CONSERVATIVE", "CAPITAL_EFFICIENT", "EMERGENCY" ] }, "sourceEvidenceHash": { "$ref": "#/components/schemas/Hash" } } }, "minItems": 1, "maxItems": 64 }, "autonomyPolicy": { "$ref": "#/components/schemas/LiquidityPassportRecordBinding" }, "positionReconciliation": { "type": "object", "additionalProperties": false, "required": [ "vaultId", "vaultRecordHash", "vaultUpdatedAt", "snapshotId", "snapshotHash", "snapshotCapturedAt", "reconciliationRunId", "reconciliationEvidenceHash", "reconciliationBlockHash" ], "properties": { "vaultId": { "type": "string" }, "vaultRecordHash": { "$ref": "#/components/schemas/Hash" }, "vaultUpdatedAt": { "type": "string", "format": "date-time" }, "snapshotId": { "type": "string" }, "snapshotHash": { "$ref": "#/components/schemas/Hash" }, "snapshotCapturedAt": { "type": "string", "format": "date-time" }, "reconciliationRunId": { "type": "string" }, "reconciliationEvidenceHash": { "$ref": "#/components/schemas/Hash" }, "reconciliationBlockHash": { "$ref": "#/components/schemas/Hash" } } }, "incidents": { "type": "object", "additionalProperties": false, "required": [ "v1IncidentEvidenceHashes", "anomalyEvidenceHashes", "anomalyRecords" ], "properties": { "v1IncidentEvidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "maxItems": 256 }, "anomalyEvidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "maxItems": 256 }, "anomalyRecords": { "type": "array", "items": { "$ref": "#/components/schemas/LiquidityPassportRecordBinding" }, "maxItems": 256 } } }, "treasuryEntries": { "type": "array", "items": { "$ref": "#/components/schemas/LiquidityPassportRecordBinding" }, "maxItems": 256 }, "marketMakerEvidence": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "mandate", "observationEventId", "observationArtifactHash", "providerId", "providerKeyResourceVersion", "providerAttestationHash", "observedAt" ], "properties": { "mandate": { "$ref": "#/components/schemas/LiquidityPassportRecordBinding" }, "observationEventId": { "type": "string" }, "observationArtifactHash": { "$ref": "#/components/schemas/Hash" }, "providerId": { "type": "string" }, "providerKeyResourceVersion": { "$ref": "#/components/schemas/Hash" }, "providerAttestationHash": { "$ref": "#/components/schemas/Hash" }, "observedAt": { "type": "string", "format": "date-time" } } }, "maxItems": 128 }, "reportArtifacts": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "reportId", "contentHash", "bundleHash" ], "properties": { "reportId": { "type": "string" }, "contentHash": { "$ref": "#/components/schemas/Hash" }, "bundleHash": { "$ref": "#/components/schemas/Hash" }, "publicationHash": { "$ref": "#/components/schemas/Hash" } } }, "minItems": 1, "maxItems": 128 } } }, "LiquidityPassport": { "type": "object", "additionalProperties": false, "required": [ "passportVersion", "artifactRendererVersion", "signatureAlgorithm", "signerProviderId", "signerKeyResourceVersion", "slug", "vaultId", "issuerName", "generatedAt", "validUntil", "marketQualityScore", "usableDepthByTradeSize", "historicalReliabilityPips", "policyCompliancePips", "reconciledPositionCount", "majorIncidentCount", "dataFreshnessSeconds", "disclosure", "reportHashes", "sourceBindings", "contentHash", "signature" ], "properties": { "passportVersion": { "const": "liquidity-passport-v1" }, "artifactRendererVersion": { "type": "string", "enum": [ "liquidity-passport-artifacts-v1", "liquidity-passport-artifacts-v2" ] }, "signatureAlgorithm": { "const": "Ed25519" }, "signerProviderId": { "type": "string" }, "signerKeyResourceVersion": { "$ref": "#/components/schemas/Hash" }, "slug": { "type": "string" }, "vaultId": { "type": "string" }, "issuerName": { "type": "string" }, "reportBrand": { "type": "object", "additionalProperties": false, "required": [ "partnerId", "name", "accentColor" ], "properties": { "partnerId": { "type": "string" }, "name": { "type": "string" }, "accentColor": { "type": "string", "pattern": "^#[0-9a-fA-F]{6}$" }, "logoContentHash": { "$ref": "#/components/schemas/Hash" }, "sourceBinding": { "type": "object", "additionalProperties": false, "required": [ "partnerOrganizationId", "partnerConfigurationResourceVersion", "partnerConfigurationArtifactHash", "consentId", "consentResourceVersion", "consentArtifactHash" ], "properties": { "partnerOrganizationId": { "type": "string" }, "partnerConfigurationResourceVersion": { "$ref": "#/components/schemas/Hash" }, "partnerConfigurationArtifactHash": { "$ref": "#/components/schemas/Hash" }, "consentId": { "type": "string" }, "consentResourceVersion": { "$ref": "#/components/schemas/Hash" }, "consentArtifactHash": { "$ref": "#/components/schemas/Hash" } } } } }, "generatedAt": { "type": "string", "format": "date-time" }, "validUntil": { "type": "string", "format": "date-time" }, "marketQualityScore": { "$ref": "#/components/schemas/MarketQualityScore" }, "usableDepthByTradeSize": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "tradeSizeQuote", "buySlippagePips", "sellSlippagePips" ], "properties": { "tradeSizeQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "buySlippagePips": { "$ref": "#/components/schemas/Pips" }, "sellSlippagePips": { "$ref": "#/components/schemas/Pips" } } }, "minItems": 1 }, "historicalReliabilityPips": { "$ref": "#/components/schemas/Pips" }, "policyCompliancePips": { "anyOf": [ { "$ref": "#/components/schemas/Pips" }, { "type": "null" } ] }, "policyLimits": { "type": "object", "additionalProperties": false, "required": [ "level", "maximumAmountPerTransaction", "maximumDailyTurnover", "maximumSlippagePips", "approvedContracts", "approvedAssets", "approvedAdapterIds", "minimumSecondsBetweenActions", "oracleMaximumAgeSeconds", "expiresAt", "controlEpoch", "publicMempoolFallbackAllowed" ], "properties": { "level": { "type": "integer", "enum": [ 0, 1, 2, 3, 4 ] }, "maximumAmountPerTransaction": { "$ref": "#/components/schemas/AtomicAmount" }, "maximumDailyTurnover": { "$ref": "#/components/schemas/AtomicAmount" }, "maximumSlippagePips": { "$ref": "#/components/schemas/Pips" }, "approvedContracts": { "type": "array", "items": { "$ref": "#/components/schemas/Address" }, "maxItems": 256 }, "approvedAssets": { "type": "array", "items": { "$ref": "#/components/schemas/Address" }, "maxItems": 256 }, "approvedAdapterIds": { "type": "array", "items": { "type": "string" }, "maxItems": 256 }, "minimumSecondsBetweenActions": { "type": "integer", "minimum": 0, "maximum": 31536000 }, "minimumPriceX18": { "$ref": "#/components/schemas/AtomicAmount" }, "maximumPriceX18": { "$ref": "#/components/schemas/AtomicAmount" }, "oracleMaximumAgeSeconds": { "type": "integer", "minimum": 1, "maximum": 86400 }, "expiresAt": { "type": "string", "format": "date-time" }, "controlEpoch": { "$ref": "#/components/schemas/AtomicAmount" }, "publicMempoolFallbackAllowed": { "type": "boolean" } } }, "reconciledPositionCount": { "type": "integer", "minimum": 0 }, "majorIncidentCount": { "type": "integer", "minimum": 0 }, "treasuryOwnedLiquidityQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "rentedLiquidityQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "incidentDetails": { "type": "object", "additionalProperties": false, "required": [ "v1IncidentEvidenceHashes", "anomalies" ], "properties": { "v1IncidentEvidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "maxItems": 256 }, "anomalies": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "detectorVersion", "kind", "severity", "artifactHash" ], "properties": { "detectorVersion": { "const": "robust-mad-v1" }, "kind": { "type": "string", "enum": [ "LIQUIDITY_DISAPPEARANCE", "ONE_SIDED_FLOW", "INACTIVE_RANGE", "STABLECOIN_DEPEG", "ORACLE_DISAGREEMENT", "INVENTORY_ACCUMULATION", "EXCESSIVE_TURNOVER", "MANIPULATION_INDICATOR", "SIMULATED_REALIZED_DIVERGENCE" ] }, "severity": { "type": "string", "enum": [ "INFO", "WARNING", "CRITICAL" ] }, "artifactHash": { "$ref": "#/components/schemas/Hash" } } }, "maxItems": 256 } } }, "externalManagerExposureQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "externalManagerNames": { "type": "array", "items": { "type": "string" } }, "dataFreshnessSeconds": { "type": "integer", "minimum": 0 }, "disclosure": { "type": "object", "additionalProperties": false, "required": [ "showTreasuryOwnership", "showExternalManagerNames", "showIncidentDetails", "showPolicyLimits" ], "properties": { "showTreasuryOwnership": { "type": "boolean" }, "showExternalManagerNames": { "type": "boolean" }, "showIncidentDetails": { "type": "boolean" }, "showPolicyLimits": { "type": "boolean" } } }, "reportHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "minItems": 1, "maxItems": 128 }, "sourceBindings": { "$ref": "#/components/schemas/LiquidityPassportSourceBindings" }, "resultsRegistryProviderId": { "type": "string" }, "resultsRegistryProviderResourceVersion": { "$ref": "#/components/schemas/Hash" }, "resultsRegistryProviderAttestationHash": { "$ref": "#/components/schemas/Hash" }, "resultsRegistryCommitmentHash": { "$ref": "#/components/schemas/Hash" }, "resultsRegistryReceipt": { "type": "object", "additionalProperties": false, "required": [ "receiptVersion", "providerId", "providerResourceVersion", "providerAttestationHash", "passportSubjectHash", "commitmentHash", "issuedAt", "signature" ], "properties": { "receiptVersion": { "const": "liquidity-passport-results-registry-receipt-v1" }, "providerId": { "type": "string" }, "providerResourceVersion": { "$ref": "#/components/schemas/Hash" }, "providerAttestationHash": { "$ref": "#/components/schemas/Hash" }, "passportSubjectHash": { "$ref": "#/components/schemas/Hash" }, "commitmentHash": { "$ref": "#/components/schemas/Hash" }, "issuedAt": { "type": "string", "format": "date-time" }, "signature": { "type": "string", "contentEncoding": "base64" } } }, "supersedesPassportHash": { "$ref": "#/components/schemas/Hash" }, "contentHash": { "$ref": "#/components/schemas/Hash" }, "signature": { "type": "string", "contentEncoding": "base64" } } }, "OperatingSystemArtifact": { "type": "object", "additionalProperties": false, "required": [ "organizationId", "contentHash", "recordType", "recordId", "recordVersion", "objectKey", "mediaType", "byteSize", "sourceHashes", "createdAt", "createdBy" ], "properties": { "organizationId": { "type": "string", "minLength": 3, "maxLength": 160 }, "contentHash": { "$ref": "#/components/schemas/Hash" }, "recordType": { "type": "string" }, "recordId": { "type": "string", "minLength": 3, "maxLength": 160 }, "recordVersion": { "type": "integer", "minimum": 1 }, "objectKey": { "type": "string" }, "mediaType": { "type": "string" }, "byteSize": { "$ref": "#/components/schemas/AtomicAmount" }, "sourceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" } }, "retentionUntil": { "type": "string", "format": "date-time" }, "createdAt": { "type": "string", "format": "date-time" }, "createdBy": { "type": "string" } } }, "PublicPartnerBrand": { "type": "object", "additionalProperties": false, "required": [ "domain", "partnerId", "name", "reportBrandName", "logoPath", "terminology", "accentTokens", "verificationHash", "configurationArtifactHash", "configurationVersion", "validUntil" ], "properties": { "domain": { "type": "string" }, "partnerId": { "type": "string" }, "name": { "type": "string", "minLength": 2, "maxLength": 160, "pattern": "^[^\\u0000-\\u001f\\u007f]+$" }, "reportBrandName": { "type": "string", "minLength": 2, "maxLength": 160, "pattern": "^[^\\u0000-\\u001f\\u007f]+$" }, "supportEmail": { "type": "string", "format": "email", "maxLength": 254 }, "logoPath": { "type": [ "string", "null" ], "pattern": "^/api/liquidity-studio/v2/public/partner-brand/logo/0x[0-9a-f]{64}$" }, "terminology": { "type": "object", "maxProperties": 64, "propertyNames": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\u0000-\\u001f\\u007f]+$" }, "additionalProperties": { "type": "string", "minLength": 1, "maxLength": 120, "pattern": "^[^\\u0000-\\u001f\\u007f]+$" } }, "accentTokens": { "type": "object", "additionalProperties": false, "required": [ "darkPrimary", "darkPrimaryForeground", "lightPrimary", "lightPrimaryForeground" ], "properties": { "darkPrimary": { "type": "string", "pattern": "^#[0-9a-f]{6}$" }, "darkPrimaryForeground": { "type": "string", "enum": [ "#000000", "#ffffff" ] }, "lightPrimary": { "type": "string", "pattern": "^#[0-9a-f]{6}$" }, "lightPrimaryForeground": { "type": "string", "enum": [ "#000000", "#ffffff" ] } } }, "verificationHash": { "$ref": "#/components/schemas/Hash" }, "configurationArtifactHash": { "$ref": "#/components/schemas/Hash" }, "configurationVersion": { "type": "integer", "minimum": 1 }, "validUntil": { "type": "string", "format": "date-time" } } }, "ApiError": { "type": "object", "additionalProperties": false, "required": [ "code", "message", "correlationId", "retryable" ], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "remediation": { "type": "string" }, "correlationId": { "type": "string" }, "retryable": { "type": "boolean" }, "fieldErrors": { "type": "object", "additionalProperties": { "type": "array", "items": { "type": "string" } } } } }, "PaginationMeta": { "type": "object", "additionalProperties": false, "required": [ "count", "hasMore" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string" } } }, "OperatingSystemEvent": { "type": "object", "additionalProperties": false, "required": [ "organizationId", "eventId", "recordType", "recordId", "eventKind", "payload", "artifactHash", "createdBy", "actorRole", "reason", "requestId", "createdAt" ], "properties": { "organizationId": { "type": "string", "minLength": 3, "maxLength": 160 }, "eventId": { "type": "string", "minLength": 3, "maxLength": 160 }, "recordType": { "$ref": "#/components/schemas/OperatingSystemRecordType" }, "recordId": { "type": "string", "minLength": 3, "maxLength": 160 }, "eventKind": { "type": "string" }, "payload": { "type": "object", "additionalProperties": true, "required": [], "properties": {} }, "artifactHash": { "$ref": "#/components/schemas/Hash" }, "createdBy": { "type": "string" }, "actorRole": { "type": "string" }, "reason": { "type": "string" }, "requestId": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" } } }, "OperatingSystemJob": { "type": "object", "additionalProperties": false, "required": [ "organizationId", "jobId", "lane", "aggregateType", "aggregateId", "requestPayload", "requestHash", "state", "attempts", "maximumAttempts", "availableAt", "fencingToken", "createdAt", "updatedAt" ], "properties": { "organizationId": { "type": "string", "minLength": 3, "maxLength": 160 }, "jobId": { "type": "string", "minLength": 3, "maxLength": 160 }, "lane": { "type": "string", "enum": [ "QUANTITATIVE_STUDIES", "EXTERNAL_VENUE_INDEXING", "ANOMALY_DETECTION", "PROPOSAL_SCHEDULING", "PROTECTED_EXECUTION_QUOTES", "WEBHOOK_DELIVERY", "REPORTING", "PARTNER_INTEGRATIONS", "AGENT_ORCHESTRATION" ] }, "aggregateType": { "type": "string" }, "aggregateId": { "type": "string", "minLength": 3, "maxLength": 160 }, "requestPayload": { "type": "object", "additionalProperties": true, "required": [], "properties": {} }, "requestHash": { "$ref": "#/components/schemas/Hash" }, "state": { "type": "string", "enum": [ "PENDING", "LEASED", "COMPLETED", "FAILED", "DEAD_LETTER" ] }, "attempts": { "type": "integer", "minimum": 0 }, "maximumAttempts": { "type": "integer", "minimum": 1 }, "availableAt": { "type": "string", "format": "date-time" }, "leaseHolder": { "type": "string" }, "leaseExpiresAt": { "type": "string", "format": "date-time" }, "fencingToken": { "type": "string" }, "result": { "type": "object", "additionalProperties": true, "required": [], "properties": {} }, "lastErrorCode": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "completedAt": { "type": "string", "format": "date-time" } } }, "OperatingSystemProvider": { "type": "object", "additionalProperties": false, "required": [ "organizationId", "providerId", "capability", "chainScope", "venueScope", "attestationHash", "timeoutMilliseconds", "maximumAgeSeconds", "healthState", "consecutiveFailures", "responsePublicKey", "updatedAt", "resourceVersion" ], "properties": { "organizationId": { "type": "string", "minLength": 3, "maxLength": 160 }, "providerId": { "type": "string", "minLength": 3, "maxLength": 160 }, "capability": { "type": "string", "enum": [ "AI_EXTRACTION", "RPC", "ORACLE", "PRIVATE_RELAY", "RFQ", "SOLVER", "OBJECT_STORAGE", "WEBHOOK", "MARKET_MAKER", "INCENTIVE_ADAPTER", "PARTNER", "ISSUER_SIGNING", "RESULTS_REGISTRY", "STRATEGY_APPROVAL_REGISTRY", "DOMAIN_VERIFICATION", "EXECUTION_ATTRIBUTION" ] }, "chainScope": { "type": "array", "items": { "type": "integer", "minimum": 1 } }, "venueScope": { "type": "array", "items": { "type": "string" } }, "attestationHash": { "$ref": "#/components/schemas/Hash" }, "timeoutMilliseconds": { "type": "integer", "minimum": 100, "maximum": 120000 }, "maximumAgeSeconds": { "type": "integer", "minimum": 1, "maximum": 86400 }, "healthState": { "type": "string", "enum": [ "HEALTHY", "DEGRADED", "OPEN_CIRCUIT", "DISABLED" ] }, "consecutiveFailures": { "type": "integer", "minimum": 0 }, "circuitOpenUntil": { "type": "string", "format": "date-time" }, "responsePublicKey": { "type": "string" }, "updatedAt": { "type": "string", "format": "date-time" }, "resourceVersion": { "$ref": "#/components/schemas/Hash" } } }, "StudyShare": { "type": "object", "additionalProperties": false, "required": [ "slug", "studyId", "visibility", "expiresAt", "disclosure", "approvedBy" ], "properties": { "slug": { "type": "string" }, "studyId": { "type": "string", "minLength": 3, "maxLength": 160 }, "visibility": { "type": "string", "enum": [ "PRIVATE", "PUBLIC" ] }, "expiresAt": { "type": "string", "format": "date-time" }, "disclosure": { "type": "object", "additionalProperties": false, "required": [ "includeDrivers", "includeTreasury", "includePolicy" ], "properties": { "includeDrivers": { "type": "boolean" }, "includeTreasury": { "type": "boolean" }, "includePolicy": { "type": "boolean" } } }, "approvedBy": { "type": "string" } } }, "DeveloperCredential": { "type": "object", "additionalProperties": false, "required": [ "credentialId", "label", "kind", "scopes", "keyPrefix", "secretHash", "createdAt" ], "properties": { "credentialId": { "type": "string", "minLength": 3, "maxLength": 160 }, "label": { "type": "string" }, "kind": { "type": "string", "enum": [ "API_KEY", "OAUTH_CLIENT" ] }, "scopes": { "type": "array", "items": { "type": "string", "enum": [ "scores:read", "studies:read", "studies:write", "strategies:validate", "policies:compile", "policies:check", "proposals:read", "proposals:prepare", "vaults:read", "receipts:read", "proof:read", "alerts:read", "webhooks:manage" ] } }, "keyPrefix": { "type": "string", "minLength": 12, "maxLength": 32, "pattern": "^klo_[A-Za-z0-9_-]+$" }, "secretHash": { "$ref": "#/components/schemas/Hash" }, "createdAt": { "type": "string", "format": "date-time" }, "expiresAt": { "type": "string", "format": "date-time" }, "rotatedAt": { "type": "string", "format": "date-time" }, "supersededSecretHash": { "$ref": "#/components/schemas/Hash" } } }, "WebhookSubscription": { "type": "object", "additionalProperties": false, "required": [ "subscriptionId", "url", "eventTypes", "secretHash", "active", "maximumAttempts", "createdAt", "secretReference" ], "properties": { "subscriptionId": { "type": "string", "minLength": 3, "maxLength": 160 }, "url": { "type": "string", "format": "uri" }, "eventTypes": { "type": "array", "items": { "type": "string" } }, "secretHash": { "$ref": "#/components/schemas/Hash" }, "active": { "type": "boolean" }, "maximumAttempts": { "const": 8 }, "createdAt": { "type": "string", "format": "date-time" }, "secretReference": { "type": "string" } } }, "QualifiedVaultV2": { "type": "object", "additionalProperties": false, "required": [ "id", "organizationId", "name", "projectToken", "quoteToken", "ownerSafe", "poolAddress", "lifecycle", "mode", "runtimeVersion", "launchContext", "capitalCapAtomic", "contracts", "deployment", "policy", "control", "createdAt", "updatedAt", "artifactHash", "resourceVersion" ], "properties": { "id": { "type": "string", "minLength": 3, "maxLength": 160 }, "organizationId": { "type": "string", "minLength": 3, "maxLength": 160 }, "name": { "type": "string" }, "projectToken": { "$ref": "#/components/schemas/Address" }, "quoteToken": { "$ref": "#/components/schemas/Address" }, "ownerSafe": { "$ref": "#/components/schemas/Address" }, "poolAddress": { "anyOf": [ { "$ref": "#/components/schemas/Address" }, { "type": "null" } ] }, "lifecycle": { "type": "string" }, "mode": { "type": "string" }, "runtimeVersion": { "type": "string" }, "launchContext": { "anyOf": [ { "type": "object", "additionalProperties": true, "required": [], "properties": {} }, { "type": "null" } ] }, "capitalCapAtomic": { "anyOf": [ { "$ref": "#/components/schemas/AtomicAmount" }, { "type": "null" } ] }, "contracts": { "type": "object", "additionalProperties": true, "required": [], "properties": {} }, "deployment": { "type": "object", "additionalProperties": true, "required": [], "properties": {} }, "policy": { "anyOf": [ { "type": "object", "additionalProperties": true, "required": [], "properties": {} }, { "type": "null" } ] }, "control": { "type": "object", "additionalProperties": true, "required": [], "properties": {} }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "artifactHash": { "$ref": "#/components/schemas/Hash" }, "resourceVersion": { "$ref": "#/components/schemas/Hash" } } }, "ExecutionReceiptV2": { "type": "object", "additionalProperties": false, "required": [ "id", "organizationId", "vaultId", "proposalHash", "transactionHash", "status", "inclusion", "finality", "reconciliation", "attribution", "failureAttribution", "executionAttempts", "sourceProposalState", "createdAt", "updatedAt", "artifactHash", "resourceVersion" ], "properties": { "id": { "type": "string", "minLength": 3, "maxLength": 160 }, "organizationId": { "type": "string", "minLength": 3, "maxLength": 160 }, "vaultId": { "type": "string", "minLength": 3, "maxLength": 160 }, "proposalHash": { "anyOf": [ { "$ref": "#/components/schemas/Hash" }, { "type": "null" } ] }, "transactionHash": { "anyOf": [ { "$ref": "#/components/schemas/Hash" }, { "type": "null" } ] }, "status": { "type": "string", "enum": [ "FAILED_RECONCILED", "FINALIZED_RECONCILED_ATTRIBUTED", "FINALIZED_RECONCILED", "FINALIZED_PENDING_RECONCILIATION", "INCLUDED_PENDING_FINALITY" ] }, "inclusion": { "anyOf": [ { "type": "object", "additionalProperties": true, "required": [], "properties": {} }, { "type": "null" } ] }, "finality": { "anyOf": [ { "type": "object", "additionalProperties": true, "required": [], "properties": {} }, { "type": "null" } ] }, "reconciliation": { "anyOf": [ { "type": "object", "additionalProperties": true, "required": [], "properties": {} }, { "type": "null" } ] }, "attribution": { "anyOf": [ { "type": "object", "additionalProperties": true, "required": [], "properties": {} }, { "type": "null" } ] }, "failureAttribution": { "anyOf": [ { "type": "object", "additionalProperties": true, "required": [], "properties": {} }, { "type": "null" } ] }, "executionAttempts": { "type": "array", "items": { "type": "object", "additionalProperties": true, "required": [], "properties": {} } }, "sourceProposalState": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "artifactHash": { "$ref": "#/components/schemas/Hash" }, "resourceVersion": { "$ref": "#/components/schemas/Hash" } } }, "OAuthTokenResponse": { "type": "object", "additionalProperties": false, "required": [ "access_token", "token_type", "expires_in", "scope" ], "properties": { "access_token": { "type": "string" }, "token_type": { "const": "Bearer" }, "expires_in": { "type": "integer", "minimum": 1 }, "scope": { "type": "string" } } }, "OperatingSystemStatus": { "type": "object", "additionalProperties": false, "required": [ "status", "schemaVersion", "liveAuthority", "executionAdapters", "release", "checkedAt" ], "properties": { "status": { "const": "AVAILABLE" }, "schemaVersion": { "const": "klineo-token-liquidity-os-v2" }, "liveAuthority": { "type": "string", "enum": [ "SIGNED_V2_BOUNDARY", "FAIL_CLOSED" ] }, "executionAdapters": { "type": "object", "additionalProperties": true, "required": [], "properties": {} }, "release": { "type": "object", "additionalProperties": true, "required": [], "properties": {} }, "checkedAt": { "type": "string", "format": "date-time" } } }, "StrategyCompilation": { "type": "object", "additionalProperties": false, "required": [ "compilerVersion", "valid", "allocationPips", "issues", "enforceability", "activationClass" ], "properties": { "compilerVersion": { "const": "strategy-dsl-v1" }, "valid": { "type": "boolean" }, "allocationPips": { "$ref": "#/components/schemas/Pips" }, "issues": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "code", "severity", "path", "message" ], "properties": { "code": { "type": "string" }, "severity": { "type": "string", "enum": [ "ERROR", "WARNING" ] }, "path": { "type": "string" }, "message": { "type": "string" } } } }, "enforceability": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "field", "class", "reason" ], "properties": { "field": { "type": "string" }, "class": { "type": "string", "enum": [ "ONCHAIN", "DETERMINISTIC_OFFCHAIN", "MANUAL_APPROVAL" ] }, "reason": { "type": "string" } } } }, "activationClass": { "type": "string", "enum": [ "BOUNDED_AUTOPILOT_ELIGIBLE", "SAFE_APPROVAL_ONLY", "INVALID" ] } } }, "CompiledPolicyIntent": { "type": "object", "additionalProperties": false, "required": [ "compilerVersion", "valid", "clauses", "errors", "warnings", "confirmationSummary" ], "properties": { "compilerVersion": { "const": "policy-intent-compiler-v1" }, "valid": { "type": "boolean" }, "clauses": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "field", "operator", "value", "unit", "sourceStart", "sourceEnd", "confidencePips", "enforceability" ], "properties": { "field": { "type": "string" }, "operator": { "type": "string", "enum": [ "EQ", "LTE", "GTE" ] }, "value": { "type": "string" }, "unit": { "type": "string", "enum": [ "QUOTE_ATOMIC", "QUOTE_WHOLE_UNITS", "PIPS", "PRICE_X18", "SECONDS" ] }, "sourceStart": { "type": "integer", "minimum": 0 }, "sourceEnd": { "type": "integer", "minimum": 0 }, "confidencePips": { "$ref": "#/components/schemas/Pips" }, "enforceability": { "type": "string", "enum": [ "ONCHAIN", "DETERMINISTIC_OFFCHAIN", "MANUAL_APPROVAL" ] } } } }, "errors": { "type": "array", "items": { "type": "string" } }, "warnings": { "type": "array", "items": { "type": "string" } }, "confirmationSummary": { "type": "array", "items": { "type": "string" } } } }, "OperatingSystemWorkspace": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "role", "navigation", "releaseTrains", "counts", "unavailable", "workers", "providers", "authority" ], "properties": { "schemaVersion": { "const": "klineo-token-liquidity-os-v1" }, "role": { "type": "string" }, "navigation": { "type": "array", "items": { "type": "string", "enum": [ "OPERATE", "PLAN", "SIMULATE", "STRATEGIES", "PROPOSALS", "INTELLIGENCE", "PROVE", "PLATFORM" ] } }, "releaseTrains": { "type": "array", "items": { "type": "object", "additionalProperties": true, "required": [], "properties": {} } }, "counts": { "type": "object", "additionalProperties": { "type": "integer", "minimum": 0 } }, "unavailable": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "recordType", "recordId", "reason" ], "properties": { "recordType": { "$ref": "#/components/schemas/OperatingSystemRecordType" }, "recordId": { "type": "string", "minLength": 3, "maxLength": 160 }, "reason": { "type": "string" } } } }, "workers": { "type": "object", "additionalProperties": false, "required": [ "pending", "deadLetter" ], "properties": { "pending": { "type": "integer", "minimum": 0 }, "deadLetter": { "type": "integer", "minimum": 0 } } }, "providers": { "type": "object", "additionalProperties": false, "required": [ "configured", "healthy", "degraded" ], "properties": { "configured": { "type": "integer", "minimum": 0 }, "healthy": { "type": "integer", "minimum": 0 }, "degraded": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "providerId", "capability", "healthState" ], "properties": { "providerId": { "type": "string", "minLength": 3, "maxLength": 160 }, "capability": { "type": "string", "enum": [ "AI_EXTRACTION", "RPC", "ORACLE", "PRIVATE_RELAY", "RFQ", "SOLVER", "OBJECT_STORAGE", "WEBHOOK", "MARKET_MAKER", "INCENTIVE_ADAPTER", "PARTNER", "ISSUER_SIGNING", "RESULTS_REGISTRY", "STRATEGY_APPROVAL_REGISTRY", "DOMAIN_VERIFICATION", "EXECUTION_ATTRIBUTION" ] }, "healthState": { "type": "string" } } } } } }, "authority": { "type": "object", "additionalProperties": false, "required": [ "aiExecutable", "issuerSafeRequired", "arbitraryCalldataAllowed" ], "properties": { "aiExecutable": { "const": false }, "issuerSafeRequired": { "const": true }, "arbitraryCalldataAllowed": { "const": false } } } } }, "UnifiedLiquidityMap": { "type": "object", "additionalProperties": false, "required": [ "capturedAt", "availability", "deployedCapitalQuote", "activeCapitalQuote", "usableDepthQuote", "venues", "warnings" ], "properties": { "capturedAt": { "type": "string", "format": "date-time" }, "availability": { "type": "string", "enum": [ "AVAILABLE", "DEGRADED", "UNAVAILABLE" ] }, "deployedCapitalQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "activeCapitalQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "usableDepthQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "venues": { "type": "array", "items": { "type": "object", "additionalProperties": true, "required": [ "venueId", "assetMappingId", "deployedCapitalQuote", "activeCapitalQuote", "usableDepthQuote", "freshnessSeconds", "maximumAgeSeconds", "freshness", "profileStatus", "sourceProfileGenerationMatches", "includedInTotals" ], "properties": { "venueId": { "type": "string", "minLength": 3, "maxLength": 160 }, "assetMappingId": { "type": "string", "minLength": 3, "maxLength": 160 }, "deployedCapitalQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "activeCapitalQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "usableDepthQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "freshnessSeconds": { "type": "integer", "minimum": 0 }, "maximumAgeSeconds": { "type": "integer", "minimum": 1 }, "freshness": { "type": "string", "enum": [ "FRESH", "STALE", "FUTURE", "UNVERIFIED" ] }, "profileStatus": { "type": "string", "enum": [ "DRAFT", "VALIDATED", "ACTIVE", "PAUSED", "COMPLETED", "EXPIRED", "REVOKED", "SUPERSEDED", "UNAVAILABLE" ] }, "sourceProfileGenerationMatches": { "type": "boolean" }, "includedInTotals": { "type": "boolean" } } } }, "warnings": { "type": "array", "items": { "type": "string" } } } }, "ProposalDecisionResult": { "type": "object", "additionalProperties": false, "required": [ "proposal", "decision", "safeAuthorityGranted" ], "properties": { "proposal": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/ProposalWorkspace" } } } ] }, "decision": { "$ref": "#/components/schemas/OperatingSystemEvent" }, "approvalProgress": { "type": "object", "additionalProperties": false, "required": [ "approved", "required" ], "properties": { "approved": { "type": "integer", "minimum": 0 }, "required": { "type": "integer", "minimum": 0 } } }, "rejectionReason": { "type": "string" }, "safeAuthorityGranted": { "const": false } } }, "ProposalSafeSubmissionResult": { "type": "object", "additionalProperties": false, "required": [ "proposal", "safeAuthorityEvidence", "safeTransactionRegistered", "executionPerformed" ], "properties": { "proposal": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/ProposalWorkspace" } } } ] }, "safeAuthorityEvidence": { "$ref": "#/components/schemas/OperatingSystemEvent" }, "safeTransactionRegistered": { "const": true }, "executionPerformed": { "const": false } } }, "ProposalComparison": { "type": "object", "additionalProperties": false, "required": [ "comparedAt", "proposals", "immutableComparisonHash", "executionAuthorityGranted" ], "properties": { "comparedAt": { "type": "string", "format": "date-time" }, "proposals": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "id", "version", "title", "expectedImprovementQuote", "maximumDownsideQuote", "costOfNoActionQuote", "beforeDepthQuote", "afterDepthQuote", "approvalProgress", "expiresAt", "artifactHash" ], "properties": { "id": { "type": "string", "minLength": 3, "maxLength": 160 }, "version": { "type": "integer", "minimum": 1 }, "title": { "type": "string" }, "expectedImprovementQuote": { "$ref": "#/components/schemas/SignedAtomicAmount" }, "maximumDownsideQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "costOfNoActionQuote": { "$ref": "#/components/schemas/SignedAtomicAmount" }, "beforeDepthQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "afterDepthQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "approvalProgress": { "type": "string" }, "expiresAt": { "type": "string", "format": "date-time" }, "artifactHash": { "$ref": "#/components/schemas/Hash" } } } }, "immutableComparisonHash": { "$ref": "#/components/schemas/Hash" }, "executionAuthorityGranted": { "const": false } } }, "LaunchTimeline": { "type": "object", "additionalProperties": false, "required": [ "launchPlanId", "resourceVersion", "timeline", "evidenceHash" ], "properties": { "launchPlanId": { "type": "string", "minLength": 3, "maxLength": 160 }, "resourceVersion": { "$ref": "#/components/schemas/Hash" }, "timeline": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "id", "kind", "scheduledAt", "reviewOwnerId", "dependsOn", "requiresReview", "status", "evidenceHashes", "dependenciesComplete" ], "properties": { "id": { "type": "string" }, "kind": { "type": "string", "enum": [ "PRE_LAUNCH_SIMULATION", "INITIAL_FUNDING", "TGE", "FIRST_24_HOURS", "FIRST_7_DAYS", "MAINTENANCE_TRANSITION", "EXCHANGE_LISTING", "INCENTIVE_CHANGE", "TOKEN_UNLOCK", "TREASURY_DIVERSIFICATION" ] }, "scheduledAt": { "type": "string", "format": "date-time" }, "reviewOwnerId": { "type": "string" }, "dependsOn": { "type": "array", "items": { "type": "string" } }, "requiresReview": { "type": "boolean" }, "status": { "type": "string", "enum": [ "PLANNED", "READY", "IN_REVIEW", "COMPLETED", "BLOCKED", "CANCELLED" ] }, "evidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" } }, "recommendationTrigger": { "type": "string" }, "reminderLeadSeconds": { "type": "integer", "minimum": 60 }, "completedAt": { "type": "string", "format": "date-time" }, "completionReceiptHash": { "$ref": "#/components/schemas/Hash" }, "dependenciesComplete": { "type": "boolean" } } } }, "evidenceHash": { "$ref": "#/components/schemas/Hash" } } }, "LaunchWorkspaceSeed": { "type": "object", "additionalProperties": false, "required": [ "issuerIntent", "capitalRequirement", "strategy", "strategyCompilation", "simulationStudy", "policyDraft", "fundingProposal", "fundingProposalTemplate", "proposalPreparationBlockedBy", "vaultQualification", "safeTransactionPrepared", "executionPerformed" ], "properties": { "issuerIntent": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/IssuerIntent" } } } ] }, "capitalRequirement": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/CapitalRequirementStudy" } } } ] }, "strategy": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/StrategyDefinitionV2" } } } ] }, "strategyCompilation": { "$ref": "#/components/schemas/StrategyCompilation" }, "simulationStudy": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/SimulationStudy" } } } ] }, "policyDraft": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/PolicyIntentDraft" } } } ] }, "fundingProposal": { "type": "null" }, "fundingProposalTemplate": { "type": "object", "additionalProperties": true, "required": [], "properties": {} }, "proposalPreparationBlockedBy": { "type": "array", "items": { "type": "string" } }, "vaultQualification": { "type": "object", "additionalProperties": true, "required": [], "properties": {} }, "safeTransactionPrepared": { "const": false }, "executionPerformed": { "const": false } } }, "MigrationPlanStateResult": { "type": "object", "additionalProperties": false, "required": [ "planId", "planResourceVersion", "state", "stateHash", "executionClass", "executionAuthorized", "readyLegIds" ], "properties": { "planId": { "type": "string", "minLength": 3, "maxLength": 160 }, "planResourceVersion": { "$ref": "#/components/schemas/Hash" }, "state": { "$ref": "#/components/schemas/MigrationPlanExecutionState" }, "stateHash": { "$ref": "#/components/schemas/Hash" }, "executionClass": { "type": "string" }, "executionAuthorized": { "const": false }, "readyLegIds": { "type": "array", "items": { "type": "string", "minLength": 3, "maxLength": 160 } } } }, "MigrationTransitionResult": { "type": "object", "additionalProperties": false, "required": [ "event", "state", "stateHash", "executionClass", "executionAuthorized", "evidenceAuthority", "evidenceHashes" ], "properties": { "event": { "$ref": "#/components/schemas/OperatingSystemEvent" }, "state": { "$ref": "#/components/schemas/MigrationPlanExecutionState" }, "stateHash": { "$ref": "#/components/schemas/Hash" }, "executionClass": { "type": "string" }, "executionAuthorized": { "const": true }, "evidenceAuthority": { "const": "SERVER_VERIFIED_LEG_SPECIFIC" }, "evidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" } } } }, "PolicyCompilationResult": { "type": "object", "additionalProperties": false, "required": [ "compilation", "executable", "nextRequiredGates" ], "properties": { "compilation": { "$ref": "#/components/schemas/CompiledPolicyIntent" }, "executable": { "const": false }, "nextRequiredGates": { "type": "array", "items": { "type": "string", "enum": [ "USER_CONFIRMATION", "REVIEW", "SIMULATION", "TIMELOCK", "ISSUER_SAFE" ] } } } }, "PolicyDraftResult": { "type": "object", "additionalProperties": false, "required": [ "draft", "compilationPreview", "executable" ], "properties": { "draft": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/PolicyIntentDraft" } } } ] }, "compilationPreview": { "$ref": "#/components/schemas/CompiledPolicyIntent" }, "executable": { "const": false } } }, "PolicyCheckResult": { "type": "object", "additionalProperties": false, "required": [ "check", "evidence" ], "properties": { "check": { "type": "object", "additionalProperties": false, "required": [ "compilerVersion", "valid", "errors", "authorityExpansion", "exactPolicyHash", "executable", "activationGates", "checkedAt" ], "properties": { "compilerVersion": { "const": "autonomy-policy-check-v1" }, "valid": { "type": "boolean" }, "errors": { "type": "array", "items": { "type": "string" } }, "authorityExpansion": { "type": "boolean" }, "exactPolicyHash": { "$ref": "#/components/schemas/Hash" }, "executable": { "const": false }, "activationGates": { "type": "array", "items": { "type": "string" } }, "checkedAt": { "type": "string", "format": "date-time" } } }, "evidence": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/PolicyIntentDraft" } } } ] } } }, "PartnerPortfolio": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "partnerId", "partnerConfigurationResourceVersion", "partnerConfigurationArtifactHash", "brand", "issuers", "generatedAt", "custodyAuthorityGranted", "crossIssuerMutationAuthorityGranted" ], "properties": { "schemaVersion": { "const": "partner-portfolio-view-v2" }, "partnerId": { "type": "string", "minLength": 3, "maxLength": 160 }, "partnerConfigurationResourceVersion": { "$ref": "#/components/schemas/Hash" }, "partnerConfigurationArtifactHash": { "$ref": "#/components/schemas/Hash" }, "brand": { "type": "object", "additionalProperties": false, "required": [ "name", "reportBrandName", "accentColor", "verifiedDomains" ], "properties": { "name": { "type": "string" }, "reportBrandName": { "type": "string" }, "accentColor": { "type": "string" }, "verifiedDomains": { "type": "array", "items": { "type": "string" } } } }, "issuers": { "type": "array", "items": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "issuerOrganizationId", "availability", "consentArtifactHash", "consentResourceVersion", "consentStatus", "consentExpiresAt", "proposalPreparationScope", "marketQuality", "venueCount", "proposals" ], "properties": { "issuerOrganizationId": { "type": "string", "minLength": 3, "maxLength": 160 }, "availability": { "const": "AVAILABLE" }, "consentArtifactHash": { "$ref": "#/components/schemas/Hash" }, "consentResourceVersion": { "$ref": "#/components/schemas/Hash" }, "consentStatus": { "const": "ACTIVE" }, "consentExpiresAt": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "proposalPreparationScope": { "type": "string", "enum": [ "DECLARED", "NOT_DECLARED" ] }, "marketQuality": { "anyOf": [ { "type": "object", "additionalProperties": false, "required": [ "score", "capturedAt", "coveragePips", "artifactHash" ], "properties": { "score": { "type": "integer", "minimum": 0, "maximum": 100 }, "capturedAt": { "type": "string", "format": "date-time" }, "coveragePips": { "$ref": "#/components/schemas/Pips" }, "artifactHash": { "$ref": "#/components/schemas/Hash" } } }, { "type": "object", "additionalProperties": false, "required": [ "availability" ], "properties": { "availability": { "const": "UNAVAILABLE" } } } ] }, "venueCount": { "type": "integer", "minimum": 0 }, "proposals": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "proposalId", "title", "status", "expiresAt", "artifactHash" ], "properties": { "proposalId": { "type": "string", "minLength": 3, "maxLength": 160 }, "title": { "type": "string" }, "status": { "$ref": "#/components/schemas/OperatingSystemRecordStatus" }, "expiresAt": { "type": "string", "format": "date-time" }, "artifactHash": { "$ref": "#/components/schemas/Hash" } } } } } }, { "type": "object", "additionalProperties": false, "required": [ "issuerOrganizationId", "availability" ], "properties": { "issuerOrganizationId": { "type": "string", "minLength": 3, "maxLength": 160 }, "availability": { "const": "UNAVAILABLE_NO_BILATERAL_CONSENT" } } } ] } }, "generatedAt": { "type": "string", "format": "date-time" }, "custodyAuthorityGranted": { "const": false }, "crossIssuerMutationAuthorityGranted": { "const": false } } }, "PartnerProposalPreparationResult": { "type": "object", "additionalProperties": false, "required": [ "preparation", "deliveryJobId", "issuerImportAndStandardApprovalRequired", "safeAuthorityGranted", "custodyAuthorityGranted" ], "properties": { "preparation": { "$ref": "#/components/schemas/OperatingSystemEvent" }, "deliveryJobId": { "anyOf": [ { "type": "string", "minLength": 3, "maxLength": 160 }, { "type": "null" } ] }, "issuerImportAndStandardApprovalRequired": { "const": true }, "safeAuthorityGranted": { "const": false }, "custodyAuthorityGranted": { "const": false } } }, "MarketMakerEvidenceResult": { "type": "object", "additionalProperties": false, "required": [ "observation", "oversight", "comparison", "provenancePreserved", "reconciliationStatus", "custodyAuthorityGranted", "cexTradingAuthorityGranted" ], "properties": { "observation": { "$ref": "#/components/schemas/OperatingSystemEvent" }, "oversight": { "$ref": "#/components/schemas/MarketMakerOversight" }, "comparison": { "type": "array", "items": { "type": "object", "additionalProperties": true, "required": [], "properties": {} } }, "provenancePreserved": { "const": true }, "reconciliationStatus": { "type": "string", "enum": [ "PENDING", "MATCHED", "DISPUTED", "FINALIZED" ] }, "custodyAuthorityGranted": { "const": false }, "cexTradingAuthorityGranted": { "const": false } } }, "IncentiveOptimizationResult": { "type": "object", "additionalProperties": false, "required": [ "program", "optimization", "workflow", "executionAuthority", "executionPerformed" ], "properties": { "program": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/IncentiveProgram" } } } ] }, "optimization": { "$ref": "#/components/schemas/IncentiveOptimization" }, "workflow": { "type": "object", "additionalProperties": true, "required": [ "mode", "preparationHash", "evidenceEventId" ], "properties": { "mode": { "type": "string", "enum": [ "TYPED_ADAPTER_ACTIVATION_REVIEW", "OPERATIONAL_PROPOSAL_PREPARATION" ] }, "preparationHash": { "$ref": "#/components/schemas/Hash" }, "evidenceEventId": { "type": "string", "minLength": 3, "maxLength": 160 } } }, "executionAuthority": { "type": "string", "enum": [ "STANDARD_TYPED_ADAPTER_ACTIVATION_WORKFLOW", "OPERATIONAL_PROPOSAL_ONLY" ] }, "executionPerformed": { "const": false } } }, "PublicPassportResult": { "type": "object", "additionalProperties": false, "required": [ "passport", "publication", "verification" ], "properties": { "passport": { "$ref": "#/components/schemas/LiquidityPassport" }, "publication": { "type": "object", "additionalProperties": false, "required": [ "version", "artifactHash", "publishedAt", "supersedesVersion" ], "properties": { "version": { "type": "integer", "minimum": 1 }, "artifactHash": { "$ref": "#/components/schemas/Hash" }, "publishedAt": { "type": "string", "format": "date-time" }, "supersedesVersion": { "anyOf": [ { "type": "integer", "minimum": 1 }, { "type": "null" } ] } } }, "verification": { "type": "object", "additionalProperties": false, "required": [ "signatureValid", "signatureAlgorithm", "signerProviderId", "signerKeyResourceVersion", "signerAttestationHash", "responsePublicKey", "publicKeyFingerprint", "trustAnchorState", "verifiedAt" ], "properties": { "signatureValid": { "const": true }, "signatureAlgorithm": { "const": "Ed25519" }, "signerProviderId": { "type": "string", "minLength": 3, "maxLength": 160 }, "signerKeyResourceVersion": { "$ref": "#/components/schemas/Hash" }, "signerAttestationHash": { "$ref": "#/components/schemas/Hash" }, "responsePublicKey": { "type": "string", "contentEncoding": "base64" }, "publicKeyFingerprint": { "$ref": "#/components/schemas/Hash" }, "trustAnchorState": { "type": "string", "enum": [ "CURRENT", "ROTATED" ] }, "verifiedAt": { "type": "string", "format": "date-time" } } } } }, "LiquidityPassportVerificationBundle": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "passport", "publication", "verification", "artifacts", "sourceReportHashes", "resultsRegistryCommitment" ], "properties": { "schemaVersion": { "const": "klineo-liquidity-passport-verification-bundle-v1" }, "passport": { "$ref": "#/components/schemas/LiquidityPassport" }, "publication": { "type": "object", "additionalProperties": false, "required": [ "version", "artifactHash", "publishedAt", "supersedesVersion" ], "properties": { "version": { "type": "integer", "minimum": 1 }, "artifactHash": { "$ref": "#/components/schemas/Hash" }, "publishedAt": { "type": "string", "format": "date-time" }, "supersedesVersion": { "anyOf": [ { "type": "integer", "minimum": 1 }, { "type": "null" } ] } } }, "verification": { "type": "object", "additionalProperties": false, "required": [ "signatureValid", "signatureAlgorithm", "signerProviderId", "signerKeyResourceVersion", "signerAttestationHash", "responsePublicKey", "publicKeyFingerprint", "trustAnchorState", "verifiedAt" ], "properties": { "signatureValid": { "const": true }, "signatureAlgorithm": { "const": "Ed25519" }, "signerProviderId": { "type": "string", "minLength": 3, "maxLength": 160 }, "signerKeyResourceVersion": { "$ref": "#/components/schemas/Hash" }, "signerAttestationHash": { "$ref": "#/components/schemas/Hash" }, "responsePublicKey": { "type": "string", "contentEncoding": "base64" }, "publicKeyFingerprint": { "$ref": "#/components/schemas/Hash" }, "trustAnchorState": { "type": "string", "enum": [ "CURRENT", "ROTATED" ] }, "verifiedAt": { "type": "string", "format": "date-time" } } }, "artifacts": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "format", "mediaType", "fileName", "contentHash", "byteSize", "objectKey", "sourceHashes", "providerEvidence", "downloadPath" ], "properties": { "format": { "type": "string", "enum": [ "JSON", "HTML", "PDF", "CSV" ] }, "mediaType": { "type": "string" }, "fileName": { "type": "string" }, "contentHash": { "$ref": "#/components/schemas/Hash" }, "byteSize": { "$ref": "#/components/schemas/AtomicAmount" }, "objectKey": { "type": "string" }, "sourceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" } }, "providerEvidence": { "$ref": "#/components/schemas/PersistedProviderGatewayEvidence" }, "downloadPath": { "type": "string" } } } }, "sourceReportHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" } }, "resultsRegistryCommitment": { "anyOf": [ { "type": "object", "additionalProperties": false, "required": [ "receiptVersion", "signatureAlgorithm", "providerId", "providerResourceVersion", "providerAttestationHash", "responsePublicKey", "publicKeyFingerprint", "trustAnchorState", "passportSubjectHash", "commitmentHash", "issuedAt", "receiptSignature", "verificationState" ], "properties": { "receiptVersion": { "const": "liquidity-passport-results-registry-receipt-v1" }, "signatureAlgorithm": { "const": "Ed25519" }, "providerId": { "type": "string", "minLength": 3, "maxLength": 160 }, "providerResourceVersion": { "$ref": "#/components/schemas/Hash" }, "providerAttestationHash": { "$ref": "#/components/schemas/Hash" }, "responsePublicKey": { "type": "string", "contentEncoding": "base64" }, "publicKeyFingerprint": { "$ref": "#/components/schemas/Hash" }, "trustAnchorState": { "type": "string", "enum": [ "CURRENT", "ROTATED" ] }, "passportSubjectHash": { "$ref": "#/components/schemas/Hash" }, "commitmentHash": { "$ref": "#/components/schemas/Hash" }, "issuedAt": { "type": "string", "format": "date-time" }, "receiptSignature": { "type": "string", "contentEncoding": "base64" }, "verificationState": { "const": "PROVIDER_SIGNATURE_VERIFIED" } } }, { "type": "null" } ] } } }, "SharedSimulationStudy": { "type": "object", "additionalProperties": false, "required": [ "share", "study", "disclosure" ], "properties": { "share": { "type": "object", "additionalProperties": false, "required": [ "slug", "visibility", "expiresAt", "disclosure" ], "properties": { "slug": { "type": "string" }, "visibility": { "type": "string", "enum": [ "PRIVATE", "PUBLIC" ] }, "expiresAt": { "type": "string", "format": "date-time" }, "disclosure": { "type": "object", "additionalProperties": false, "required": [ "includeDrivers", "includeTreasury", "includePolicy" ], "properties": { "includeDrivers": { "type": "boolean" }, "includeTreasury": { "type": "boolean" }, "includePolicy": { "type": "boolean" } } } } }, "study": { "type": "object", "additionalProperties": false, "required": [ "id", "version", "status", "payload", "artifactHash", "sourceArtifactHash", "updatedAt" ], "properties": { "id": { "type": "string", "minLength": 3, "maxLength": 160 }, "version": { "type": "integer", "minimum": 1 }, "status": { "$ref": "#/components/schemas/OperatingSystemRecordStatus" }, "payload": { "$ref": "#/components/schemas/DisclosedSimulationStudy" }, "artifactHash": { "$ref": "#/components/schemas/Hash" }, "sourceArtifactHash": { "$ref": "#/components/schemas/Hash" }, "updatedAt": { "type": "string", "format": "date-time" } } }, "disclosure": { "type": "object", "additionalProperties": false, "required": [ "includeDrivers", "includeTreasury", "includePolicy" ], "properties": { "includeDrivers": { "type": "boolean" }, "includeTreasury": { "type": "boolean" }, "includePolicy": { "type": "boolean" } } } } }, "ProofResource": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "id", "kind", "status", "artifactHash", "resourceVersion", "createdAt", "updatedAt", "record" ], "properties": { "id": { "type": "string" }, "kind": { "const": "LIQUIDITY_PASSPORT" }, "status": { "$ref": "#/components/schemas/OperatingSystemRecordStatus" }, "artifactHash": { "$ref": "#/components/schemas/Hash" }, "resourceVersion": { "$ref": "#/components/schemas/Hash" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "record": { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/LiquidityPassport" } } } ] } } }, { "type": "object", "additionalProperties": false, "required": [ "id", "kind", "status", "artifactHash", "resourceVersion", "createdAt", "updatedAt", "artifact" ], "properties": { "id": { "type": "string" }, "kind": { "const": "CONTENT_ADDRESSED_ARTIFACT" }, "status": { "const": "IMMUTABLE" }, "artifactHash": { "$ref": "#/components/schemas/Hash" }, "resourceVersion": { "$ref": "#/components/schemas/Hash" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "artifact": { "$ref": "#/components/schemas/OperatingSystemArtifact" } } } ] }, "OpenApiDocument": { "type": "object", "additionalProperties": false, "required": [ "openapi", "info", "paths", "components" ], "properties": { "openapi": { "type": "string" }, "info": { "type": "object", "additionalProperties": true, "required": [], "properties": {} }, "servers": { "type": "array", "items": { "type": "object", "additionalProperties": true, "required": [], "properties": {} } }, "paths": { "type": "object", "additionalProperties": { "type": "object", "additionalProperties": true, "required": [], "properties": {} } }, "components": { "type": "object", "additionalProperties": true, "required": [], "properties": {} } } }, "SimulationStudyRequest": { "type": "object", "additionalProperties": false, "required": [ "issuerIntentId", "expectedIssuerIntentResourceVersion", "seed", "pathCount", "stepCount", "startingPortfolioQuote", "startingDepthQuote", "startingInventoryPips", "scenario", "reason" ], "properties": { "issuerIntentId": { "type": "string", "minLength": 3, "maxLength": 160 }, "expectedIssuerIntentResourceVersion": { "$ref": "#/components/schemas/Hash" }, "seed": { "type": "string", "minLength": 8, "maxLength": 200 }, "pathCount": { "type": "integer", "enum": [ 2000, 10000 ] }, "stepCount": { "type": "integer", "minimum": 1, "maximum": 365 }, "startingPortfolioQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "startingDepthQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "startingInventoryPips": { "$ref": "#/components/schemas/Pips" }, "scenario": { "$ref": "#/components/schemas/ScenarioDefinition" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "SandboxSimulationStudyRequest": { "type": "object", "additionalProperties": false, "required": [ "intent", "seed", "pathCount", "stepCount", "startingPortfolioQuote", "startingDepthQuote", "startingInventoryPips", "scenario", "reason" ], "properties": { "intent": { "$ref": "#/components/schemas/IssuerIntent" }, "seed": { "type": "string", "minLength": 1, "maxLength": 256 }, "pathCount": { "const": 2000 }, "stepCount": { "type": "integer", "minimum": 1, "maximum": 365 }, "startingPortfolioQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "startingDepthQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "startingInventoryPips": { "$ref": "#/components/schemas/Pips" }, "scenario": { "$ref": "#/components/schemas/ScenarioDefinition" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "StudyShareRequest": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "visibility", "expiresAt", "disclosure", "reason" ], "properties": { "visibility": { "const": "PRIVATE" }, "expiresAt": { "type": "string", "format": "date-time" }, "disclosure": { "type": "object", "additionalProperties": false, "required": [ "includeDrivers", "includeTreasury", "includePolicy" ], "properties": { "includeDrivers": { "type": "boolean" }, "includeTreasury": { "type": "boolean" }, "includePolicy": { "type": "boolean" } } }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, { "type": "object", "additionalProperties": false, "required": [ "visibility", "expiresAt", "disclosure", "reason" ], "properties": { "slug": { "type": "string", "minLength": 8, "maxLength": 128, "pattern": "^[a-z0-9][a-z0-9_-]{6,126}[a-z0-9]$" }, "visibility": { "const": "PUBLIC" }, "expiresAt": { "type": "string", "format": "date-time" }, "disclosure": { "type": "object", "additionalProperties": false, "required": [ "includeDrivers", "includeTreasury", "includePolicy" ], "properties": { "includeDrivers": { "type": "boolean" }, "includeTreasury": { "type": "boolean" }, "includePolicy": { "type": "boolean" } } }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } ] }, "SignedStudyReportRequest": { "type": "object", "additionalProperties": false, "required": [ "formats", "disclosure", "reason" ], "properties": { "formats": { "type": "array", "items": { "type": "string", "enum": [ "JSON", "PDF", "CSV" ] }, "minItems": 1, "maxItems": 3 }, "disclosure": { "type": "object", "additionalProperties": false, "required": [ "includeDrivers", "includeTreasury", "includePolicy" ], "properties": { "includeDrivers": { "type": "boolean" }, "includeTreasury": { "type": "boolean" }, "includePolicy": { "type": "boolean" } } }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "StrategyProposalAdmissionRequest": { "type": "object", "additionalProperties": false, "required": [ "issuerIntentId", "simulationStudyId", "policyIntentDraftId", "oracleEvidence", "reason" ], "properties": { "issuerIntentId": { "type": "string", "minLength": 3, "maxLength": 160 }, "simulationStudyId": { "type": "string", "minLength": 3, "maxLength": 160 }, "policyIntentDraftId": { "type": "string", "minLength": 3, "maxLength": 160 }, "oracleEvidence": { "type": "object", "additionalProperties": false, "required": [ "providerId", "providerResourceVersion", "observedAt", "payloadHash", "signature" ], "properties": { "providerId": { "type": "string", "minLength": 3, "maxLength": 160 }, "providerResourceVersion": { "$ref": "#/components/schemas/Hash" }, "observedAt": { "type": "string", "format": "date-time" }, "payloadHash": { "$ref": "#/components/schemas/Hash" }, "signature": { "type": "string" } } }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "ProposalCommentRequest": { "type": "object", "additionalProperties": false, "required": [ "body", "mentions", "reason" ], "properties": { "body": { "type": "string", "minLength": 1, "maxLength": 4000 }, "mentions": { "type": "array", "items": { "type": "string", "format": "uuid" }, "maxItems": 50 }, "supersedesCommentId": { "type": "string", "minLength": 3, "maxLength": 160 }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "ProposalDecisionRequest": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "decision", "evidenceHash", "reason" ], "properties": { "decision": { "const": "APPROVE" }, "evidenceHash": { "$ref": "#/components/schemas/Hash" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, { "type": "object", "additionalProperties": false, "required": [ "decision", "rejectionReason", "reason" ], "properties": { "decision": { "const": "REJECT" }, "rejectionReason": { "type": "string", "minLength": 10, "maxLength": 2000 }, "evidenceHash": { "$ref": "#/components/schemas/Hash" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } ], "discriminator": { "propertyName": "decision" } }, "ProposalSafeSubmissionRequest": { "type": "object", "additionalProperties": false, "required": [ "reason" ], "properties": { "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "ProposalComparisonRequest": { "type": "object", "additionalProperties": false, "required": [ "proposalIds", "reason" ], "properties": { "proposalIds": { "type": "array", "items": { "type": "string", "minLength": 3, "maxLength": 160 }, "minItems": 2, "maxItems": 8 }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "LaunchPlanRequest": { "type": "object", "additionalProperties": false, "required": [ "name", "tokenSupply", "treasuryAllocation", "launchValuationQuote", "liquidityBudgetQuote", "expectedInitialDemandQuote", "targetTradeSizeQuote", "maximumInitialSlippagePips", "acceptableInitialVolatilityPips", "initialPriceX18", "unlocks", "reviewOwnerId", "launchAt", "reason" ], "properties": { "name": { "type": "string", "minLength": 3, "maxLength": 160 }, "tokenSupply": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "treasuryAllocation": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "launchValuationQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "liquidityBudgetQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "expectedInitialDemandQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "targetTradeSizeQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "maximumInitialSlippagePips": { "type": "integer", "minimum": 1, "maximum": 1000000 }, "acceptableInitialVolatilityPips": { "$ref": "#/components/schemas/Pips" }, "initialPriceX18": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "unlocks": { "type": "array", "items": { "$ref": "#/components/schemas/UnlockTranche" }, "maxItems": 256 }, "reviewOwnerId": { "type": "string", "format": "uuid" }, "launchAt": { "type": "string", "format": "date-time" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "TimelineEventRequest": { "type": "object", "additionalProperties": false, "required": [ "payload", "reason" ], "properties": { "payload": { "$ref": "#/components/schemas/LaunchTimelineEventCreate" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "TimelineCompletionRequest": { "type": "object", "additionalProperties": false, "required": [ "completedAt", "completionReceiptHash", "reason" ], "properties": { "completedAt": { "type": "string", "format": "date-time" }, "completionReceiptHash": { "$ref": "#/components/schemas/Hash" }, "evidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "maxItems": 128 }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "LaunchWorkspaceSeedRequest": { "type": "object", "additionalProperties": false, "required": [ "vaultId", "projectTokenAddress", "quoteTokenAddress", "vaultAddress", "quoteSymbol", "reason" ], "properties": { "vaultId": { "type": "string", "minLength": 3, "maxLength": 160 }, "projectTokenAddress": { "$ref": "#/components/schemas/Address" }, "quoteTokenAddress": { "$ref": "#/components/schemas/Address" }, "vaultAddress": { "$ref": "#/components/schemas/Address" }, "quoteSymbol": { "type": "string", "minLength": 2, "maxLength": 16 }, "actionDeadline": { "type": "string", "format": "date-time" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "UnlockImpactRequest": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "sourceLaunchPlanId", "sourceObservation", "reason" ], "properties": { "sourceLaunchPlanId": { "type": "string", "minLength": 3, "maxLength": 160 }, "unlockIds": { "type": "array", "items": { "type": "string", "minLength": 3, "maxLength": 153, "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,152}$" }, "minItems": 1, "maxItems": 256 }, "sourceObservation": { "$ref": "#/components/schemas/UnlockImpactSourceObservation" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, { "type": "object", "additionalProperties": false, "required": [ "unlocks", "sourceObservation", "reason" ], "properties": { "unlocks": { "type": "array", "items": { "$ref": "#/components/schemas/UnlockTranche" }, "minItems": 1, "maxItems": 256 }, "sourceObservation": { "$ref": "#/components/schemas/UnlockImpactSourceObservation" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } ] }, "MarketQualityRequest": { "type": "object", "additionalProperties": false, "required": [ "vaultId", "capturedAt", "rawMetrics", "sourceBindings", "reason" ], "properties": { "vaultId": { "type": "string", "minLength": 3, "maxLength": 160 }, "capturedAt": { "type": "string", "format": "date-time" }, "rawMetrics": { "$ref": "#/components/schemas/MarketQualityRawMetrics" }, "sourceBindings": { "type": "object", "additionalProperties": false, "required": [ "venueObservationIds", "executionAttributionIds" ], "properties": { "venueObservationIds": { "type": "array", "items": { "type": "string", "minLength": 3, "maxLength": 160 }, "minItems": 1, "maxItems": 64, "uniqueItems": true }, "executionAttributionIds": { "type": "array", "items": { "type": "string", "minLength": 3, "maxLength": 160 }, "maxItems": 64, "uniqueItems": true } } }, "cohortEvidence": { "type": "object", "additionalProperties": false, "required": [ "providerId", "providerResourceVersion", "providerAttestationHash", "cohortDefinitionId", "cohortDefinitionHash", "observedAt", "issuers", "signature" ], "properties": { "providerId": { "type": "string", "minLength": 3, "maxLength": 160 }, "providerResourceVersion": { "$ref": "#/components/schemas/Hash" }, "providerAttestationHash": { "$ref": "#/components/schemas/Hash" }, "cohortDefinitionId": { "type": "string", "minLength": 3, "maxLength": 160 }, "cohortDefinitionHash": { "$ref": "#/components/schemas/Hash" }, "observedAt": { "type": "string", "format": "date-time" }, "issuers": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "issuerCommitmentHash", "score", "eligibilityEvidenceHash" ], "properties": { "issuerCommitmentHash": { "$ref": "#/components/schemas/Hash" }, "score": { "type": "integer", "minimum": 0, "maximum": 100 }, "eligibilityEvidenceHash": { "$ref": "#/components/schemas/Hash" } } }, "minItems": 10, "maxItems": 10000 }, "signature": { "type": "string" } } }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "ExecutionAttributionRequest": { "type": "object", "additionalProperties": false, "required": [ "proposalId", "observationEvidence", "reason" ], "properties": { "proposalId": { "type": "string", "minLength": 3, "maxLength": 160 }, "observationEvidence": { "type": "object", "additionalProperties": false, "required": [ "providerId", "providerResourceVersion", "providerAttestationHash", "observedAt", "payloadHash", "payload", "signature" ], "properties": { "providerId": { "type": "string", "minLength": 3, "maxLength": 160 }, "providerResourceVersion": { "$ref": "#/components/schemas/Hash" }, "providerAttestationHash": { "$ref": "#/components/schemas/Hash" }, "observedAt": { "type": "string", "format": "date-time" }, "payloadHash": { "$ref": "#/components/schemas/Hash" }, "payload": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "proposalId", "transactionHash", "observationHorizons", "adverseSelectionQuote", "evidenceHashes" ], "properties": { "schemaVersion": { "type": "string", "const": "execution-attribution-observation-v1" }, "proposalId": { "type": "string", "minLength": 3, "maxLength": 160 }, "transactionHash": { "$ref": "#/components/schemas/Hash" }, "observationHorizons": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "kind", "endedAt", "evidenceHash" ], "properties": { "kind": { "type": "string", "enum": [ "IMMEDIATE", "ADVERSE_SELECTION", "RECOVERY" ] }, "endedAt": { "type": "string", "format": "date-time" }, "evidenceHash": { "$ref": "#/components/schemas/Hash" } } }, "minItems": 3, "maxItems": 3 }, "adverseSelectionQuote": { "$ref": "#/components/schemas/SignedAtomicAmount" }, "evidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "minItems": 1, "maxItems": 128 } } }, "signature": { "type": "string", "pattern": "^[A-Za-z0-9+/]{80,700}={0,2}$" } } }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "AnomalyDetectionRequest": { "type": "object", "additionalProperties": false, "required": [ "subject", "kind", "observations", "currentObservation", "minimumObservations", "thresholdMadMultiples", "providerEvidence", "reason" ], "properties": { "subject": { "type": "object", "additionalProperties": false, "required": [ "kind", "vaultId" ], "properties": { "kind": { "type": "string", "const": "VAULT" }, "vaultId": { "type": "string", "minLength": 3, "maxLength": 160 } } }, "kind": { "type": "string", "enum": [ "LIQUIDITY_DISAPPEARANCE", "ONE_SIDED_FLOW", "INACTIVE_RANGE", "STABLECOIN_DEPEG", "ORACLE_DISAGREEMENT", "INVENTORY_ACCUMULATION", "EXCESSIVE_TURNOVER", "MANIPULATION_INDICATOR", "SIMULATED_REALIZED_DIVERGENCE" ] }, "observations": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "capturedAt", "value", "evidenceHash" ], "properties": { "capturedAt": { "type": "string", "format": "date-time" }, "value": { "$ref": "#/components/schemas/SignedAtomicAmount" }, "evidenceHash": { "$ref": "#/components/schemas/Hash" } } }, "minItems": 1, "maxItems": 10000 }, "currentObservation": { "type": "object", "additionalProperties": false, "required": [ "capturedAt", "value", "evidenceHash" ], "properties": { "capturedAt": { "type": "string", "format": "date-time" }, "value": { "$ref": "#/components/schemas/SignedAtomicAmount" }, "evidenceHash": { "$ref": "#/components/schemas/Hash" } } }, "minimumObservations": { "type": "integer", "minimum": 5, "maximum": 10000 }, "thresholdMadMultiples": { "type": "integer", "minimum": 2, "maximum": 100 }, "providerEvidence": { "type": "object", "additionalProperties": false, "required": [ "providerId", "providerResourceVersion", "providerAttestationHash", "observedAt", "payloadHash", "signature" ], "properties": { "providerId": { "type": "string", "minLength": 3, "maxLength": 160 }, "providerResourceVersion": { "$ref": "#/components/schemas/Hash" }, "providerAttestationHash": { "$ref": "#/components/schemas/Hash" }, "observedAt": { "type": "string", "format": "date-time" }, "payloadHash": { "$ref": "#/components/schemas/Hash" }, "signature": { "type": "string", "pattern": "^[A-Za-z0-9+/]{80,700}={0,2}$" } } }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "CapitalRequirementRequest": { "type": "object", "additionalProperties": false, "required": [ "issuerIntentId", "reason" ], "properties": { "issuerIntentId": { "type": "string", "minLength": 3, "maxLength": 160 }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "CapitalIntentSeedRequest": { "type": "object", "additionalProperties": false, "required": [ "reason" ], "properties": { "targetIssuerIntentId": { "type": "string", "minLength": 3, "maxLength": 160 }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "CapitalLaunchSeedRequest": { "type": "object", "additionalProperties": false, "required": [ "name", "tokenSupply", "treasuryAllocation", "launchValuationQuote", "expectedInitialDemandQuote", "initialPriceX18", "unlocks", "reviewOwnerId", "launchAt", "reason" ], "properties": { "targetLaunchPlanId": { "type": "string", "minLength": 3, "maxLength": 160 }, "name": { "type": "string", "minLength": 3, "maxLength": 160 }, "tokenSupply": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "treasuryAllocation": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "launchValuationQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "expectedInitialDemandQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "initialPriceX18": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "unlocks": { "type": "array", "items": { "$ref": "#/components/schemas/UnlockTranche" }, "maxItems": 256 }, "reviewOwnerId": { "type": "string", "format": "uuid" }, "launchAt": { "type": "string", "format": "date-time" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "CapitalReservationRequest": { "type": "object", "additionalProperties": false, "required": [ "reservationKind", "entryId", "bucket", "asset", "sourceId", "sourceObservationId", "capitalContainerId", "custodyLocationId", "obligationIds", "oracleSourceId", "oracleProviderResourceVersion", "oracleAttestationHash", "oracleEvidenceHash", "oracleSignature", "oracleObservedAt", "oracleMaximumAgeSeconds", "oracleConfidencePips", "bridgeHaircutPips", "counterpartyHaircutPips", "effectiveAt", "evidenceHash", "reconciliationEvidenceHash", "reason" ], "properties": { "reservationKind": { "type": "string", "enum": [ "MINIMUM_CAPITAL", "STABLE_RESERVE" ] }, "entryId": { "type": "string", "minLength": 3, "maxLength": 160 }, "bucket": { "type": "string", "enum": [ "OPERATING_RESERVE", "EMERGENCY_RESERVE", "LIQUIDITY_CAPITAL", "DIVERSIFICATION_CAPITAL", "INCENTIVE_BUDGET", "STRATEGIC_RESERVE" ] }, "asset": { "$ref": "#/components/schemas/Address" }, "sourceId": { "type": "string", "minLength": 3, "maxLength": 160 }, "sourceObservationId": { "type": "string", "minLength": 3, "maxLength": 160 }, "capitalContainerId": { "type": "string", "minLength": 3, "maxLength": 160 }, "custodyLocationId": { "type": "string", "minLength": 3, "maxLength": 160 }, "obligationIds": { "type": "array", "items": { "type": "string", "minLength": 3, "maxLength": 160 }, "minItems": 1, "maxItems": 256 }, "oracleSourceId": { "type": "string", "minLength": 3, "maxLength": 160 }, "oracleProviderResourceVersion": { "$ref": "#/components/schemas/Hash" }, "oracleAttestationHash": { "$ref": "#/components/schemas/Hash" }, "oracleEvidenceHash": { "$ref": "#/components/schemas/Hash" }, "oracleSignature": { "type": "string" }, "oracleObservedAt": { "type": "string", "format": "date-time" }, "oracleMaximumAgeSeconds": { "type": "integer", "minimum": 1, "maximum": 86400 }, "oracleConfidencePips": { "$ref": "#/components/schemas/Pips" }, "bridgeHaircutPips": { "$ref": "#/components/schemas/Pips" }, "counterpartyHaircutPips": { "$ref": "#/components/schemas/Pips" }, "effectiveAt": { "type": "string", "format": "date-time" }, "evidenceHash": { "$ref": "#/components/schemas/Hash" }, "reconciliationEvidenceHash": { "$ref": "#/components/schemas/Hash" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "TreasuryStressRequest": { "type": "object", "additionalProperties": false, "required": [ "launchPlanId", "unlockImpactId", "unlockImpactResourceVersion", "unlockImpactArtifactHash", "vaultId", "monthlyOperatingCostQuote", "reason" ], "properties": { "launchPlanId": { "type": "string", "minLength": 3, "maxLength": 160 }, "unlockImpactId": { "type": "string", "minLength": 3, "maxLength": 160 }, "unlockImpactResourceVersion": { "$ref": "#/components/schemas/Hash" }, "unlockImpactArtifactHash": { "$ref": "#/components/schemas/Hash" }, "vaultId": { "type": "string", "minLength": 3, "maxLength": 160 }, "monthlyOperatingCostQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "AllocationRequest": { "type": "object", "additionalProperties": false, "required": [ "issuerIntentId", "totalCapitalQuote", "assetMappingId", "venueIds", "reason" ], "properties": { "issuerIntentId": { "type": "string", "minLength": 3, "maxLength": 160 }, "totalCapitalQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "assetMappingId": { "type": "string", "minLength": 3, "maxLength": 160 }, "venueIds": { "type": "array", "items": { "type": "string", "minLength": 3, "maxLength": 160 }, "minItems": 1, "maxItems": 64 }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "MigrationRequest": { "type": "object", "additionalProperties": false, "required": [ "sourceVenueId", "targetVenueId", "assetMappingId", "capitalQuote", "gasAndFeesQuote", "reason" ], "properties": { "sourceVenueId": { "type": "string", "minLength": 3, "maxLength": 160 }, "targetVenueId": { "type": "string", "minLength": 3, "maxLength": 160 }, "assetMappingId": { "type": "string", "minLength": 3, "maxLength": 160 }, "capitalQuote": { "$ref": "#/components/schemas/PositiveAtomicAmount" }, "gasAndFeesQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "execution": { "type": "object", "additionalProperties": false, "required": [ "vaultId", "scheduledPlanId", "legs" ], "properties": { "vaultId": { "type": "string", "minLength": 3, "maxLength": 160 }, "scheduledPlanId": { "$ref": "#/components/schemas/Hash" }, "legs": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "legId", "scheduledLegIndex", "proof", "action", "economicBinding" ], "properties": { "legId": { "type": "string", "enum": [ "forward-withdraw-source", "forward-deploy-target", "rollback-withdraw-target", "rollback-redeploy-source" ] }, "scheduledLegIndex": { "type": "integer", "minimum": 0, "maximum": 4294967295 }, "proof": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" }, "maxItems": 64 }, "action": { "$ref": "#/components/schemas/ControllerVenueActionV2" }, "economicBinding": { "$ref": "#/components/schemas/MigrationLegEconomicBindingV2" } } }, "minItems": 4, "maxItems": 4 } } }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "MigrationTransitionRequest": { "type": "object", "additionalProperties": false, "required": [ "legId", "route", "toStatus", "previousStateHash", "reason" ], "properties": { "legId": { "type": "string", "minLength": 3, "maxLength": 160 }, "route": { "type": "string", "enum": [ "FORWARD", "ROLLBACK" ] }, "toStatus": { "type": "string", "enum": [ "SUBMITTED", "FINALIZED_RECONCILED", "FAILED_FINALIZED_RECONCILED", "SKIPPED_RECONCILED" ] }, "previousStateHash": { "$ref": "#/components/schemas/Hash" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "PolicyExtractRequest": { "type": "object", "additionalProperties": false, "required": [ "sourceText", "reason" ], "properties": { "sourceText": { "type": "string", "minLength": 10, "maxLength": 4000 }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "StructuredPolicyRequest": { "type": "object", "additionalProperties": false, "required": [ "clauses", "reason" ], "properties": { "clauses": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "field", "operator", "value", "unit" ], "properties": { "field": { "type": "string", "enum": [ "EXECUTABLE_DEPTH_QUOTE", "PRICE_BAND_PIPS", "MAXIMUM_TREASURY_DEPLOYMENT_PIPS", "MAXIMUM_SLIPPAGE_PIPS", "MINIMUM_PRICE_X18", "MAXIMUM_DAILY_TURNOVER_PIPS", "COOLDOWN_SECONDS" ] }, "operator": { "type": "string", "enum": [ "EQ", "LTE", "GTE" ] }, "value": { "$ref": "#/components/schemas/AtomicAmount" }, "unit": { "type": "string", "enum": [ "QUOTE_ATOMIC", "PIPS", "PRICE_X18", "SECONDS" ] } } }, "minItems": 1, "maxItems": 32 }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "PolicyCheckRequest": { "type": "object", "additionalProperties": false, "required": [ "policy", "reason" ], "properties": { "policy": { "$ref": "#/components/schemas/AutonomyPolicy" }, "previousPolicy": { "$ref": "#/components/schemas/AutonomyPolicy" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "ProviderRegistrationRequest": { "type": "object", "additionalProperties": false, "required": [ "providerId", "capability", "chainScope", "venueScope", "attestationHash", "timeoutMilliseconds", "maximumAgeSeconds", "healthState", "consecutiveFailures", "responsePublicKey", "reason" ], "properties": { "providerId": { "type": "string", "minLength": 3, "maxLength": 160 }, "capability": { "type": "string", "enum": [ "AI_EXTRACTION", "RPC", "ORACLE", "PRIVATE_RELAY", "RFQ", "SOLVER", "OBJECT_STORAGE", "WEBHOOK", "MARKET_MAKER", "INCENTIVE_ADAPTER", "PARTNER", "ISSUER_SIGNING", "RESULTS_REGISTRY", "STRATEGY_APPROVAL_REGISTRY", "DOMAIN_VERIFICATION", "EXECUTION_ATTRIBUTION" ] }, "chainScope": { "type": "array", "items": { "type": "integer", "minimum": 1 }, "maxItems": 64 }, "venueScope": { "type": "array", "items": { "type": "string" }, "maxItems": 64 }, "attestationHash": { "$ref": "#/components/schemas/Hash" }, "timeoutMilliseconds": { "type": "integer", "minimum": 100, "maximum": 120000 }, "maximumAgeSeconds": { "type": "integer", "minimum": 1, "maximum": 86400 }, "healthState": { "type": "string", "enum": [ "HEALTHY", "DEGRADED", "OPEN_CIRCUIT", "DISABLED" ] }, "consecutiveFailures": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "circuitOpenUntil": { "type": "string", "format": "date-time" }, "responsePublicKey": { "type": "string", "minLength": 16, "maxLength": 1000 }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "DeveloperCredentialRequest": { "type": "object", "additionalProperties": false, "required": [ "label", "kind", "scopes", "reason" ], "properties": { "label": { "type": "string", "minLength": 3, "maxLength": 160 }, "kind": { "type": "string", "enum": [ "API_KEY", "OAUTH_CLIENT" ] }, "scopes": { "type": "array", "items": { "type": "string", "enum": [ "scores:read", "studies:read", "studies:write", "strategies:validate", "policies:compile", "policies:check", "proposals:read", "proposals:prepare", "vaults:read", "receipts:read", "proof:read", "alerts:read", "webhooks:manage" ] }, "minItems": 1, "maxItems": 32 }, "expiresAt": { "type": "string", "format": "date-time" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "WebhookRequest": { "type": "object", "additionalProperties": false, "required": [ "url", "eventTypes", "reason" ], "properties": { "subscriptionId": { "type": "string", "minLength": 3, "maxLength": 160 }, "url": { "type": "string", "format": "uri", "maxLength": 2000 }, "eventTypes": { "type": "array", "items": { "type": "string", "pattern": "^[a-z][a-z0-9_.-]{2,119}$" }, "minItems": 1, "maxItems": 64 }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "StrategyPackageCandidate": { "type": "object", "additionalProperties": false, "required": [ "packageId", "publisherOrganizationId", "name", "version", "compilerVersion", "compilerHash", "definition", "supportedAssetIds", "supportedVenueIds", "riskClass", "performanceAssumptions", "historicalTests", "forkTests", "maximumCapitalQuote", "failureConditions" ], "properties": { "packageId": { "type": "string" }, "publisherOrganizationId": { "type": "string" }, "name": { "type": "string" }, "version": { "type": "string" }, "compilerVersion": { "const": "strategy-dsl-v1" }, "compilerHash": { "$ref": "#/components/schemas/Hash" }, "definition": { "$ref": "#/components/schemas/StrategyDefinitionV2Input" }, "supportedAssetIds": { "type": "array", "items": { "type": "string" } }, "supportedVenueIds": { "type": "array", "items": { "type": "string" } }, "riskClass": { "type": "string", "enum": [ "LOW", "MODERATE", "HIGH", "EXPERIMENTAL" ] }, "performanceAssumptions": { "type": "array", "items": { "type": "string" } }, "historicalTests": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "studyId", "datasetHash", "reportHash", "compilerHash", "passedAt", "passed" ], "properties": { "studyId": { "type": "string" }, "datasetHash": { "$ref": "#/components/schemas/Hash" }, "reportHash": { "$ref": "#/components/schemas/Hash" }, "compilerHash": { "$ref": "#/components/schemas/Hash" }, "passedAt": { "type": "string", "format": "date-time" }, "passed": { "const": true } } } }, "forkTests": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "testRunId", "chainId", "forkBlockNumber", "forkBlockHash", "rpcQuorumEvidenceHashes", "artifactHash", "compilerHash", "passedAt", "passed" ], "properties": { "testRunId": { "type": "string" }, "chainId": { "type": "integer", "minimum": 1 }, "forkBlockNumber": { "$ref": "#/components/schemas/AtomicAmount" }, "forkBlockHash": { "$ref": "#/components/schemas/Hash" }, "rpcQuorumEvidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" } }, "artifactHash": { "$ref": "#/components/schemas/Hash" }, "compilerHash": { "$ref": "#/components/schemas/Hash" }, "passedAt": { "type": "string", "format": "date-time" }, "passed": { "const": true } } } }, "maximumCapitalQuote": { "$ref": "#/components/schemas/AtomicAmount" }, "failureConditions": { "type": "array", "items": { "type": "string" } } } }, "StrategyPackageApprovalRequest": { "type": "object", "additionalProperties": false, "required": [ "independentReviews", "approvalRegistryEvidence", "reason" ], "properties": { "independentReviews": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "reviewerIdentityId", "reviewerName", "reviewerOrganization", "reviewedPackageContentHash", "evidenceHash", "reviewedAt", "decision" ], "properties": { "reviewerIdentityId": { "type": "string" }, "reviewerName": { "type": "string" }, "reviewerOrganization": { "type": "string" }, "reviewedPackageContentHash": { "$ref": "#/components/schemas/Hash" }, "evidenceHash": { "$ref": "#/components/schemas/Hash" }, "reviewedAt": { "type": "string", "format": "date-time" }, "decision": { "const": "APPROVE" } } }, "minItems": 2 }, "approvalRegistryEvidence": { "type": "object", "additionalProperties": false, "required": [ "approvalId", "providerId", "providerKeyResourceVersion", "providerAttestationHash", "packageId", "packageVersion", "packageContentHash", "compilerHash", "reviewSetHash", "issuedAt", "validUntil", "signature" ], "properties": { "approvalId": { "type": "string" }, "providerId": { "type": "string" }, "providerKeyResourceVersion": { "$ref": "#/components/schemas/Hash" }, "providerAttestationHash": { "$ref": "#/components/schemas/Hash" }, "packageId": { "type": "string" }, "packageVersion": { "type": "string" }, "packageContentHash": { "$ref": "#/components/schemas/Hash" }, "compilerHash": { "$ref": "#/components/schemas/Hash" }, "reviewSetHash": { "$ref": "#/components/schemas/Hash" }, "issuedAt": { "type": "string", "format": "date-time" }, "validUntil": { "type": "string", "format": "date-time" }, "signature": { "type": "string" } } }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "StrategyPackageSeedRequest": { "type": "object", "additionalProperties": false, "required": [ "targetStrategyId", "reason" ], "properties": { "targetStrategyId": { "type": "string", "minLength": 3, "maxLength": 160 }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "PartnerTenantCreate": { "type": "object", "additionalProperties": false, "required": [ "partnerId", "name", "domainVerifications", "accentColor", "terminology", "issuerOrganizationIds", "portfolioReaderActorIds", "proposalPreparerActorIds", "reportBrandName" ], "properties": { "partnerId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "name": { "type": "string", "minLength": 2, "maxLength": 160, "pattern": "^[^\\u0000-\\u001f\\u007f]+$" }, "domainVerifications": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "domain", "providerId", "providerKeyResourceVersion", "providerAttestationHash", "challengeHash", "observedAt", "validUntil", "signature" ], "properties": { "domain": { "type": "string", "minLength": 3, "maxLength": 253, "pattern": "^(?=.{1,253}$)(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\\.)+[a-zA-Z]{2,63}$" }, "providerId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "providerKeyResourceVersion": { "$ref": "#/components/schemas/Hash" }, "providerAttestationHash": { "$ref": "#/components/schemas/Hash" }, "challengeHash": { "$ref": "#/components/schemas/Hash" }, "observedAt": { "type": "string", "format": "date-time" }, "validUntil": { "type": "string", "format": "date-time" }, "signature": { "type": "string", "pattern": "^[A-Za-z0-9+/]{80,700}={0,2}$" } } }, "minItems": 1, "maxItems": 32 }, "logoAsset": { "$ref": "#/components/schemas/PartnerLogoAsset" }, "accentColor": { "type": "string", "pattern": "^#[0-9a-fA-F]{6}$" }, "terminology": { "type": "object", "maxProperties": 64, "propertyNames": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\u0000-\\u001f\\u007f]+$" }, "additionalProperties": { "type": "string", "minLength": 1, "maxLength": 120, "pattern": "^[^\\u0000-\\u001f\\u007f]+$" } }, "issuerOrganizationIds": { "type": "array", "items": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "maxItems": 1000 }, "portfolioReaderActorIds": { "type": "array", "items": { "type": "string", "format": "uuid" }, "maxItems": 1000 }, "proposalPreparerActorIds": { "type": "array", "items": { "type": "string", "format": "uuid" }, "maxItems": 1000 }, "reportBrandName": { "type": "string", "minLength": 2, "maxLength": 160, "pattern": "^[^\\u0000-\\u001f\\u007f]+$" }, "supportEmail": { "type": "string", "format": "email", "maxLength": 254 }, "contactName": { "type": "string", "minLength": 2, "maxLength": 160, "pattern": "^[^\\u0000-\\u001f\\u007f]+$" }, "description": { "type": "string", "minLength": 1, "maxLength": 280 } } }, "PartnerConsentOptions": { "type": "object", "additionalProperties": false, "required": [ "partnerId", "partnerOrganizationId", "name", "partnerConfigurationResourceVersion", "partnerConfigurationArtifactHash", "portfolioReaderActorIds", "proposalPreparerActorIds", "status", "currentConsentId" ], "properties": { "partnerId": { "type": "string", "minLength": 3, "maxLength": 160 }, "partnerOrganizationId": { "type": "string", "minLength": 3, "maxLength": 160 }, "name": { "type": "string" }, "partnerConfigurationResourceVersion": { "$ref": "#/components/schemas/Hash" }, "partnerConfigurationArtifactHash": { "$ref": "#/components/schemas/Hash" }, "portfolioReaderActorIds": { "type": "array", "items": { "type": "string", "format": "uuid" }, "maxItems": 1000 }, "proposalPreparerActorIds": { "type": "array", "items": { "type": "string", "format": "uuid" }, "maxItems": 1000 }, "status": { "const": "ACTIVE" }, "currentConsentId": { "anyOf": [ { "type": "string", "minLength": 3, "maxLength": 160 }, { "type": "null" } ] } } }, "PartnerPreparationContext": { "type": "object", "additionalProperties": false, "required": [ "partnerId", "issuerOrganizationId", "partnerConfigurationResourceVersion", "partnerConfigurationArtifactHash", "consentId", "consentResourceVersion", "consentArtifactHash", "consentExpiresAt", "proposalPreparationAllowed", "externalDeliveryAvailable" ], "properties": { "partnerId": { "type": "string", "minLength": 3, "maxLength": 160 }, "issuerOrganizationId": { "type": "string", "minLength": 3, "maxLength": 160 }, "partnerConfigurationResourceVersion": { "$ref": "#/components/schemas/Hash" }, "partnerConfigurationArtifactHash": { "$ref": "#/components/schemas/Hash" }, "consentId": { "type": "string", "minLength": 3, "maxLength": 160 }, "consentResourceVersion": { "$ref": "#/components/schemas/Hash" }, "consentArtifactHash": { "$ref": "#/components/schemas/Hash" }, "consentExpiresAt": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "proposalPreparationAllowed": { "const": true }, "externalDeliveryAvailable": { "type": "boolean" } } }, "PartnerPreparationReceipt": { "type": "object", "additionalProperties": false, "required": [ "preparationEventId", "preparationHash", "proposalId", "partnerId", "partnerOrganizationId", "partnerActorId", "issuerOrganizationId", "consentId", "consentResourceVersion", "consentArtifactHash", "partnerConfigurationResourceVersion", "partnerConfigurationArtifactHash", "deliveryJobId", "issuerImportAndStandardApprovalRequired", "executionAuthorityGranted", "safeAuthorityGranted", "custodyAuthorityGranted" ], "properties": { "preparationEventId": { "type": "string", "minLength": 3, "maxLength": 160 }, "preparationHash": { "$ref": "#/components/schemas/Hash" }, "proposalId": { "type": "string", "minLength": 3, "maxLength": 160 }, "partnerId": { "type": "string", "minLength": 3, "maxLength": 160 }, "partnerOrganizationId": { "type": "string", "minLength": 3, "maxLength": 160 }, "partnerActorId": { "type": "string", "format": "uuid" }, "issuerOrganizationId": { "type": "string", "minLength": 3, "maxLength": 160 }, "consentId": { "type": "string", "minLength": 3, "maxLength": 160 }, "consentResourceVersion": { "$ref": "#/components/schemas/Hash" }, "consentArtifactHash": { "$ref": "#/components/schemas/Hash" }, "partnerConfigurationResourceVersion": { "$ref": "#/components/schemas/Hash" }, "partnerConfigurationArtifactHash": { "$ref": "#/components/schemas/Hash" }, "deliveryJobId": { "anyOf": [ { "type": "string", "minLength": 3, "maxLength": 160 }, { "type": "null" } ] }, "issuerImportAndStandardApprovalRequired": { "const": true }, "executionAuthorityGranted": { "const": false }, "safeAuthorityGranted": { "const": false }, "custodyAuthorityGranted": { "const": false } } }, "PartnerPreparationReceiptRecovery": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "state", "receipt" ], "properties": { "state": { "const": "ACCEPTED" }, "receipt": { "$ref": "#/components/schemas/PartnerPreparationReceipt" } } }, { "type": "object", "additionalProperties": false, "required": [ "state" ], "properties": { "state": { "const": "UNRESOLVED" } } } ] }, "PartnerPreparationInboxEntry": { "type": "object", "additionalProperties": false, "required": [ "eventId", "consentId", "partnerId", "partnerOrganizationId", "partnerActorId", "createdAt", "preparationHash", "proposal", "consentResourceVersion", "consentArtifactHash", "status", "unavailableReason", "importedProposalId", "executionAuthorityGranted" ], "properties": { "eventId": { "type": "string", "minLength": 3, "maxLength": 160 }, "consentId": { "type": "string", "minLength": 3, "maxLength": 160 }, "partnerId": { "type": "string", "minLength": 3, "maxLength": 160 }, "partnerOrganizationId": { "type": "string", "minLength": 3, "maxLength": 160 }, "partnerActorId": { "type": "string", "format": "uuid" }, "createdAt": { "type": "string", "format": "date-time" }, "preparationHash": { "$ref": "#/components/schemas/Hash" }, "proposal": { "anyOf": [ { "$ref": "#/components/schemas/ProposalWorkspace" }, { "type": "null" } ] }, "consentResourceVersion": { "$ref": "#/components/schemas/Hash" }, "consentArtifactHash": { "$ref": "#/components/schemas/Hash" }, "status": { "type": "string", "enum": [ "PENDING", "IMPORTED", "DECLINED", "UNAVAILABLE" ] }, "unavailableReason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "importedProposalId": { "anyOf": [ { "type": "string", "minLength": 3, "maxLength": 160 }, { "type": "null" } ] }, "executionAuthorityGranted": { "const": false } } }, "PartnerPreparationDecisionResult": { "type": "object", "additionalProperties": false, "required": [ "decision", "proposal", "issuerReviewRequired", "executionAuthorityGranted" ], "properties": { "decision": { "$ref": "#/components/schemas/OperatingSystemEvent" }, "proposal": { "anyOf": [ { "allOf": [ { "$ref": "#/components/schemas/RecordEnvelope" }, { "type": "object", "additionalProperties": true, "required": [ "payload" ], "properties": { "payload": { "$ref": "#/components/schemas/ProposalWorkspace" } } } ] }, { "type": "null" } ] }, "issuerReviewRequired": { "type": "boolean" }, "executionAuthorityGranted": { "const": false } } }, "PartnerPreparationStatus": { "type": "object", "additionalProperties": false, "required": [ "preparationEventId", "deliveryJobId", "deliveryState", "lastErrorCode", "issuerDecision", "executionAuthorityGranted" ], "properties": { "preparationEventId": { "type": "string", "minLength": 3, "maxLength": 160 }, "deliveryJobId": { "anyOf": [ { "type": "string", "minLength": 3, "maxLength": 160 }, { "type": "null" } ] }, "deliveryState": { "type": "string", "enum": [ "NOT_REQUESTED", "PENDING", "LEASED", "COMPLETED", "FAILED", "DEAD_LETTER", "UNAVAILABLE" ] }, "lastErrorCode": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "issuerDecision": { "type": "string", "enum": [ "PENDING", "IMPORTED", "DECLINED" ] }, "executionAuthorityGranted": { "const": false } } }, "PartnerDomainDnsRecord": { "type": "object", "additionalProperties": false, "required": [ "type", "name", "value" ], "properties": { "type": { "type": "string", "enum": [ "TXT", "CNAME" ] }, "name": { "type": "string", "maxLength": 253 }, "value": { "type": "string", "maxLength": 1000 } } }, "PartnerCustomHostname": { "type": "object", "additionalProperties": false, "required": [ "id", "hostnameStatus", "sslStatus", "validationRecords" ], "properties": { "id": { "type": "string", "format": "uuid" }, "hostnameStatus": { "type": "string", "maxLength": 80 }, "sslStatus": { "type": "string", "maxLength": 80 }, "validationRecords": { "type": "array", "items": { "$ref": "#/components/schemas/PartnerDomainDnsRecord" }, "maxItems": 32 } } }, "PartnerDomainChallenge": { "type": "object", "additionalProperties": false, "required": [ "id", "organizationId", "partnerId", "domain", "createdBy", "createdAt", "expiresAt", "version", "challengeHash", "dns", "state", "verification", "customHostname" ], "properties": { "id": { "type": "string", "format": "uuid" }, "organizationId": { "type": "string", "minLength": 3, "maxLength": 160 }, "partnerId": { "type": "string", "minLength": 3, "maxLength": 160 }, "domain": { "type": "string", "minLength": 3, "maxLength": 232, "pattern": "^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)+[a-z]{2,63}$" }, "createdBy": { "type": "string", "format": "uuid" }, "createdAt": { "type": "string", "format": "date-time" }, "expiresAt": { "type": "string", "format": "date-time" }, "version": { "type": "integer", "minimum": 1 }, "challengeHash": { "$ref": "#/components/schemas/Hash" }, "dns": { "$ref": "#/components/schemas/PartnerDomainDnsRecord" }, "state": { "type": "string", "enum": [ "PENDING", "VERIFIED", "REVOKED" ] }, "verification": { "anyOf": [ { "type": "object", "additionalProperties": false, "required": [ "domain", "providerId", "providerKeyResourceVersion", "providerAttestationHash", "challengeHash", "observedAt", "validUntil", "signature" ], "properties": { "domain": { "type": "string", "minLength": 3, "maxLength": 253, "pattern": "^(?=.{1,253}$)(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\\.)+[a-zA-Z]{2,63}$" }, "providerId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "providerKeyResourceVersion": { "$ref": "#/components/schemas/Hash" }, "providerAttestationHash": { "$ref": "#/components/schemas/Hash" }, "challengeHash": { "$ref": "#/components/schemas/Hash" }, "observedAt": { "type": "string", "format": "date-time" }, "validUntil": { "type": "string", "format": "date-time" }, "signature": { "type": "string", "pattern": "^[A-Za-z0-9+/]{80,700}={0,2}$" } } }, { "type": "null" } ] }, "customHostname": { "anyOf": [ { "$ref": "#/components/schemas/PartnerCustomHostname" }, { "type": "null" } ] }, "provisioningOperation": { "anyOf": [ { "type": "object", "additionalProperties": false, "required": [ "id", "startedAt" ], "properties": { "id": { "type": "string", "format": "uuid" }, "startedAt": { "type": "string", "format": "date-time" } } }, { "type": "null" } ] } } }, "PartnerDomainStatus": { "type": "object", "additionalProperties": false, "required": [ "challenge", "ownershipVerified", "customHostname", "cnameTarget", "dnsPointsToTarget", "httpsReady", "checkedAt", "provisioning" ], "properties": { "challenge": { "$ref": "#/components/schemas/PartnerDomainChallenge" }, "ownershipVerified": { "type": "boolean" }, "customHostname": { "anyOf": [ { "$ref": "#/components/schemas/PartnerCustomHostname" }, { "type": "null" } ] }, "cnameTarget": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "dnsPointsToTarget": { "type": "boolean" }, "httpsReady": { "type": "boolean" }, "checkedAt": { "type": "string", "format": "date-time" }, "provisioning": { "type": "string", "enum": [ "CLOUDFLARE_FOR_SAAS", "OPERATOR_MANAGED" ] } } }, "PartnerDomainChallengeCreateRequest": { "type": "object", "additionalProperties": false, "required": [ "partnerId", "domain", "reason" ], "properties": { "partnerId": { "type": "string", "minLength": 3, "maxLength": 160 }, "domain": { "type": "string", "minLength": 3, "maxLength": 232, "pattern": "^(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\\.)+[a-zA-Z]{2,63}$", "description": "Exact hostname, normalized to lowercase by the service." }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "PartnerConsentGrantRequest": { "type": "object", "additionalProperties": false, "required": [ "partnerId", "partnerOrganizationId", "partnerConfigurationResourceVersion", "partnerConfigurationArtifactHash", "portfolioReaderActorIds", "proposalPreparerActorIds", "reason" ], "properties": { "partnerId": { "type": "string", "minLength": 3, "maxLength": 160 }, "partnerOrganizationId": { "type": "string", "minLength": 3, "maxLength": 160 }, "partnerConfigurationResourceVersion": { "$ref": "#/components/schemas/Hash" }, "partnerConfigurationArtifactHash": { "$ref": "#/components/schemas/Hash" }, "portfolioReaderActorIds": { "type": "array", "items": { "type": "string", "format": "uuid" }, "maxItems": 1000 }, "proposalPreparerActorIds": { "type": "array", "items": { "type": "string", "format": "uuid" }, "maxItems": 1000 }, "expiresAt": { "type": "string", "format": "date-time" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "MarketMakerEvidenceRequest": { "type": "object", "additionalProperties": false, "required": [ "payload", "reason" ], "properties": { "payload": { "$ref": "#/components/schemas/MarketMakerEvidenceObservationInput" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "MarketQualityScoreActivationRequest": { "type": "object", "additionalProperties": false, "required": [ "reason" ], "properties": { "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "TreasuryLedgerRefreshRequest": { "type": "object", "additionalProperties": false, "required": [ "payload", "reason" ], "properties": { "payload": { "$ref": "#/components/schemas/TreasuryBucket" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "TreasuryLedgerRetirementRequest": { "type": "object", "additionalProperties": false, "required": [ "retirementEvidenceHash", "reason" ], "properties": { "retirementEvidenceHash": { "$ref": "#/components/schemas/Hash" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, "AgentControlCommand": { "oneOf": [ { "type": "object", "properties": { "action": { "type": "string", "const": "REVISE_ASSUMPTIONS" }, "questionId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "proposalHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "assumptions": { "type": "object", "properties": { "seed": { "type": "string", "minLength": 8, "maxLength": 200 }, "stepCount": { "type": "integer", "minimum": 1, "maximum": 365 }, "startingPortfolioQuote": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "startingDepthQuote": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "startingInventoryPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "objective": { "type": "object", "properties": { "metric": { "type": "string", "enum": [ "ENDING_VALUE_P50", "MINIMUM_DEPTH_P5", "GAS_COST_P50", "DRAWDOWN_P95", "RESERVE_BREACH_PROBABILITY" ] }, "direction": { "type": "string", "enum": [ "MAXIMIZE", "MINIMIZE" ] } }, "required": [ "metric", "direction" ], "additionalProperties": false }, "baselineScenario": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "name": { "type": "string", "minLength": 3, "maxLength": 160 }, "kind": { "type": "string", "enum": [ "HISTORICAL_REPLAY", "BULL", "BEAR", "SIDEWAYS", "LIQUIDITY_CRISIS", "TOKEN_UNLOCK", "LARGE_BUYER", "LARGE_SELLER", "LIQUIDITY_WITHDRAWAL", "GAS_SPIKE", "ORACLE_OUTAGE", "COMBINED" ] }, "driftPipsPerStep": { "type": "integer", "minimum": -1000000, "maximum": 1000000 }, "volatilityPipsPerStep": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "liquidityWithdrawalPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "oneSidedFlowPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "gasIncreasePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "oracleOutageStep": { "type": "integer", "minimum": 0, "maximum": 364 }, "historicalReturnPips": { "minItems": 1, "maxItems": 365, "type": "array", "items": { "type": "integer", "minimum": -1000000, "maximum": 1000000 } }, "protocolFeePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "platformFeePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "unlocks": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,152}$" }, "unlocksAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "tokenAmount": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "recipientCategory": { "type": "string", "enum": [ "TEAM", "INVESTOR", "COMMUNITY", "TREASURY", "ECOSYSTEM", "OTHER" ] }, "expectedSaleParticipationPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "confidencePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "correlationGroup": { "type": "string", "minLength": 1, "maxLength": 120 }, "evidenceHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" } }, "required": [ "id", "unlocksAt", "tokenAmount", "recipientCategory", "expectedSaleParticipationPips", "confidencePips" ], "additionalProperties": false } } }, "required": [ "id", "name", "kind", "driftPipsPerStep", "volatilityPipsPerStep", "liquidityWithdrawalPips", "oneSidedFlowPips", "gasIncreasePips", "unlocks" ], "additionalProperties": false }, "alternatives": { "maxItems": 3, "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string", "minLength": 1, "maxLength": 120 }, "scenario": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "name": { "type": "string", "minLength": 3, "maxLength": 160 }, "kind": { "type": "string", "enum": [ "HISTORICAL_REPLAY", "BULL", "BEAR", "SIDEWAYS", "LIQUIDITY_CRISIS", "TOKEN_UNLOCK", "LARGE_BUYER", "LARGE_SELLER", "LIQUIDITY_WITHDRAWAL", "GAS_SPIKE", "ORACLE_OUTAGE", "COMBINED" ] }, "driftPipsPerStep": { "type": "integer", "minimum": -1000000, "maximum": 1000000 }, "volatilityPipsPerStep": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "liquidityWithdrawalPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "oneSidedFlowPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "gasIncreasePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "oracleOutageStep": { "type": "integer", "minimum": 0, "maximum": 364 }, "historicalReturnPips": { "minItems": 1, "maxItems": 365, "type": "array", "items": { "type": "integer", "minimum": -1000000, "maximum": 1000000 } }, "protocolFeePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "platformFeePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "unlocks": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,152}$" }, "unlocksAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "tokenAmount": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "recipientCategory": { "type": "string", "enum": [ "TEAM", "INVESTOR", "COMMUNITY", "TREASURY", "ECOSYSTEM", "OTHER" ] }, "expectedSaleParticipationPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "confidencePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "correlationGroup": { "type": "string", "minLength": 1, "maxLength": 120 }, "evidenceHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" } }, "required": [ "id", "unlocksAt", "tokenAmount", "recipientCategory", "expectedSaleParticipationPips", "confidencePips" ], "additionalProperties": false } } }, "required": [ "id", "name", "kind", "driftPipsPerStep", "volatilityPipsPerStep", "liquidityWithdrawalPips", "oneSidedFlowPips", "gasIncreasePips", "unlocks" ], "additionalProperties": false } }, "required": [ "label", "scenario" ], "additionalProperties": false } } }, "additionalProperties": false } }, "required": [ "action", "questionId", "proposalHash", "assumptions" ], "additionalProperties": false }, { "type": "object", "properties": { "action": { "type": "string", "const": "CONFIRM_RESEARCH" }, "questionId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "confirmation": { "type": "object", "properties": { "proposalHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "expectedSourceResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "acceptedAcknowledgements": { "minItems": 12, "maxItems": 12, "type": "array", "items": { "type": "string", "enum": [ "MODELED_STEPS_NOT_CALENDAR_DAYS", "CURRENT_DATA_NOT_HISTORICAL_REPLAY", "CURRENT_IS_PLANNER_GENERATED_NOT_ACTUAL_HOLDINGS", "UNLOCKS_AGGREGATED_AT_MIDPOINT", "NO_POSITIVE_BUYER_PRICE_IMPACT", "GAS_INCREASE_AT_MOST_TWO_TIMES", "QUOTE_IDENTITY_AND_DECIMALS_UNVERIFIED", "SCENARIOS_ARE_HYPOTHESES_NOT_FORECASTS", "UNLOCK_MAGNITUDE_IS_WEIGHTED_PARTICIPATION_PROXY", "HISTORICAL_RETURNS_ARE_FIXED_RETURN_MODEL_REPLAY", "DRIVER_ATTRIBUTION_IS_APPROXIMATE", "RESERVE_ORACLE_BREACH_IS_COMPOSITE_MODELED_EVENT" ] } }, "acceptProposedHypotheses": { "type": "boolean", "const": true }, "limitationsAccepted": { "type": "boolean", "const": true } }, "required": [ "proposalHash", "expectedSourceResourceVersion", "acceptedAcknowledgements", "acceptProposedHypotheses", "limitationsAccepted" ], "additionalProperties": false } }, "required": [ "action", "questionId", "confirmation" ], "additionalProperties": false }, { "type": "object", "properties": { "action": { "type": "string", "const": "CANCEL" } }, "required": [ "action" ], "additionalProperties": false }, { "type": "object", "properties": { "action": { "type": "string", "const": "RESPOND" }, "questionId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "optionId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, "required": [ "action", "questionId", "optionId" ], "additionalProperties": false } ] }, "AgentControlReceipt": { "type": "object", "properties": { "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "action": { "type": "string", "enum": [ "CANCEL", "RESPOND", "REVISE_ASSUMPTIONS", "CONFIRM_RESEARCH" ] }, "state": { "type": "string", "enum": [ "CANCELLED", "QUEUED", "COMPLETED" ] }, "successorRunId": { "anyOf": [ { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, { "type": "null" } ] }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "acceptedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "replayed": { "type": "boolean" } }, "required": [ "organizationId", "runId", "action", "state", "resourceVersion", "acceptedAt", "replayed" ], "additionalProperties": false }, "ResearchPlanningState": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "research-planning-state-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "runResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "runState": { "type": "string", "enum": [ "QUEUED", "RUNNING", "WAITING_FOR_INPUT", "WAITING_FOR_CHILDREN", "COMPLETED", "PARTIAL", "ABSTAINED", "FAILED", "CANCELLED" ] }, "checkedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "subject": { "type": "object", "properties": { "issuerIntentId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "expectedResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "issuerIntentId", "expectedResourceVersion" ], "additionalProperties": false }, "currentSourceResourceVersion": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] }, "proposal": { "anyOf": [ { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "research-planning-proposal-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "contextHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "sourceHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "subject": { "type": "object", "properties": { "issuerIntentId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "expectedResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "issuerIntentId", "expectedResourceVersion" ], "additionalProperties": false }, "question": { "type": "string", "minLength": 3, "maxLength": 2000 }, "status": { "type": "string", "enum": [ "NEEDS_INPUT", "NEEDS_REVIEW" ] }, "candidate": { "type": "object", "properties": { "seed": { "type": "string", "minLength": 8, "maxLength": 200 }, "stepCount": { "type": "integer", "minimum": 1, "maximum": 365 }, "startingPortfolioQuote": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "startingDepthQuote": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "startingInventoryPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "objective": { "type": "object", "properties": { "metric": { "type": "string", "enum": [ "ENDING_VALUE_P50", "MINIMUM_DEPTH_P5", "GAS_COST_P50", "DRAWDOWN_P95", "RESERVE_BREACH_PROBABILITY" ] }, "direction": { "type": "string", "enum": [ "MAXIMIZE", "MINIMIZE" ] } }, "required": [ "metric", "direction" ], "additionalProperties": false }, "baselineScenario": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "name": { "type": "string", "minLength": 3, "maxLength": 160 }, "kind": { "type": "string", "enum": [ "HISTORICAL_REPLAY", "BULL", "BEAR", "SIDEWAYS", "LIQUIDITY_CRISIS", "TOKEN_UNLOCK", "LARGE_BUYER", "LARGE_SELLER", "LIQUIDITY_WITHDRAWAL", "GAS_SPIKE", "ORACLE_OUTAGE", "COMBINED" ] }, "driftPipsPerStep": { "type": "integer", "minimum": -1000000, "maximum": 1000000 }, "volatilityPipsPerStep": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "liquidityWithdrawalPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "oneSidedFlowPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "gasIncreasePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "oracleOutageStep": { "type": "integer", "minimum": 0, "maximum": 364 }, "historicalReturnPips": { "minItems": 1, "maxItems": 365, "type": "array", "items": { "type": "integer", "minimum": -1000000, "maximum": 1000000 } }, "protocolFeePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "platformFeePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "unlocks": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,152}$" }, "unlocksAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "tokenAmount": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "recipientCategory": { "type": "string", "enum": [ "TEAM", "INVESTOR", "COMMUNITY", "TREASURY", "ECOSYSTEM", "OTHER" ] }, "expectedSaleParticipationPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "confidencePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "correlationGroup": { "type": "string", "minLength": 1, "maxLength": 120 }, "evidenceHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" } }, "required": [ "id", "unlocksAt", "tokenAmount", "recipientCategory", "expectedSaleParticipationPips", "confidencePips" ], "additionalProperties": false } } }, "required": [ "id", "name", "kind", "driftPipsPerStep", "volatilityPipsPerStep", "liquidityWithdrawalPips", "oneSidedFlowPips", "gasIncreasePips", "unlocks" ], "additionalProperties": false }, "alternatives": { "maxItems": 3, "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string", "minLength": 1, "maxLength": 120 }, "scenario": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "name": { "type": "string", "minLength": 3, "maxLength": 160 }, "kind": { "type": "string", "enum": [ "HISTORICAL_REPLAY", "BULL", "BEAR", "SIDEWAYS", "LIQUIDITY_CRISIS", "TOKEN_UNLOCK", "LARGE_BUYER", "LARGE_SELLER", "LIQUIDITY_WITHDRAWAL", "GAS_SPIKE", "ORACLE_OUTAGE", "COMBINED" ] }, "driftPipsPerStep": { "type": "integer", "minimum": -1000000, "maximum": 1000000 }, "volatilityPipsPerStep": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "liquidityWithdrawalPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "oneSidedFlowPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "gasIncreasePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "oracleOutageStep": { "type": "integer", "minimum": 0, "maximum": 364 }, "historicalReturnPips": { "minItems": 1, "maxItems": 365, "type": "array", "items": { "type": "integer", "minimum": -1000000, "maximum": 1000000 } }, "protocolFeePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "platformFeePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "unlocks": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,152}$" }, "unlocksAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "tokenAmount": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "recipientCategory": { "type": "string", "enum": [ "TEAM", "INVESTOR", "COMMUNITY", "TREASURY", "ECOSYSTEM", "OTHER" ] }, "expectedSaleParticipationPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "confidencePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "correlationGroup": { "type": "string", "minLength": 1, "maxLength": 120 }, "evidenceHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" } }, "required": [ "id", "unlocksAt", "tokenAmount", "recipientCategory", "expectedSaleParticipationPips", "confidencePips" ], "additionalProperties": false } } }, "required": [ "id", "name", "kind", "driftPipsPerStep", "volatilityPipsPerStep", "liquidityWithdrawalPips", "oneSidedFlowPips", "gasIncreasePips", "unlocks" ], "additionalProperties": false } }, "required": [ "label", "scenario" ], "additionalProperties": false } }, "schemaVersion": { "type": "string", "const": "research-experiment-v1" }, "pathCount": { "type": "number", "const": 2000 }, "interpretation": { "type": "string", "const": "CURRENT_DATA_HYPOTHETICAL_MODELED_STEPS" } }, "required": [ "alternatives", "schemaVersion", "pathCount", "interpretation" ], "additionalProperties": false }, "missingInputs": { "maxItems": 7, "type": "array", "items": { "type": "string", "enum": [ "objective", "baselineScenario", "seed", "stepCount", "startingPortfolioQuote", "startingDepthQuote", "startingInventoryPips" ] } }, "validationIssues": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string", "maxLength": 300 }, "message": { "type": "string", "maxLength": 1000 } }, "required": [ "path", "message" ], "additionalProperties": false } }, "unsupportedRequests": { "maxItems": 9, "type": "array", "items": { "type": "string", "enum": [ "CALENDAR_TIME", "HISTORICAL_AS_OF", "ACTUAL_HOLDINGS_BASELINE", "EXACT_UNLOCK_TIMING", "POSITIVE_BUYER_IMPACT", "GAS_ABOVE_TWO_TIMES", "UNLOCK_MARKET_DEPTH_IMPACT", "FILL_ACCURATE_BACKTEST", "OTHER_UNSUPPORTED" ] } }, "provenance": { "minItems": 8, "maxItems": 8, "type": "array", "items": { "type": "object", "properties": { "field": { "type": "string", "enum": [ "objective", "baselineScenario", "seed", "stepCount", "startingPortfolioQuote", "startingDepthQuote", "startingInventoryPips", "alternatives" ] }, "basis": { "type": "string", "enum": [ "USER_SUPPLIED_ASSUMPTION", "MODEL_PROPOSED_HYPOTHESIS", "MISSING" ] } }, "required": [ "field", "basis" ], "additionalProperties": false } }, "requiredAcknowledgements": { "minItems": 12, "maxItems": 12, "type": "array", "items": { "type": "string", "enum": [ "MODELED_STEPS_NOT_CALENDAR_DAYS", "CURRENT_DATA_NOT_HISTORICAL_REPLAY", "CURRENT_IS_PLANNER_GENERATED_NOT_ACTUAL_HOLDINGS", "UNLOCKS_AGGREGATED_AT_MIDPOINT", "NO_POSITIVE_BUYER_PRICE_IMPACT", "GAS_INCREASE_AT_MOST_TWO_TIMES", "QUOTE_IDENTITY_AND_DECIMALS_UNVERIFIED", "SCENARIOS_ARE_HYPOTHESES_NOT_FORECASTS", "UNLOCK_MAGNITUDE_IS_WEIGHTED_PARTICIPATION_PROXY", "HISTORICAL_RETURNS_ARE_FIXED_RETURN_MODEL_REPLAY", "DRIVER_ATTRIBUTION_IS_APPROXIMATE", "RESERVE_ORACLE_BREACH_IS_COMPOSITE_MODELED_EVENT" ] } }, "financialAuthority": { "type": "boolean", "const": false }, "publicationAuthority": { "type": "boolean", "const": false }, "executionAuthorized": { "type": "boolean", "const": false }, "proposalHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "schemaVersion", "organizationId", "runId", "contextHash", "sourceHash", "sourceCutoff", "subject", "question", "status", "candidate", "missingInputs", "validationIssues", "unsupportedRequests", "provenance", "requiredAcknowledgements", "financialAuthority", "publicationAuthority", "executionAuthorized", "proposalHash" ], "additionalProperties": false }, { "type": "null" } ] }, "questionId": { "anyOf": [ { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, { "type": "null" } ] }, "successorRunId": { "anyOf": [ { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, { "type": "null" } ] } }, "required": [ "schemaVersion", "organizationId", "runId", "runResourceVersion", "runState", "checkedAt", "subject", "currentSourceResourceVersion", "proposal", "questionId", "successorRunId" ], "additionalProperties": false }, "ResearchPlanningAssumptions": { "type": "object", "properties": { "seed": { "type": "string", "minLength": 8, "maxLength": 200 }, "stepCount": { "type": "integer", "minimum": 1, "maximum": 365 }, "startingPortfolioQuote": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "startingDepthQuote": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "startingInventoryPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "objective": { "type": "object", "properties": { "metric": { "type": "string", "enum": [ "ENDING_VALUE_P50", "MINIMUM_DEPTH_P5", "GAS_COST_P50", "DRAWDOWN_P95", "RESERVE_BREACH_PROBABILITY" ] }, "direction": { "type": "string", "enum": [ "MAXIMIZE", "MINIMIZE" ] } }, "required": [ "metric", "direction" ], "additionalProperties": false }, "baselineScenario": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "name": { "type": "string", "minLength": 3, "maxLength": 160 }, "kind": { "type": "string", "enum": [ "HISTORICAL_REPLAY", "BULL", "BEAR", "SIDEWAYS", "LIQUIDITY_CRISIS", "TOKEN_UNLOCK", "LARGE_BUYER", "LARGE_SELLER", "LIQUIDITY_WITHDRAWAL", "GAS_SPIKE", "ORACLE_OUTAGE", "COMBINED" ] }, "driftPipsPerStep": { "type": "integer", "minimum": -1000000, "maximum": 1000000 }, "volatilityPipsPerStep": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "liquidityWithdrawalPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "oneSidedFlowPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "gasIncreasePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "oracleOutageStep": { "type": "integer", "minimum": 0, "maximum": 364 }, "historicalReturnPips": { "minItems": 1, "maxItems": 365, "type": "array", "items": { "type": "integer", "minimum": -1000000, "maximum": 1000000 } }, "protocolFeePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "platformFeePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "unlocks": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,152}$" }, "unlocksAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "tokenAmount": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "recipientCategory": { "type": "string", "enum": [ "TEAM", "INVESTOR", "COMMUNITY", "TREASURY", "ECOSYSTEM", "OTHER" ] }, "expectedSaleParticipationPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "confidencePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "correlationGroup": { "type": "string", "minLength": 1, "maxLength": 120 }, "evidenceHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" } }, "required": [ "id", "unlocksAt", "tokenAmount", "recipientCategory", "expectedSaleParticipationPips", "confidencePips" ], "additionalProperties": false } } }, "required": [ "id", "name", "kind", "driftPipsPerStep", "volatilityPipsPerStep", "liquidityWithdrawalPips", "oneSidedFlowPips", "gasIncreasePips", "unlocks" ], "additionalProperties": false }, "alternatives": { "maxItems": 3, "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string", "minLength": 1, "maxLength": 120 }, "scenario": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "name": { "type": "string", "minLength": 3, "maxLength": 160 }, "kind": { "type": "string", "enum": [ "HISTORICAL_REPLAY", "BULL", "BEAR", "SIDEWAYS", "LIQUIDITY_CRISIS", "TOKEN_UNLOCK", "LARGE_BUYER", "LARGE_SELLER", "LIQUIDITY_WITHDRAWAL", "GAS_SPIKE", "ORACLE_OUTAGE", "COMBINED" ] }, "driftPipsPerStep": { "type": "integer", "minimum": -1000000, "maximum": 1000000 }, "volatilityPipsPerStep": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "liquidityWithdrawalPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "oneSidedFlowPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "gasIncreasePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "oracleOutageStep": { "type": "integer", "minimum": 0, "maximum": 364 }, "historicalReturnPips": { "minItems": 1, "maxItems": 365, "type": "array", "items": { "type": "integer", "minimum": -1000000, "maximum": 1000000 } }, "protocolFeePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "platformFeePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "unlocks": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,152}$" }, "unlocksAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "tokenAmount": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "recipientCategory": { "type": "string", "enum": [ "TEAM", "INVESTOR", "COMMUNITY", "TREASURY", "ECOSYSTEM", "OTHER" ] }, "expectedSaleParticipationPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "confidencePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "correlationGroup": { "type": "string", "minLength": 1, "maxLength": 120 }, "evidenceHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" } }, "required": [ "id", "unlocksAt", "tokenAmount", "recipientCategory", "expectedSaleParticipationPips", "confidencePips" ], "additionalProperties": false } } }, "required": [ "id", "name", "kind", "driftPipsPerStep", "volatilityPipsPerStep", "liquidityWithdrawalPips", "oneSidedFlowPips", "gasIncreasePips", "unlocks" ], "additionalProperties": false } }, "required": [ "label", "scenario" ], "additionalProperties": false } } }, "additionalProperties": false }, "ResearchPlanningAdmissionRequest": { "type": "object", "properties": { "kind": { "type": "string", "const": "WHAT_IF_RESEARCH" }, "mode": { "type": "string", "const": "PLAN" }, "question": { "type": "string", "minLength": 3, "maxLength": 2000 }, "subject": { "type": "object", "properties": { "issuerIntentId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "expectedResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "issuerIntentId", "expectedResourceVersion" ], "additionalProperties": false }, "assumptions": { "type": "object", "properties": { "seed": { "type": "string", "minLength": 8, "maxLength": 200 }, "stepCount": { "type": "integer", "minimum": 1, "maximum": 365 }, "startingPortfolioQuote": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "startingDepthQuote": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "startingInventoryPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "objective": { "type": "object", "properties": { "metric": { "type": "string", "enum": [ "ENDING_VALUE_P50", "MINIMUM_DEPTH_P5", "GAS_COST_P50", "DRAWDOWN_P95", "RESERVE_BREACH_PROBABILITY" ] }, "direction": { "type": "string", "enum": [ "MAXIMIZE", "MINIMIZE" ] } }, "required": [ "metric", "direction" ], "additionalProperties": false }, "baselineScenario": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "name": { "type": "string", "minLength": 3, "maxLength": 160 }, "kind": { "type": "string", "enum": [ "HISTORICAL_REPLAY", "BULL", "BEAR", "SIDEWAYS", "LIQUIDITY_CRISIS", "TOKEN_UNLOCK", "LARGE_BUYER", "LARGE_SELLER", "LIQUIDITY_WITHDRAWAL", "GAS_SPIKE", "ORACLE_OUTAGE", "COMBINED" ] }, "driftPipsPerStep": { "type": "integer", "minimum": -1000000, "maximum": 1000000 }, "volatilityPipsPerStep": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "liquidityWithdrawalPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "oneSidedFlowPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "gasIncreasePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "oracleOutageStep": { "type": "integer", "minimum": 0, "maximum": 364 }, "historicalReturnPips": { "minItems": 1, "maxItems": 365, "type": "array", "items": { "type": "integer", "minimum": -1000000, "maximum": 1000000 } }, "protocolFeePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "platformFeePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "unlocks": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,152}$" }, "unlocksAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "tokenAmount": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "recipientCategory": { "type": "string", "enum": [ "TEAM", "INVESTOR", "COMMUNITY", "TREASURY", "ECOSYSTEM", "OTHER" ] }, "expectedSaleParticipationPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "confidencePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "correlationGroup": { "type": "string", "minLength": 1, "maxLength": 120 }, "evidenceHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" } }, "required": [ "id", "unlocksAt", "tokenAmount", "recipientCategory", "expectedSaleParticipationPips", "confidencePips" ], "additionalProperties": false } } }, "required": [ "id", "name", "kind", "driftPipsPerStep", "volatilityPipsPerStep", "liquidityWithdrawalPips", "oneSidedFlowPips", "gasIncreasePips", "unlocks" ], "additionalProperties": false }, "alternatives": { "maxItems": 3, "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string", "minLength": 1, "maxLength": 120 }, "scenario": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "name": { "type": "string", "minLength": 3, "maxLength": 160 }, "kind": { "type": "string", "enum": [ "HISTORICAL_REPLAY", "BULL", "BEAR", "SIDEWAYS", "LIQUIDITY_CRISIS", "TOKEN_UNLOCK", "LARGE_BUYER", "LARGE_SELLER", "LIQUIDITY_WITHDRAWAL", "GAS_SPIKE", "ORACLE_OUTAGE", "COMBINED" ] }, "driftPipsPerStep": { "type": "integer", "minimum": -1000000, "maximum": 1000000 }, "volatilityPipsPerStep": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "liquidityWithdrawalPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "oneSidedFlowPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "gasIncreasePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "oracleOutageStep": { "type": "integer", "minimum": 0, "maximum": 364 }, "historicalReturnPips": { "minItems": 1, "maxItems": 365, "type": "array", "items": { "type": "integer", "minimum": -1000000, "maximum": 1000000 } }, "protocolFeePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "platformFeePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "unlocks": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,152}$" }, "unlocksAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "tokenAmount": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "recipientCategory": { "type": "string", "enum": [ "TEAM", "INVESTOR", "COMMUNITY", "TREASURY", "ECOSYSTEM", "OTHER" ] }, "expectedSaleParticipationPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "confidencePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "correlationGroup": { "type": "string", "minLength": 1, "maxLength": 120 }, "evidenceHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" } }, "required": [ "id", "unlocksAt", "tokenAmount", "recipientCategory", "expectedSaleParticipationPips", "confidencePips" ], "additionalProperties": false } } }, "required": [ "id", "name", "kind", "driftPipsPerStep", "volatilityPipsPerStep", "liquidityWithdrawalPips", "oneSidedFlowPips", "gasIncreasePips", "unlocks" ], "additionalProperties": false } }, "required": [ "label", "scenario" ], "additionalProperties": false } } }, "additionalProperties": false } }, "required": [ "kind", "mode", "question", "subject", "assumptions" ], "additionalProperties": false }, "ResearchPlanningProposal": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "research-planning-proposal-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "contextHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "sourceHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "subject": { "type": "object", "properties": { "issuerIntentId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "expectedResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "issuerIntentId", "expectedResourceVersion" ], "additionalProperties": false }, "question": { "type": "string", "minLength": 3, "maxLength": 2000 }, "status": { "type": "string", "enum": [ "NEEDS_INPUT", "NEEDS_REVIEW" ] }, "candidate": { "type": "object", "properties": { "seed": { "type": "string", "minLength": 8, "maxLength": 200 }, "stepCount": { "type": "integer", "minimum": 1, "maximum": 365 }, "startingPortfolioQuote": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "startingDepthQuote": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "startingInventoryPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "objective": { "type": "object", "properties": { "metric": { "type": "string", "enum": [ "ENDING_VALUE_P50", "MINIMUM_DEPTH_P5", "GAS_COST_P50", "DRAWDOWN_P95", "RESERVE_BREACH_PROBABILITY" ] }, "direction": { "type": "string", "enum": [ "MAXIMIZE", "MINIMIZE" ] } }, "required": [ "metric", "direction" ], "additionalProperties": false }, "baselineScenario": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "name": { "type": "string", "minLength": 3, "maxLength": 160 }, "kind": { "type": "string", "enum": [ "HISTORICAL_REPLAY", "BULL", "BEAR", "SIDEWAYS", "LIQUIDITY_CRISIS", "TOKEN_UNLOCK", "LARGE_BUYER", "LARGE_SELLER", "LIQUIDITY_WITHDRAWAL", "GAS_SPIKE", "ORACLE_OUTAGE", "COMBINED" ] }, "driftPipsPerStep": { "type": "integer", "minimum": -1000000, "maximum": 1000000 }, "volatilityPipsPerStep": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "liquidityWithdrawalPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "oneSidedFlowPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "gasIncreasePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "oracleOutageStep": { "type": "integer", "minimum": 0, "maximum": 364 }, "historicalReturnPips": { "minItems": 1, "maxItems": 365, "type": "array", "items": { "type": "integer", "minimum": -1000000, "maximum": 1000000 } }, "protocolFeePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "platformFeePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "unlocks": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,152}$" }, "unlocksAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "tokenAmount": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "recipientCategory": { "type": "string", "enum": [ "TEAM", "INVESTOR", "COMMUNITY", "TREASURY", "ECOSYSTEM", "OTHER" ] }, "expectedSaleParticipationPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "confidencePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "correlationGroup": { "type": "string", "minLength": 1, "maxLength": 120 }, "evidenceHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" } }, "required": [ "id", "unlocksAt", "tokenAmount", "recipientCategory", "expectedSaleParticipationPips", "confidencePips" ], "additionalProperties": false } } }, "required": [ "id", "name", "kind", "driftPipsPerStep", "volatilityPipsPerStep", "liquidityWithdrawalPips", "oneSidedFlowPips", "gasIncreasePips", "unlocks" ], "additionalProperties": false }, "alternatives": { "maxItems": 3, "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string", "minLength": 1, "maxLength": 120 }, "scenario": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "name": { "type": "string", "minLength": 3, "maxLength": 160 }, "kind": { "type": "string", "enum": [ "HISTORICAL_REPLAY", "BULL", "BEAR", "SIDEWAYS", "LIQUIDITY_CRISIS", "TOKEN_UNLOCK", "LARGE_BUYER", "LARGE_SELLER", "LIQUIDITY_WITHDRAWAL", "GAS_SPIKE", "ORACLE_OUTAGE", "COMBINED" ] }, "driftPipsPerStep": { "type": "integer", "minimum": -1000000, "maximum": 1000000 }, "volatilityPipsPerStep": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "liquidityWithdrawalPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "oneSidedFlowPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "gasIncreasePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "oracleOutageStep": { "type": "integer", "minimum": 0, "maximum": 364 }, "historicalReturnPips": { "minItems": 1, "maxItems": 365, "type": "array", "items": { "type": "integer", "minimum": -1000000, "maximum": 1000000 } }, "protocolFeePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "platformFeePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "unlocks": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,152}$" }, "unlocksAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "tokenAmount": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "recipientCategory": { "type": "string", "enum": [ "TEAM", "INVESTOR", "COMMUNITY", "TREASURY", "ECOSYSTEM", "OTHER" ] }, "expectedSaleParticipationPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "confidencePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "correlationGroup": { "type": "string", "minLength": 1, "maxLength": 120 }, "evidenceHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" } }, "required": [ "id", "unlocksAt", "tokenAmount", "recipientCategory", "expectedSaleParticipationPips", "confidencePips" ], "additionalProperties": false } } }, "required": [ "id", "name", "kind", "driftPipsPerStep", "volatilityPipsPerStep", "liquidityWithdrawalPips", "oneSidedFlowPips", "gasIncreasePips", "unlocks" ], "additionalProperties": false } }, "required": [ "label", "scenario" ], "additionalProperties": false } }, "schemaVersion": { "type": "string", "const": "research-experiment-v1" }, "pathCount": { "type": "number", "const": 2000 }, "interpretation": { "type": "string", "const": "CURRENT_DATA_HYPOTHETICAL_MODELED_STEPS" } }, "required": [ "alternatives", "schemaVersion", "pathCount", "interpretation" ], "additionalProperties": false }, "missingInputs": { "maxItems": 7, "type": "array", "items": { "type": "string", "enum": [ "objective", "baselineScenario", "seed", "stepCount", "startingPortfolioQuote", "startingDepthQuote", "startingInventoryPips" ] } }, "validationIssues": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string", "maxLength": 300 }, "message": { "type": "string", "maxLength": 1000 } }, "required": [ "path", "message" ], "additionalProperties": false } }, "unsupportedRequests": { "maxItems": 9, "type": "array", "items": { "type": "string", "enum": [ "CALENDAR_TIME", "HISTORICAL_AS_OF", "ACTUAL_HOLDINGS_BASELINE", "EXACT_UNLOCK_TIMING", "POSITIVE_BUYER_IMPACT", "GAS_ABOVE_TWO_TIMES", "UNLOCK_MARKET_DEPTH_IMPACT", "FILL_ACCURATE_BACKTEST", "OTHER_UNSUPPORTED" ] } }, "provenance": { "minItems": 8, "maxItems": 8, "type": "array", "items": { "type": "object", "properties": { "field": { "type": "string", "enum": [ "objective", "baselineScenario", "seed", "stepCount", "startingPortfolioQuote", "startingDepthQuote", "startingInventoryPips", "alternatives" ] }, "basis": { "type": "string", "enum": [ "USER_SUPPLIED_ASSUMPTION", "MODEL_PROPOSED_HYPOTHESIS", "MISSING" ] } }, "required": [ "field", "basis" ], "additionalProperties": false } }, "requiredAcknowledgements": { "minItems": 12, "maxItems": 12, "type": "array", "items": { "type": "string", "enum": [ "MODELED_STEPS_NOT_CALENDAR_DAYS", "CURRENT_DATA_NOT_HISTORICAL_REPLAY", "CURRENT_IS_PLANNER_GENERATED_NOT_ACTUAL_HOLDINGS", "UNLOCKS_AGGREGATED_AT_MIDPOINT", "NO_POSITIVE_BUYER_PRICE_IMPACT", "GAS_INCREASE_AT_MOST_TWO_TIMES", "QUOTE_IDENTITY_AND_DECIMALS_UNVERIFIED", "SCENARIOS_ARE_HYPOTHESES_NOT_FORECASTS", "UNLOCK_MAGNITUDE_IS_WEIGHTED_PARTICIPATION_PROXY", "HISTORICAL_RETURNS_ARE_FIXED_RETURN_MODEL_REPLAY", "DRIVER_ATTRIBUTION_IS_APPROXIMATE", "RESERVE_ORACLE_BREACH_IS_COMPOSITE_MODELED_EVENT" ] } }, "financialAuthority": { "type": "boolean", "const": false }, "publicationAuthority": { "type": "boolean", "const": false }, "executionAuthorized": { "type": "boolean", "const": false }, "proposalHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "schemaVersion", "organizationId", "runId", "contextHash", "sourceHash", "sourceCutoff", "subject", "question", "status", "candidate", "missingInputs", "validationIssues", "unsupportedRequests", "provenance", "requiredAcknowledgements", "financialAuthority", "publicationAuthority", "executionAuthorized", "proposalHash" ], "additionalProperties": false }, "ResearchPlanningConfirmation": { "type": "object", "properties": { "proposalHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "expectedSourceResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "acceptedAcknowledgements": { "minItems": 12, "maxItems": 12, "type": "array", "items": { "type": "string", "enum": [ "MODELED_STEPS_NOT_CALENDAR_DAYS", "CURRENT_DATA_NOT_HISTORICAL_REPLAY", "CURRENT_IS_PLANNER_GENERATED_NOT_ACTUAL_HOLDINGS", "UNLOCKS_AGGREGATED_AT_MIDPOINT", "NO_POSITIVE_BUYER_PRICE_IMPACT", "GAS_INCREASE_AT_MOST_TWO_TIMES", "QUOTE_IDENTITY_AND_DECIMALS_UNVERIFIED", "SCENARIOS_ARE_HYPOTHESES_NOT_FORECASTS", "UNLOCK_MAGNITUDE_IS_WEIGHTED_PARTICIPATION_PROXY", "HISTORICAL_RETURNS_ARE_FIXED_RETURN_MODEL_REPLAY", "DRIVER_ATTRIBUTION_IS_APPROXIMATE", "RESERVE_ORACLE_BREACH_IS_COMPOSITE_MODELED_EVENT" ] } }, "acceptProposedHypotheses": { "type": "boolean", "const": true }, "limitationsAccepted": { "type": "boolean", "const": true } }, "required": [ "proposalHash", "expectedSourceResourceVersion", "acceptedAcknowledgements", "acceptProposedHypotheses", "limitationsAccepted" ], "additionalProperties": false }, "ResearchComparison": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "research-comparison-v1" }, "baselineTrialId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{0,159}$" }, "objective": { "type": "object", "properties": { "metric": { "type": "string", "enum": [ "ENDING_VALUE_P50", "MINIMUM_DEPTH_P5", "GAS_COST_P50", "DRAWDOWN_P95", "RESERVE_BREACH_PROBABILITY" ] }, "direction": { "type": "string", "enum": [ "MAXIMIZE", "MINIMIZE" ] } }, "required": [ "metric", "direction" ], "additionalProperties": false }, "context": { "anyOf": [ { "type": "object", "properties": { "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "issuerIntentId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "issuerIntentResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "issuerIntentArtifactHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "quoteSymbol": { "type": "string", "minLength": 1, "maxLength": 256 }, "quoteAssetId": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 256 }, { "type": "null" } ] }, "quoteDecimals": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 36 }, { "type": "null" } ] }, "seedPolicyVersion": { "type": "string", "minLength": 1, "maxLength": 256 }, "horizonUnit": { "type": "string", "enum": [ "MODELED_STEPS", "CALIBRATED_STEPS" ] }, "stepDurationSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "analysisBasis": { "type": "string", "enum": [ "CURRENT_DATA_HYPOTHETICAL", "HISTORICAL_POINT_IN_TIME" ] }, "historicalAvailabilityEvidenceHash": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] } }, "required": [ "organizationId", "issuerIntentId", "issuerIntentResourceVersion", "issuerIntentArtifactHash", "sourceCutoff", "quoteSymbol", "quoteAssetId", "quoteDecimals", "seedPolicyVersion", "horizonUnit", "stepDurationSeconds", "analysisBasis", "historicalAvailabilityEvidenceHash" ], "additionalProperties": false }, { "type": "null" } ] }, "status": { "type": "string", "enum": [ "BASELINE_UNAVAILABLE", "COMPLETE", "PARTIAL" ] }, "eligibilityRule": { "type": "string", "const": "ADMITTED_INTENT_CONSTRAINTS_AND_RESERVE_BREACH_AT_MOST_100000_PIPS" }, "rankingScope": { "type": "string", "const": "WITHIN_SCENARIO_VARIANTS" }, "limitations": { "minItems": 6, "maxItems": 6, "type": "array", "items": { "type": "string", "enum": [ "CURRENT_IS_ENGINE_GENERATED_NOT_ACTUAL_HOLDINGS", "COMPARISON_DOES_NOT_PROVE_EQUAL_CAPITAL_SUPERIORITY", "MARGINAL_PERCENTILE_DIFFERENCES_ARE_NOT_PAIRED_DIFFERENCE_PERCENTILES", "RESERVE_BREACH_IS_COMPOSITE_RESERVE_OR_ORACLE_BLOCKED_EVENT", "MODEL_OUTCOMES_ARE_NOT_FINANCIAL_GUARANTEES", "ARTIFACT_HASHES_DO_NOT_REPRODUCE_ENGINE_OUTPUT" ] } }, "trials": { "minItems": 1, "maxItems": 4, "type": "array", "items": { "type": "object", "properties": { "trialId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{0,159}$" }, "label": { "type": "string", "minLength": 1, "maxLength": 160 }, "state": { "type": "string", "enum": [ "QUEUED", "RUNNING", "COMPLETED", "FAILED", "CANCELLED" ] }, "failureCode": { "anyOf": [ { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{2,119}$" }, { "type": "null" } ] }, "admittedInputHash": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] }, "resultArtifactHash": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] }, "context": { "anyOf": [ { "type": "object", "properties": { "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "issuerIntentId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "issuerIntentResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "issuerIntentArtifactHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "quoteSymbol": { "type": "string", "minLength": 1, "maxLength": 256 }, "quoteAssetId": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 256 }, { "type": "null" } ] }, "quoteDecimals": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 36 }, { "type": "null" } ] }, "seedPolicyVersion": { "type": "string", "minLength": 1, "maxLength": 256 }, "horizonUnit": { "type": "string", "enum": [ "MODELED_STEPS", "CALIBRATED_STEPS" ] }, "stepDurationSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "analysisBasis": { "type": "string", "enum": [ "CURRENT_DATA_HYPOTHETICAL", "HISTORICAL_POINT_IN_TIME" ] }, "historicalAvailabilityEvidenceHash": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] } }, "required": [ "organizationId", "issuerIntentId", "issuerIntentResourceVersion", "issuerIntentArtifactHash", "sourceCutoff", "quoteSymbol", "quoteAssetId", "quoteDecimals", "seedPolicyVersion", "horizonUnit", "stepDurationSeconds", "analysisBasis", "historicalAvailabilityEvidenceHash" ], "additionalProperties": false }, { "type": "null" } ] }, "admittedInput": { "anyOf": [ { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "simulation-study-input-snapshot-v1" }, "engineVersion": { "type": "string", "const": "digital-twin-pcg64-fixed-v2" }, "seed": { "type": "string", "minLength": 1, "maxLength": 256 }, "pathCount": { "anyOf": [ { "type": "number", "const": 2000 }, { "type": "number", "const": 10000 } ] }, "stepCount": { "type": "integer", "minimum": 1, "maximum": 365 }, "targetTradeSizeQuote": { "type": "string", "pattern": "^[1-9][0-9]*$" }, "startingPortfolioQuote": { "type": "string", "pattern": "^[1-9][0-9]*$" }, "startingDepthQuote": { "type": "string", "pattern": "^[1-9][0-9]*$" }, "startingInventoryPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "scenario": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "name": { "type": "string", "minLength": 3, "maxLength": 160 }, "kind": { "type": "string", "enum": [ "HISTORICAL_REPLAY", "BULL", "BEAR", "SIDEWAYS", "LIQUIDITY_CRISIS", "TOKEN_UNLOCK", "LARGE_BUYER", "LARGE_SELLER", "LIQUIDITY_WITHDRAWAL", "GAS_SPIKE", "ORACLE_OUTAGE", "COMBINED" ] }, "driftPipsPerStep": { "type": "integer", "minimum": -1000000, "maximum": 1000000 }, "volatilityPipsPerStep": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "liquidityWithdrawalPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "oneSidedFlowPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "gasIncreasePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "oracleOutageStep": { "type": "integer", "minimum": 0, "maximum": 364 }, "historicalReturnPips": { "minItems": 1, "maxItems": 365, "type": "array", "items": { "type": "integer", "minimum": -1000000, "maximum": 1000000 } }, "protocolFeePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "platformFeePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "unlocks": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,152}$" }, "unlocksAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "tokenAmount": { "type": "string", "pattern": "^[1-9][0-9]*$" }, "recipientCategory": { "type": "string", "enum": [ "TEAM", "INVESTOR", "COMMUNITY", "TREASURY", "ECOSYSTEM", "OTHER" ] }, "expectedSaleParticipationPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "confidencePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "correlationGroup": { "type": "string", "minLength": 1, "maxLength": 120 }, "evidenceHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" } }, "required": [ "id", "unlocksAt", "tokenAmount", "recipientCategory", "expectedSaleParticipationPips", "confidencePips" ], "additionalProperties": false } } }, "required": [ "id", "name", "kind", "driftPipsPerStep", "volatilityPipsPerStep", "liquidityWithdrawalPips", "oneSidedFlowPips", "gasIncreasePips", "unlocks" ], "additionalProperties": false }, "variants": { "minItems": 5, "maxItems": 5, "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "CURRENT", "RECOMMENDED", "CONSERVATIVE", "CAPITAL_EFFICIENT", "EMERGENCY" ] }, "requiredCapitalQuote": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "deployableCapitalQuote": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "stableReserveQuote": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "emergencyReserveQuote": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "rangeWidthPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "expectedSlippagePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "expectedFeeIncomeLowQuote": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "expectedFeeIncomeHighQuote": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "inventoryExposurePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "maximumDailyTurnoverPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "satisfiesIntent": { "type": "boolean" }, "reasons": { "maxItems": 64, "type": "array", "items": { "type": "string" } } }, "required": [ "kind", "requiredCapitalQuote", "deployableCapitalQuote", "stableReserveQuote", "emergencyReserveQuote", "rangeWidthPips", "expectedSlippagePips", "expectedFeeIncomeLowQuote", "expectedFeeIncomeHighQuote", "inventoryExposurePips", "maximumDailyTurnoverPips", "satisfiesIntent", "reasons" ], "additionalProperties": false } } }, "required": [ "schemaVersion", "engineVersion", "seed", "pathCount", "stepCount", "targetTradeSizeQuote", "startingPortfolioQuote", "startingDepthQuote", "startingInventoryPips", "scenario", "variants" ], "additionalProperties": false }, { "type": "null" } ] }, "status": { "type": "string", "enum": [ "PENDING", "FAILED", "CANCELLED", "INVALID", "INCOMPATIBLE", "BASELINE_UNAVAILABLE", "COMPARABLE" ] }, "reasons": { "maxItems": 16, "type": "array", "items": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{2,119}$" } }, "warnings": { "maxItems": 64, "type": "array", "items": { "type": "string", "maxLength": 1200 } }, "variants": { "maxItems": 5, "type": "array", "items": { "type": "object", "properties": { "variant": { "type": "string", "enum": [ "CURRENT", "RECOMMENDED", "CONSERVATIVE", "CAPITAL_EFFICIENT", "EMERGENCY" ] }, "capitalPlan": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "CURRENT", "RECOMMENDED", "CONSERVATIVE", "CAPITAL_EFFICIENT", "EMERGENCY" ] }, "requiredCapitalQuote": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "deployableCapitalQuote": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "stableReserveQuote": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "emergencyReserveQuote": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "rangeWidthPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "expectedSlippagePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "expectedFeeIncomeLowQuote": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "expectedFeeIncomeHighQuote": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "inventoryExposurePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "maximumDailyTurnoverPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "satisfiesIntent": { "type": "boolean" }, "reasons": { "maxItems": 64, "type": "array", "items": { "type": "string", "maxLength": 1200 } } }, "required": [ "kind", "requiredCapitalQuote", "deployableCapitalQuote", "stableReserveQuote", "emergencyReserveQuote", "rangeWidthPips", "expectedSlippagePips", "expectedFeeIncomeLowQuote", "expectedFeeIncomeHighQuote", "inventoryExposurePips", "maximumDailyTurnoverPips", "satisfiesIntent", "reasons" ], "additionalProperties": false }, "outcomes": { "type": "object", "properties": { "variant": { "type": "string", "enum": [ "CURRENT", "RECOMMENDED", "CONSERVATIVE", "CAPITAL_EFFICIENT", "EMERGENCY" ] }, "endingValueQuote": { "type": "object", "properties": { "p5": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p25": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p50": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p75": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p95": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" } }, "required": [ "p5", "p25", "p50", "p75", "p95" ], "additionalProperties": false }, "turnoverQuote": { "type": "object", "properties": { "p5": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p25": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p50": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p75": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p95": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" } }, "required": [ "p5", "p25", "p50", "p75", "p95" ], "additionalProperties": false }, "gasCostQuote": { "type": "object", "properties": { "p5": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p25": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p50": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p75": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p95": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" } }, "required": [ "p5", "p25", "p50", "p75", "p95" ], "additionalProperties": false }, "feeIncomeQuote": { "type": "object", "properties": { "p5": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p25": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p50": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p75": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p95": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" } }, "required": [ "p5", "p25", "p50", "p75", "p95" ], "additionalProperties": false }, "protocolFeesQuote": { "type": "object", "properties": { "p5": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p25": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p50": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p75": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p95": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" } }, "required": [ "p5", "p25", "p50", "p75", "p95" ], "additionalProperties": false }, "platformFeesQuote": { "type": "object", "properties": { "p5": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p25": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p50": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p75": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p95": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" } }, "required": [ "p5", "p25", "p50", "p75", "p95" ], "additionalProperties": false }, "minimumDepthQuote": { "type": "object", "properties": { "p5": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p25": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p50": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p75": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p95": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" } }, "required": [ "p5", "p25", "p50", "p75", "p95" ], "additionalProperties": false }, "slippagePips": { "type": "object", "properties": { "p5": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p25": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p50": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p75": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p95": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "p5", "p25", "p50", "p75", "p95" ], "additionalProperties": false }, "drawdownPips": { "type": "object", "properties": { "p5": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p25": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p50": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p75": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p95": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "p5", "p25", "p50", "p75", "p95" ], "additionalProperties": false }, "inventoryPips": { "type": "object", "properties": { "p5": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p25": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p50": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p75": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p95": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "p5", "p25", "p50", "p75", "p95" ], "additionalProperties": false }, "reserveBreachProbabilityPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "drivers": { "maxItems": 7, "type": "array", "items": { "type": "object", "properties": { "driver": { "type": "string", "enum": [ "PRICE_PATH", "VOLATILITY", "FLOW", "LIQUIDITY", "UNLOCK", "GAS", "RESERVE" ] }, "impactQuote": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "evidence": { "type": "string", "maxLength": 1200 }, "method": { "type": "string", "const": "DETERMINISTIC_COUNTERFACTUAL_DELTA_V1" } }, "required": [ "driver", "impactQuote", "evidence", "method" ], "additionalProperties": false } } }, "required": [ "variant", "endingValueQuote", "turnoverQuote", "gasCostQuote", "feeIncomeQuote", "protocolFeesQuote", "platformFeesQuote", "minimumDepthQuote", "slippagePips", "drawdownPips", "inventoryPips", "reserveBreachProbabilityPips", "drivers" ], "additionalProperties": false }, "eligible": { "type": "boolean" }, "ineligibilityReasons": { "maxItems": 4, "type": "array", "items": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{2,119}$" } }, "differences": { "maxItems": 51, "type": "array", "items": { "type": "object", "properties": { "metric": { "type": "string", "enum": [ "endingValueQuote", "turnoverQuote", "gasCostQuote", "feeIncomeQuote", "protocolFeesQuote", "platformFeesQuote", "minimumDepthQuote", "slippagePips", "drawdownPips", "inventoryPips", "reserveBreachProbabilityPips" ] }, "percentile": { "anyOf": [ { "type": "string", "enum": [ "p5", "p25", "p50", "p75", "p95" ] }, { "type": "null" } ] }, "unit": { "type": "string", "enum": [ "VERIFIED_QUOTE_ASSET_ATOMIC", "ISSUER_INTENT_QUOTE_ATOMIC", "PIPS_POINT_DIFFERENCE" ] }, "baseline": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "scenario": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "delta": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,78})$" }, "interpretation": { "type": "string", "enum": [ "DIFFERENCE_OF_MARGINAL_PERCENTILES", "DIFFERENCE_OF_PROBABILITIES" ] } }, "required": [ "metric", "percentile", "unit", "baseline", "scenario", "delta", "interpretation" ], "additionalProperties": false } } }, "required": [ "variant", "capitalPlan", "outcomes", "eligible", "ineligibilityReasons", "differences" ], "additionalProperties": false } }, "ranking": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "BLOCKED", "NO_ELIGIBLE_RECOMMENDATION", "RANKED" ] }, "reason": { "anyOf": [ { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{2,119}$" }, { "type": "null" } ] }, "entries": { "maxItems": 5, "type": "array", "items": { "type": "object", "properties": { "variant": { "type": "string", "enum": [ "CURRENT", "RECOMMENDED", "CONSERVATIVE", "CAPITAL_EFFICIENT", "EMERGENCY" ] }, "rank": { "type": "integer", "minimum": 1, "maximum": 5 }, "objectiveValue": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" } }, "required": [ "variant", "rank", "objectiveValue" ], "additionalProperties": false } } }, "required": [ "status", "reason", "entries" ], "additionalProperties": false } }, "required": [ "trialId", "label", "state", "failureCode", "admittedInputHash", "resultArtifactHash", "context", "admittedInput", "status", "reasons", "warnings", "variants", "ranking" ], "additionalProperties": false } } }, "required": [ "schemaVersion", "baselineTrialId", "objective", "context", "status", "eligibilityRule", "rankingScope", "limitations", "trials" ], "additionalProperties": false }, "ResearchReport": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "agent-research-report-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "protocolHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "status": { "type": "string", "enum": [ "ABSTAINED", "PARTIAL", "COMPLETED" ] }, "comparison": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "research-comparison-v1" }, "baselineTrialId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{0,159}$" }, "objective": { "type": "object", "properties": { "metric": { "type": "string", "enum": [ "ENDING_VALUE_P50", "MINIMUM_DEPTH_P5", "GAS_COST_P50", "DRAWDOWN_P95", "RESERVE_BREACH_PROBABILITY" ] }, "direction": { "type": "string", "enum": [ "MAXIMIZE", "MINIMIZE" ] } }, "required": [ "metric", "direction" ], "additionalProperties": false }, "context": { "anyOf": [ { "type": "object", "properties": { "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "issuerIntentId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "issuerIntentResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "issuerIntentArtifactHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "quoteSymbol": { "type": "string", "minLength": 1, "maxLength": 256 }, "quoteAssetId": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 256 }, { "type": "null" } ] }, "quoteDecimals": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 36 }, { "type": "null" } ] }, "seedPolicyVersion": { "type": "string", "minLength": 1, "maxLength": 256 }, "horizonUnit": { "type": "string", "enum": [ "MODELED_STEPS", "CALIBRATED_STEPS" ] }, "stepDurationSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "analysisBasis": { "type": "string", "enum": [ "CURRENT_DATA_HYPOTHETICAL", "HISTORICAL_POINT_IN_TIME" ] }, "historicalAvailabilityEvidenceHash": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] } }, "required": [ "organizationId", "issuerIntentId", "issuerIntentResourceVersion", "issuerIntentArtifactHash", "sourceCutoff", "quoteSymbol", "quoteAssetId", "quoteDecimals", "seedPolicyVersion", "horizonUnit", "stepDurationSeconds", "analysisBasis", "historicalAvailabilityEvidenceHash" ], "additionalProperties": false }, { "type": "null" } ] }, "status": { "type": "string", "enum": [ "BASELINE_UNAVAILABLE", "COMPLETE", "PARTIAL" ] }, "eligibilityRule": { "type": "string", "const": "ADMITTED_INTENT_CONSTRAINTS_AND_RESERVE_BREACH_AT_MOST_100000_PIPS" }, "rankingScope": { "type": "string", "const": "WITHIN_SCENARIO_VARIANTS" }, "limitations": { "minItems": 6, "maxItems": 6, "type": "array", "items": { "type": "string", "enum": [ "CURRENT_IS_ENGINE_GENERATED_NOT_ACTUAL_HOLDINGS", "COMPARISON_DOES_NOT_PROVE_EQUAL_CAPITAL_SUPERIORITY", "MARGINAL_PERCENTILE_DIFFERENCES_ARE_NOT_PAIRED_DIFFERENCE_PERCENTILES", "RESERVE_BREACH_IS_COMPOSITE_RESERVE_OR_ORACLE_BLOCKED_EVENT", "MODEL_OUTCOMES_ARE_NOT_FINANCIAL_GUARANTEES", "ARTIFACT_HASHES_DO_NOT_REPRODUCE_ENGINE_OUTPUT" ] } }, "trials": { "minItems": 1, "maxItems": 4, "type": "array", "items": { "type": "object", "properties": { "trialId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{0,159}$" }, "label": { "type": "string", "minLength": 1, "maxLength": 160 }, "state": { "type": "string", "enum": [ "QUEUED", "RUNNING", "COMPLETED", "FAILED", "CANCELLED" ] }, "failureCode": { "anyOf": [ { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{2,119}$" }, { "type": "null" } ] }, "admittedInputHash": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] }, "resultArtifactHash": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] }, "context": { "anyOf": [ { "type": "object", "properties": { "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "issuerIntentId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "issuerIntentResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "issuerIntentArtifactHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "quoteSymbol": { "type": "string", "minLength": 1, "maxLength": 256 }, "quoteAssetId": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 256 }, { "type": "null" } ] }, "quoteDecimals": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 36 }, { "type": "null" } ] }, "seedPolicyVersion": { "type": "string", "minLength": 1, "maxLength": 256 }, "horizonUnit": { "type": "string", "enum": [ "MODELED_STEPS", "CALIBRATED_STEPS" ] }, "stepDurationSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "analysisBasis": { "type": "string", "enum": [ "CURRENT_DATA_HYPOTHETICAL", "HISTORICAL_POINT_IN_TIME" ] }, "historicalAvailabilityEvidenceHash": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] } }, "required": [ "organizationId", "issuerIntentId", "issuerIntentResourceVersion", "issuerIntentArtifactHash", "sourceCutoff", "quoteSymbol", "quoteAssetId", "quoteDecimals", "seedPolicyVersion", "horizonUnit", "stepDurationSeconds", "analysisBasis", "historicalAvailabilityEvidenceHash" ], "additionalProperties": false }, { "type": "null" } ] }, "admittedInput": { "anyOf": [ { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "simulation-study-input-snapshot-v1" }, "engineVersion": { "type": "string", "const": "digital-twin-pcg64-fixed-v2" }, "seed": { "type": "string", "minLength": 1, "maxLength": 256 }, "pathCount": { "anyOf": [ { "type": "number", "const": 2000 }, { "type": "number", "const": 10000 } ] }, "stepCount": { "type": "integer", "minimum": 1, "maximum": 365 }, "targetTradeSizeQuote": { "type": "string", "pattern": "^[1-9][0-9]*$" }, "startingPortfolioQuote": { "type": "string", "pattern": "^[1-9][0-9]*$" }, "startingDepthQuote": { "type": "string", "pattern": "^[1-9][0-9]*$" }, "startingInventoryPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "scenario": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "name": { "type": "string", "minLength": 3, "maxLength": 160 }, "kind": { "type": "string", "enum": [ "HISTORICAL_REPLAY", "BULL", "BEAR", "SIDEWAYS", "LIQUIDITY_CRISIS", "TOKEN_UNLOCK", "LARGE_BUYER", "LARGE_SELLER", "LIQUIDITY_WITHDRAWAL", "GAS_SPIKE", "ORACLE_OUTAGE", "COMBINED" ] }, "driftPipsPerStep": { "type": "integer", "minimum": -1000000, "maximum": 1000000 }, "volatilityPipsPerStep": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "liquidityWithdrawalPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "oneSidedFlowPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "gasIncreasePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "oracleOutageStep": { "type": "integer", "minimum": 0, "maximum": 364 }, "historicalReturnPips": { "minItems": 1, "maxItems": 365, "type": "array", "items": { "type": "integer", "minimum": -1000000, "maximum": 1000000 } }, "protocolFeePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "platformFeePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "unlocks": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,152}$" }, "unlocksAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "tokenAmount": { "type": "string", "pattern": "^[1-9][0-9]*$" }, "recipientCategory": { "type": "string", "enum": [ "TEAM", "INVESTOR", "COMMUNITY", "TREASURY", "ECOSYSTEM", "OTHER" ] }, "expectedSaleParticipationPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "confidencePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "correlationGroup": { "type": "string", "minLength": 1, "maxLength": 120 }, "evidenceHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" } }, "required": [ "id", "unlocksAt", "tokenAmount", "recipientCategory", "expectedSaleParticipationPips", "confidencePips" ], "additionalProperties": false } } }, "required": [ "id", "name", "kind", "driftPipsPerStep", "volatilityPipsPerStep", "liquidityWithdrawalPips", "oneSidedFlowPips", "gasIncreasePips", "unlocks" ], "additionalProperties": false }, "variants": { "minItems": 5, "maxItems": 5, "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "CURRENT", "RECOMMENDED", "CONSERVATIVE", "CAPITAL_EFFICIENT", "EMERGENCY" ] }, "requiredCapitalQuote": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "deployableCapitalQuote": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "stableReserveQuote": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "emergencyReserveQuote": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "rangeWidthPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "expectedSlippagePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "expectedFeeIncomeLowQuote": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "expectedFeeIncomeHighQuote": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "inventoryExposurePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "maximumDailyTurnoverPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "satisfiesIntent": { "type": "boolean" }, "reasons": { "maxItems": 64, "type": "array", "items": { "type": "string" } } }, "required": [ "kind", "requiredCapitalQuote", "deployableCapitalQuote", "stableReserveQuote", "emergencyReserveQuote", "rangeWidthPips", "expectedSlippagePips", "expectedFeeIncomeLowQuote", "expectedFeeIncomeHighQuote", "inventoryExposurePips", "maximumDailyTurnoverPips", "satisfiesIntent", "reasons" ], "additionalProperties": false } } }, "required": [ "schemaVersion", "engineVersion", "seed", "pathCount", "stepCount", "targetTradeSizeQuote", "startingPortfolioQuote", "startingDepthQuote", "startingInventoryPips", "scenario", "variants" ], "additionalProperties": false }, { "type": "null" } ] }, "status": { "type": "string", "enum": [ "PENDING", "FAILED", "CANCELLED", "INVALID", "INCOMPATIBLE", "BASELINE_UNAVAILABLE", "COMPARABLE" ] }, "reasons": { "maxItems": 16, "type": "array", "items": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{2,119}$" } }, "warnings": { "maxItems": 64, "type": "array", "items": { "type": "string", "maxLength": 1200 } }, "variants": { "maxItems": 5, "type": "array", "items": { "type": "object", "properties": { "variant": { "type": "string", "enum": [ "CURRENT", "RECOMMENDED", "CONSERVATIVE", "CAPITAL_EFFICIENT", "EMERGENCY" ] }, "capitalPlan": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "CURRENT", "RECOMMENDED", "CONSERVATIVE", "CAPITAL_EFFICIENT", "EMERGENCY" ] }, "requiredCapitalQuote": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "deployableCapitalQuote": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "stableReserveQuote": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "emergencyReserveQuote": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "rangeWidthPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "expectedSlippagePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "expectedFeeIncomeLowQuote": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "expectedFeeIncomeHighQuote": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "inventoryExposurePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "maximumDailyTurnoverPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "satisfiesIntent": { "type": "boolean" }, "reasons": { "maxItems": 64, "type": "array", "items": { "type": "string", "maxLength": 1200 } } }, "required": [ "kind", "requiredCapitalQuote", "deployableCapitalQuote", "stableReserveQuote", "emergencyReserveQuote", "rangeWidthPips", "expectedSlippagePips", "expectedFeeIncomeLowQuote", "expectedFeeIncomeHighQuote", "inventoryExposurePips", "maximumDailyTurnoverPips", "satisfiesIntent", "reasons" ], "additionalProperties": false }, "outcomes": { "type": "object", "properties": { "variant": { "type": "string", "enum": [ "CURRENT", "RECOMMENDED", "CONSERVATIVE", "CAPITAL_EFFICIENT", "EMERGENCY" ] }, "endingValueQuote": { "type": "object", "properties": { "p5": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p25": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p50": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p75": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p95": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" } }, "required": [ "p5", "p25", "p50", "p75", "p95" ], "additionalProperties": false }, "turnoverQuote": { "type": "object", "properties": { "p5": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p25": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p50": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p75": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p95": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" } }, "required": [ "p5", "p25", "p50", "p75", "p95" ], "additionalProperties": false }, "gasCostQuote": { "type": "object", "properties": { "p5": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p25": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p50": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p75": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p95": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" } }, "required": [ "p5", "p25", "p50", "p75", "p95" ], "additionalProperties": false }, "feeIncomeQuote": { "type": "object", "properties": { "p5": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p25": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p50": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p75": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p95": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" } }, "required": [ "p5", "p25", "p50", "p75", "p95" ], "additionalProperties": false }, "protocolFeesQuote": { "type": "object", "properties": { "p5": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p25": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p50": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p75": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p95": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" } }, "required": [ "p5", "p25", "p50", "p75", "p95" ], "additionalProperties": false }, "platformFeesQuote": { "type": "object", "properties": { "p5": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p25": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p50": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p75": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p95": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" } }, "required": [ "p5", "p25", "p50", "p75", "p95" ], "additionalProperties": false }, "minimumDepthQuote": { "type": "object", "properties": { "p5": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p25": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p50": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p75": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p95": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" } }, "required": [ "p5", "p25", "p50", "p75", "p95" ], "additionalProperties": false }, "slippagePips": { "type": "object", "properties": { "p5": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p25": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p50": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p75": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p95": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "p5", "p25", "p50", "p75", "p95" ], "additionalProperties": false }, "drawdownPips": { "type": "object", "properties": { "p5": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p25": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p50": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p75": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p95": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "p5", "p25", "p50", "p75", "p95" ], "additionalProperties": false }, "inventoryPips": { "type": "object", "properties": { "p5": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p25": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p50": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p75": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p95": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "p5", "p25", "p50", "p75", "p95" ], "additionalProperties": false }, "reserveBreachProbabilityPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "drivers": { "maxItems": 7, "type": "array", "items": { "type": "object", "properties": { "driver": { "type": "string", "enum": [ "PRICE_PATH", "VOLATILITY", "FLOW", "LIQUIDITY", "UNLOCK", "GAS", "RESERVE" ] }, "impactQuote": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "evidence": { "type": "string", "maxLength": 1200 }, "method": { "type": "string", "const": "DETERMINISTIC_COUNTERFACTUAL_DELTA_V1" } }, "required": [ "driver", "impactQuote", "evidence", "method" ], "additionalProperties": false } } }, "required": [ "variant", "endingValueQuote", "turnoverQuote", "gasCostQuote", "feeIncomeQuote", "protocolFeesQuote", "platformFeesQuote", "minimumDepthQuote", "slippagePips", "drawdownPips", "inventoryPips", "reserveBreachProbabilityPips", "drivers" ], "additionalProperties": false }, "eligible": { "type": "boolean" }, "ineligibilityReasons": { "maxItems": 4, "type": "array", "items": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{2,119}$" } }, "differences": { "maxItems": 51, "type": "array", "items": { "type": "object", "properties": { "metric": { "type": "string", "enum": [ "endingValueQuote", "turnoverQuote", "gasCostQuote", "feeIncomeQuote", "protocolFeesQuote", "platformFeesQuote", "minimumDepthQuote", "slippagePips", "drawdownPips", "inventoryPips", "reserveBreachProbabilityPips" ] }, "percentile": { "anyOf": [ { "type": "string", "enum": [ "p5", "p25", "p50", "p75", "p95" ] }, { "type": "null" } ] }, "unit": { "type": "string", "enum": [ "VERIFIED_QUOTE_ASSET_ATOMIC", "ISSUER_INTENT_QUOTE_ATOMIC", "PIPS_POINT_DIFFERENCE" ] }, "baseline": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "scenario": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "delta": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,78})$" }, "interpretation": { "type": "string", "enum": [ "DIFFERENCE_OF_MARGINAL_PERCENTILES", "DIFFERENCE_OF_PROBABILITIES" ] } }, "required": [ "metric", "percentile", "unit", "baseline", "scenario", "delta", "interpretation" ], "additionalProperties": false } } }, "required": [ "variant", "capitalPlan", "outcomes", "eligible", "ineligibilityReasons", "differences" ], "additionalProperties": false } }, "ranking": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "BLOCKED", "NO_ELIGIBLE_RECOMMENDATION", "RANKED" ] }, "reason": { "anyOf": [ { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{2,119}$" }, { "type": "null" } ] }, "entries": { "maxItems": 5, "type": "array", "items": { "type": "object", "properties": { "variant": { "type": "string", "enum": [ "CURRENT", "RECOMMENDED", "CONSERVATIVE", "CAPITAL_EFFICIENT", "EMERGENCY" ] }, "rank": { "type": "integer", "minimum": 1, "maximum": 5 }, "objectiveValue": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" } }, "required": [ "variant", "rank", "objectiveValue" ], "additionalProperties": false } } }, "required": [ "status", "reason", "entries" ], "additionalProperties": false } }, "required": [ "trialId", "label", "state", "failureCode", "admittedInputHash", "resultArtifactHash", "context", "admittedInput", "status", "reasons", "warnings", "variants", "ranking" ], "additionalProperties": false } } }, "required": [ "schemaVersion", "baselineTrialId", "objective", "context", "status", "eligibilityRule", "rankingScope", "limitations", "trials" ], "additionalProperties": false }, "findings": { "maxItems": 32, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "maxLength": 120, "pattern": "^finding-[a-z0-9-]+$" }, "kind": { "type": "string", "enum": [ "SCOPE", "ANALYSIS_BASIS", "DISPOSITION", "TRIAL", "ELIGIBILITY", "ADVERSE_OUTCOME", "LIMITATION", "METRIC_EXPLANATION" ] }, "mandatory": { "type": "boolean" }, "severity": { "type": "string", "enum": [ "INFO", "WARNING" ] }, "summary": { "type": "string", "minLength": 1, "maxLength": 1200 }, "trialId": { "anyOf": [ { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{0,159}$" }, { "type": "null" } ] } }, "required": [ "id", "kind", "mandatory", "severity", "summary", "trialId" ], "additionalProperties": false } }, "nextChecks": { "maxItems": 5, "type": "array", "items": { "type": "string", "enum": [ "INSPECT_STUDY_INPUTS", "INSPECT_FAILED_TRIALS", "REVIEW_MODEL_LIMITATIONS", "EDIT_AND_RERUN", "RETURN_TO_PLAN" ] } }, "financialAuthority": { "type": "boolean", "const": false }, "publicationAuthority": { "type": "boolean", "const": false } }, "required": [ "schemaVersion", "organizationId", "runId", "protocolHash", "sourceCutoff", "status", "comparison", "findings", "nextChecks", "financialAuthority", "publicationAuthority" ], "additionalProperties": false }, "SavedResearchResult": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "saved-research-result-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resultVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "completedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "protocolHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "report": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "agent-research-report-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "protocolHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "status": { "type": "string", "enum": [ "ABSTAINED", "PARTIAL", "COMPLETED" ] }, "comparison": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "research-comparison-v1" }, "baselineTrialId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{0,159}$" }, "objective": { "type": "object", "properties": { "metric": { "type": "string", "enum": [ "ENDING_VALUE_P50", "MINIMUM_DEPTH_P5", "GAS_COST_P50", "DRAWDOWN_P95", "RESERVE_BREACH_PROBABILITY" ] }, "direction": { "type": "string", "enum": [ "MAXIMIZE", "MINIMIZE" ] } }, "required": [ "metric", "direction" ], "additionalProperties": false }, "context": { "anyOf": [ { "type": "object", "properties": { "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "issuerIntentId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "issuerIntentResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "issuerIntentArtifactHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "quoteSymbol": { "type": "string", "minLength": 1, "maxLength": 256 }, "quoteAssetId": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 256 }, { "type": "null" } ] }, "quoteDecimals": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 36 }, { "type": "null" } ] }, "seedPolicyVersion": { "type": "string", "minLength": 1, "maxLength": 256 }, "horizonUnit": { "type": "string", "enum": [ "MODELED_STEPS", "CALIBRATED_STEPS" ] }, "stepDurationSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "analysisBasis": { "type": "string", "enum": [ "CURRENT_DATA_HYPOTHETICAL", "HISTORICAL_POINT_IN_TIME" ] }, "historicalAvailabilityEvidenceHash": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] } }, "required": [ "organizationId", "issuerIntentId", "issuerIntentResourceVersion", "issuerIntentArtifactHash", "sourceCutoff", "quoteSymbol", "quoteAssetId", "quoteDecimals", "seedPolicyVersion", "horizonUnit", "stepDurationSeconds", "analysisBasis", "historicalAvailabilityEvidenceHash" ], "additionalProperties": false }, { "type": "null" } ] }, "status": { "type": "string", "enum": [ "BASELINE_UNAVAILABLE", "COMPLETE", "PARTIAL" ] }, "eligibilityRule": { "type": "string", "const": "ADMITTED_INTENT_CONSTRAINTS_AND_RESERVE_BREACH_AT_MOST_100000_PIPS" }, "rankingScope": { "type": "string", "const": "WITHIN_SCENARIO_VARIANTS" }, "limitations": { "minItems": 6, "maxItems": 6, "type": "array", "items": { "type": "string", "enum": [ "CURRENT_IS_ENGINE_GENERATED_NOT_ACTUAL_HOLDINGS", "COMPARISON_DOES_NOT_PROVE_EQUAL_CAPITAL_SUPERIORITY", "MARGINAL_PERCENTILE_DIFFERENCES_ARE_NOT_PAIRED_DIFFERENCE_PERCENTILES", "RESERVE_BREACH_IS_COMPOSITE_RESERVE_OR_ORACLE_BLOCKED_EVENT", "MODEL_OUTCOMES_ARE_NOT_FINANCIAL_GUARANTEES", "ARTIFACT_HASHES_DO_NOT_REPRODUCE_ENGINE_OUTPUT" ] } }, "trials": { "minItems": 1, "maxItems": 4, "type": "array", "items": { "type": "object", "properties": { "trialId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{0,159}$" }, "label": { "type": "string", "minLength": 1, "maxLength": 160 }, "state": { "type": "string", "enum": [ "QUEUED", "RUNNING", "COMPLETED", "FAILED", "CANCELLED" ] }, "failureCode": { "anyOf": [ { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{2,119}$" }, { "type": "null" } ] }, "admittedInputHash": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] }, "resultArtifactHash": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] }, "context": { "anyOf": [ { "type": "object", "properties": { "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "issuerIntentId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "issuerIntentResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "issuerIntentArtifactHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "quoteSymbol": { "type": "string", "minLength": 1, "maxLength": 256 }, "quoteAssetId": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 256 }, { "type": "null" } ] }, "quoteDecimals": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 36 }, { "type": "null" } ] }, "seedPolicyVersion": { "type": "string", "minLength": 1, "maxLength": 256 }, "horizonUnit": { "type": "string", "enum": [ "MODELED_STEPS", "CALIBRATED_STEPS" ] }, "stepDurationSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "analysisBasis": { "type": "string", "enum": [ "CURRENT_DATA_HYPOTHETICAL", "HISTORICAL_POINT_IN_TIME" ] }, "historicalAvailabilityEvidenceHash": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] } }, "required": [ "organizationId", "issuerIntentId", "issuerIntentResourceVersion", "issuerIntentArtifactHash", "sourceCutoff", "quoteSymbol", "quoteAssetId", "quoteDecimals", "seedPolicyVersion", "horizonUnit", "stepDurationSeconds", "analysisBasis", "historicalAvailabilityEvidenceHash" ], "additionalProperties": false }, { "type": "null" } ] }, "admittedInput": { "anyOf": [ { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "simulation-study-input-snapshot-v1" }, "engineVersion": { "type": "string", "const": "digital-twin-pcg64-fixed-v2" }, "seed": { "type": "string", "minLength": 1, "maxLength": 256 }, "pathCount": { "anyOf": [ { "type": "number", "const": 2000 }, { "type": "number", "const": 10000 } ] }, "stepCount": { "type": "integer", "minimum": 1, "maximum": 365 }, "targetTradeSizeQuote": { "type": "string", "pattern": "^[1-9][0-9]*$" }, "startingPortfolioQuote": { "type": "string", "pattern": "^[1-9][0-9]*$" }, "startingDepthQuote": { "type": "string", "pattern": "^[1-9][0-9]*$" }, "startingInventoryPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "scenario": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "name": { "type": "string", "minLength": 3, "maxLength": 160 }, "kind": { "type": "string", "enum": [ "HISTORICAL_REPLAY", "BULL", "BEAR", "SIDEWAYS", "LIQUIDITY_CRISIS", "TOKEN_UNLOCK", "LARGE_BUYER", "LARGE_SELLER", "LIQUIDITY_WITHDRAWAL", "GAS_SPIKE", "ORACLE_OUTAGE", "COMBINED" ] }, "driftPipsPerStep": { "type": "integer", "minimum": -1000000, "maximum": 1000000 }, "volatilityPipsPerStep": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "liquidityWithdrawalPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "oneSidedFlowPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "gasIncreasePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "oracleOutageStep": { "type": "integer", "minimum": 0, "maximum": 364 }, "historicalReturnPips": { "minItems": 1, "maxItems": 365, "type": "array", "items": { "type": "integer", "minimum": -1000000, "maximum": 1000000 } }, "protocolFeePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "platformFeePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "unlocks": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,152}$" }, "unlocksAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "tokenAmount": { "type": "string", "pattern": "^[1-9][0-9]*$" }, "recipientCategory": { "type": "string", "enum": [ "TEAM", "INVESTOR", "COMMUNITY", "TREASURY", "ECOSYSTEM", "OTHER" ] }, "expectedSaleParticipationPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "confidencePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "correlationGroup": { "type": "string", "minLength": 1, "maxLength": 120 }, "evidenceHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" } }, "required": [ "id", "unlocksAt", "tokenAmount", "recipientCategory", "expectedSaleParticipationPips", "confidencePips" ], "additionalProperties": false } } }, "required": [ "id", "name", "kind", "driftPipsPerStep", "volatilityPipsPerStep", "liquidityWithdrawalPips", "oneSidedFlowPips", "gasIncreasePips", "unlocks" ], "additionalProperties": false }, "variants": { "minItems": 5, "maxItems": 5, "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "CURRENT", "RECOMMENDED", "CONSERVATIVE", "CAPITAL_EFFICIENT", "EMERGENCY" ] }, "requiredCapitalQuote": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "deployableCapitalQuote": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "stableReserveQuote": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "emergencyReserveQuote": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "rangeWidthPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "expectedSlippagePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "expectedFeeIncomeLowQuote": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "expectedFeeIncomeHighQuote": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "inventoryExposurePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "maximumDailyTurnoverPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "satisfiesIntent": { "type": "boolean" }, "reasons": { "maxItems": 64, "type": "array", "items": { "type": "string" } } }, "required": [ "kind", "requiredCapitalQuote", "deployableCapitalQuote", "stableReserveQuote", "emergencyReserveQuote", "rangeWidthPips", "expectedSlippagePips", "expectedFeeIncomeLowQuote", "expectedFeeIncomeHighQuote", "inventoryExposurePips", "maximumDailyTurnoverPips", "satisfiesIntent", "reasons" ], "additionalProperties": false } } }, "required": [ "schemaVersion", "engineVersion", "seed", "pathCount", "stepCount", "targetTradeSizeQuote", "startingPortfolioQuote", "startingDepthQuote", "startingInventoryPips", "scenario", "variants" ], "additionalProperties": false }, { "type": "null" } ] }, "status": { "type": "string", "enum": [ "PENDING", "FAILED", "CANCELLED", "INVALID", "INCOMPATIBLE", "BASELINE_UNAVAILABLE", "COMPARABLE" ] }, "reasons": { "maxItems": 16, "type": "array", "items": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{2,119}$" } }, "warnings": { "maxItems": 64, "type": "array", "items": { "type": "string", "maxLength": 1200 } }, "variants": { "maxItems": 5, "type": "array", "items": { "type": "object", "properties": { "variant": { "type": "string", "enum": [ "CURRENT", "RECOMMENDED", "CONSERVATIVE", "CAPITAL_EFFICIENT", "EMERGENCY" ] }, "capitalPlan": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "CURRENT", "RECOMMENDED", "CONSERVATIVE", "CAPITAL_EFFICIENT", "EMERGENCY" ] }, "requiredCapitalQuote": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "deployableCapitalQuote": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "stableReserveQuote": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "emergencyReserveQuote": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "rangeWidthPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "expectedSlippagePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "expectedFeeIncomeLowQuote": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "expectedFeeIncomeHighQuote": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "inventoryExposurePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "maximumDailyTurnoverPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "satisfiesIntent": { "type": "boolean" }, "reasons": { "maxItems": 64, "type": "array", "items": { "type": "string", "maxLength": 1200 } } }, "required": [ "kind", "requiredCapitalQuote", "deployableCapitalQuote", "stableReserveQuote", "emergencyReserveQuote", "rangeWidthPips", "expectedSlippagePips", "expectedFeeIncomeLowQuote", "expectedFeeIncomeHighQuote", "inventoryExposurePips", "maximumDailyTurnoverPips", "satisfiesIntent", "reasons" ], "additionalProperties": false }, "outcomes": { "type": "object", "properties": { "variant": { "type": "string", "enum": [ "CURRENT", "RECOMMENDED", "CONSERVATIVE", "CAPITAL_EFFICIENT", "EMERGENCY" ] }, "endingValueQuote": { "type": "object", "properties": { "p5": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p25": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p50": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p75": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p95": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" } }, "required": [ "p5", "p25", "p50", "p75", "p95" ], "additionalProperties": false }, "turnoverQuote": { "type": "object", "properties": { "p5": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p25": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p50": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p75": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p95": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" } }, "required": [ "p5", "p25", "p50", "p75", "p95" ], "additionalProperties": false }, "gasCostQuote": { "type": "object", "properties": { "p5": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p25": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p50": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p75": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p95": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" } }, "required": [ "p5", "p25", "p50", "p75", "p95" ], "additionalProperties": false }, "feeIncomeQuote": { "type": "object", "properties": { "p5": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p25": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p50": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p75": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p95": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" } }, "required": [ "p5", "p25", "p50", "p75", "p95" ], "additionalProperties": false }, "protocolFeesQuote": { "type": "object", "properties": { "p5": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p25": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p50": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p75": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p95": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" } }, "required": [ "p5", "p25", "p50", "p75", "p95" ], "additionalProperties": false }, "platformFeesQuote": { "type": "object", "properties": { "p5": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p25": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p50": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p75": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p95": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" } }, "required": [ "p5", "p25", "p50", "p75", "p95" ], "additionalProperties": false }, "minimumDepthQuote": { "type": "object", "properties": { "p5": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p25": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p50": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p75": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "p95": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" } }, "required": [ "p5", "p25", "p50", "p75", "p95" ], "additionalProperties": false }, "slippagePips": { "type": "object", "properties": { "p5": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p25": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p50": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p75": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p95": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "p5", "p25", "p50", "p75", "p95" ], "additionalProperties": false }, "drawdownPips": { "type": "object", "properties": { "p5": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p25": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p50": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p75": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p95": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "p5", "p25", "p50", "p75", "p95" ], "additionalProperties": false }, "inventoryPips": { "type": "object", "properties": { "p5": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p25": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p50": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p75": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "p95": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "p5", "p25", "p50", "p75", "p95" ], "additionalProperties": false }, "reserveBreachProbabilityPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "drivers": { "maxItems": 7, "type": "array", "items": { "type": "object", "properties": { "driver": { "type": "string", "enum": [ "PRICE_PATH", "VOLATILITY", "FLOW", "LIQUIDITY", "UNLOCK", "GAS", "RESERVE" ] }, "impactQuote": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "evidence": { "type": "string", "maxLength": 1200 }, "method": { "type": "string", "const": "DETERMINISTIC_COUNTERFACTUAL_DELTA_V1" } }, "required": [ "driver", "impactQuote", "evidence", "method" ], "additionalProperties": false } } }, "required": [ "variant", "endingValueQuote", "turnoverQuote", "gasCostQuote", "feeIncomeQuote", "protocolFeesQuote", "platformFeesQuote", "minimumDepthQuote", "slippagePips", "drawdownPips", "inventoryPips", "reserveBreachProbabilityPips", "drivers" ], "additionalProperties": false }, "eligible": { "type": "boolean" }, "ineligibilityReasons": { "maxItems": 4, "type": "array", "items": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{2,119}$" } }, "differences": { "maxItems": 51, "type": "array", "items": { "type": "object", "properties": { "metric": { "type": "string", "enum": [ "endingValueQuote", "turnoverQuote", "gasCostQuote", "feeIncomeQuote", "protocolFeesQuote", "platformFeesQuote", "minimumDepthQuote", "slippagePips", "drawdownPips", "inventoryPips", "reserveBreachProbabilityPips" ] }, "percentile": { "anyOf": [ { "type": "string", "enum": [ "p5", "p25", "p50", "p75", "p95" ] }, { "type": "null" } ] }, "unit": { "type": "string", "enum": [ "VERIFIED_QUOTE_ASSET_ATOMIC", "ISSUER_INTENT_QUOTE_ATOMIC", "PIPS_POINT_DIFFERENCE" ] }, "baseline": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "scenario": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "delta": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,78})$" }, "interpretation": { "type": "string", "enum": [ "DIFFERENCE_OF_MARGINAL_PERCENTILES", "DIFFERENCE_OF_PROBABILITIES" ] } }, "required": [ "metric", "percentile", "unit", "baseline", "scenario", "delta", "interpretation" ], "additionalProperties": false } } }, "required": [ "variant", "capitalPlan", "outcomes", "eligible", "ineligibilityReasons", "differences" ], "additionalProperties": false } }, "ranking": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "BLOCKED", "NO_ELIGIBLE_RECOMMENDATION", "RANKED" ] }, "reason": { "anyOf": [ { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{2,119}$" }, { "type": "null" } ] }, "entries": { "maxItems": 5, "type": "array", "items": { "type": "object", "properties": { "variant": { "type": "string", "enum": [ "CURRENT", "RECOMMENDED", "CONSERVATIVE", "CAPITAL_EFFICIENT", "EMERGENCY" ] }, "rank": { "type": "integer", "minimum": 1, "maximum": 5 }, "objectiveValue": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" } }, "required": [ "variant", "rank", "objectiveValue" ], "additionalProperties": false } } }, "required": [ "status", "reason", "entries" ], "additionalProperties": false } }, "required": [ "trialId", "label", "state", "failureCode", "admittedInputHash", "resultArtifactHash", "context", "admittedInput", "status", "reasons", "warnings", "variants", "ranking" ], "additionalProperties": false } } }, "required": [ "schemaVersion", "baselineTrialId", "objective", "context", "status", "eligibilityRule", "rankingScope", "limitations", "trials" ], "additionalProperties": false }, "findings": { "maxItems": 32, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "maxLength": 120, "pattern": "^finding-[a-z0-9-]+$" }, "kind": { "type": "string", "enum": [ "SCOPE", "ANALYSIS_BASIS", "DISPOSITION", "TRIAL", "ELIGIBILITY", "ADVERSE_OUTCOME", "LIMITATION", "METRIC_EXPLANATION" ] }, "mandatory": { "type": "boolean" }, "severity": { "type": "string", "enum": [ "INFO", "WARNING" ] }, "summary": { "type": "string", "minLength": 1, "maxLength": 1200 }, "trialId": { "anyOf": [ { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{0,159}$" }, { "type": "null" } ] } }, "required": [ "id", "kind", "mandatory", "severity", "summary", "trialId" ], "additionalProperties": false } }, "nextChecks": { "maxItems": 5, "type": "array", "items": { "type": "string", "enum": [ "INSPECT_STUDY_INPUTS", "INSPECT_FAILED_TRIALS", "REVIEW_MODEL_LIMITATIONS", "EDIT_AND_RERUN", "RETURN_TO_PLAN" ] } }, "financialAuthority": { "type": "boolean", "const": false }, "publicationAuthority": { "type": "boolean", "const": false } }, "required": [ "schemaVersion", "organizationId", "runId", "protocolHash", "sourceCutoff", "status", "comparison", "findings", "nextChecks", "financialAuthority", "publicationAuthority" ], "additionalProperties": false }, "applicability": { "type": "object", "properties": { "scope": { "type": "string", "const": "ISSUER_INTENT_VERSION_ONLY" }, "status": { "type": "string", "enum": [ "SAME_SUBJECT_VERSION", "SUBJECT_CHANGED", "SUBJECT_UNAVAILABLE" ] }, "checkedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "savedSubjectVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "currentSubjectVersion": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] } }, "required": [ "scope", "status", "checkedAt", "savedSubjectVersion", "currentSubjectVersion" ], "additionalProperties": false } }, "required": [ "schemaVersion", "organizationId", "runId", "resultVersion", "completedAt", "protocolHash", "report", "applicability" ], "additionalProperties": false }, "ResearchTrialInput": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "agent-research-trial-input-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "trialKey": { "type": "string", "enum": [ "baseline", "alternative-1", "alternative-2", "alternative-3" ] }, "label": { "type": "string", "minLength": 1, "maxLength": 120 }, "protocolHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "inputHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "state": { "type": "string", "enum": [ "QUEUED", "RUNNING", "COMPLETED", "FAILED", "CANCELLED" ] }, "chargedComputeUnits": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,7})$" }, "failureCode": { "anyOf": [ { "type": "string", "maxLength": 160 }, { "type": "null" } ] }, "artifactHash": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] }, "recordedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, { "type": "null" } ] }, "input": { "type": "object", "properties": { "seed": { "type": "string", "minLength": 1, "maxLength": 256 }, "pathCount": { "anyOf": [ { "type": "number", "const": 2000 }, { "type": "number", "const": 10000 } ] }, "stepCount": { "type": "integer", "minimum": 1, "maximum": 365 }, "targetTradeSizeQuote": { "type": "string", "pattern": "^[1-9][0-9]*$" }, "startingPortfolioQuote": { "type": "string", "pattern": "^[1-9][0-9]*$" }, "startingDepthQuote": { "type": "string", "pattern": "^[1-9][0-9]*$" }, "startingInventoryPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "scenario": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "name": { "type": "string", "minLength": 3, "maxLength": 160 }, "kind": { "type": "string", "enum": [ "HISTORICAL_REPLAY", "BULL", "BEAR", "SIDEWAYS", "LIQUIDITY_CRISIS", "TOKEN_UNLOCK", "LARGE_BUYER", "LARGE_SELLER", "LIQUIDITY_WITHDRAWAL", "GAS_SPIKE", "ORACLE_OUTAGE", "COMBINED" ] }, "driftPipsPerStep": { "type": "integer", "minimum": -1000000, "maximum": 1000000 }, "volatilityPipsPerStep": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "liquidityWithdrawalPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "oneSidedFlowPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "gasIncreasePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "oracleOutageStep": { "type": "integer", "minimum": 0, "maximum": 364 }, "historicalReturnPips": { "minItems": 1, "maxItems": 365, "type": "array", "items": { "type": "integer", "minimum": -1000000, "maximum": 1000000 } }, "protocolFeePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "platformFeePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "unlocks": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,152}$" }, "unlocksAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "tokenAmount": { "type": "string", "pattern": "^[1-9][0-9]*$" }, "recipientCategory": { "type": "string", "enum": [ "TEAM", "INVESTOR", "COMMUNITY", "TREASURY", "ECOSYSTEM", "OTHER" ] }, "expectedSaleParticipationPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "confidencePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "correlationGroup": { "type": "string", "minLength": 1, "maxLength": 120 }, "evidenceHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" } }, "required": [ "id", "unlocksAt", "tokenAmount", "recipientCategory", "expectedSaleParticipationPips", "confidencePips" ], "additionalProperties": false } } }, "required": [ "id", "name", "kind", "driftPipsPerStep", "volatilityPipsPerStep", "liquidityWithdrawalPips", "oneSidedFlowPips", "gasIncreasePips", "unlocks" ], "additionalProperties": false }, "variants": { "minItems": 5, "maxItems": 5, "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "CURRENT", "RECOMMENDED", "CONSERVATIVE", "CAPITAL_EFFICIENT", "EMERGENCY" ] }, "requiredCapitalQuote": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "deployableCapitalQuote": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "stableReserveQuote": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "emergencyReserveQuote": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "rangeWidthPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "expectedSlippagePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "expectedFeeIncomeLowQuote": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "expectedFeeIncomeHighQuote": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "inventoryExposurePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "maximumDailyTurnoverPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "satisfiesIntent": { "type": "boolean" }, "reasons": { "maxItems": 64, "type": "array", "items": { "type": "string" } } }, "required": [ "kind", "requiredCapitalQuote", "deployableCapitalQuote", "stableReserveQuote", "emergencyReserveQuote", "rangeWidthPips", "expectedSlippagePips", "expectedFeeIncomeLowQuote", "expectedFeeIncomeHighQuote", "inventoryExposurePips", "maximumDailyTurnoverPips", "satisfiesIntent", "reasons" ], "additionalProperties": false } } }, "required": [ "seed", "pathCount", "stepCount", "targetTradeSizeQuote", "startingPortfolioQuote", "startingDepthQuote", "startingInventoryPips", "scenario", "variants" ], "additionalProperties": false }, "financialAuthority": { "type": "boolean", "const": false }, "publicationAuthority": { "type": "boolean", "const": false } }, "required": [ "schemaVersion", "organizationId", "runId", "trialKey", "label", "protocolHash", "inputHash", "state", "chargedComputeUnits", "failureCode", "artifactHash", "recordedAt", "input", "financialAuthority", "publicationAuthority" ], "additionalProperties": false }, "ResearchAdmissionRequest": { "type": "object", "properties": { "kind": { "type": "string", "const": "WHAT_IF_RESEARCH" }, "question": { "type": "string", "minLength": 3, "maxLength": 2000 }, "subject": { "type": "object", "properties": { "issuerIntentId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "expectedResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "issuerIntentId", "expectedResourceVersion" ], "additionalProperties": false }, "experiment": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "research-experiment-v1" }, "objective": { "type": "object", "properties": { "metric": { "type": "string", "enum": [ "ENDING_VALUE_P50", "MINIMUM_DEPTH_P5", "GAS_COST_P50", "DRAWDOWN_P95", "RESERVE_BREACH_PROBABILITY" ] }, "direction": { "type": "string", "enum": [ "MAXIMIZE", "MINIMIZE" ] } }, "required": [ "metric", "direction" ], "additionalProperties": false }, "seed": { "type": "string", "minLength": 8, "maxLength": 200 }, "pathCount": { "type": "number", "const": 2000 }, "stepCount": { "type": "integer", "minimum": 1, "maximum": 365 }, "startingPortfolioQuote": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "startingDepthQuote": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "startingInventoryPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "baselineScenario": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "name": { "type": "string", "minLength": 3, "maxLength": 160 }, "kind": { "type": "string", "enum": [ "HISTORICAL_REPLAY", "BULL", "BEAR", "SIDEWAYS", "LIQUIDITY_CRISIS", "TOKEN_UNLOCK", "LARGE_BUYER", "LARGE_SELLER", "LIQUIDITY_WITHDRAWAL", "GAS_SPIKE", "ORACLE_OUTAGE", "COMBINED" ] }, "driftPipsPerStep": { "type": "integer", "minimum": -1000000, "maximum": 1000000 }, "volatilityPipsPerStep": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "liquidityWithdrawalPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "oneSidedFlowPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "gasIncreasePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "oracleOutageStep": { "type": "integer", "minimum": 0, "maximum": 364 }, "historicalReturnPips": { "minItems": 1, "maxItems": 365, "type": "array", "items": { "type": "integer", "minimum": -1000000, "maximum": 1000000 } }, "protocolFeePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "platformFeePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "unlocks": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,152}$" }, "unlocksAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "tokenAmount": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "recipientCategory": { "type": "string", "enum": [ "TEAM", "INVESTOR", "COMMUNITY", "TREASURY", "ECOSYSTEM", "OTHER" ] }, "expectedSaleParticipationPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "confidencePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "correlationGroup": { "type": "string", "minLength": 1, "maxLength": 120 }, "evidenceHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" } }, "required": [ "id", "unlocksAt", "tokenAmount", "recipientCategory", "expectedSaleParticipationPips", "confidencePips" ], "additionalProperties": false } } }, "required": [ "id", "name", "kind", "driftPipsPerStep", "volatilityPipsPerStep", "liquidityWithdrawalPips", "oneSidedFlowPips", "gasIncreasePips", "unlocks" ], "additionalProperties": false }, "alternatives": { "maxItems": 3, "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string", "minLength": 1, "maxLength": 120 }, "scenario": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "name": { "type": "string", "minLength": 3, "maxLength": 160 }, "kind": { "type": "string", "enum": [ "HISTORICAL_REPLAY", "BULL", "BEAR", "SIDEWAYS", "LIQUIDITY_CRISIS", "TOKEN_UNLOCK", "LARGE_BUYER", "LARGE_SELLER", "LIQUIDITY_WITHDRAWAL", "GAS_SPIKE", "ORACLE_OUTAGE", "COMBINED" ] }, "driftPipsPerStep": { "type": "integer", "minimum": -1000000, "maximum": 1000000 }, "volatilityPipsPerStep": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "liquidityWithdrawalPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "oneSidedFlowPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "gasIncreasePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "oracleOutageStep": { "type": "integer", "minimum": 0, "maximum": 364 }, "historicalReturnPips": { "minItems": 1, "maxItems": 365, "type": "array", "items": { "type": "integer", "minimum": -1000000, "maximum": 1000000 } }, "protocolFeePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "platformFeePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "unlocks": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,152}$" }, "unlocksAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "tokenAmount": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "recipientCategory": { "type": "string", "enum": [ "TEAM", "INVESTOR", "COMMUNITY", "TREASURY", "ECOSYSTEM", "OTHER" ] }, "expectedSaleParticipationPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "confidencePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "correlationGroup": { "type": "string", "minLength": 1, "maxLength": 120 }, "evidenceHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" } }, "required": [ "id", "unlocksAt", "tokenAmount", "recipientCategory", "expectedSaleParticipationPips", "confidencePips" ], "additionalProperties": false } } }, "required": [ "id", "name", "kind", "driftPipsPerStep", "volatilityPipsPerStep", "liquidityWithdrawalPips", "oneSidedFlowPips", "gasIncreasePips", "unlocks" ], "additionalProperties": false } }, "required": [ "label", "scenario" ], "additionalProperties": false } }, "interpretation": { "type": "string", "const": "CURRENT_DATA_HYPOTHETICAL_MODELED_STEPS" }, "limitationsAccepted": { "type": "boolean", "const": true } }, "required": [ "schemaVersion", "objective", "seed", "pathCount", "stepCount", "startingPortfolioQuote", "startingDepthQuote", "startingInventoryPips", "baselineScenario", "alternatives", "interpretation", "limitationsAccepted" ], "additionalProperties": false } }, "required": [ "kind", "question", "subject", "experiment" ], "additionalProperties": false }, "ResearchProgress": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "agent-research-progress-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "runResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "runState": { "type": "string", "enum": [ "QUEUED", "RUNNING", "WAITING_FOR_INPUT", "WAITING_FOR_CHILDREN", "COMPLETED", "PARTIAL", "ABSTAINED", "FAILED", "CANCELLED" ] }, "checkedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "protocolHash": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] }, "studyCount": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 4 }, { "type": "null" } ] }, "trials": { "maxItems": 4, "type": "array", "items": { "type": "object", "properties": { "trialKey": { "type": "string", "enum": [ "baseline", "alternative-1", "alternative-2", "alternative-3" ] }, "label": { "type": "string", "minLength": 1, "maxLength": 120 }, "state": { "type": "string", "enum": [ "QUEUED", "RUNNING", "COMPLETED", "FAILED", "CANCELLED" ] }, "chargedComputeUnits": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,7})$" }, "failureCode": { "anyOf": [ { "type": "string", "maxLength": 160 }, { "type": "null" } ] }, "artifactHash": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] }, "recordedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, { "type": "null" } ] }, "inputHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "trialKey", "label", "state", "chargedComputeUnits", "failureCode", "artifactHash", "recordedAt", "inputHash" ], "additionalProperties": false } }, "financialAuthority": { "type": "boolean", "const": false }, "publicationAuthority": { "type": "boolean", "const": false } }, "required": [ "schemaVersion", "organizationId", "runId", "runResourceVersion", "runState", "checkedAt", "sourceCutoff", "protocolHash", "studyCount", "trials", "financialAuthority", "publicationAuthority" ], "additionalProperties": false }, "HealthAgentAdmissionRequest": { "type": "object", "properties": { "kind": { "const": "HEALTH_INVESTIGATION" }, "question": { "type": "string", "minLength": 3, "maxLength": 2000 }, "subject": { "oneOf": [ { "type": "object", "properties": { "vaultId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "expectedVaultUpdatedAt": { "type": "string", "format": "date-time" }, "window": { "type": "object", "properties": { "start": { "type": "string", "format": "date-time" }, "end": { "type": "string", "format": "date-time" } }, "required": [ "start", "end" ], "additionalProperties": false }, "baselineWindow": { "type": "object", "properties": { "start": { "type": "string", "format": "date-time" }, "end": { "type": "string", "format": "date-time" } }, "required": [ "start", "end" ], "additionalProperties": false } }, "required": [ "vaultId", "expectedVaultUpdatedAt", "window", "baselineWindow" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "const": "SAVED_PUBLIC_PROJECT" }, "projectId": { "type": "string", "pattern": "^project_[0-9a-f]{32}$" }, "expectedResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "observationSequence": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" }, "baselineSequence": { "anyOf": [ { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" }, { "type": "null" } ] } }, "required": [ "type", "projectId", "expectedResourceVersion", "observationSequence", "baselineSequence" ], "additionalProperties": false } ] } }, "required": [ "kind", "question", "subject" ], "additionalProperties": false }, "ProposalReviewAdmissionRequest": { "type": "object", "properties": { "kind": { "const": "PROPOSAL_REVIEW" }, "question": { "type": "string", "minLength": 3, "maxLength": 2000 }, "subject": { "oneOf": [ { "type": "object", "properties": { "generation": { "const": "V1" }, "proposalId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "expectedUpdatedAt": { "type": "string", "format": "date-time" } }, "required": [ "generation", "proposalId", "expectedUpdatedAt" ], "additionalProperties": false }, { "type": "object", "properties": { "generation": { "const": "V2" }, "proposalId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "expectedResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "generation", "proposalId", "expectedResourceVersion" ], "additionalProperties": false }, { "type": "object", "properties": { "generation": { "const": "DECISION_PACK" }, "packId": { "type": "string", "pattern": "^decisionpack_[a-f0-9]{32}$" }, "expectedResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "expectedContentHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "generation", "packId", "expectedResourceVersion", "expectedContentHash" ], "additionalProperties": false } ] } }, "required": [ "kind", "question", "subject" ], "additionalProperties": false }, "AgentAdmissionRequest": { "oneOf": [ { "$ref": "#/components/schemas/HealthAgentAdmissionRequest" }, { "$ref": "#/components/schemas/ProposalReviewAdmissionRequest" }, { "$ref": "#/components/schemas/ResearchAdmissionRequest" }, { "$ref": "#/components/schemas/ResearchPlanningAdmissionRequest" } ] }, "AgentAdmissionReceipt": { "type": "object", "properties": { "schemaVersion": { "const": "agent-admission-receipt-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "kind": { "type": "string", "enum": [ "HEALTH_INVESTIGATION", "PROPOSAL_REVIEW", "WHAT_IF_RESEARCH" ] }, "state": { "type": "string", "enum": [ "QUEUED", "RUNNING", "WAITING_FOR_INPUT", "WAITING_FOR_CHILDREN", "COMPLETED", "PARTIAL", "ABSTAINED", "FAILED", "CANCELLED" ] }, "phase": { "type": "string", "enum": [ "ADMITTED", "CAPTURING_EVIDENCE", "CHECKING_SOURCES", "COMPARING_EVIDENCE", "PLANNING", "READING_EVIDENCE", "WAITING_FOR_INPUT", "WAITING_FOR_STUDIES", "VALIDATING_REPORT", "FINISHED" ] }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "createdAt": { "type": "string", "format": "date-time" }, "deadline": { "type": "string", "format": "date-time" }, "replayed": { "type": "boolean" } }, "required": [ "schemaVersion", "organizationId", "runId", "kind", "state", "phase", "resourceVersion", "createdAt", "deadline", "replayed" ], "additionalProperties": false }, "HealthEvidenceSource": { "oneOf": [ { "type": "object", "properties": { "generation": { "const": "V1" }, "recordType": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "recordId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "updatedAt": { "type": "string", "format": "date-time" }, "copiedPayloadHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "generation", "recordType", "recordId", "updatedAt", "copiedPayloadHash" ], "additionalProperties": false }, { "type": "object", "properties": { "generation": { "const": "V2" }, "recordType": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "recordId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "artifactHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "generation", "recordType", "recordId", "resourceVersion", "artifactHash" ], "additionalProperties": false } ] }, "HealthFieldReceipt": { "type": "object", "properties": { "evidenceId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "source": { "$ref": "#/components/schemas/HealthEvidenceSource" }, "temporalScope": { "type": "string", "enum": [ "HISTORICAL", "CURRENT_CONTEXT" ] }, "observedAt": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "availableAt": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "capturedAt": { "type": "string", "format": "date-time" }, "sourceCutoff": { "type": "string", "format": "date-time" }, "quoteAssetId": { "anyOf": [ { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, { "type": "null" } ] }, "finality": { "type": "string", "enum": [ "FINALIZED", "NOT_APPLICABLE", "UNKNOWN" ] }, "field": { "type": "string" }, "value": { "oneOf": [ { "type": "string" }, { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "boolean" } ] } }, "required": [ "evidenceId", "source", "temporalScope", "observedAt", "availableAt", "capturedAt", "sourceCutoff", "quoteAssetId", "finality", "field", "value" ], "additionalProperties": false }, "HealthMetricReading": { "type": "object", "properties": { "evidenceId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "field": { "type": "string" }, "value": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$", "description": "Exact unsigned atomic amount; never coerce to a JavaScript number." }, "observedAt": { "type": "string", "format": "date-time" }, "quoteAssetId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "quoteDecimals": { "type": "integer", "minimum": 0, "maximum": 255 }, "definition": { "type": "string" } }, "required": [ "evidenceId", "field", "value", "observedAt", "quoteAssetId", "quoteDecimals", "definition" ], "additionalProperties": false }, "HealthMetricComparison": { "type": "object", "properties": { "metric": { "type": "string", "enum": [ "QUOTE_BALANCE", "PROTECTED_QUOTE_RESERVE", "BUY_DEPTH", "SELL_DEPTH" ] }, "aggregation": { "const": "LAST_RECORDED_SAMPLE" }, "unit": { "const": "QUOTE_ATOMIC" }, "baseline": { "anyOf": [ { "$ref": "#/components/schemas/HealthMetricReading" }, { "type": "null" } ] }, "observation": { "anyOf": [ { "$ref": "#/components/schemas/HealthMetricReading" }, { "type": "null" } ] }, "status": { "type": "string", "enum": [ "COMPARABLE", "BASELINE_UNAVAILABLE", "OBSERVATION_UNAVAILABLE", "BOTH_UNAVAILABLE", "INCOMPATIBLE_UNITS", "INCOMPATIBLE_DEFINITION" ] }, "absoluteDelta": { "anyOf": [ { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$", "description": "Exact signed integer difference in quote atomic units." }, { "type": "null" } ] }, "relativeChange": { "anyOf": [ { "type": "object", "properties": { "numerator": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$", "description": "Exact signed integer difference in quote atomic units." }, "denominator": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$", "description": "Exact unsigned atomic amount; never coerce to a JavaScript number." } }, "required": [ "numerator", "denominator" ], "additionalProperties": false }, { "type": "null" } ] }, "relativeUnavailableReason": { "anyOf": [ { "type": "string", "enum": [ "ZERO_BASELINE", "NOT_COMPARABLE" ] }, { "type": "null" } ] } }, "required": [ "metric", "aggregation", "unit", "baseline", "observation", "status", "absoluteDelta", "relativeChange", "relativeUnavailableReason" ], "additionalProperties": false }, "HealthMarketQualityCheck": { "type": "object", "properties": { "evidenceId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "period": { "type": "string", "enum": [ "CONTEXT", "BASELINE", "OBSERVATION" ] }, "algorithm": { "const": "market-quality-score-v2" }, "arithmetic": { "type": "string", "enum": [ "REPRODUCED", "MISMATCH", "UNAVAILABLE" ] }, "sourceBindings": { "type": "string", "enum": [ "MATCHED", "MISMATCH", "INCOMPLETE" ] }, "rawMetrics": { "type": "string", "enum": [ "REPRODUCED", "MISMATCH", "UNAVAILABLE" ] }, "sourceEvidenceIds": { "type": "array", "items": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, "issues": { "type": "array", "items": { "type": "string" } }, "reproduced": { "anyOf": [ { "type": "object", "properties": { "availability": { "type": "string", "enum": [ "AVAILABLE", "UNAVAILABLE" ] }, "score": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 100 }, { "type": "null" } ] }, "coveragePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "components": { "type": "array", "items": { "type": "object", "properties": { "component": { "type": "string" }, "weightPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "score": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 100 }, { "type": "null" } ] } }, "required": [ "component", "weightPips", "score" ], "additionalProperties": false }, "maxItems": 16 } }, "required": [ "availability", "score", "coveragePips", "components" ], "additionalProperties": false }, { "type": "null" } ] }, "verificationScope": { "const": "DERIVED_SCORE_FIELDS_AND_CAPTURED_INPUTS" }, "signaturesAndQualification": { "const": "NOT_REVERIFIED" }, "fullInputHash": { "type": "string", "enum": [ "MATCHED", "MISMATCH", "NOT_RECOMPUTED" ] } }, "required": [ "evidenceId", "period", "algorithm", "arithmetic", "sourceBindings", "rawMetrics", "sourceEvidenceIds", "issues", "reproduced", "verificationScope", "signaturesAndQualification", "fullInputHash" ], "additionalProperties": false }, "HealthClaim": { "type": "object", "properties": { "claimId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "kind": { "type": "string", "enum": [ "RECORDED_FIELD", "CHECKED_COMPARISON", "CHECKED_MARKET_QUALITY" ] }, "label": { "type": "string" }, "verification": { "type": "string", "enum": [ "RECORDED_SOURCE_ONLY", "EXACT_ARITHMETIC", "REPRODUCED_FROM_CAPTURED_INPUTS" ] }, "receipts": { "type": "array", "items": { "$ref": "#/components/schemas/HealthFieldReceipt" } }, "comparison": { "$ref": "#/components/schemas/HealthMetricComparison" }, "marketQuality": { "$ref": "#/components/schemas/HealthMarketQualityCheck" } }, "required": [ "claimId", "kind", "label", "verification", "receipts" ], "additionalProperties": false }, "HealthCoverageGroup": { "type": "object", "properties": { "sourceType": { "type": "string", "enum": [ "VAULT", "POLICY", "FINALIZED_SNAPSHOT", "MARKET_QUALITY_SCORE", "VENUE_OBSERVATION", "EXECUTION_ATTRIBUTION", "ANOMALY", "INCIDENT", "PROPOSAL" ] }, "period": { "type": "string", "enum": [ "CONTEXT", "BASELINE", "OBSERVATION" ] }, "candidateCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "includedCount": { "type": "integer", "minimum": 0, "maximum": 200 } }, "required": [ "sourceType", "period", "candidateCount", "includedCount" ], "additionalProperties": false }, "ValidatedHealthReport": { "type": "object", "properties": { "schemaVersion": { "const": "agent-health-report-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "captureHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "sourceCutoff": { "type": "string", "format": "date-time" }, "capturedAt": { "type": "string", "format": "date-time" }, "window": { "type": "object", "properties": { "start": { "type": "string", "format": "date-time" }, "end": { "type": "string", "format": "date-time" } }, "required": [ "start", "end" ], "additionalProperties": false }, "baselineWindow": { "type": "object", "properties": { "start": { "type": "string", "format": "date-time" }, "end": { "type": "string", "format": "date-time" } }, "required": [ "start", "end" ], "additionalProperties": false }, "status": { "type": "string", "enum": [ "PARTIAL", "ABSTAINED" ] }, "marketHealth": { "const": "NOT_ASSESSED" }, "title": { "type": "string" }, "findings": { "type": "array", "items": { "$ref": "#/components/schemas/HealthClaim" }, "maxItems": 32 }, "comparisons": { "type": "array", "items": { "$ref": "#/components/schemas/HealthMetricComparison" }, "maxItems": 4 }, "marketQuality": { "type": "array", "items": { "$ref": "#/components/schemas/HealthMarketQualityCheck" }, "maxItems": 200 }, "hypotheses": { "type": "array", "items": { "type": "object", "properties": { "hypothesisId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "rank": { "type": "integer", "minimum": 1, "maximum": 6 }, "label": { "const": "UNVERIFIED_HYPOTHESIS" }, "explanation": { "type": "string", "minLength": 10, "maxLength": 1200 }, "supportingClaims": { "type": "array", "items": { "$ref": "#/components/schemas/HealthClaim" }, "maxItems": 8 }, "contradictingClaims": { "type": "array", "items": { "$ref": "#/components/schemas/HealthClaim" }, "maxItems": 8 }, "uncertainty": { "type": "string", "minLength": 10, "maxLength": 800 }, "warning": { "type": "string" } }, "required": [ "hypothesisId", "rank", "label", "explanation", "supportingClaims", "contradictingClaims", "uncertainty", "warning" ], "additionalProperties": false }, "maxItems": 6 }, "coverage": { "type": "array", "items": { "$ref": "#/components/schemas/HealthCoverageGroup" }, "maxItems": 16 }, "gaps": { "type": "array", "items": { "type": "string" } }, "nextChecks": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "REVIEW_POLICY", "REVIEW_ACTIVITY", "REVIEW_INCIDENTS", "CHECK_DATA_HEALTH", "EXPLORE_RESEARCH_DRAFT" ] }, "label": { "type": "string" }, "destination": { "type": "string", "enum": [ "POLICY", "ACTIVITY", "INCIDENTS", "DATA_HEALTH", "RESEARCH_SETUP" ] }, "execution": { "const": "MANUAL_NAVIGATION_ONLY" } }, "required": [ "kind", "label", "destination", "execution" ], "additionalProperties": false }, "maxItems": 5 }, "validation": { "type": "object", "properties": { "version": { "const": "health-report-validator-v1" }, "checkedClaimCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "recordedClaimCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "availableClaimCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "hypothesisSemanticsVerified": { "const": false } }, "required": [ "version", "checkedClaimCount", "recordedClaimCount", "availableClaimCount", "hypothesisSemanticsVerified" ], "additionalProperties": false } }, "required": [ "schemaVersion", "organizationId", "runId", "captureHash", "sourceCutoff", "capturedAt", "window", "baselineWindow", "status", "marketHealth", "title", "findings", "comparisons", "marketQuality", "hypotheses", "coverage", "gaps", "nextChecks", "validation" ], "additionalProperties": false }, "SavedHealthResult": { "type": "object", "properties": { "schemaVersion": { "const": "agent-health-result-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "reportId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resultVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "completedAt": { "type": "string", "format": "date-time" }, "report": { "$ref": "#/components/schemas/ValidatedHealthReport" }, "provenance": { "type": "object", "properties": { "workflowVersion": { "type": "string" }, "validatorVersion": { "const": "health-report-validator-v1" }, "provider": { "type": "string", "minLength": 1, "maxLength": 100 }, "model": { "type": "string", "minLength": 1, "maxLength": 160 }, "modelVersion": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "workflowVersion", "validatorVersion", "provider", "model", "modelVersion" ], "additionalProperties": false }, "applicability": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "SAME_SUBJECT_VERSION", "SUBJECT_CHANGED", "CURRENT_STATUS_UNAVAILABLE" ] }, "checkedAt": { "type": "string", "format": "date-time" }, "savedSubjectVersion": { "type": "string", "format": "date-time" }, "currentSubjectVersion": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "scope": { "const": "VAULT_RECORD_VERSION_ONLY" } }, "required": [ "status", "checkedAt", "savedSubjectVersion", "currentSubjectVersion", "scope" ], "additionalProperties": false } }, "required": [ "schemaVersion", "organizationId", "runId", "reportId", "resultVersion", "completedAt", "report", "provenance", "applicability" ], "additionalProperties": false }, "CapturedHealthEvidenceView": { "type": "object", "properties": { "schemaVersion": { "const": "agent-health-evidence-view-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "captureHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "evidence": { "type": "object", "properties": { "evidenceId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "source": { "$ref": "#/components/schemas/HealthEvidenceSource" }, "temporalScope": { "type": "string", "enum": [ "HISTORICAL", "CURRENT_CONTEXT" ] }, "observedAt": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "availableAt": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "capturedAt": { "type": "string", "format": "date-time" }, "sourceCutoff": { "type": "string", "format": "date-time" }, "quoteAssetId": { "anyOf": [ { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, { "type": "null" } ] }, "finality": { "type": "string", "enum": [ "FINALIZED", "NOT_APPLICABLE", "UNKNOWN" ] }, "unit": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 80 }, { "type": "null" } ] }, "coverage": { "type": "object", "properties": { "includedRecords": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "excludedRecords": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "truncated": { "type": "boolean" }, "gaps": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 500 }, "maxItems": 64 } }, "required": [ "includedRecords", "excludedRecords", "truncated", "gaps" ], "additionalProperties": false }, "sourceType": { "type": "string", "enum": [ "VAULT", "POLICY", "FINALIZED_SNAPSHOT", "MARKET_QUALITY_SCORE", "VENUE_OBSERVATION", "EXECUTION_ATTRIBUTION", "ANOMALY", "INCIDENT", "PROPOSAL" ] }, "period": { "type": "string", "enum": [ "CONTEXT", "BASELINE", "OBSERVATION" ] }, "fields": { "type": "array", "items": { "type": "object", "properties": { "field": { "type": "string" }, "value": { "anyOf": [ { "oneOf": [ { "type": "string" }, { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "boolean" } ] }, { "type": "null" } ] } }, "required": [ "field", "value" ], "additionalProperties": false }, "maxItems": 2048 }, "verification": { "const": "RECORDED_SOURCE_ASSERTIONS" } }, "required": [ "evidenceId", "source", "temporalScope", "observedAt", "availableAt", "capturedAt", "sourceCutoff", "quoteAssetId", "finality", "unit", "coverage", "sourceType", "period", "fields", "verification" ], "additionalProperties": false } }, "required": [ "schemaVersion", "organizationId", "runId", "captureHash", "evidence" ], "additionalProperties": false }, "ProjectHealthFinding": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^finding-[a-z0-9-]+$" }, "summary": { "type": "string", "maxLength": 2000 }, "evidenceSequences": { "type": "array", "minItems": 1, "maxItems": 2, "uniqueItems": true, "items": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" } }, "measurement": { "anyOf": [ { "type": "object", "properties": { "asset": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "decimals": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 36 }, { "type": "null" } ] }, "baselineAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$", "maxLength": 34 }, "observationAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$", "maxLength": 34 }, "changeAtomic": { "type": "string", "pattern": "^(0|-?[1-9][0-9]*)$", "maxLength": 35 } }, "required": [ "asset", "decimals", "baselineAtomic", "observationAtomic", "changeAtomic" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "id", "summary", "evidenceSequences", "measurement" ], "additionalProperties": false }, "ProjectHealthReport": { "type": "object", "properties": { "schemaVersion": { "const": "agent-project-health-report-v1" }, "classification": { "const": "PUBLIC_MARKET" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "projectId": { "type": "string", "pattern": "^project_[0-9a-f]{32}$" }, "captureHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "sourceCutoff": { "type": "string", "format": "date-time" }, "status": { "type": "string", "enum": [ "PARTIAL", "ABSTAINED" ] }, "marketHealth": { "const": "NOT_ASSESSED" }, "findings": { "type": "array", "maxItems": 12, "items": { "$ref": "#/components/schemas/ProjectHealthFinding" } }, "gaps": { "type": "array", "maxItems": 24, "uniqueItems": true, "items": { "type": "string", "maxLength": 120 } }, "nextChecks": { "type": "array", "maxItems": 4, "uniqueItems": true, "items": { "type": "string", "enum": [ "REFRESH_PUBLIC_OBSERVATION", "VERIFY_TRANSFER_BEHAVIOR", "VERIFY_LIQUIDITY_CONTROL", "COLLECT_BASELINE_OBSERVATION" ] } }, "evidence": { "type": "array", "minItems": 1, "maxItems": 2, "items": { "$ref": "#/components/schemas/SavedProjectObservation" } }, "financialAuthority": { "const": false } }, "required": [ "schemaVersion", "classification", "organizationId", "runId", "projectId", "captureHash", "sourceCutoff", "status", "marketHealth", "findings", "gaps", "nextChecks", "evidence", "financialAuthority" ], "additionalProperties": false }, "SavedProjectHealthResult": { "type": "object", "properties": { "schemaVersion": { "const": "saved-project-health-result-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resultVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "completedAt": { "type": "string", "format": "date-time" }, "report": { "$ref": "#/components/schemas/ProjectHealthReport" }, "applicability": { "type": "object", "properties": { "scope": { "const": "PROJECT_OBSERVATION_VERSION_ONLY" }, "status": { "type": "string", "enum": [ "SAME_SUBJECT_VERSION", "SUBJECT_CHANGED", "SUBJECT_UNAVAILABLE" ] }, "savedResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "currentResourceVersion": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] } }, "required": [ "scope", "status", "savedResourceVersion", "currentResourceVersion" ], "additionalProperties": false } }, "required": [ "schemaVersion", "organizationId", "runId", "resultVersion", "completedAt", "report", "applicability" ], "additionalProperties": false }, "AgentHealthResult": { "oneOf": [ { "$ref": "#/components/schemas/SavedHealthResult" }, { "$ref": "#/components/schemas/SavedProjectHealthResult" } ] }, "ProposalReviewSource": { "type": "object", "properties": { "generation": { "type": "string", "enum": [ "V1", "V2" ] }, "recordType": { "type": "string", "enum": [ "PROPOSAL", "PROPOSAL_WORKSPACE" ] }, "recordId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "version": { "type": "string", "maxLength": 100, "minLength": 1 }, "artifactHash": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] }, "economicHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "generation", "recordType", "recordId", "version", "artifactHash", "economicHash" ], "additionalProperties": false }, "ProposalReviewDependency": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "SIMULATION", "SIMULATION_STUDY", "STRATEGY_DEFINITION", "STRATEGY_ADMISSION", "POLICY_INTENT_DRAFT" ] }, "recordId": { "anyOf": [ { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, { "type": "null" } ] }, "resourceVersion": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] }, "artifactHash": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] }, "status": { "type": "string", "enum": [ "AVAILABLE", "UNAVAILABLE", "BINDING_MISMATCH" ] }, "recordedStatus": { "anyOf": [ { "type": "string", "maxLength": 100 }, { "type": "null" } ] } }, "required": [ "kind", "recordId", "resourceVersion", "artifactHash", "status", "recordedStatus" ], "additionalProperties": false }, "ProposalReviewTokenFlow": { "type": "object", "properties": { "token": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "amountAtomic": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$", "description": "Exact atomic amount; never coerce to a floating-point number." }, "destination": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "basis": { "const": "PERSISTED_FLOW_NOT_EXECUTION_VERIFIED" } }, "required": [ "token", "amountAtomic", "destination", "basis" ], "additionalProperties": false }, "ProposalReviewFinding": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^finding-[a-z0-9-]+$" }, "summary": { "type": "string", "maxLength": 1200 }, "evidenceIds": { "type": "array", "items": { "type": "string", "maxLength": 160 }, "maxItems": 8 } }, "required": [ "id", "summary", "evidenceIds" ], "additionalProperties": false }, "ProposalReviewCheck": { "type": "object", "properties": { "id": { "type": "string", "maxLength": 100 }, "status": { "type": "string", "enum": [ "RECORDED_PASS", "RECORDED_FAIL", "UNAVAILABLE", "NOT_APPLICABLE" ] }, "detail": { "type": "string", "maxLength": 1200 } }, "required": [ "id", "status", "detail" ], "additionalProperties": false }, "ProposalReviewReport": { "type": "object", "properties": { "schemaVersion": { "const": "agent-proposal-review-report-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "reviewScope": { "const": "SAVED_PROPOSAL_EVIDENCE" }, "status": { "type": "string", "enum": [ "PARTIAL", "ABSTAINED" ] }, "reviewedAt": { "type": "string", "format": "date-time" }, "sourceCutoff": { "type": "string", "format": "date-time" }, "captureHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "reviewedProposal": { "$ref": "#/components/schemas/ProposalReviewSource" }, "findings": { "type": "array", "items": { "$ref": "#/components/schemas/ProposalReviewFinding" }, "maxItems": 24 }, "checks": { "type": "array", "items": { "$ref": "#/components/schemas/ProposalReviewCheck" }, "maxItems": 20 }, "metrics": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "maxLength": 100 }, "valueAtomic": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$", "description": "Exact atomic amount; never coerce to a floating-point number." }, "quoteProfile": { "anyOf": [ { "type": "string", "maxLength": 100 }, { "type": "null" } ] }, "unit": { "const": "QUOTE_ATOMIC" }, "basis": { "type": "string", "enum": [ "PERSISTED_ASSERTION", "EXACT_DIFFERENCE_OF_ASSERTIONS" ] } }, "required": [ "id", "valueAtomic", "quoteProfile", "unit", "basis" ], "additionalProperties": false }, "maxItems": 10 }, "costs": { "type": "array", "items": { "type": "object", "properties": { "category": { "type": "string", "enum": [ "GAS", "INCENTIVE", "PLATFORM_FEE", "CAPITAL_LOSS", "VENUE_FEE", "SLIPPAGE" ] }, "status": { "type": "string", "enum": [ "DECLARED_ASSUMPTION", "UNAVAILABLE" ] }, "amountAtomic": { "anyOf": [ { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$", "description": "Exact atomic amount; never coerce to a floating-point number." }, { "type": "null" } ] }, "reason": { "type": "string", "maxLength": 1200 } }, "required": [ "category", "status", "amountAtomic", "reason" ], "additionalProperties": false }, "maxItems": 6, "minItems": 6 }, "tokenFlows": { "type": "array", "items": { "$ref": "#/components/schemas/ProposalReviewTokenFlow" }, "maxItems": 64 }, "dependencies": { "type": "array", "items": { "$ref": "#/components/schemas/ProposalReviewDependency" }, "maxItems": 5 }, "gaps": { "type": "array", "items": { "type": "string", "maxLength": 120 }, "maxItems": 32 }, "nextChecks": { "type": "array", "items": { "type": "string", "enum": [ "INSPECT_REFERENCED_EVIDENCE", "VERIFY_COMPLETE_COSTS", "REFRESH_PROPOSAL", "RECHECK_POLICY_AND_EXPIRY", "USE_EXISTING_HUMAN_APPROVAL_WORKFLOW" ] }, "maxItems": 5 }, "approvalAuthorityGranted": { "const": false }, "executionAuthorityGranted": { "const": false } }, "required": [ "schemaVersion", "organizationId", "runId", "reviewScope", "status", "reviewedAt", "sourceCutoff", "captureHash", "reviewedProposal", "findings", "checks", "metrics", "costs", "tokenFlows", "dependencies", "gaps", "nextChecks", "approvalAuthorityGranted", "executionAuthorityGranted" ], "additionalProperties": false }, "SavedProposalReviewResult": { "type": "object", "properties": { "schemaVersion": { "const": "saved-proposal-review-result-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resultVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "completedAt": { "type": "string", "format": "date-time" }, "report": { "$ref": "#/components/schemas/ProposalReviewReport" }, "applicability": { "type": "object", "properties": { "scope": { "const": "PROPOSAL_PACKET_AND_REFERENCED_GENERATIONS" }, "status": { "type": "string", "enum": [ "SAME_ECONOMIC_PACKET", "OPERATIONAL_STATUS_CHANGED", "ECONOMIC_PACKET_CHANGED", "SUBJECT_UNAVAILABLE" ] }, "checkedAt": { "type": "string", "format": "date-time" }, "currentSourceVersion": { "anyOf": [ { "type": "string", "maxLength": 100, "minLength": 1 }, { "type": "null" } ] }, "currentEconomicHash": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] }, "expired": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "dependenciesChanged": { "type": "boolean" } }, "required": [ "scope", "status", "checkedAt", "currentSourceVersion", "currentEconomicHash", "expired", "dependenciesChanged" ], "additionalProperties": false } }, "required": [ "schemaVersion", "organizationId", "runId", "resultVersion", "completedAt", "report", "applicability" ], "additionalProperties": false }, "CandidateReviewReport": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "agent-candidate-review-report-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "reviewScope": { "type": "string", "const": "RESEARCH_CANDIDATE_EVIDENCE" }, "status": { "type": "string", "const": "PARTIAL" }, "captureHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "reviewedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "reviewedCandidate": { "type": "object", "properties": { "packId": { "type": "string", "pattern": "^decisionpack_[a-f0-9]{32}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "contentHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "packId", "resourceVersion", "contentHash" ], "additionalProperties": false }, "checks": { "maxItems": 16, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "maxLength": 100 }, "status": { "type": "string", "enum": [ "RECORDED_PASS", "RECORDED_FAIL", "UNAVAILABLE" ] }, "detail": { "type": "string", "maxLength": 1200 } }, "required": [ "id", "status", "detail" ], "additionalProperties": false } }, "findings": { "maxItems": 24, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^finding-[a-z0-9-]+$" }, "summary": { "type": "string", "maxLength": 1200 }, "evidenceIds": { "maxItems": 8, "type": "array", "items": { "type": "string", "maxLength": 160 } } }, "required": [ "id", "summary", "evidenceIds" ], "additionalProperties": false } }, "trialReferences": { "minItems": 1, "maxItems": 4, "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "const": "RESEARCH_TRIAL" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "protocolHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "trialKey": { "type": "string", "enum": [ "baseline", "alternative-1", "alternative-2", "alternative-3" ] }, "inputHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "artifactHash": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] }, "state": { "type": "string", "enum": [ "QUEUED", "RUNNING", "COMPLETED", "FAILED", "CANCELLED" ] }, "recordedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, { "type": "null" } ] }, "failureCode": { "anyOf": [ { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{2,119}$" }, { "type": "null" } ] } }, "required": [ "kind", "runId", "protocolHash", "trialKey", "inputHash", "artifactHash", "state", "recordedAt", "failureCode" ], "additionalProperties": false } }, "costs": { "minItems": 6, "maxItems": 6, "type": "array", "items": { "type": "object", "properties": { "category": { "type": "string", "enum": [ "GAS", "INCENTIVE", "PLATFORM_FEE", "CAPITAL_LOSS", "VENUE_FEE", "SLIPPAGE" ] }, "status": { "type": "string", "const": "UNAVAILABLE" }, "amountAtomic": { "type": "null" }, "reason": { "type": "string", "maxLength": 1200 } }, "required": [ "category", "status", "amountAtomic", "reason" ], "additionalProperties": false } }, "gaps": { "maxItems": 24, "type": "array", "items": { "type": "string", "maxLength": 120 } }, "nextChecks": { "maxItems": 5, "type": "array", "items": { "type": "string", "enum": [ "INSPECT_RESEARCH_TRIALS", "RESOLVE_MISSING_SCENARIOS", "VERIFY_PROJECT_AND_QUOTE_BINDING", "PREPARE_OPERATIONAL_PREREQUISITES", "USE_SEPARATE_HUMAN_APPROVAL" ] } }, "approvalAuthorityGranted": { "type": "boolean", "const": false }, "executionAuthorityGranted": { "type": "boolean", "const": false }, "publicationAuthorityGranted": { "type": "boolean", "const": false } }, "required": [ "schemaVersion", "organizationId", "runId", "reviewScope", "status", "captureHash", "sourceCutoff", "reviewedAt", "reviewedCandidate", "checks", "findings", "trialReferences", "costs", "gaps", "nextChecks", "approvalAuthorityGranted", "executionAuthorityGranted", "publicationAuthorityGranted" ], "additionalProperties": false }, "SavedCandidateReviewResult": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "saved-candidate-review-result-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resultVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "completedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "report": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "agent-candidate-review-report-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "reviewScope": { "type": "string", "const": "RESEARCH_CANDIDATE_EVIDENCE" }, "status": { "type": "string", "const": "PARTIAL" }, "captureHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "reviewedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "reviewedCandidate": { "type": "object", "properties": { "packId": { "type": "string", "pattern": "^decisionpack_[a-f0-9]{32}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "contentHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "packId", "resourceVersion", "contentHash" ], "additionalProperties": false }, "checks": { "maxItems": 16, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "maxLength": 100 }, "status": { "type": "string", "enum": [ "RECORDED_PASS", "RECORDED_FAIL", "UNAVAILABLE" ] }, "detail": { "type": "string", "maxLength": 1200 } }, "required": [ "id", "status", "detail" ], "additionalProperties": false } }, "findings": { "maxItems": 24, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^finding-[a-z0-9-]+$" }, "summary": { "type": "string", "maxLength": 1200 }, "evidenceIds": { "maxItems": 8, "type": "array", "items": { "type": "string", "maxLength": 160 } } }, "required": [ "id", "summary", "evidenceIds" ], "additionalProperties": false } }, "trialReferences": { "minItems": 1, "maxItems": 4, "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "const": "RESEARCH_TRIAL" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "protocolHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "trialKey": { "type": "string", "enum": [ "baseline", "alternative-1", "alternative-2", "alternative-3" ] }, "inputHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "artifactHash": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] }, "state": { "type": "string", "enum": [ "QUEUED", "RUNNING", "COMPLETED", "FAILED", "CANCELLED" ] }, "recordedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, { "type": "null" } ] }, "failureCode": { "anyOf": [ { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{2,119}$" }, { "type": "null" } ] } }, "required": [ "kind", "runId", "protocolHash", "trialKey", "inputHash", "artifactHash", "state", "recordedAt", "failureCode" ], "additionalProperties": false } }, "costs": { "minItems": 6, "maxItems": 6, "type": "array", "items": { "type": "object", "properties": { "category": { "type": "string", "enum": [ "GAS", "INCENTIVE", "PLATFORM_FEE", "CAPITAL_LOSS", "VENUE_FEE", "SLIPPAGE" ] }, "status": { "type": "string", "const": "UNAVAILABLE" }, "amountAtomic": { "type": "null" }, "reason": { "type": "string", "maxLength": 1200 } }, "required": [ "category", "status", "amountAtomic", "reason" ], "additionalProperties": false } }, "gaps": { "maxItems": 24, "type": "array", "items": { "type": "string", "maxLength": 120 } }, "nextChecks": { "maxItems": 5, "type": "array", "items": { "type": "string", "enum": [ "INSPECT_RESEARCH_TRIALS", "RESOLVE_MISSING_SCENARIOS", "VERIFY_PROJECT_AND_QUOTE_BINDING", "PREPARE_OPERATIONAL_PREREQUISITES", "USE_SEPARATE_HUMAN_APPROVAL" ] } }, "approvalAuthorityGranted": { "type": "boolean", "const": false }, "executionAuthorityGranted": { "type": "boolean", "const": false }, "publicationAuthorityGranted": { "type": "boolean", "const": false } }, "required": [ "schemaVersion", "organizationId", "runId", "reviewScope", "status", "captureHash", "sourceCutoff", "reviewedAt", "reviewedCandidate", "checks", "findings", "trialReferences", "costs", "gaps", "nextChecks", "approvalAuthorityGranted", "executionAuthorityGranted", "publicationAuthorityGranted" ], "additionalProperties": false }, "applicability": { "type": "object", "properties": { "scope": { "type": "string", "const": "CANDIDATE_CONTENT_AND_REFERENCED_GENERATIONS" }, "status": { "type": "string", "enum": [ "SAME_CONTENT", "LIFECYCLE_CHANGED", "CONTENT_CHANGED", "SUBJECT_UNAVAILABLE" ] }, "checkedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "currentPackResourceVersion": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] }, "currentContentHash": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] }, "currentIssuerIntentResourceVersion": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] }, "currentProjectResourceVersion": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] }, "issuerIntentChanged": { "type": "boolean" }, "projectObservationChanged": { "type": "boolean" } }, "required": [ "scope", "status", "checkedAt", "currentPackResourceVersion", "currentContentHash", "currentIssuerIntentResourceVersion", "currentProjectResourceVersion", "issuerIntentChanged", "projectObservationChanged" ], "additionalProperties": false } }, "required": [ "schemaVersion", "organizationId", "runId", "resultVersion", "completedAt", "report", "applicability" ], "additionalProperties": false }, "AgentRunResult": { "oneOf": [ { "$ref": "#/components/schemas/AgentHealthResult" }, { "$ref": "#/components/schemas/SavedProposalReviewResult" }, { "$ref": "#/components/schemas/SavedResearchResult" }, { "$ref": "#/components/schemas/SavedCandidateReviewResult" } ] }, "AgentRunSummary": { "type": "object", "properties": { "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "kind": { "type": "string", "enum": [ "HEALTH_INVESTIGATION", "PROPOSAL_REVIEW", "WHAT_IF_RESEARCH" ] }, "mode": { "type": "string", "const": "PLAN" }, "question": { "type": "string", "minLength": 3, "maxLength": 2000 }, "state": { "type": "string", "enum": [ "QUEUED", "RUNNING", "WAITING_FOR_INPUT", "WAITING_FOR_CHILDREN", "COMPLETED", "PARTIAL", "ABSTAINED", "FAILED", "CANCELLED" ] }, "phase": { "type": "string", "enum": [ "ADMITTED", "CAPTURING_EVIDENCE", "CHECKING_SOURCES", "COMPARING_EVIDENCE", "PLANNING", "READING_EVIDENCE", "WAITING_FOR_INPUT", "WAITING_FOR_STUDIES", "VALIDATING_REPORT", "FINISHED" ] }, "sourceCutoff": { "type": "string", "format": "date-time" }, "deadline": { "type": "string", "format": "date-time" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "cancellationRequestedAt": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "subject": { "type": "object", "properties": { "generation": { "type": "string", "enum": [ "V1", "V2", "PROJECT", "DECISION_PACK" ] }, "recordType": { "type": "string", "enum": [ "VAULT", "PROPOSAL", "PROPOSAL_WORKSPACE", "ISSUER_INTENT", "SAVED_PUBLIC_PROJECT", "DECISION_PACK" ] }, "recordId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "vaultId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "updatedAt": { "type": "string", "format": "date-time" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "observationSequence": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" }, "baselineSequence": { "anyOf": [ { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" }, { "type": "null" } ] }, "window": { "type": "object", "properties": { "start": { "type": "string", "format": "date-time" }, "end": { "type": "string", "format": "date-time" } }, "required": [ "start", "end" ], "additionalProperties": false }, "baselineWindow": { "type": "object", "properties": { "start": { "type": "string", "format": "date-time" }, "end": { "type": "string", "format": "date-time" } }, "required": [ "start", "end" ], "additionalProperties": false } }, "required": [ "generation", "recordType", "recordId" ], "additionalProperties": false } }, "required": [ "organizationId", "runId", "kind", "question", "state", "phase", "sourceCutoff", "deadline", "createdAt", "updatedAt", "resourceVersion", "cancellationRequestedAt", "subject" ], "additionalProperties": false }, "AgentClarification": { "type": "object", "properties": { "schemaVersion": { "const": "agent-clarification-v1" }, "questionId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "prompt": { "type": "string", "minLength": 3, "maxLength": 2000 }, "contextHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "options": { "type": "array", "minItems": 2, "maxItems": 6, "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "label": { "type": "string", "minLength": 1, "maxLength": 160 }, "description": { "type": "string", "minLength": 1, "maxLength": 1000 } }, "required": [ "id", "label", "description" ], "additionalProperties": false } } }, "required": [ "schemaVersion", "questionId", "prompt", "contextHash", "options" ], "additionalProperties": false }, "AgentRunLimits": { "type": "object", "properties": { "maximumToolExecutions": { "type": "integer", "minimum": 1, "maximum": 10 }, "maximumOptionalToolCalls": { "type": "integer", "minimum": 0, "maximum": 6 }, "maximumModelAttempts": { "type": "integer", "minimum": 1, "maximum": 4 }, "maximumEvidenceRecords": { "type": "integer", "minimum": 1, "maximum": 200 }, "maximumEvidenceBytesPerRequest": { "type": "integer", "minimum": 1, "maximum": 131072 }, "maximumTokens": { "type": "integer", "minimum": 1, "maximum": 1000000 }, "maximumCostMicrounits": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" }, "costCurrency": { "const": "USD" }, "maximumResearchTrials": { "type": "integer", "minimum": 0, "maximum": 4 }, "maximumComputeUnits": { "type": "integer", "minimum": 0, "maximum": 14600000 } }, "required": [ "maximumToolExecutions", "maximumOptionalToolCalls", "maximumModelAttempts", "maximumEvidenceRecords", "maximumEvidenceBytesPerRequest", "maximumTokens", "maximumCostMicrounits", "costCurrency", "maximumResearchTrials", "maximumComputeUnits" ], "additionalProperties": false }, "AgentRunDetail": { "type": "object", "properties": { "run": { "$ref": "#/components/schemas/AgentRunSummary" }, "pendingQuestion": { "anyOf": [ { "$ref": "#/components/schemas/AgentClarification" }, { "type": "null" } ] }, "steps": { "type": "object", "properties": { "queued": { "type": "integer", "minimum": 0 }, "running": { "type": "integer", "minimum": 0 }, "completed": { "type": "integer", "minimum": 0 }, "failed": { "type": "integer", "minimum": 0 }, "uncertain": { "type": "integer", "minimum": 0 } }, "required": [ "queued", "running", "completed", "failed", "uncertain" ], "additionalProperties": false }, "activityHighWater": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,18})$", "description": "Exact decimal sequence; do not coerce to a JavaScript number." }, "limits": { "$ref": "#/components/schemas/AgentRunLimits" }, "usage": { "type": "null", "description": "Provider usage is not available until attempt settlement is connected; this does not mean zero usage." }, "resultAvailable": { "type": "boolean", "description": "True only when the specialized saved result transport is configured and a supported Health or Proposal Review run has terminal PARTIAL or ABSTAINED status, or a Research run has terminal COMPLETED, PARTIAL or ABSTAINED status with a persisted result. Reading revalidates the saved report; availability is not an economic assurance." }, "controls": { "type": "object", "properties": { "canCancel": { "type": "boolean" }, "canRespond": { "type": "boolean" } }, "required": [ "canCancel", "canRespond" ], "additionalProperties": false } }, "required": [ "run", "pendingQuestion", "steps", "activityHighWater", "limits", "usage", "resultAvailable", "controls" ], "additionalProperties": false }, "AgentRunList": { "type": "object", "properties": { "runs": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/AgentRunSummary" } }, "nextCursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "runs", "nextCursor" ], "additionalProperties": false }, "AgentActivityEvent": { "type": "object", "properties": { "sequence": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,18})$", "description": "Exact decimal sequence; do not coerce to a JavaScript number." }, "kind": { "type": "string", "enum": [ "RUN_STATE", "STEP_STATE" ] }, "state": { "type": "string", "enum": [ "QUEUED", "RUNNING", "WAITING_FOR_INPUT", "WAITING_FOR_CHILDREN", "COMPLETED", "PARTIAL", "ABSTAINED", "FAILED", "CANCELLED" ] }, "phase": { "type": "string", "enum": [ "ADMITTED", "CAPTURING_EVIDENCE", "CHECKING_SOURCES", "COMPARING_EVIDENCE", "PLANNING", "READING_EVIDENCE", "WAITING_FOR_INPUT", "WAITING_FOR_STUDIES", "VALIDATING_REPORT", "FINISHED" ] }, "stepSequence": { "anyOf": [ { "type": "integer", "minimum": 1 }, { "type": "null" } ] }, "stepKind": { "anyOf": [ { "type": "string", "enum": [ "SOURCE_CAPTURE", "DETERMINISTIC_CHECK", "TOOL_READ", "MODEL_CALL", "CLARIFICATION", "RESEARCH_DISPATCH", "RESEARCH_RESUME", "REPORT_VALIDATION" ] }, { "type": "null" } ] }, "stepState": { "anyOf": [ { "type": "string", "enum": [ "QUEUED", "RUNNING", "COMPLETED", "FAILED", "UNCERTAIN" ] }, { "type": "null" } ] }, "occurredAt": { "type": "string", "format": "date-time" } }, "required": [ "sequence", "kind", "state", "phase", "stepSequence", "stepKind", "stepState", "occurredAt" ], "additionalProperties": false }, "AgentActivityPage": { "type": "object", "properties": { "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "events": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/AgentActivityEvent" } }, "nextAfter": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,18})$", "description": "Exact decimal sequence; do not coerce to a JavaScript number." }, "hasMore": { "type": "boolean" }, "highWater": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,18})$", "description": "Exact decimal sequence; do not coerce to a JavaScript number." } }, "required": [ "organizationId", "runId", "events", "nextAfter", "hasMore", "highWater" ], "additionalProperties": false }, "PublicProjectResolveRequest": { "type": "object", "properties": { "identifier": { "type": "string", "minLength": 1, "maxLength": 512, "description": "Supported Virtuals project URL or token address. Only the supported identifier forms are resolved; arbitrary URLs are rejected. The full JSON body is limited to 2 KiB." } }, "required": [ "identifier" ], "additionalProperties": false }, "PublicProjectAnalysis": { "type": "object", "properties": { "schemaVersion": { "const": "public-project-analysis-v1" }, "chainId": { "const": 8453 }, "identifier": { "type": "string", "maxLength": 512 }, "token": { "anyOf": [ { "type": "object", "properties": { "address": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "name": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 120 }, { "type": "null" } ] }, "symbol": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 120 }, { "type": "null" } ] }, "decimals": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 36 }, { "type": "null" } ] } }, "required": [ "address", "name", "symbol", "decimals" ], "additionalProperties": false }, { "type": "null" } ] }, "project": { "type": "object", "properties": { "virtualsProjectId": { "anyOf": [ { "type": "string", "pattern": "^[1-9][0-9]{0,19}$" }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string", "format": "uri", "maxLength": 512 }, { "type": "null" } ] }, "relationship": { "const": "PUBLIC_IDENTIFIER_ONLY" } }, "required": [ "virtualsProjectId", "url", "relationship" ], "additionalProperties": false }, "launchStage": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "UNKNOWN", "POOL_OBSERVED" ] }, "explanation": { "type": "string", "maxLength": 1000 } }, "required": [ "status", "explanation" ], "additionalProperties": false }, "observation": { "anyOf": [ { "type": "object", "properties": { "blockNumber": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$", "maxLength": 78 }, "blockHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "blockTimestamp": { "type": "string", "format": "date-time" }, "observedAt": { "type": "string", "format": "date-time", "description": "Read time, equal to readAt; not a durable recorded observation time." }, "readAt": { "type": "string", "format": "date-time" }, "recordedAt": { "type": "null" }, "providerId": { "type": "string", "pattern": "^[a-zA-Z0-9:_-]{1,120}$" }, "providerGeneration": { "type": "string", "pattern": "^[a-zA-Z0-9:_-]{1,120}$" }, "finality": { "const": "FINALIZED" }, "finalityVerification": { "const": "SINGLE_RPC_ASSERTION" } }, "required": [ "blockNumber", "blockHash", "blockTimestamp", "observedAt", "readAt", "recordedAt", "providerId", "providerGeneration", "finality", "finalityVerification" ], "additionalProperties": false }, { "type": "null" } ] }, "pools": { "type": "array", "maxItems": 1, "items": { "type": "object", "properties": { "address": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "factory": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "token0": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "token1": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "reserve0Atomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,33})$", "description": "Exact unsigned uint112 reserve in native atomic units. Never coerce to a JavaScript number or assume decimal metadata is available." }, "reserve1Atomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,33})$", "description": "Exact unsigned uint112 reserve in native atomic units. Never coerce to a JavaScript number or assume decimal metadata is available." }, "reserve0Decimals": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 36 }, { "type": "null" } ] }, "reserve1Decimals": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 36 }, { "type": "null" } ] }, "verification": { "const": "CANONICAL_FACTORY_AND_PAIR_AT_BLOCK" }, "quoteStatus": { "const": "UNAVAILABLE_TRANSFER_BEHAVIOR" } }, "required": [ "address", "factory", "token0", "token1", "reserve0Atomic", "reserve1Atomic", "reserve0Decimals", "reserve1Decimals", "verification", "quoteStatus" ], "additionalProperties": false } }, "gaps": { "type": "array", "maxItems": 20, "items": { "type": "string", "maxLength": 120 } }, "financialAuthority": { "const": false } }, "required": [ "schemaVersion", "chainId", "identifier", "token", "project", "launchStage", "observation", "pools", "gaps", "financialAuthority" ], "additionalProperties": false }, "PublicLiquidityInvestigationRequest": { "type": "object", "properties": { "identifier": { "type": "string", "minLength": 1, "maxLength": 512, "description": "Supported Virtuals project URL or token address, as in public project resolution. The complete JSON body is limited to 2 KiB." }, "question": { "const": "POOL_RESERVE_SCALE_V1" }, "quoteTradeSizeAtomic": { "anyOf": [ { "type": "string", "pattern": "^[1-9][0-9]{0,77}$", "maxLength": 78, "description": "Canonical positive decimal uint256 in native atomic units. The server also checks the exact uint256 maximum without number coercion." }, { "type": "null" } ] } }, "required": [ "identifier", "question", "quoteTradeSizeAtomic" ], "additionalProperties": false }, "PublicLiquidityInvestigation": { "type": "object", "properties": { "schemaVersion": { "const": "public-liquidity-investigation-v1" }, "question": { "const": "POOL_RESERVE_SCALE_V1" }, "investigationId": { "type": "string", "pattern": "^0x[0-9a-f]{64}$", "description": "Deterministic identifier for this public-source investigation; not a saved tenant record." }, "requestedQuoteSizeAtomic": { "anyOf": [ { "type": "string", "pattern": "^[1-9][0-9]{0,77}$", "maxLength": 78, "description": "Canonical positive decimal uint256 in native atomic units. The server also checks the exact uint256 maximum without number coercion." }, { "type": "null" } ] }, "source": { "$ref": "#/components/schemas/PublicProjectAnalysis" }, "finding": { "type": "object", "properties": { "state": { "type": "string", "enum": [ "AVAILABLE", "UNAVAILABLE" ] }, "poolAddress": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, { "type": "null" } ] }, "quoteReserveAtomic": { "anyOf": [ { "type": "string", "pattern": "^(0|[1-9][0-9]{0,33})$", "description": "Exact verified VIRTUAL-side reserve in native atomic units; null if not established." }, { "type": "null" } ] }, "quoteDecimals": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 36 }, { "type": "null" } ] }, "sizeToReservePips": { "anyOf": [ { "type": "string", "pattern": "^(0|[1-9][0-9]*)$", "maxLength": 84, "description": "Integer floor(requested quote size atomic × 1,000,000 / positive verified quote reserve atomic). Reserve-scale context only, never an executable quote or slippage estimate." }, { "type": "null" } ] }, "reason": { "type": "string", "enum": [ "NO_QUOTE_SIZE", "NO_VERIFIED_POOL", "QUOTE_PRECISION_UNAVAILABLE", "ZERO_QUOTE_RESERVE", "SOURCE_INCONSISTENT", "VERIFIED_RESERVE_RATIO_ONLY" ] } }, "required": [ "state", "poolAddress", "quoteReserveAtomic", "quoteDecimals", "sizeToReservePips", "reason" ], "additionalProperties": false }, "limitations": { "type": "array", "minItems": 1, "maxItems": 20, "items": { "type": "string", "minLength": 1, "maxLength": 500 } }, "financialAuthority": { "const": false } }, "required": [ "schemaVersion", "question", "investigationId", "requestedQuoteSizeAtomic", "source", "finding", "limitations", "financialAuthority" ], "additionalProperties": false }, "SavedProjectObservation": { "type": "object", "properties": { "sequence": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$", "description": "Exact immutable observation sequence; do not coerce to a JavaScript number." }, "recordedAt": { "type": "string", "format": "date-time" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "analysis": { "$ref": "#/components/schemas/PublicProjectAnalysis" } }, "required": [ "sequence", "recordedAt", "resourceVersion", "analysis" ], "additionalProperties": false }, "SavedProjectObservationMetadata": { "type": "object", "properties": { "sequence": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$", "description": "Exact immutable observation sequence; do not coerce to a JavaScript number." }, "recordedAt": { "type": "string", "format": "date-time" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "sequence", "recordedAt", "resourceVersion" ], "additionalProperties": false }, "SavedPublicProject": { "type": "object", "properties": { "organizationId": { "type": "string", "minLength": 1, "maxLength": 160 }, "projectId": { "type": "string", "pattern": "^project_[0-9a-f]{32}$" }, "identifier": { "type": "string", "maxLength": 512 }, "tokenAddress": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, { "type": "null" } ] }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "currentSequence": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$", "description": "Exact immutable observation sequence; do not coerce to a JavaScript number." }, "latestObservation": { "$ref": "#/components/schemas/SavedProjectObservation" } }, "required": [ "organizationId", "projectId", "identifier", "tokenAddress", "createdAt", "updatedAt", "resourceVersion", "currentSequence", "latestObservation" ], "additionalProperties": false }, "SavedProjectWriteReceipt": { "type": "object", "properties": { "project": { "$ref": "#/components/schemas/SavedPublicProject" }, "replayed": { "type": "boolean" } }, "required": [ "project", "replayed" ], "additionalProperties": false }, "SavedProjectList": { "type": "object", "properties": { "projects": { "type": "array", "maxItems": 20, "items": { "$ref": "#/components/schemas/SavedPublicProject" } }, "nextCursor": { "anyOf": [ { "type": "string", "pattern": "^project_[0-9a-f]{32}$" }, { "type": "null" } ] } }, "required": [ "projects", "nextCursor" ], "additionalProperties": false }, "SavedProjectObservationList": { "type": "object", "properties": { "observations": { "type": "array", "maxItems": 20, "items": { "$ref": "#/components/schemas/SavedProjectObservationMetadata" } }, "nextCursor": { "anyOf": [ { "type": "string", "pattern": "^[1-9][0-9]{0,17}$", "description": "Exact immutable observation sequence; do not coerce to a JavaScript number." }, { "type": "null" } ] } }, "required": [ "observations", "nextCursor" ], "additionalProperties": false }, "WorkspacePlan": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]{0,63}$" }, "version": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]{0,63}$" }, "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "description": { "type": "string", "minLength": 1, "maxLength": 500 }, "price": { "type": "object", "properties": { "currency": { "const": "USD" }, "amountMinor": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,17})$", "description": "Exact USD minor units as a string. Preview terms, not an accepted invoice." }, "billingBasis": { "type": "string", "enum": [ "ONE_TIME", "MONTHLY", "ANNUAL" ] } }, "required": [ "currency", "amountMinor", "billingBasis" ], "additionalProperties": false }, "features": { "type": "array", "minItems": 1, "maxItems": 7, "uniqueItems": true, "items": { "type": "string", "enum": [ "PUBLIC_ANALYSIS", "PRIVATE_TREASURY", "TEAM_COLLABORATION", "SCENARIO_RESEARCH", "PROPOSAL_REVIEW", "MONITORING", "DECISION_PACKS" ] } }, "limits": { "type": "object", "properties": { "projects": { "type": "integer", "minimum": 1, "maximum": 100000 }, "teamSeats": { "type": "integer", "minimum": 1, "maximum": 100000 }, "analyses": { "type": "integer", "minimum": 1, "maximum": 100000 }, "analysisPeriod": { "type": "string", "enum": [ "ONE_TIME", "MONTHLY", "ANNUAL" ], "description": "Must match billingBasis. These are preview allowances, not current tenant entitlements." }, "monitoringIntervalMinutes": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 525600, "description": "Non-null exactly when MONITORING is included." }, { "type": "null" } ] } }, "required": [ "projects", "teamSeats", "analyses", "analysisPeriod", "monitoringIntervalMinutes" ], "additionalProperties": false }, "overagePolicy": { "const": "NO_AUTOMATIC_OVERAGE" }, "cancellationTerms": { "type": "string", "minLength": 1, "maxLength": 1000 } }, "required": [ "id", "version", "name", "description", "price", "features", "limits", "overagePolicy", "cancellationTerms" ], "additionalProperties": false }, "WorkspacePlanCatalog": { "type": "object", "properties": { "schemaVersion": { "const": "workspace-plan-catalog-v1" }, "status": { "type": "string", "enum": [ "NOT_CONFIGURED", "PREVIEW" ] }, "catalogVersion": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$", "description": "Hash of the validated deployment snapshot. Null when unconfigured or expired." }, { "type": "null" } ] }, "validUntil": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "plans": { "type": "array", "maxItems": 12, "items": { "$ref": "#/components/schemas/WorkspacePlan" } }, "purchaseAvailability": { "const": "UNAVAILABLE" }, "financialAuthority": { "const": false } }, "required": [ "schemaVersion", "status", "catalogVersion", "validUntil", "plans", "purchaseAvailability", "financialAuthority" ], "additionalProperties": false }, "AcpOffering": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]{0,63}$" }, "version": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]{0,63}$" }, "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "description": { "type": "string", "minLength": 1, "maxLength": 500 }, "requirements": { "type": "object", "properties": { "kind": { "const": "PUBLIC_VIRTUALS_PROJECT" }, "chainId": { "const": 8453 } }, "required": [ "kind", "chainId" ], "additionalProperties": false }, "deliverable": { "type": "object", "properties": { "kind": { "const": "PUBLIC_PROJECT_ANALYSIS_V1" } }, "required": [ "kind" ], "additionalProperties": false }, "price": { "type": "object", "properties": { "currency": { "const": "USDC" }, "amountAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,17})$", "description": "Exact USDC atomic units as a string. Preview terms only; no payment is accepted here." } }, "required": [ "currency", "amountAtomic" ], "additionalProperties": false }, "slaMinutes": { "type": "integer", "minimum": 1, "maximum": 525600 }, "fundTransfer": { "const": false } }, "required": [ "id", "version", "name", "description", "requirements", "deliverable", "price", "slaMinutes", "fundTransfer" ], "additionalProperties": false }, "AcpOfferingPreview": { "type": "object", "properties": { "schemaVersion": { "const": "acp-offering-preview-v1" }, "status": { "type": "string", "enum": [ "NOT_CONFIGURED", "PREVIEW" ] }, "catalogVersion": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$", "description": "Hash of the validated deployment snapshot. Null when unconfigured or expired." }, { "type": "null" } ] }, "validUntil": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "offering": { "anyOf": [ { "$ref": "#/components/schemas/AcpOffering" }, { "type": "null" } ] }, "purchaseAvailability": { "const": "UNAVAILABLE" }, "financialAuthority": { "const": false } }, "required": [ "schemaVersion", "status", "catalogVersion", "validUntil", "offering", "purchaseAvailability", "financialAuthority" ], "additionalProperties": false }, "CreateDecisionPack": { "type": "object", "properties": { "projectId": { "type": "string", "pattern": "^project_[0-9a-f]{32}$" }, "observationSequence": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" }, "expectedProjectResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "question": { "type": "string", "minLength": 3, "maxLength": 2000 }, "assumptions": { "maxItems": 10, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 1000 } } }, "required": [ "projectId", "observationSequence", "expectedProjectResourceVersion", "question", "assumptions" ], "additionalProperties": false }, "CreateTreasuryDecisionPack": { "type": "object", "properties": { "projectionId": { "type": "string", "pattern": "^treasury_projection_[0-9a-f]{32}$" }, "projectionResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "question": { "type": "string", "minLength": 3, "maxLength": 2000 }, "assumptions": { "maxItems": 10, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 1000 } } }, "required": [ "projectionId", "projectionResourceVersion", "question", "assumptions" ], "additionalProperties": false }, "TreasuryScenarioDecisionPack": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "decision-pack-v3" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "packId": { "type": "string", "pattern": "^decisionpack_[a-f0-9]{32}$" }, "sequence": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "state": { "type": "string", "enum": [ "DRAFT", "READY_FOR_REVIEW", "DECISION_RECORDED", "FOLLOW_UP_DUE", "CLOSED", "SUPERSEDED" ] }, "scope": { "type": "string", "const": "TREASURY_SCENARIO_REVIEW" }, "coverage": { "type": "string", "const": "PARTIAL" }, "question": { "type": "string", "minLength": 3, "maxLength": 2000 }, "project": { "type": "object", "properties": { "projectId": { "type": "string", "pattern": "^project_[0-9a-f]{32}$" }, "observationSequence": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "projectId", "observationSequence", "resourceVersion" ], "additionalProperties": false }, "healthReport": { "anyOf": [ { "type": "object", "properties": { "question": { "type": "string", "minLength": 3, "maxLength": 2000 }, "relation": { "type": "string", "const": "SUPPORTING_EVIDENCE_ONLY" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resultVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "captureHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "status": { "type": "string", "enum": [ "PARTIAL", "ABSTAINED" ] } }, "required": [ "question", "relation", "runId", "resultVersion", "captureHash", "sourceCutoff", "status" ], "additionalProperties": false }, { "type": "null" } ] }, "assumptions": { "type": "object", "properties": { "version": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "items": { "maxItems": 10, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 1000 } } }, "required": [ "version", "items" ], "additionalProperties": false }, "references": { "type": "object", "properties": { "baselineStudy": { "type": "null" }, "alternativeStudies": { "minItems": 0, "maxItems": 0, "type": "array", "items": { "not": {} } }, "proposalReview": { "type": "null" }, "treasuryProjection": { "type": "object", "properties": { "kind": { "type": "string", "const": "DECLARED_TREASURY_SCENARIO" }, "projectionId": { "type": "string", "pattern": "^treasury_projection_[0-9a-f]{32}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "modelHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "sourceHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "assumptions": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^treasury_assumptions_[0-9a-f]{32}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion" ], "additionalProperties": false }, "reconciliation": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^reconciliation_[0-9a-f]{32}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion" ], "additionalProperties": false }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "relation": { "type": "string", "const": "HISTORICAL_SUPPORTING_EVIDENCE_ONLY" }, "provenance": { "type": "string", "const": "DECLARED_SCENARIO" }, "spendability": { "type": "string", "const": "NOT_ESTABLISHED" } }, "required": [ "kind", "projectionId", "resourceVersion", "modelHash", "sourceHash", "assumptions", "reconciliation", "sourceCutoff", "relation", "provenance", "spendability" ], "additionalProperties": false }, "commercialOrder": { "type": "null" } }, "required": [ "baselineStudy", "alternativeStudies", "proposalReview", "treasuryProjection", "commercialOrder" ], "additionalProperties": false }, "unsupportedReferences": { "type": "array", "prefixItems": [ { "type": "string", "const": "STUDIES" }, { "type": "string", "const": "PROPOSAL_REVIEW" }, { "type": "string", "const": "COMMERCIAL_ORDER" } ], "minItems": 3, "maxItems": 3, "items": false }, "decision": { "anyOf": [ { "type": "object", "properties": { "choice": { "type": "string", "enum": [ "DO_NOTHING", "REQUEST_MORE_EVIDENCE", "TAKE_TO_SEPARATE_APPROVAL" ] }, "rationale": { "type": "string", "minLength": 1, "maxLength": 4000 }, "recordedBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "followUpAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, { "type": "null" } ] } }, "required": [ "choice", "rationale", "recordedBy", "recordedAt", "followUpAt" ], "additionalProperties": false }, { "type": "null" } ] }, "closure": { "anyOf": [ { "type": "object", "properties": { "note": { "type": "string", "minLength": 1, "maxLength": 4000 }, "recordedBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "note", "recordedBy", "recordedAt" ], "additionalProperties": false }, { "type": "null" } ] }, "supersededBy": { "anyOf": [ { "type": "string", "pattern": "^decisionpack_[a-f0-9]{32}$" }, { "type": "null" } ] }, "financialAuthority": { "type": "boolean", "const": false }, "publicationAuthority": { "type": "boolean", "const": false } }, "required": [ "schemaVersion", "organizationId", "packId", "sequence", "resourceVersion", "createdAt", "recordedAt", "state", "scope", "coverage", "question", "project", "healthReport", "assumptions", "references", "unsupportedReferences", "decision", "closure", "supersededBy", "financialAuthority", "publicationAuthority" ], "additionalProperties": false }, "CreateResearchDecisionPack": { "type": "object", "properties": { "projectId": { "type": "string", "pattern": "^project_[0-9a-f]{32}$" }, "observationSequence": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" }, "expectedProjectResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "question": { "type": "string", "minLength": 3, "maxLength": 2000 }, "assumptions": { "maxItems": 10, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 1000 } }, "researchRunId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "researchResultVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "expectedIssuerIntentResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "selectedVariant": { "type": "string", "enum": [ "CURRENT", "RECOMMENDED", "CONSERVATIVE", "CAPITAL_EFFICIENT", "EMERGENCY" ] }, "association": { "type": "string", "const": "USER_SELECTED_RESEARCH_CONTEXT" } }, "required": [ "projectId", "observationSequence", "expectedProjectResourceVersion", "question", "assumptions", "researchRunId", "researchResultVersion", "expectedIssuerIntentResourceVersion", "selectedVariant", "association" ], "additionalProperties": false }, "PublicEvidenceDecisionPack": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "decision-pack-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "packId": { "type": "string", "pattern": "^decisionpack_[a-f0-9]{32}$" }, "sequence": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "state": { "type": "string", "enum": [ "DRAFT", "READY_FOR_REVIEW", "DECISION_RECORDED", "FOLLOW_UP_DUE", "CLOSED", "SUPERSEDED" ] }, "scope": { "type": "string", "const": "PUBLIC_EVIDENCE_REVIEW" }, "coverage": { "type": "string", "const": "PARTIAL" }, "question": { "type": "string", "minLength": 3, "maxLength": 2000 }, "project": { "type": "object", "properties": { "projectId": { "type": "string", "pattern": "^project_[0-9a-f]{32}$" }, "observationSequence": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "projectId", "observationSequence", "resourceVersion" ], "additionalProperties": false }, "healthReport": { "anyOf": [ { "type": "object", "properties": { "question": { "type": "string", "minLength": 3, "maxLength": 2000 }, "relation": { "type": "string", "const": "SUPPORTING_EVIDENCE_ONLY" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resultVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "captureHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "status": { "type": "string", "enum": [ "PARTIAL", "ABSTAINED" ] } }, "required": [ "question", "relation", "runId", "resultVersion", "captureHash", "sourceCutoff", "status" ], "additionalProperties": false }, { "type": "null" } ] }, "assumptions": { "type": "object", "properties": { "version": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "items": { "maxItems": 10, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 1000 } } }, "required": [ "version", "items" ], "additionalProperties": false }, "references": { "type": "object", "properties": { "baselineStudy": { "type": "null" }, "alternativeStudies": { "minItems": 0, "maxItems": 0, "type": "array", "items": { "not": {} } }, "proposalReview": { "type": "null" }, "treasuryProjection": { "type": "null" }, "commercialOrder": { "type": "null" } }, "required": [ "baselineStudy", "alternativeStudies", "proposalReview", "treasuryProjection", "commercialOrder" ], "additionalProperties": false }, "unsupportedReferences": { "type": "array", "prefixItems": [ { "type": "string", "const": "STUDIES" }, { "type": "string", "const": "PROPOSAL_REVIEW" }, { "type": "string", "const": "TREASURY_PROJECTION" }, { "type": "string", "const": "COMMERCIAL_ORDER" } ], "minItems": 4, "maxItems": 4, "items": false }, "decision": { "anyOf": [ { "type": "object", "properties": { "choice": { "type": "string", "enum": [ "DO_NOTHING", "REQUEST_MORE_EVIDENCE", "TAKE_TO_SEPARATE_APPROVAL" ] }, "rationale": { "type": "string", "minLength": 1, "maxLength": 4000 }, "recordedBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "followUpAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, { "type": "null" } ] } }, "required": [ "choice", "rationale", "recordedBy", "recordedAt", "followUpAt" ], "additionalProperties": false }, { "type": "null" } ] }, "closure": { "anyOf": [ { "type": "object", "properties": { "note": { "type": "string", "minLength": 1, "maxLength": 4000 }, "recordedBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "note", "recordedBy", "recordedAt" ], "additionalProperties": false }, { "type": "null" } ] }, "supersededBy": { "anyOf": [ { "type": "string", "pattern": "^decisionpack_[a-f0-9]{32}$" }, { "type": "null" } ] }, "financialAuthority": { "type": "boolean", "const": false }, "publicationAuthority": { "type": "boolean", "const": false } }, "required": [ "schemaVersion", "organizationId", "packId", "sequence", "resourceVersion", "createdAt", "recordedAt", "state", "scope", "coverage", "question", "project", "healthReport", "assumptions", "references", "unsupportedReferences", "decision", "closure", "supersededBy", "financialAuthority", "publicationAuthority" ], "additionalProperties": false }, "ResearchCandidateDecisionPack": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "decision-pack-v2" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "packId": { "type": "string", "pattern": "^decisionpack_[a-f0-9]{32}$" }, "sequence": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "state": { "type": "string", "enum": [ "DRAFT", "READY_FOR_REVIEW", "DECISION_RECORDED", "FOLLOW_UP_DUE", "CLOSED", "SUPERSEDED" ] }, "scope": { "type": "string", "const": "RESEARCH_CANDIDATE_REVIEW" }, "coverage": { "type": "string", "const": "PARTIAL" }, "question": { "type": "string", "minLength": 3, "maxLength": 2000 }, "project": { "type": "object", "properties": { "projectId": { "type": "string", "pattern": "^project_[0-9a-f]{32}$" }, "observationSequence": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "projectId", "observationSequence", "resourceVersion" ], "additionalProperties": false }, "healthReport": { "anyOf": [ { "type": "object", "properties": { "question": { "type": "string", "minLength": 3, "maxLength": 2000 }, "relation": { "type": "string", "const": "SUPPORTING_EVIDENCE_ONLY" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resultVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "captureHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "status": { "type": "string", "enum": [ "PARTIAL", "ABSTAINED" ] } }, "required": [ "question", "relation", "runId", "resultVersion", "captureHash", "sourceCutoff", "status" ], "additionalProperties": false }, { "type": "null" } ] }, "assumptions": { "type": "object", "properties": { "version": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "items": { "maxItems": 10, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 1000 } } }, "required": [ "version", "items" ], "additionalProperties": false }, "references": { "type": "object", "properties": { "baselineStudy": { "type": "object", "properties": { "kind": { "type": "string", "const": "RESEARCH_TRIAL" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "protocolHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "trialKey": { "type": "string", "enum": [ "baseline", "alternative-1", "alternative-2", "alternative-3" ] }, "inputHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "artifactHash": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] }, "state": { "type": "string", "enum": [ "QUEUED", "RUNNING", "COMPLETED", "FAILED", "CANCELLED" ] }, "recordedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, { "type": "null" } ] }, "failureCode": { "anyOf": [ { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{2,119}$" }, { "type": "null" } ] } }, "required": [ "kind", "runId", "protocolHash", "trialKey", "inputHash", "artifactHash", "state", "recordedAt", "failureCode" ], "additionalProperties": false }, "alternativeStudies": { "maxItems": 3, "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "const": "RESEARCH_TRIAL" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "protocolHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "trialKey": { "type": "string", "enum": [ "baseline", "alternative-1", "alternative-2", "alternative-3" ] }, "inputHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "artifactHash": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] }, "state": { "type": "string", "enum": [ "QUEUED", "RUNNING", "COMPLETED", "FAILED", "CANCELLED" ] }, "recordedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, { "type": "null" } ] }, "failureCode": { "anyOf": [ { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{2,119}$" }, { "type": "null" } ] } }, "required": [ "kind", "runId", "protocolHash", "trialKey", "inputHash", "artifactHash", "state", "recordedAt", "failureCode" ], "additionalProperties": false } }, "proposalReview": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "CANDIDATE_REVIEW" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resultVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "captureHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "contentHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "reviewedPackResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "status": { "type": "string", "const": "PARTIAL" }, "relation": { "type": "string", "const": "ANALYSIS_REVIEW_ONLY" } }, "required": [ "kind", "runId", "resultVersion", "captureHash", "contentHash", "reviewedPackResourceVersion", "sourceCutoff", "status", "relation" ], "additionalProperties": false }, { "type": "null" } ] }, "treasuryProjection": { "type": "null" }, "commercialOrder": { "type": "null" } }, "required": [ "baselineStudy", "alternativeStudies", "proposalReview", "treasuryProjection", "commercialOrder" ], "additionalProperties": false }, "unsupportedReferences": { "anyOf": [ { "type": "array", "prefixItems": [ { "type": "string", "const": "TREASURY_PROJECTION" }, { "type": "string", "const": "COMMERCIAL_ORDER" } ], "minItems": 2, "maxItems": 2, "items": false }, { "type": "array", "prefixItems": [ { "type": "string", "const": "PROPOSAL_REVIEW" }, { "type": "string", "const": "TREASURY_PROJECTION" }, { "type": "string", "const": "COMMERCIAL_ORDER" } ], "minItems": 3, "maxItems": 3, "items": false } ] }, "decision": { "anyOf": [ { "type": "object", "properties": { "choice": { "type": "string", "enum": [ "DO_NOTHING", "REQUEST_MORE_EVIDENCE", "TAKE_TO_SEPARATE_APPROVAL" ] }, "rationale": { "type": "string", "minLength": 1, "maxLength": 4000 }, "recordedBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "followUpAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, { "type": "null" } ] } }, "required": [ "choice", "rationale", "recordedBy", "recordedAt", "followUpAt" ], "additionalProperties": false }, { "type": "null" } ] }, "closure": { "anyOf": [ { "type": "object", "properties": { "note": { "type": "string", "minLength": 1, "maxLength": 4000 }, "recordedBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "note", "recordedBy", "recordedAt" ], "additionalProperties": false }, { "type": "null" } ] }, "supersededBy": { "anyOf": [ { "type": "string", "pattern": "^decisionpack_[a-f0-9]{32}$" }, { "type": "null" } ] }, "financialAuthority": { "type": "boolean", "const": false }, "publicationAuthority": { "type": "boolean", "const": false }, "contentHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "sourceAssociation": { "type": "object", "properties": { "relation": { "type": "string", "const": "USER_SELECTED_RESEARCH_CONTEXT" }, "assertedBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "assertedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "ownershipVerified": { "type": "boolean", "const": false }, "quoteUnitsVerified": { "type": "boolean", "const": false } }, "required": [ "relation", "assertedBy", "assertedAt", "ownershipVerified", "quoteUnitsVerified" ], "additionalProperties": false }, "research": { "type": "object", "properties": { "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resultVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "protocolHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "issuerIntent": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "artifactHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion", "artifactHash" ], "additionalProperties": false }, "question": { "type": "string", "minLength": 3, "maxLength": 2000 }, "relation": { "type": "string", "const": "SUPPORTING_EVIDENCE_ONLY" }, "objective": { "type": "object", "properties": { "metric": { "type": "string", "enum": [ "ENDING_VALUE_P50", "MINIMUM_DEPTH_P5", "GAS_COST_P50", "DRAWDOWN_P95", "RESERVE_BREACH_PROBABILITY" ] }, "direction": { "type": "string", "enum": [ "MAXIMIZE", "MINIMIZE" ] } }, "required": [ "metric", "direction" ], "additionalProperties": false }, "comparisonStatus": { "type": "string", "enum": [ "BASELINE_UNAVAILABLE", "COMPLETE", "PARTIAL" ] }, "quote": { "type": "object", "properties": { "symbol": { "type": "string", "maxLength": 256 }, "assetId": { "type": "null" }, "decimals": { "type": "null" }, "unit": { "type": "string", "const": "ISSUER_INTENT_QUOTE_ATOMIC" } }, "required": [ "symbol", "assetId", "decimals", "unit" ], "additionalProperties": false }, "limitations": { "minItems": 6, "maxItems": 6, "type": "array", "items": { "type": "string", "enum": [ "CURRENT_IS_ENGINE_GENERATED_NOT_ACTUAL_HOLDINGS", "COMPARISON_DOES_NOT_PROVE_EQUAL_CAPITAL_SUPERIORITY", "MARGINAL_PERCENTILE_DIFFERENCES_ARE_NOT_PAIRED_DIFFERENCE_PERCENTILES", "RESERVE_BREACH_IS_COMPOSITE_RESERVE_OR_ORACLE_BLOCKED_EVENT", "MODEL_OUTCOMES_ARE_NOT_FINANCIAL_GUARANTEES", "ARTIFACT_HASHES_DO_NOT_REPRODUCE_ENGINE_OUTPUT" ] } }, "trials": { "minItems": 1, "maxItems": 4, "type": "array", "items": { "type": "object", "properties": { "reference": { "type": "object", "properties": { "kind": { "type": "string", "const": "RESEARCH_TRIAL" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "protocolHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "trialKey": { "type": "string", "enum": [ "baseline", "alternative-1", "alternative-2", "alternative-3" ] }, "inputHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "artifactHash": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] }, "state": { "type": "string", "enum": [ "QUEUED", "RUNNING", "COMPLETED", "FAILED", "CANCELLED" ] }, "recordedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, { "type": "null" } ] }, "failureCode": { "anyOf": [ { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{2,119}$" }, { "type": "null" } ] } }, "required": [ "kind", "runId", "protocolHash", "trialKey", "inputHash", "artifactHash", "state", "recordedAt", "failureCode" ], "additionalProperties": false }, "label": { "type": "string", "minLength": 1, "maxLength": 160 }, "comparisonStatus": { "type": "string", "enum": [ "PENDING", "FAILED", "CANCELLED", "INVALID", "INCOMPATIBLE", "BASELINE_UNAVAILABLE", "COMPARABLE" ] }, "reasons": { "maxItems": 16, "type": "array", "items": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{2,119}$" } }, "warningCount": { "type": "integer", "minimum": 0, "maximum": 64 }, "selected": { "anyOf": [ { "type": "object", "properties": { "variant": { "type": "string", "enum": [ "CURRENT", "RECOMMENDED", "CONSERVATIVE", "CAPITAL_EFFICIENT", "EMERGENCY" ] }, "eligible": { "type": "boolean" }, "ineligibilityReasons": { "maxItems": 4, "type": "array", "items": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{2,119}$" } } }, "required": [ "variant", "eligible", "ineligibilityReasons" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "reference", "label", "comparisonStatus", "reasons", "warningCount", "selected" ], "additionalProperties": false } } }, "required": [ "runId", "resultVersion", "protocolHash", "sourceCutoff", "issuerIntent", "question", "relation", "objective", "comparisonStatus", "quote", "limitations", "trials" ], "additionalProperties": false }, "candidate": { "type": "object", "properties": { "selectedVariant": { "type": "string", "enum": [ "CURRENT", "RECOMMENDED", "CONSERVATIVE", "CAPITAL_EFFICIENT", "EMERGENCY" ] }, "capitalPlan": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "CURRENT", "RECOMMENDED", "CONSERVATIVE", "CAPITAL_EFFICIENT", "EMERGENCY" ] }, "requiredCapitalQuote": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "deployableCapitalQuote": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "stableReserveQuote": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "emergencyReserveQuote": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "rangeWidthPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "expectedSlippagePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "expectedFeeIncomeLowQuote": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "expectedFeeIncomeHighQuote": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "inventoryExposurePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "maximumDailyTurnoverPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "satisfiesIntent": { "type": "boolean" }, "reasons": { "maxItems": 64, "type": "array", "items": { "type": "string", "maxLength": 1200 } } }, "required": [ "kind", "requiredCapitalQuote", "deployableCapitalQuote", "stableReserveQuote", "emergencyReserveQuote", "rangeWidthPips", "expectedSlippagePips", "expectedFeeIncomeLowQuote", "expectedFeeIncomeHighQuote", "inventoryExposurePips", "maximumDailyTurnoverPips", "satisfiesIntent", "reasons" ], "additionalProperties": false }, "baselineEligible": { "type": "boolean" }, "status": { "type": "string", "enum": [ "BLOCKED_BASELINE_UNAVAILABLE", "BLOCKED_BASELINE_INELIGIBLE", "INCOMPLETE_ALTERNATIVES", "INELIGIBLE_IN_ALTERNATIVES", "ELIGIBLE_IN_CAPTURED_SCENARIOS" ] }, "rankingScope": { "type": "string", "const": "WITHIN_SCENARIO_VARIANTS" } }, "required": [ "selectedVariant", "capitalPlan", "baselineEligible", "status", "rankingScope" ], "additionalProperties": false } }, "required": [ "schemaVersion", "organizationId", "packId", "sequence", "resourceVersion", "createdAt", "recordedAt", "state", "scope", "coverage", "question", "project", "healthReport", "assumptions", "references", "unsupportedReferences", "decision", "closure", "supersededBy", "financialAuthority", "publicationAuthority", "contentHash", "sourceAssociation", "research", "candidate" ], "additionalProperties": false }, "DecisionPackCommand": { "oneOf": [ { "type": "object", "properties": { "action": { "type": "string", "const": "EDIT_DRAFT" }, "question": { "type": "string", "minLength": 3, "maxLength": 2000 }, "assumptions": { "maxItems": 10, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 1000 } } }, "required": [ "action", "question", "assumptions" ], "additionalProperties": false }, { "type": "object", "properties": { "action": { "type": "string", "const": "ATTACH_CANDIDATE_REVIEW" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resultVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "action", "runId", "resultVersion" ], "additionalProperties": false }, { "type": "object", "properties": { "action": { "type": "string", "const": "ATTACH_TREASURY_PROJECTION" }, "projectionId": { "type": "string", "pattern": "^treasury_projection_[0-9a-f]{32}$" }, "projectionResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "action", "projectionId", "projectionResourceVersion" ], "additionalProperties": false }, { "type": "object", "properties": { "action": { "type": "string", "const": "ATTACH_HEALTH" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resultVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "action", "runId", "resultVersion" ], "additionalProperties": false }, { "type": "object", "properties": { "action": { "type": "string", "const": "READY_FOR_REVIEW" } }, "required": [ "action" ], "additionalProperties": false }, { "type": "object", "properties": { "action": { "type": "string", "const": "RECORD_DECISION" }, "choice": { "type": "string", "enum": [ "DO_NOTHING", "REQUEST_MORE_EVIDENCE", "TAKE_TO_SEPARATE_APPROVAL" ] }, "rationale": { "type": "string", "minLength": 1, "maxLength": 4000 }, "followUpAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, { "type": "null" } ] } }, "required": [ "action", "choice", "rationale", "followUpAt" ], "additionalProperties": false }, { "type": "object", "properties": { "action": { "type": "string", "const": "MARK_FOLLOW_UP_DUE" } }, "required": [ "action" ], "additionalProperties": false }, { "type": "object", "properties": { "action": { "type": "string", "const": "CLOSE" }, "note": { "type": "string", "minLength": 1, "maxLength": 4000 } }, "required": [ "action", "note" ], "additionalProperties": false }, { "type": "object", "properties": { "action": { "type": "string", "const": "SUPERSEDE" }, "replacementPackId": { "type": "string", "pattern": "^decisionpack_[a-f0-9]{32}$" } }, "required": [ "action", "replacementPackId" ], "additionalProperties": false } ] }, "DecisionPack": { "oneOf": [ { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "decision-pack-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "packId": { "type": "string", "pattern": "^decisionpack_[a-f0-9]{32}$" }, "sequence": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "state": { "type": "string", "enum": [ "DRAFT", "READY_FOR_REVIEW", "DECISION_RECORDED", "FOLLOW_UP_DUE", "CLOSED", "SUPERSEDED" ] }, "scope": { "type": "string", "const": "PUBLIC_EVIDENCE_REVIEW" }, "coverage": { "type": "string", "const": "PARTIAL" }, "question": { "type": "string", "minLength": 3, "maxLength": 2000 }, "project": { "type": "object", "properties": { "projectId": { "type": "string", "pattern": "^project_[0-9a-f]{32}$" }, "observationSequence": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "projectId", "observationSequence", "resourceVersion" ], "additionalProperties": false }, "healthReport": { "anyOf": [ { "type": "object", "properties": { "question": { "type": "string", "minLength": 3, "maxLength": 2000 }, "relation": { "type": "string", "const": "SUPPORTING_EVIDENCE_ONLY" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resultVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "captureHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "status": { "type": "string", "enum": [ "PARTIAL", "ABSTAINED" ] } }, "required": [ "question", "relation", "runId", "resultVersion", "captureHash", "sourceCutoff", "status" ], "additionalProperties": false }, { "type": "null" } ] }, "assumptions": { "type": "object", "properties": { "version": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "items": { "maxItems": 10, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 1000 } } }, "required": [ "version", "items" ], "additionalProperties": false }, "references": { "type": "object", "properties": { "baselineStudy": { "type": "null" }, "alternativeStudies": { "minItems": 0, "maxItems": 0, "type": "array", "items": { "not": {} } }, "proposalReview": { "type": "null" }, "treasuryProjection": { "type": "null" }, "commercialOrder": { "type": "null" } }, "required": [ "baselineStudy", "alternativeStudies", "proposalReview", "treasuryProjection", "commercialOrder" ], "additionalProperties": false }, "unsupportedReferences": { "type": "array", "prefixItems": [ { "type": "string", "const": "STUDIES" }, { "type": "string", "const": "PROPOSAL_REVIEW" }, { "type": "string", "const": "TREASURY_PROJECTION" }, { "type": "string", "const": "COMMERCIAL_ORDER" } ], "minItems": 4, "maxItems": 4, "items": false }, "decision": { "anyOf": [ { "type": "object", "properties": { "choice": { "type": "string", "enum": [ "DO_NOTHING", "REQUEST_MORE_EVIDENCE", "TAKE_TO_SEPARATE_APPROVAL" ] }, "rationale": { "type": "string", "minLength": 1, "maxLength": 4000 }, "recordedBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "followUpAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, { "type": "null" } ] } }, "required": [ "choice", "rationale", "recordedBy", "recordedAt", "followUpAt" ], "additionalProperties": false }, { "type": "null" } ] }, "closure": { "anyOf": [ { "type": "object", "properties": { "note": { "type": "string", "minLength": 1, "maxLength": 4000 }, "recordedBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "note", "recordedBy", "recordedAt" ], "additionalProperties": false }, { "type": "null" } ] }, "supersededBy": { "anyOf": [ { "type": "string", "pattern": "^decisionpack_[a-f0-9]{32}$" }, { "type": "null" } ] }, "financialAuthority": { "type": "boolean", "const": false }, "publicationAuthority": { "type": "boolean", "const": false } }, "required": [ "schemaVersion", "organizationId", "packId", "sequence", "resourceVersion", "createdAt", "recordedAt", "state", "scope", "coverage", "question", "project", "healthReport", "assumptions", "references", "unsupportedReferences", "decision", "closure", "supersededBy", "financialAuthority", "publicationAuthority" ], "additionalProperties": false }, { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "decision-pack-v2" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "packId": { "type": "string", "pattern": "^decisionpack_[a-f0-9]{32}$" }, "sequence": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "state": { "type": "string", "enum": [ "DRAFT", "READY_FOR_REVIEW", "DECISION_RECORDED", "FOLLOW_UP_DUE", "CLOSED", "SUPERSEDED" ] }, "scope": { "type": "string", "const": "RESEARCH_CANDIDATE_REVIEW" }, "coverage": { "type": "string", "const": "PARTIAL" }, "question": { "type": "string", "minLength": 3, "maxLength": 2000 }, "project": { "type": "object", "properties": { "projectId": { "type": "string", "pattern": "^project_[0-9a-f]{32}$" }, "observationSequence": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "projectId", "observationSequence", "resourceVersion" ], "additionalProperties": false }, "healthReport": { "anyOf": [ { "type": "object", "properties": { "question": { "type": "string", "minLength": 3, "maxLength": 2000 }, "relation": { "type": "string", "const": "SUPPORTING_EVIDENCE_ONLY" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resultVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "captureHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "status": { "type": "string", "enum": [ "PARTIAL", "ABSTAINED" ] } }, "required": [ "question", "relation", "runId", "resultVersion", "captureHash", "sourceCutoff", "status" ], "additionalProperties": false }, { "type": "null" } ] }, "assumptions": { "type": "object", "properties": { "version": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "items": { "maxItems": 10, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 1000 } } }, "required": [ "version", "items" ], "additionalProperties": false }, "references": { "type": "object", "properties": { "baselineStudy": { "type": "object", "properties": { "kind": { "type": "string", "const": "RESEARCH_TRIAL" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "protocolHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "trialKey": { "type": "string", "enum": [ "baseline", "alternative-1", "alternative-2", "alternative-3" ] }, "inputHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "artifactHash": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] }, "state": { "type": "string", "enum": [ "QUEUED", "RUNNING", "COMPLETED", "FAILED", "CANCELLED" ] }, "recordedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, { "type": "null" } ] }, "failureCode": { "anyOf": [ { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{2,119}$" }, { "type": "null" } ] } }, "required": [ "kind", "runId", "protocolHash", "trialKey", "inputHash", "artifactHash", "state", "recordedAt", "failureCode" ], "additionalProperties": false }, "alternativeStudies": { "maxItems": 3, "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "const": "RESEARCH_TRIAL" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "protocolHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "trialKey": { "type": "string", "enum": [ "baseline", "alternative-1", "alternative-2", "alternative-3" ] }, "inputHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "artifactHash": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] }, "state": { "type": "string", "enum": [ "QUEUED", "RUNNING", "COMPLETED", "FAILED", "CANCELLED" ] }, "recordedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, { "type": "null" } ] }, "failureCode": { "anyOf": [ { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{2,119}$" }, { "type": "null" } ] } }, "required": [ "kind", "runId", "protocolHash", "trialKey", "inputHash", "artifactHash", "state", "recordedAt", "failureCode" ], "additionalProperties": false } }, "proposalReview": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "CANDIDATE_REVIEW" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resultVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "captureHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "contentHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "reviewedPackResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "status": { "type": "string", "const": "PARTIAL" }, "relation": { "type": "string", "const": "ANALYSIS_REVIEW_ONLY" } }, "required": [ "kind", "runId", "resultVersion", "captureHash", "contentHash", "reviewedPackResourceVersion", "sourceCutoff", "status", "relation" ], "additionalProperties": false }, { "type": "null" } ] }, "treasuryProjection": { "type": "null" }, "commercialOrder": { "type": "null" } }, "required": [ "baselineStudy", "alternativeStudies", "proposalReview", "treasuryProjection", "commercialOrder" ], "additionalProperties": false }, "unsupportedReferences": { "anyOf": [ { "type": "array", "prefixItems": [ { "type": "string", "const": "TREASURY_PROJECTION" }, { "type": "string", "const": "COMMERCIAL_ORDER" } ], "minItems": 2, "maxItems": 2, "items": false }, { "type": "array", "prefixItems": [ { "type": "string", "const": "PROPOSAL_REVIEW" }, { "type": "string", "const": "TREASURY_PROJECTION" }, { "type": "string", "const": "COMMERCIAL_ORDER" } ], "minItems": 3, "maxItems": 3, "items": false } ] }, "decision": { "anyOf": [ { "type": "object", "properties": { "choice": { "type": "string", "enum": [ "DO_NOTHING", "REQUEST_MORE_EVIDENCE", "TAKE_TO_SEPARATE_APPROVAL" ] }, "rationale": { "type": "string", "minLength": 1, "maxLength": 4000 }, "recordedBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "followUpAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, { "type": "null" } ] } }, "required": [ "choice", "rationale", "recordedBy", "recordedAt", "followUpAt" ], "additionalProperties": false }, { "type": "null" } ] }, "closure": { "anyOf": [ { "type": "object", "properties": { "note": { "type": "string", "minLength": 1, "maxLength": 4000 }, "recordedBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "note", "recordedBy", "recordedAt" ], "additionalProperties": false }, { "type": "null" } ] }, "supersededBy": { "anyOf": [ { "type": "string", "pattern": "^decisionpack_[a-f0-9]{32}$" }, { "type": "null" } ] }, "financialAuthority": { "type": "boolean", "const": false }, "publicationAuthority": { "type": "boolean", "const": false }, "contentHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "sourceAssociation": { "type": "object", "properties": { "relation": { "type": "string", "const": "USER_SELECTED_RESEARCH_CONTEXT" }, "assertedBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "assertedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "ownershipVerified": { "type": "boolean", "const": false }, "quoteUnitsVerified": { "type": "boolean", "const": false } }, "required": [ "relation", "assertedBy", "assertedAt", "ownershipVerified", "quoteUnitsVerified" ], "additionalProperties": false }, "research": { "type": "object", "properties": { "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resultVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "protocolHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "issuerIntent": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "artifactHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion", "artifactHash" ], "additionalProperties": false }, "question": { "type": "string", "minLength": 3, "maxLength": 2000 }, "relation": { "type": "string", "const": "SUPPORTING_EVIDENCE_ONLY" }, "objective": { "type": "object", "properties": { "metric": { "type": "string", "enum": [ "ENDING_VALUE_P50", "MINIMUM_DEPTH_P5", "GAS_COST_P50", "DRAWDOWN_P95", "RESERVE_BREACH_PROBABILITY" ] }, "direction": { "type": "string", "enum": [ "MAXIMIZE", "MINIMIZE" ] } }, "required": [ "metric", "direction" ], "additionalProperties": false }, "comparisonStatus": { "type": "string", "enum": [ "BASELINE_UNAVAILABLE", "COMPLETE", "PARTIAL" ] }, "quote": { "type": "object", "properties": { "symbol": { "type": "string", "maxLength": 256 }, "assetId": { "type": "null" }, "decimals": { "type": "null" }, "unit": { "type": "string", "const": "ISSUER_INTENT_QUOTE_ATOMIC" } }, "required": [ "symbol", "assetId", "decimals", "unit" ], "additionalProperties": false }, "limitations": { "minItems": 6, "maxItems": 6, "type": "array", "items": { "type": "string", "enum": [ "CURRENT_IS_ENGINE_GENERATED_NOT_ACTUAL_HOLDINGS", "COMPARISON_DOES_NOT_PROVE_EQUAL_CAPITAL_SUPERIORITY", "MARGINAL_PERCENTILE_DIFFERENCES_ARE_NOT_PAIRED_DIFFERENCE_PERCENTILES", "RESERVE_BREACH_IS_COMPOSITE_RESERVE_OR_ORACLE_BLOCKED_EVENT", "MODEL_OUTCOMES_ARE_NOT_FINANCIAL_GUARANTEES", "ARTIFACT_HASHES_DO_NOT_REPRODUCE_ENGINE_OUTPUT" ] } }, "trials": { "minItems": 1, "maxItems": 4, "type": "array", "items": { "type": "object", "properties": { "reference": { "type": "object", "properties": { "kind": { "type": "string", "const": "RESEARCH_TRIAL" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "protocolHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "trialKey": { "type": "string", "enum": [ "baseline", "alternative-1", "alternative-2", "alternative-3" ] }, "inputHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "artifactHash": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] }, "state": { "type": "string", "enum": [ "QUEUED", "RUNNING", "COMPLETED", "FAILED", "CANCELLED" ] }, "recordedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, { "type": "null" } ] }, "failureCode": { "anyOf": [ { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{2,119}$" }, { "type": "null" } ] } }, "required": [ "kind", "runId", "protocolHash", "trialKey", "inputHash", "artifactHash", "state", "recordedAt", "failureCode" ], "additionalProperties": false }, "label": { "type": "string", "minLength": 1, "maxLength": 160 }, "comparisonStatus": { "type": "string", "enum": [ "PENDING", "FAILED", "CANCELLED", "INVALID", "INCOMPATIBLE", "BASELINE_UNAVAILABLE", "COMPARABLE" ] }, "reasons": { "maxItems": 16, "type": "array", "items": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{2,119}$" } }, "warningCount": { "type": "integer", "minimum": 0, "maximum": 64 }, "selected": { "anyOf": [ { "type": "object", "properties": { "variant": { "type": "string", "enum": [ "CURRENT", "RECOMMENDED", "CONSERVATIVE", "CAPITAL_EFFICIENT", "EMERGENCY" ] }, "eligible": { "type": "boolean" }, "ineligibilityReasons": { "maxItems": 4, "type": "array", "items": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{2,119}$" } } }, "required": [ "variant", "eligible", "ineligibilityReasons" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "reference", "label", "comparisonStatus", "reasons", "warningCount", "selected" ], "additionalProperties": false } } }, "required": [ "runId", "resultVersion", "protocolHash", "sourceCutoff", "issuerIntent", "question", "relation", "objective", "comparisonStatus", "quote", "limitations", "trials" ], "additionalProperties": false }, "candidate": { "type": "object", "properties": { "selectedVariant": { "type": "string", "enum": [ "CURRENT", "RECOMMENDED", "CONSERVATIVE", "CAPITAL_EFFICIENT", "EMERGENCY" ] }, "capitalPlan": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "CURRENT", "RECOMMENDED", "CONSERVATIVE", "CAPITAL_EFFICIENT", "EMERGENCY" ] }, "requiredCapitalQuote": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "deployableCapitalQuote": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "stableReserveQuote": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "emergencyReserveQuote": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "rangeWidthPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "expectedSlippagePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "expectedFeeIncomeLowQuote": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "expectedFeeIncomeHighQuote": { "type": "string", "pattern": "^-?(0|[1-9][0-9]{0,77})$" }, "inventoryExposurePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "maximumDailyTurnoverPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "satisfiesIntent": { "type": "boolean" }, "reasons": { "maxItems": 64, "type": "array", "items": { "type": "string", "maxLength": 1200 } } }, "required": [ "kind", "requiredCapitalQuote", "deployableCapitalQuote", "stableReserveQuote", "emergencyReserveQuote", "rangeWidthPips", "expectedSlippagePips", "expectedFeeIncomeLowQuote", "expectedFeeIncomeHighQuote", "inventoryExposurePips", "maximumDailyTurnoverPips", "satisfiesIntent", "reasons" ], "additionalProperties": false }, "baselineEligible": { "type": "boolean" }, "status": { "type": "string", "enum": [ "BLOCKED_BASELINE_UNAVAILABLE", "BLOCKED_BASELINE_INELIGIBLE", "INCOMPLETE_ALTERNATIVES", "INELIGIBLE_IN_ALTERNATIVES", "ELIGIBLE_IN_CAPTURED_SCENARIOS" ] }, "rankingScope": { "type": "string", "const": "WITHIN_SCENARIO_VARIANTS" } }, "required": [ "selectedVariant", "capitalPlan", "baselineEligible", "status", "rankingScope" ], "additionalProperties": false } }, "required": [ "schemaVersion", "organizationId", "packId", "sequence", "resourceVersion", "createdAt", "recordedAt", "state", "scope", "coverage", "question", "project", "healthReport", "assumptions", "references", "unsupportedReferences", "decision", "closure", "supersededBy", "financialAuthority", "publicationAuthority", "contentHash", "sourceAssociation", "research", "candidate" ], "additionalProperties": false }, { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "decision-pack-v3" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "packId": { "type": "string", "pattern": "^decisionpack_[a-f0-9]{32}$" }, "sequence": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "state": { "type": "string", "enum": [ "DRAFT", "READY_FOR_REVIEW", "DECISION_RECORDED", "FOLLOW_UP_DUE", "CLOSED", "SUPERSEDED" ] }, "scope": { "type": "string", "const": "TREASURY_SCENARIO_REVIEW" }, "coverage": { "type": "string", "const": "PARTIAL" }, "question": { "type": "string", "minLength": 3, "maxLength": 2000 }, "project": { "type": "object", "properties": { "projectId": { "type": "string", "pattern": "^project_[0-9a-f]{32}$" }, "observationSequence": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "projectId", "observationSequence", "resourceVersion" ], "additionalProperties": false }, "healthReport": { "anyOf": [ { "type": "object", "properties": { "question": { "type": "string", "minLength": 3, "maxLength": 2000 }, "relation": { "type": "string", "const": "SUPPORTING_EVIDENCE_ONLY" }, "runId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resultVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "captureHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "status": { "type": "string", "enum": [ "PARTIAL", "ABSTAINED" ] } }, "required": [ "question", "relation", "runId", "resultVersion", "captureHash", "sourceCutoff", "status" ], "additionalProperties": false }, { "type": "null" } ] }, "assumptions": { "type": "object", "properties": { "version": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "items": { "maxItems": 10, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 1000 } } }, "required": [ "version", "items" ], "additionalProperties": false }, "references": { "type": "object", "properties": { "baselineStudy": { "type": "null" }, "alternativeStudies": { "minItems": 0, "maxItems": 0, "type": "array", "items": { "not": {} } }, "proposalReview": { "type": "null" }, "treasuryProjection": { "type": "object", "properties": { "kind": { "type": "string", "const": "DECLARED_TREASURY_SCENARIO" }, "projectionId": { "type": "string", "pattern": "^treasury_projection_[0-9a-f]{32}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "modelHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "sourceHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "assumptions": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^treasury_assumptions_[0-9a-f]{32}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion" ], "additionalProperties": false }, "reconciliation": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^reconciliation_[0-9a-f]{32}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion" ], "additionalProperties": false }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "relation": { "type": "string", "const": "HISTORICAL_SUPPORTING_EVIDENCE_ONLY" }, "provenance": { "type": "string", "const": "DECLARED_SCENARIO" }, "spendability": { "type": "string", "const": "NOT_ESTABLISHED" } }, "required": [ "kind", "projectionId", "resourceVersion", "modelHash", "sourceHash", "assumptions", "reconciliation", "sourceCutoff", "relation", "provenance", "spendability" ], "additionalProperties": false }, "commercialOrder": { "type": "null" } }, "required": [ "baselineStudy", "alternativeStudies", "proposalReview", "treasuryProjection", "commercialOrder" ], "additionalProperties": false }, "unsupportedReferences": { "type": "array", "prefixItems": [ { "type": "string", "const": "STUDIES" }, { "type": "string", "const": "PROPOSAL_REVIEW" }, { "type": "string", "const": "COMMERCIAL_ORDER" } ], "minItems": 3, "maxItems": 3, "items": false }, "decision": { "anyOf": [ { "type": "object", "properties": { "choice": { "type": "string", "enum": [ "DO_NOTHING", "REQUEST_MORE_EVIDENCE", "TAKE_TO_SEPARATE_APPROVAL" ] }, "rationale": { "type": "string", "minLength": 1, "maxLength": 4000 }, "recordedBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "followUpAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, { "type": "null" } ] } }, "required": [ "choice", "rationale", "recordedBy", "recordedAt", "followUpAt" ], "additionalProperties": false }, { "type": "null" } ] }, "closure": { "anyOf": [ { "type": "object", "properties": { "note": { "type": "string", "minLength": 1, "maxLength": 4000 }, "recordedBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "note", "recordedBy", "recordedAt" ], "additionalProperties": false }, { "type": "null" } ] }, "supersededBy": { "anyOf": [ { "type": "string", "pattern": "^decisionpack_[a-f0-9]{32}$" }, { "type": "null" } ] }, "financialAuthority": { "type": "boolean", "const": false }, "publicationAuthority": { "type": "boolean", "const": false } }, "required": [ "schemaVersion", "organizationId", "packId", "sequence", "resourceVersion", "createdAt", "recordedAt", "state", "scope", "coverage", "question", "project", "healthReport", "assumptions", "references", "unsupportedReferences", "decision", "closure", "supersededBy", "financialAuthority", "publicationAuthority" ], "additionalProperties": false } ] }, "DecisionPackWriteReceipt": { "type": "object", "properties": { "pack": { "$ref": "#/components/schemas/DecisionPack" }, "replayed": { "type": "boolean" } }, "required": [ "pack", "replayed" ], "additionalProperties": false }, "DecisionPackList": { "type": "object", "properties": { "packs": { "type": "array", "maxItems": 20, "items": { "$ref": "#/components/schemas/DecisionPack" } }, "nextCursor": { "anyOf": [ { "type": "string", "pattern": "^decisionpack_[a-f0-9]{32}$" }, { "type": "null" } ] } }, "required": [ "packs", "nextCursor" ], "additionalProperties": false }, "DecisionPackHistory": { "type": "object", "properties": { "versions": { "type": "array", "maxItems": 20, "items": { "type": "object", "properties": { "sequence": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "state": { "type": "string", "enum": [ "DRAFT", "READY_FOR_REVIEW", "DECISION_RECORDED", "FOLLOW_UP_DUE", "CLOSED", "SUPERSEDED" ] }, "recordedAt": { "type": "string", "format": "date-time" } }, "required": [ "sequence", "resourceVersion", "state", "recordedAt" ], "additionalProperties": false } }, "nextCursor": { "anyOf": [ { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" }, { "type": "null" } ] } }, "required": [ "versions", "nextCursor" ], "additionalProperties": false }, "SignedTreasuryEvidence": { "type": "object", "properties": { "payload": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "treasury-custody-evidence-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "projectId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "evidenceId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "relationship": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "evidenceHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion", "evidenceHash" ], "additionalProperties": false }, "provider": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "attestationHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion", "attestationHash" ], "additionalProperties": false }, "observation": { "type": "object", "properties": { "chainId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "genesisHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "token": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "decimals": { "type": "integer", "minimum": 0, "maximum": 36 }, "custodyAccount": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "amountAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "blockNumber": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "blockHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "blockTimestamp": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "finality": { "type": "string", "const": "FINALIZED" } }, "required": [ "chainId", "genesisHash", "token", "decimals", "custodyAccount", "amountAtomic", "blockNumber", "blockHash", "blockTimestamp", "finality" ], "additionalProperties": false }, "observedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "expiresAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "schemaVersion", "organizationId", "projectId", "evidenceId", "relationship", "provider", "observation", "observedAt", "sourceCutoff", "expiresAt" ], "additionalProperties": false }, "payloadHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "signature": { "type": "string", "pattern": "^[A-Za-z0-9+/]{86}==$" } }, "required": [ "payload", "payloadHash", "signature" ], "additionalProperties": false }, "PersistedTreasuryEvidence": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "persisted-treasury-custody-evidence-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "evidenceId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "recordedBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "verification": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "verified-treasury-custody-evidence-v1" }, "evidence": { "type": "object", "properties": { "payload": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "treasury-custody-evidence-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "projectId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "evidenceId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "relationship": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "evidenceHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion", "evidenceHash" ], "additionalProperties": false }, "provider": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "attestationHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion", "attestationHash" ], "additionalProperties": false }, "observation": { "type": "object", "properties": { "chainId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "genesisHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "token": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "decimals": { "type": "integer", "minimum": 0, "maximum": 36 }, "custodyAccount": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "amountAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "blockNumber": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "blockHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "blockTimestamp": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "finality": { "type": "string", "const": "FINALIZED" } }, "required": [ "chainId", "genesisHash", "token", "decimals", "custodyAccount", "amountAtomic", "blockNumber", "blockHash", "blockTimestamp", "finality" ], "additionalProperties": false }, "observedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "expiresAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "schemaVersion", "organizationId", "projectId", "evidenceId", "relationship", "provider", "observation", "observedAt", "sourceCutoff", "expiresAt" ], "additionalProperties": false }, "payloadHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "signature": { "type": "string", "pattern": "^[A-Za-z0-9+/]{86}==$" } }, "required": [ "payload", "payloadHash", "signature" ], "additionalProperties": false }, "observation": { "type": "object", "properties": { "chainId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "genesisHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "token": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "decimals": { "type": "integer", "minimum": 0, "maximum": 36 }, "custodyAccount": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "amountAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "blockNumber": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "blockHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "blockTimestamp": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "finality": { "type": "string", "const": "FINALIZED" } }, "required": [ "chainId", "genesisHash", "token", "decimals", "custodyAccount", "amountAtomic", "blockNumber", "blockHash", "blockTimestamp", "finality" ], "additionalProperties": false }, "checkedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "authority": { "type": "object", "properties": { "relationship": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "evidenceHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion", "evidenceHash" ], "additionalProperties": false }, "provider": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "attestationHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion", "attestationHash" ], "additionalProperties": false } }, "required": [ "relationship", "provider" ], "additionalProperties": false }, "quorum": { "type": "object", "properties": { "kind": { "type": "string", "const": "CONFIGURED_OPERATOR_MAJORITY" }, "members": { "anyOf": [ { "type": "number", "const": 3 }, { "type": "number", "const": 5 }, { "type": "number", "const": 7 } ] }, "required": { "type": "integer", "minimum": 2, "maximum": 4 } }, "required": [ "kind", "members", "required" ], "additionalProperties": false }, "replayProtection": { "type": "string", "const": "REQUIRES_PERSISTED_EVIDENCE_ID_UNIQUENESS" }, "spendability": { "type": "string", "const": "NOT_ESTABLISHED" }, "financialAuthority": { "type": "boolean", "const": false } }, "required": [ "schemaVersion", "evidence", "observation", "checkedAt", "authority", "quorum", "replayProtection", "spendability", "financialAuthority" ], "additionalProperties": false }, "replayProtection": { "type": "string", "const": "TENANT_EVIDENCE_ID_EXACT_CONTENT" }, "spendability": { "type": "string", "const": "NOT_ESTABLISHED" }, "financialAuthority": { "type": "boolean", "const": false } }, "required": [ "schemaVersion", "organizationId", "evidenceId", "resourceVersion", "recordedAt", "recordedBy", "verification", "replayProtection", "spendability", "financialAuthority" ], "additionalProperties": false }, "TreasuryEvidenceWrite": { "type": "object", "properties": { "record": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "persisted-treasury-custody-evidence-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "evidenceId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "recordedBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "verification": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "verified-treasury-custody-evidence-v1" }, "evidence": { "type": "object", "properties": { "payload": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "treasury-custody-evidence-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "projectId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "evidenceId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "relationship": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "evidenceHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion", "evidenceHash" ], "additionalProperties": false }, "provider": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "attestationHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion", "attestationHash" ], "additionalProperties": false }, "observation": { "type": "object", "properties": { "chainId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "genesisHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "token": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "decimals": { "type": "integer", "minimum": 0, "maximum": 36 }, "custodyAccount": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "amountAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "blockNumber": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "blockHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "blockTimestamp": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "finality": { "type": "string", "const": "FINALIZED" } }, "required": [ "chainId", "genesisHash", "token", "decimals", "custodyAccount", "amountAtomic", "blockNumber", "blockHash", "blockTimestamp", "finality" ], "additionalProperties": false }, "observedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "expiresAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "schemaVersion", "organizationId", "projectId", "evidenceId", "relationship", "provider", "observation", "observedAt", "sourceCutoff", "expiresAt" ], "additionalProperties": false }, "payloadHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "signature": { "type": "string", "pattern": "^[A-Za-z0-9+/]{86}==$" } }, "required": [ "payload", "payloadHash", "signature" ], "additionalProperties": false }, "observation": { "type": "object", "properties": { "chainId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "genesisHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "token": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "decimals": { "type": "integer", "minimum": 0, "maximum": 36 }, "custodyAccount": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "amountAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "blockNumber": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "blockHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "blockTimestamp": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "finality": { "type": "string", "const": "FINALIZED" } }, "required": [ "chainId", "genesisHash", "token", "decimals", "custodyAccount", "amountAtomic", "blockNumber", "blockHash", "blockTimestamp", "finality" ], "additionalProperties": false }, "checkedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "authority": { "type": "object", "properties": { "relationship": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "evidenceHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion", "evidenceHash" ], "additionalProperties": false }, "provider": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "attestationHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion", "attestationHash" ], "additionalProperties": false } }, "required": [ "relationship", "provider" ], "additionalProperties": false }, "quorum": { "type": "object", "properties": { "kind": { "type": "string", "const": "CONFIGURED_OPERATOR_MAJORITY" }, "members": { "anyOf": [ { "type": "number", "const": 3 }, { "type": "number", "const": 5 }, { "type": "number", "const": 7 } ] }, "required": { "type": "integer", "minimum": 2, "maximum": 4 } }, "required": [ "kind", "members", "required" ], "additionalProperties": false }, "replayProtection": { "type": "string", "const": "REQUIRES_PERSISTED_EVIDENCE_ID_UNIQUENESS" }, "spendability": { "type": "string", "const": "NOT_ESTABLISHED" }, "financialAuthority": { "type": "boolean", "const": false } }, "required": [ "schemaVersion", "evidence", "observation", "checkedAt", "authority", "quorum", "replayProtection", "spendability", "financialAuthority" ], "additionalProperties": false }, "replayProtection": { "type": "string", "const": "TENANT_EVIDENCE_ID_EXACT_CONTENT" }, "spendability": { "type": "string", "const": "NOT_ESTABLISHED" }, "financialAuthority": { "type": "boolean", "const": false } }, "required": [ "schemaVersion", "organizationId", "evidenceId", "resourceVersion", "recordedAt", "recordedBy", "verification", "replayProtection", "spendability", "financialAuthority" ], "additionalProperties": false }, "replayed": { "type": "boolean" } }, "required": [ "record", "replayed" ], "additionalProperties": false }, "TreasuryEvidenceList": { "type": "object", "properties": { "records": { "maxItems": 20, "type": "array", "items": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "persisted-treasury-custody-evidence-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "evidenceId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "recordedBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "verification": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "verified-treasury-custody-evidence-v1" }, "evidence": { "type": "object", "properties": { "payload": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "treasury-custody-evidence-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "projectId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "evidenceId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "relationship": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "evidenceHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion", "evidenceHash" ], "additionalProperties": false }, "provider": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "attestationHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion", "attestationHash" ], "additionalProperties": false }, "observation": { "type": "object", "properties": { "chainId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "genesisHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "token": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "decimals": { "type": "integer", "minimum": 0, "maximum": 36 }, "custodyAccount": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "amountAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "blockNumber": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "blockHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "blockTimestamp": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "finality": { "type": "string", "const": "FINALIZED" } }, "required": [ "chainId", "genesisHash", "token", "decimals", "custodyAccount", "amountAtomic", "blockNumber", "blockHash", "blockTimestamp", "finality" ], "additionalProperties": false }, "observedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "expiresAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "schemaVersion", "organizationId", "projectId", "evidenceId", "relationship", "provider", "observation", "observedAt", "sourceCutoff", "expiresAt" ], "additionalProperties": false }, "payloadHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "signature": { "type": "string", "pattern": "^[A-Za-z0-9+/]{86}==$" } }, "required": [ "payload", "payloadHash", "signature" ], "additionalProperties": false }, "observation": { "type": "object", "properties": { "chainId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "genesisHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "token": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "decimals": { "type": "integer", "minimum": 0, "maximum": 36 }, "custodyAccount": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "amountAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "blockNumber": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "blockHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "blockTimestamp": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "finality": { "type": "string", "const": "FINALIZED" } }, "required": [ "chainId", "genesisHash", "token", "decimals", "custodyAccount", "amountAtomic", "blockNumber", "blockHash", "blockTimestamp", "finality" ], "additionalProperties": false }, "checkedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "authority": { "type": "object", "properties": { "relationship": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "evidenceHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion", "evidenceHash" ], "additionalProperties": false }, "provider": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "attestationHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion", "attestationHash" ], "additionalProperties": false } }, "required": [ "relationship", "provider" ], "additionalProperties": false }, "quorum": { "type": "object", "properties": { "kind": { "type": "string", "const": "CONFIGURED_OPERATOR_MAJORITY" }, "members": { "anyOf": [ { "type": "number", "const": 3 }, { "type": "number", "const": 5 }, { "type": "number", "const": 7 } ] }, "required": { "type": "integer", "minimum": 2, "maximum": 4 } }, "required": [ "kind", "members", "required" ], "additionalProperties": false }, "replayProtection": { "type": "string", "const": "REQUIRES_PERSISTED_EVIDENCE_ID_UNIQUENESS" }, "spendability": { "type": "string", "const": "NOT_ESTABLISHED" }, "financialAuthority": { "type": "boolean", "const": false } }, "required": [ "schemaVersion", "evidence", "observation", "checkedAt", "authority", "quorum", "replayProtection", "spendability", "financialAuthority" ], "additionalProperties": false }, "replayProtection": { "type": "string", "const": "TENANT_EVIDENCE_ID_EXACT_CONTENT" }, "spendability": { "type": "string", "const": "NOT_ESTABLISHED" }, "financialAuthority": { "type": "boolean", "const": false } }, "required": [ "schemaVersion", "organizationId", "evidenceId", "resourceVersion", "recordedAt", "recordedBy", "verification", "replayProtection", "spendability", "financialAuthority" ], "additionalProperties": false } }, "nextCursor": { "anyOf": [ { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, { "type": "null" } ] } }, "required": [ "records", "nextCursor" ], "additionalProperties": false }, "ProjectControlIssue": { "type": "object", "properties": { "identity": { "type": "object", "properties": { "payload": { "type": "object", "properties": { "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "projectId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "projectResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "chainId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "genesisHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "token": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "schemaVersion": { "type": "string", "const": "project-identity-attestation-v1" }, "publisher": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion" ], "additionalProperties": false }, "controller": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "issuedAt": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "expiresAt": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "organizationId", "projectId", "projectResourceVersion", "chainId", "genesisHash", "token", "schemaVersion", "publisher", "controller", "issuedAt", "expiresAt" ], "additionalProperties": false }, "payloadHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "signature": { "type": "string", "pattern": "^[A-Za-z0-9+/]{86}==$" } }, "required": [ "payload", "payloadHash", "signature" ], "additionalProperties": false }, "custodyAccount": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" } }, "required": [ "identity", "custodyAccount" ], "additionalProperties": false }, "ProjectControlProof": { "type": "object", "properties": { "challenge": { "type": "object", "properties": { "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "projectId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "projectResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "chainId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "genesisHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "token": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "schemaVersion": { "type": "string", "const": "project-control-challenge-v1" }, "actorId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "controller": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "custodyAccount": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "attestationHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "nonce": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "audience": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "deployment": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "purpose": { "type": "string", "const": "PROJECT_TREASURY_READ_ACCESS_ONLY" }, "issuedAt": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "expiresAt": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "organizationId", "projectId", "projectResourceVersion", "chainId", "genesisHash", "token", "schemaVersion", "actorId", "controller", "custodyAccount", "attestationHash", "nonce", "audience", "deployment", "purpose", "issuedAt", "expiresAt" ], "additionalProperties": false }, "identity": { "type": "object", "properties": { "payload": { "type": "object", "properties": { "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "projectId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "projectResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "chainId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "genesisHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "token": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "schemaVersion": { "type": "string", "const": "project-identity-attestation-v1" }, "publisher": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion" ], "additionalProperties": false }, "controller": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "issuedAt": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "expiresAt": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "organizationId", "projectId", "projectResourceVersion", "chainId", "genesisHash", "token", "schemaVersion", "publisher", "controller", "issuedAt", "expiresAt" ], "additionalProperties": false }, "payloadHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "signature": { "type": "string", "pattern": "^[A-Za-z0-9+/]{86}==$" } }, "required": [ "payload", "payloadHash", "signature" ], "additionalProperties": false }, "controllerSignature": { "type": "string", "pattern": "^0x(?:[0-9a-fA-F]{2}){1,8192}$" }, "custodySignature": { "type": "string", "pattern": "^0x(?:[0-9a-fA-F]{2}){1,8192}$" } }, "required": [ "challenge", "identity", "controllerSignature", "custodySignature" ], "additionalProperties": false }, "PersistedProjectControlChallenge": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "persisted-project-control-challenge-v1" }, "challenge": { "type": "object", "properties": { "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "projectId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "projectResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "chainId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "genesisHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "token": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "schemaVersion": { "type": "string", "const": "project-control-challenge-v1" }, "actorId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "controller": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "custodyAccount": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "attestationHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "nonce": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "audience": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "deployment": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "purpose": { "type": "string", "const": "PROJECT_TREASURY_READ_ACCESS_ONLY" }, "issuedAt": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "expiresAt": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "organizationId", "projectId", "projectResourceVersion", "chainId", "genesisHash", "token", "schemaVersion", "actorId", "controller", "custodyAccount", "attestationHash", "nonce", "audience", "deployment", "purpose", "issuedAt", "expiresAt" ], "additionalProperties": false }, "identity": { "type": "object", "properties": { "payload": { "type": "object", "properties": { "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "projectId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "projectResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "chainId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "genesisHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "token": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "schemaVersion": { "type": "string", "const": "project-identity-attestation-v1" }, "publisher": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion" ], "additionalProperties": false }, "controller": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "issuedAt": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "expiresAt": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "organizationId", "projectId", "projectResourceVersion", "chainId", "genesisHash", "token", "schemaVersion", "publisher", "controller", "issuedAt", "expiresAt" ], "additionalProperties": false }, "payloadHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "signature": { "type": "string", "pattern": "^[A-Za-z0-9+/]{86}==$" } }, "required": [ "payload", "payloadHash", "signature" ], "additionalProperties": false }, "anchor": { "type": "object", "properties": { "chainId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "genesisHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "blockNumber": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "blockHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "finality": { "type": "string", "const": "FINALIZED" } }, "required": [ "chainId", "genesisHash", "blockNumber", "blockHash", "finality" ], "additionalProperties": false }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "schemaVersion", "challenge", "identity", "anchor", "resourceVersion", "recordedAt" ], "additionalProperties": false }, "ProjectControlChallengeWrite": { "type": "object", "properties": { "record": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "persisted-project-control-challenge-v1" }, "challenge": { "type": "object", "properties": { "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "projectId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "projectResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "chainId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "genesisHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "token": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "schemaVersion": { "type": "string", "const": "project-control-challenge-v1" }, "actorId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "controller": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "custodyAccount": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "attestationHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "nonce": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "audience": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "deployment": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "purpose": { "type": "string", "const": "PROJECT_TREASURY_READ_ACCESS_ONLY" }, "issuedAt": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "expiresAt": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "organizationId", "projectId", "projectResourceVersion", "chainId", "genesisHash", "token", "schemaVersion", "actorId", "controller", "custodyAccount", "attestationHash", "nonce", "audience", "deployment", "purpose", "issuedAt", "expiresAt" ], "additionalProperties": false }, "identity": { "type": "object", "properties": { "payload": { "type": "object", "properties": { "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "projectId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "projectResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "chainId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "genesisHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "token": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "schemaVersion": { "type": "string", "const": "project-identity-attestation-v1" }, "publisher": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion" ], "additionalProperties": false }, "controller": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "issuedAt": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "expiresAt": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "organizationId", "projectId", "projectResourceVersion", "chainId", "genesisHash", "token", "schemaVersion", "publisher", "controller", "issuedAt", "expiresAt" ], "additionalProperties": false }, "payloadHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "signature": { "type": "string", "pattern": "^[A-Za-z0-9+/]{86}==$" } }, "required": [ "payload", "payloadHash", "signature" ], "additionalProperties": false }, "anchor": { "type": "object", "properties": { "chainId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "genesisHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "blockNumber": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "blockHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "finality": { "type": "string", "const": "FINALIZED" } }, "required": [ "chainId", "genesisHash", "blockNumber", "blockHash", "finality" ], "additionalProperties": false }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "schemaVersion", "challenge", "identity", "anchor", "resourceVersion", "recordedAt" ], "additionalProperties": false }, "replayed": { "type": "boolean" } }, "required": [ "record", "replayed" ], "additionalProperties": false }, "ProjectControlAcceptance": { "type": "object", "properties": { "relationship": { "type": "object", "properties": { "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "evidenceHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "projectId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "chainId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "genesisHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "custodyAccount": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "status": { "type": "string", "const": "ACTIVE" }, "validFrom": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "validUntil": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "verification": { "type": "string", "const": "PROJECT_AND_CUSTODY_CONTROL" } }, "required": [ "organizationId", "id", "resourceVersion", "evidenceHash", "projectId", "chainId", "genesisHash", "custodyAccount", "status", "validFrom", "validUntil", "verification" ], "additionalProperties": false }, "proofHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "replayed": { "type": "boolean" } }, "required": [ "relationship", "proofHash", "recordedAt", "replayed" ], "additionalProperties": false }, "TreasuryReconciliationPreviewRequest": { "type": "object", "properties": { "mappings": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "ledger": { "type": "object", "properties": { "recordId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "artifactHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "recordId", "resourceVersion", "artifactHash" ], "additionalProperties": false }, "custody": { "type": "object", "properties": { "evidenceId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "evidenceId", "resourceVersion" ], "additionalProperties": false } }, "required": [ "ledger", "custody" ], "additionalProperties": false } } }, "required": [ "mappings" ], "additionalProperties": false }, "TreasuryLedgerReconciliation": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "treasury-ledger-custody-reconciliation-candidate-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "status": { "type": "string", "const": "REVIEW_CANDIDATE" }, "mappings": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "ledger": { "type": "object", "properties": { "recordId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "artifactHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "recordId", "resourceVersion", "artifactHash" ], "additionalProperties": false }, "custody": { "type": "object", "properties": { "evidenceId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "evidenceId", "resourceVersion" ], "additionalProperties": false }, "capitalContainerId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "declaredCustodyLocationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "declaredSource": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "SAFE", "VAULT", "EXTERNAL_MANAGER" ] }, "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, "required": [ "kind", "id" ], "additionalProperties": false }, "unit": { "type": "object", "properties": { "chainId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "genesisHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "asset": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "decimals": { "type": "integer", "minimum": 0, "maximum": 36 } }, "required": [ "chainId", "genesisHash", "asset", "decimals" ], "additionalProperties": false }, "custodyAccount": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "relationship": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "evidenceHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion", "evidenceHash" ], "additionalProperties": false }, "projectId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "block": { "type": "object", "properties": { "number": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "hash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "timestamp": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "number", "hash", "timestamp" ], "additionalProperties": false }, "ledgerAmountAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "observedCustodyAmountAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "unallocatedCustodySurplusAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "ledgerState": { "type": "string", "enum": [ "AVAILABLE", "DEPLOYED", "LOCKED", "AT_RISK", "FEE_GENERATING" ] }, "committedQuoteValuation": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "obligationIds": { "maxItems": 256, "type": "array", "items": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, "disposition": { "type": "string", "const": "PROPOSED_MAPPING_REQUIRES_ADMISSION" } }, "required": [ "ledger", "custody", "capitalContainerId", "declaredCustodyLocationId", "declaredSource", "unit", "custodyAccount", "relationship", "projectId", "block", "ledgerAmountAtomic", "observedCustodyAmountAtomic", "unallocatedCustodySurplusAtomic", "ledgerState", "committedQuoteValuation", "obligationIds", "disposition" ], "additionalProperties": false } }, "sourceBindings": { "type": "object", "properties": { "ledger": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "recordId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "artifactHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "recordId", "resourceVersion", "artifactHash" ], "additionalProperties": false } }, "custody": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "evidenceId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "evidenceId", "resourceVersion" ], "additionalProperties": false } } }, "required": [ "ledger", "custody" ], "additionalProperties": false }, "sourceHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "candidateHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "ledgerConservation": { "type": "object", "properties": { "scope": { "type": "string", "const": "SUPPLIED_IMMUTABLE_ENTRIES_ONLY" }, "ledgerVersion": { "type": "string", "enum": [ "treasury-ledger-v1", "treasury-ledger-v2" ] }, "conserved": { "type": "boolean", "const": true }, "commitment": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "scope", "ledgerVersion", "conserved", "commitment" ], "additionalProperties": false }, "omittedLedgerEntryIds": { "maxItems": 256, "type": "array", "items": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, "omittedCustodyEvidenceIds": { "maxItems": 256, "type": "array", "items": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, "limitations": { "type": "array", "prefixItems": [ { "type": "string", "const": "MAPPING_IS_AN_ASSERTION_NOT_VERIFIED_LEGACY_CUSTODY_IDENTITY" }, { "type": "string", "const": "CURRENT_SOURCE_AUTHORITY_REQUIRES_ADMISSION_RECHECK" }, { "type": "string", "const": "UNALLOCATED_CUSTODY_SURPLUS_IS_EXCLUDED" }, { "type": "string", "const": "OMITTED_ACCOUNTS_AND_EXPENSES_ARE_UNKNOWN" }, { "type": "string", "const": "QUOTE_COMMITMENT_VALUES_ARE_NOT_TOKEN_OBLIGATION_AMOUNTS" }, { "type": "string", "const": "BLOCK_BALANCE_IS_NOT_AN_END_OF_DAY_SNAPSHOT" }, { "type": "string", "const": "RESTRICTIONS_AND_DATED_RECEIPTS_OBLIGATIONS_REQUIRE_SEPARATE_EVIDENCE" } ] }, "spendability": { "type": "string", "const": "NOT_ESTABLISHED" }, "expenseCoverage": { "type": "string", "const": "UNKNOWN" }, "financialAuthority": { "type": "boolean", "const": false } }, "required": [ "schemaVersion", "organizationId", "sourceCutoff", "status", "mappings", "sourceBindings", "sourceHash", "candidateHash", "ledgerConservation", "omittedLedgerEntryIds", "omittedCustodyEvidenceIds", "limitations", "spendability", "expenseCoverage", "financialAuthority" ], "additionalProperties": false }, "SavedTreasuryReconciliation": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "treasury-reconciliation-draft-v1" }, "organizationId": { "type": "string", "minLength": 1 }, "id": { "type": "string", "pattern": "^reconciliation_[0-9a-f]{32}$" }, "sequence": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "state": { "type": "string", "enum": [ "DRAFT", "ACKNOWLEDGED" ] }, "candidate": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "treasury-ledger-custody-reconciliation-candidate-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "status": { "type": "string", "const": "REVIEW_CANDIDATE" }, "mappings": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "ledger": { "type": "object", "properties": { "recordId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "artifactHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "recordId", "resourceVersion", "artifactHash" ], "additionalProperties": false }, "custody": { "type": "object", "properties": { "evidenceId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "evidenceId", "resourceVersion" ], "additionalProperties": false }, "capitalContainerId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "declaredCustodyLocationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "declaredSource": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "SAFE", "VAULT", "EXTERNAL_MANAGER" ] }, "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, "required": [ "kind", "id" ], "additionalProperties": false }, "unit": { "type": "object", "properties": { "chainId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "genesisHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "asset": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "decimals": { "type": "integer", "minimum": 0, "maximum": 36 } }, "required": [ "chainId", "genesisHash", "asset", "decimals" ], "additionalProperties": false }, "custodyAccount": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "relationship": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "evidenceHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion", "evidenceHash" ], "additionalProperties": false }, "projectId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "block": { "type": "object", "properties": { "number": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "hash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "timestamp": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "number", "hash", "timestamp" ], "additionalProperties": false }, "ledgerAmountAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "observedCustodyAmountAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "unallocatedCustodySurplusAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "ledgerState": { "type": "string", "enum": [ "AVAILABLE", "DEPLOYED", "LOCKED", "AT_RISK", "FEE_GENERATING" ] }, "committedQuoteValuation": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "obligationIds": { "maxItems": 256, "type": "array", "items": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, "disposition": { "type": "string", "const": "PROPOSED_MAPPING_REQUIRES_ADMISSION" } }, "required": [ "ledger", "custody", "capitalContainerId", "declaredCustodyLocationId", "declaredSource", "unit", "custodyAccount", "relationship", "projectId", "block", "ledgerAmountAtomic", "observedCustodyAmountAtomic", "unallocatedCustodySurplusAtomic", "ledgerState", "committedQuoteValuation", "obligationIds", "disposition" ], "additionalProperties": false } }, "sourceBindings": { "type": "object", "properties": { "ledger": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "recordId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "artifactHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "recordId", "resourceVersion", "artifactHash" ], "additionalProperties": false } }, "custody": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "evidenceId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "evidenceId", "resourceVersion" ], "additionalProperties": false } } }, "required": [ "ledger", "custody" ], "additionalProperties": false }, "sourceHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "candidateHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "ledgerConservation": { "type": "object", "properties": { "scope": { "type": "string", "const": "SUPPLIED_IMMUTABLE_ENTRIES_ONLY" }, "ledgerVersion": { "type": "string", "enum": [ "treasury-ledger-v1", "treasury-ledger-v2" ] }, "conserved": { "type": "boolean", "const": true }, "commitment": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "scope", "ledgerVersion", "conserved", "commitment" ], "additionalProperties": false }, "omittedLedgerEntryIds": { "maxItems": 256, "type": "array", "items": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, "omittedCustodyEvidenceIds": { "maxItems": 256, "type": "array", "items": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, "limitations": { "type": "array", "prefixItems": [ { "type": "string", "const": "MAPPING_IS_AN_ASSERTION_NOT_VERIFIED_LEGACY_CUSTODY_IDENTITY" }, { "type": "string", "const": "CURRENT_SOURCE_AUTHORITY_REQUIRES_ADMISSION_RECHECK" }, { "type": "string", "const": "UNALLOCATED_CUSTODY_SURPLUS_IS_EXCLUDED" }, { "type": "string", "const": "OMITTED_ACCOUNTS_AND_EXPENSES_ARE_UNKNOWN" }, { "type": "string", "const": "QUOTE_COMMITMENT_VALUES_ARE_NOT_TOKEN_OBLIGATION_AMOUNTS" }, { "type": "string", "const": "BLOCK_BALANCE_IS_NOT_AN_END_OF_DAY_SNAPSHOT" }, { "type": "string", "const": "RESTRICTIONS_AND_DATED_RECEIPTS_OBLIGATIONS_REQUIRE_SEPARATE_EVIDENCE" } ] }, "spendability": { "type": "string", "const": "NOT_ESTABLISHED" }, "expenseCoverage": { "type": "string", "const": "UNKNOWN" }, "financialAuthority": { "type": "boolean", "const": false } }, "required": [ "schemaVersion", "organizationId", "sourceCutoff", "status", "mappings", "sourceBindings", "sourceHash", "candidateHash", "ledgerConservation", "omittedLedgerEntryIds", "omittedCustodyEvidenceIds", "limitations", "spendability", "expenseCoverage", "financialAuthority" ], "additionalProperties": false }, "createdBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "acknowledgment": { "anyOf": [ { "type": "object", "properties": { "recordedBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "recordedBy", "recordedAt" ], "additionalProperties": false }, { "type": "null" } ] }, "spendability": { "type": "string", "const": "NOT_ESTABLISHED" }, "financialAuthority": { "type": "boolean", "const": false } }, "required": [ "schemaVersion", "organizationId", "id", "sequence", "resourceVersion", "state", "candidate", "createdBy", "createdAt", "recordedAt", "acknowledgment", "spendability", "financialAuthority" ], "additionalProperties": false }, "TreasuryReconciliationWrite": { "type": "object", "properties": { "record": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "treasury-reconciliation-draft-v1" }, "organizationId": { "type": "string", "minLength": 1 }, "id": { "type": "string", "pattern": "^reconciliation_[0-9a-f]{32}$" }, "sequence": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "state": { "type": "string", "enum": [ "DRAFT", "ACKNOWLEDGED" ] }, "candidate": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "treasury-ledger-custody-reconciliation-candidate-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "status": { "type": "string", "const": "REVIEW_CANDIDATE" }, "mappings": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "ledger": { "type": "object", "properties": { "recordId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "artifactHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "recordId", "resourceVersion", "artifactHash" ], "additionalProperties": false }, "custody": { "type": "object", "properties": { "evidenceId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "evidenceId", "resourceVersion" ], "additionalProperties": false }, "capitalContainerId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "declaredCustodyLocationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "declaredSource": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "SAFE", "VAULT", "EXTERNAL_MANAGER" ] }, "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, "required": [ "kind", "id" ], "additionalProperties": false }, "unit": { "type": "object", "properties": { "chainId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "genesisHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "asset": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "decimals": { "type": "integer", "minimum": 0, "maximum": 36 } }, "required": [ "chainId", "genesisHash", "asset", "decimals" ], "additionalProperties": false }, "custodyAccount": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "relationship": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "evidenceHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion", "evidenceHash" ], "additionalProperties": false }, "projectId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "block": { "type": "object", "properties": { "number": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "hash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "timestamp": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "number", "hash", "timestamp" ], "additionalProperties": false }, "ledgerAmountAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "observedCustodyAmountAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "unallocatedCustodySurplusAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "ledgerState": { "type": "string", "enum": [ "AVAILABLE", "DEPLOYED", "LOCKED", "AT_RISK", "FEE_GENERATING" ] }, "committedQuoteValuation": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "obligationIds": { "maxItems": 256, "type": "array", "items": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, "disposition": { "type": "string", "const": "PROPOSED_MAPPING_REQUIRES_ADMISSION" } }, "required": [ "ledger", "custody", "capitalContainerId", "declaredCustodyLocationId", "declaredSource", "unit", "custodyAccount", "relationship", "projectId", "block", "ledgerAmountAtomic", "observedCustodyAmountAtomic", "unallocatedCustodySurplusAtomic", "ledgerState", "committedQuoteValuation", "obligationIds", "disposition" ], "additionalProperties": false } }, "sourceBindings": { "type": "object", "properties": { "ledger": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "recordId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "artifactHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "recordId", "resourceVersion", "artifactHash" ], "additionalProperties": false } }, "custody": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "evidenceId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "evidenceId", "resourceVersion" ], "additionalProperties": false } } }, "required": [ "ledger", "custody" ], "additionalProperties": false }, "sourceHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "candidateHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "ledgerConservation": { "type": "object", "properties": { "scope": { "type": "string", "const": "SUPPLIED_IMMUTABLE_ENTRIES_ONLY" }, "ledgerVersion": { "type": "string", "enum": [ "treasury-ledger-v1", "treasury-ledger-v2" ] }, "conserved": { "type": "boolean", "const": true }, "commitment": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "scope", "ledgerVersion", "conserved", "commitment" ], "additionalProperties": false }, "omittedLedgerEntryIds": { "maxItems": 256, "type": "array", "items": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, "omittedCustodyEvidenceIds": { "maxItems": 256, "type": "array", "items": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, "limitations": { "type": "array", "prefixItems": [ { "type": "string", "const": "MAPPING_IS_AN_ASSERTION_NOT_VERIFIED_LEGACY_CUSTODY_IDENTITY" }, { "type": "string", "const": "CURRENT_SOURCE_AUTHORITY_REQUIRES_ADMISSION_RECHECK" }, { "type": "string", "const": "UNALLOCATED_CUSTODY_SURPLUS_IS_EXCLUDED" }, { "type": "string", "const": "OMITTED_ACCOUNTS_AND_EXPENSES_ARE_UNKNOWN" }, { "type": "string", "const": "QUOTE_COMMITMENT_VALUES_ARE_NOT_TOKEN_OBLIGATION_AMOUNTS" }, { "type": "string", "const": "BLOCK_BALANCE_IS_NOT_AN_END_OF_DAY_SNAPSHOT" }, { "type": "string", "const": "RESTRICTIONS_AND_DATED_RECEIPTS_OBLIGATIONS_REQUIRE_SEPARATE_EVIDENCE" } ] }, "spendability": { "type": "string", "const": "NOT_ESTABLISHED" }, "expenseCoverage": { "type": "string", "const": "UNKNOWN" }, "financialAuthority": { "type": "boolean", "const": false } }, "required": [ "schemaVersion", "organizationId", "sourceCutoff", "status", "mappings", "sourceBindings", "sourceHash", "candidateHash", "ledgerConservation", "omittedLedgerEntryIds", "omittedCustodyEvidenceIds", "limitations", "spendability", "expenseCoverage", "financialAuthority" ], "additionalProperties": false }, "createdBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "acknowledgment": { "anyOf": [ { "type": "object", "properties": { "recordedBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "recordedBy", "recordedAt" ], "additionalProperties": false }, { "type": "null" } ] }, "spendability": { "type": "string", "const": "NOT_ESTABLISHED" }, "financialAuthority": { "type": "boolean", "const": false } }, "required": [ "schemaVersion", "organizationId", "id", "sequence", "resourceVersion", "state", "candidate", "createdBy", "createdAt", "recordedAt", "acknowledgment", "spendability", "financialAuthority" ], "additionalProperties": false }, "replayed": { "type": "boolean" } }, "required": [ "record", "replayed" ], "additionalProperties": false }, "TreasuryReconciliationList": { "type": "object", "properties": { "items": { "maxItems": 20, "type": "array", "items": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "treasury-reconciliation-draft-v1" }, "organizationId": { "type": "string", "minLength": 1 }, "id": { "type": "string", "pattern": "^reconciliation_[0-9a-f]{32}$" }, "sequence": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "state": { "type": "string", "enum": [ "DRAFT", "ACKNOWLEDGED" ] }, "candidate": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "treasury-ledger-custody-reconciliation-candidate-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "status": { "type": "string", "const": "REVIEW_CANDIDATE" }, "mappings": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "ledger": { "type": "object", "properties": { "recordId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "artifactHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "recordId", "resourceVersion", "artifactHash" ], "additionalProperties": false }, "custody": { "type": "object", "properties": { "evidenceId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "evidenceId", "resourceVersion" ], "additionalProperties": false }, "capitalContainerId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "declaredCustodyLocationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "declaredSource": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "SAFE", "VAULT", "EXTERNAL_MANAGER" ] }, "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, "required": [ "kind", "id" ], "additionalProperties": false }, "unit": { "type": "object", "properties": { "chainId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "genesisHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "asset": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "decimals": { "type": "integer", "minimum": 0, "maximum": 36 } }, "required": [ "chainId", "genesisHash", "asset", "decimals" ], "additionalProperties": false }, "custodyAccount": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "relationship": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "evidenceHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion", "evidenceHash" ], "additionalProperties": false }, "projectId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "block": { "type": "object", "properties": { "number": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "hash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "timestamp": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "number", "hash", "timestamp" ], "additionalProperties": false }, "ledgerAmountAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "observedCustodyAmountAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "unallocatedCustodySurplusAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "ledgerState": { "type": "string", "enum": [ "AVAILABLE", "DEPLOYED", "LOCKED", "AT_RISK", "FEE_GENERATING" ] }, "committedQuoteValuation": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "obligationIds": { "maxItems": 256, "type": "array", "items": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, "disposition": { "type": "string", "const": "PROPOSED_MAPPING_REQUIRES_ADMISSION" } }, "required": [ "ledger", "custody", "capitalContainerId", "declaredCustodyLocationId", "declaredSource", "unit", "custodyAccount", "relationship", "projectId", "block", "ledgerAmountAtomic", "observedCustodyAmountAtomic", "unallocatedCustodySurplusAtomic", "ledgerState", "committedQuoteValuation", "obligationIds", "disposition" ], "additionalProperties": false } }, "sourceBindings": { "type": "object", "properties": { "ledger": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "recordId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "artifactHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "recordId", "resourceVersion", "artifactHash" ], "additionalProperties": false } }, "custody": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "evidenceId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "evidenceId", "resourceVersion" ], "additionalProperties": false } } }, "required": [ "ledger", "custody" ], "additionalProperties": false }, "sourceHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "candidateHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "ledgerConservation": { "type": "object", "properties": { "scope": { "type": "string", "const": "SUPPLIED_IMMUTABLE_ENTRIES_ONLY" }, "ledgerVersion": { "type": "string", "enum": [ "treasury-ledger-v1", "treasury-ledger-v2" ] }, "conserved": { "type": "boolean", "const": true }, "commitment": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "scope", "ledgerVersion", "conserved", "commitment" ], "additionalProperties": false }, "omittedLedgerEntryIds": { "maxItems": 256, "type": "array", "items": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, "omittedCustodyEvidenceIds": { "maxItems": 256, "type": "array", "items": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, "limitations": { "type": "array", "prefixItems": [ { "type": "string", "const": "MAPPING_IS_AN_ASSERTION_NOT_VERIFIED_LEGACY_CUSTODY_IDENTITY" }, { "type": "string", "const": "CURRENT_SOURCE_AUTHORITY_REQUIRES_ADMISSION_RECHECK" }, { "type": "string", "const": "UNALLOCATED_CUSTODY_SURPLUS_IS_EXCLUDED" }, { "type": "string", "const": "OMITTED_ACCOUNTS_AND_EXPENSES_ARE_UNKNOWN" }, { "type": "string", "const": "QUOTE_COMMITMENT_VALUES_ARE_NOT_TOKEN_OBLIGATION_AMOUNTS" }, { "type": "string", "const": "BLOCK_BALANCE_IS_NOT_AN_END_OF_DAY_SNAPSHOT" }, { "type": "string", "const": "RESTRICTIONS_AND_DATED_RECEIPTS_OBLIGATIONS_REQUIRE_SEPARATE_EVIDENCE" } ] }, "spendability": { "type": "string", "const": "NOT_ESTABLISHED" }, "expenseCoverage": { "type": "string", "const": "UNKNOWN" }, "financialAuthority": { "type": "boolean", "const": false } }, "required": [ "schemaVersion", "organizationId", "sourceCutoff", "status", "mappings", "sourceBindings", "sourceHash", "candidateHash", "ledgerConservation", "omittedLedgerEntryIds", "omittedCustodyEvidenceIds", "limitations", "spendability", "expenseCoverage", "financialAuthority" ], "additionalProperties": false }, "createdBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "acknowledgment": { "anyOf": [ { "type": "object", "properties": { "recordedBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "recordedBy", "recordedAt" ], "additionalProperties": false }, { "type": "null" } ] }, "spendability": { "type": "string", "const": "NOT_ESTABLISHED" }, "financialAuthority": { "type": "boolean", "const": false } }, "required": [ "schemaVersion", "organizationId", "id", "sequence", "resourceVersion", "state", "candidate", "createdBy", "createdAt", "recordedAt", "acknowledgment", "spendability", "financialAuthority" ], "additionalProperties": false } }, "nextCursor": { "anyOf": [ { "type": "string", "pattern": "^reconciliation_[0-9a-f]{32}$" }, { "type": "null" } ] } }, "required": [ "items", "nextCursor" ], "additionalProperties": false }, "TreasuryReconciliationHistory": { "type": "object", "properties": { "items": { "maxItems": 20, "type": "array", "items": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "treasury-reconciliation-draft-v1" }, "organizationId": { "type": "string", "minLength": 1 }, "id": { "type": "string", "pattern": "^reconciliation_[0-9a-f]{32}$" }, "sequence": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "state": { "type": "string", "enum": [ "DRAFT", "ACKNOWLEDGED" ] }, "candidate": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "treasury-ledger-custody-reconciliation-candidate-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "status": { "type": "string", "const": "REVIEW_CANDIDATE" }, "mappings": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "ledger": { "type": "object", "properties": { "recordId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "artifactHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "recordId", "resourceVersion", "artifactHash" ], "additionalProperties": false }, "custody": { "type": "object", "properties": { "evidenceId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "evidenceId", "resourceVersion" ], "additionalProperties": false }, "capitalContainerId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "declaredCustodyLocationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "declaredSource": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "SAFE", "VAULT", "EXTERNAL_MANAGER" ] }, "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, "required": [ "kind", "id" ], "additionalProperties": false }, "unit": { "type": "object", "properties": { "chainId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "genesisHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "asset": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "decimals": { "type": "integer", "minimum": 0, "maximum": 36 } }, "required": [ "chainId", "genesisHash", "asset", "decimals" ], "additionalProperties": false }, "custodyAccount": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "relationship": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "evidenceHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion", "evidenceHash" ], "additionalProperties": false }, "projectId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "block": { "type": "object", "properties": { "number": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "hash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "timestamp": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "number", "hash", "timestamp" ], "additionalProperties": false }, "ledgerAmountAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "observedCustodyAmountAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "unallocatedCustodySurplusAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "ledgerState": { "type": "string", "enum": [ "AVAILABLE", "DEPLOYED", "LOCKED", "AT_RISK", "FEE_GENERATING" ] }, "committedQuoteValuation": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "obligationIds": { "maxItems": 256, "type": "array", "items": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, "disposition": { "type": "string", "const": "PROPOSED_MAPPING_REQUIRES_ADMISSION" } }, "required": [ "ledger", "custody", "capitalContainerId", "declaredCustodyLocationId", "declaredSource", "unit", "custodyAccount", "relationship", "projectId", "block", "ledgerAmountAtomic", "observedCustodyAmountAtomic", "unallocatedCustodySurplusAtomic", "ledgerState", "committedQuoteValuation", "obligationIds", "disposition" ], "additionalProperties": false } }, "sourceBindings": { "type": "object", "properties": { "ledger": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "recordId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "artifactHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "recordId", "resourceVersion", "artifactHash" ], "additionalProperties": false } }, "custody": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "evidenceId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "evidenceId", "resourceVersion" ], "additionalProperties": false } } }, "required": [ "ledger", "custody" ], "additionalProperties": false }, "sourceHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "candidateHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "ledgerConservation": { "type": "object", "properties": { "scope": { "type": "string", "const": "SUPPLIED_IMMUTABLE_ENTRIES_ONLY" }, "ledgerVersion": { "type": "string", "enum": [ "treasury-ledger-v1", "treasury-ledger-v2" ] }, "conserved": { "type": "boolean", "const": true }, "commitment": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "scope", "ledgerVersion", "conserved", "commitment" ], "additionalProperties": false }, "omittedLedgerEntryIds": { "maxItems": 256, "type": "array", "items": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, "omittedCustodyEvidenceIds": { "maxItems": 256, "type": "array", "items": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, "limitations": { "type": "array", "prefixItems": [ { "type": "string", "const": "MAPPING_IS_AN_ASSERTION_NOT_VERIFIED_LEGACY_CUSTODY_IDENTITY" }, { "type": "string", "const": "CURRENT_SOURCE_AUTHORITY_REQUIRES_ADMISSION_RECHECK" }, { "type": "string", "const": "UNALLOCATED_CUSTODY_SURPLUS_IS_EXCLUDED" }, { "type": "string", "const": "OMITTED_ACCOUNTS_AND_EXPENSES_ARE_UNKNOWN" }, { "type": "string", "const": "QUOTE_COMMITMENT_VALUES_ARE_NOT_TOKEN_OBLIGATION_AMOUNTS" }, { "type": "string", "const": "BLOCK_BALANCE_IS_NOT_AN_END_OF_DAY_SNAPSHOT" }, { "type": "string", "const": "RESTRICTIONS_AND_DATED_RECEIPTS_OBLIGATIONS_REQUIRE_SEPARATE_EVIDENCE" } ] }, "spendability": { "type": "string", "const": "NOT_ESTABLISHED" }, "expenseCoverage": { "type": "string", "const": "UNKNOWN" }, "financialAuthority": { "type": "boolean", "const": false } }, "required": [ "schemaVersion", "organizationId", "sourceCutoff", "status", "mappings", "sourceBindings", "sourceHash", "candidateHash", "ledgerConservation", "omittedLedgerEntryIds", "omittedCustodyEvidenceIds", "limitations", "spendability", "expenseCoverage", "financialAuthority" ], "additionalProperties": false }, "createdBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "acknowledgment": { "anyOf": [ { "type": "object", "properties": { "recordedBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "recordedBy", "recordedAt" ], "additionalProperties": false }, { "type": "null" } ] }, "spendability": { "type": "string", "const": "NOT_ESTABLISHED" }, "financialAuthority": { "type": "boolean", "const": false } }, "required": [ "schemaVersion", "organizationId", "id", "sequence", "resourceVersion", "state", "candidate", "createdBy", "createdAt", "recordedAt", "acknowledgment", "spendability", "financialAuthority" ], "additionalProperties": false } }, "nextCursor": { "anyOf": [ { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" }, { "type": "null" } ] } }, "required": [ "items", "nextCursor" ], "additionalProperties": false }, "TreasuryAssumptionsCreate": { "type": "object", "properties": { "reconciliation": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^reconciliation_[0-9a-f]{32}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion" ], "additionalProperties": false }, "ledgerEntryIds": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, "assumptions": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1, "maxLength": 200 }, "obligations": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "economicKey": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "label": { "type": "string", "minLength": 1, "maxLength": 2000 }, "totalAmountAtomic": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "installments": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "dueDay": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "amountAtomic": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" } }, "required": [ "id", "dueDay", "amountAtomic" ], "additionalProperties": false } } }, "required": [ "id", "economicKey", "label", "totalAmountAtomic", "installments" ], "additionalProperties": false } }, "conditionalInflows": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "economicKey": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "label": { "type": "string", "minLength": 1, "maxLength": 2000 }, "expectedDay": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "amountAtomic": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "condition": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "id", "economicKey", "label", "expectedDay", "amountAtomic", "condition" ], "additionalProperties": false } }, "allocations": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "economicKey": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "label": { "type": "string", "minLength": 1, "maxLength": 2000 }, "day": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "amountAtomic": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" } }, "required": [ "id", "economicKey", "label", "day", "amountAtomic" ], "additionalProperties": false } }, "ledgerObligationCoverage": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "ledgerObligationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "relation": { "type": "string", "enum": [ "SCHEDULED_HERE", "DECLARED_ALREADY_DEDUCTED", "UNRESOLVED" ] }, "scheduleIds": { "maxItems": 256, "type": "array", "items": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, "note": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "ledgerObligationId", "relation", "scheduleIds", "note" ], "additionalProperties": false } }, "expenseCoverage": { "type": "object", "properties": { "declaration": { "type": "string", "enum": [ "DECLARED_COMPLETE", "DECLARED_PARTIAL", "UNKNOWN" ] }, "omittedCategories": { "maxItems": 64, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "note": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "declaration", "omittedCategories", "note" ], "additionalProperties": false } }, "required": [ "title", "obligations", "conditionalInflows", "allocations", "ledgerObligationCoverage", "expenseCoverage" ], "additionalProperties": false } }, "required": [ "reconciliation", "ledgerEntryIds", "assumptions" ], "additionalProperties": false }, "TreasuryAssumptionsRevision": { "type": "object", "properties": { "assumptions": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1, "maxLength": 200 }, "obligations": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "economicKey": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "label": { "type": "string", "minLength": 1, "maxLength": 2000 }, "totalAmountAtomic": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "installments": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "dueDay": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "amountAtomic": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" } }, "required": [ "id", "dueDay", "amountAtomic" ], "additionalProperties": false } } }, "required": [ "id", "economicKey", "label", "totalAmountAtomic", "installments" ], "additionalProperties": false } }, "conditionalInflows": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "economicKey": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "label": { "type": "string", "minLength": 1, "maxLength": 2000 }, "expectedDay": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "amountAtomic": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "condition": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "id", "economicKey", "label", "expectedDay", "amountAtomic", "condition" ], "additionalProperties": false } }, "allocations": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "economicKey": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "label": { "type": "string", "minLength": 1, "maxLength": 2000 }, "day": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "amountAtomic": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" } }, "required": [ "id", "economicKey", "label", "day", "amountAtomic" ], "additionalProperties": false } }, "ledgerObligationCoverage": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "ledgerObligationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "relation": { "type": "string", "enum": [ "SCHEDULED_HERE", "DECLARED_ALREADY_DEDUCTED", "UNRESOLVED" ] }, "scheduleIds": { "maxItems": 256, "type": "array", "items": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, "note": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "ledgerObligationId", "relation", "scheduleIds", "note" ], "additionalProperties": false } }, "expenseCoverage": { "type": "object", "properties": { "declaration": { "type": "string", "enum": [ "DECLARED_COMPLETE", "DECLARED_PARTIAL", "UNKNOWN" ] }, "omittedCategories": { "maxItems": 64, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "note": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "declaration", "omittedCategories", "note" ], "additionalProperties": false } }, "required": [ "title", "obligations", "conditionalInflows", "allocations", "ledgerObligationCoverage", "expenseCoverage" ], "additionalProperties": false } }, "required": [ "assumptions" ], "additionalProperties": false }, "TreasuryAssumptions": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "treasury-dated-assumptions-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "id": { "type": "string", "pattern": "^treasury_assumptions_[0-9a-f]{32}$" }, "sequence": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "reconciliation": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^reconciliation_[0-9a-f]{32}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion" ], "additionalProperties": false }, "ledgerEntryIds": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, "unit": { "type": "object", "properties": { "chainId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "genesisHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "asset": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "decimals": { "type": "integer", "minimum": 0, "maximum": 36 } }, "required": [ "chainId", "genesisHash", "asset", "decimals" ], "additionalProperties": false }, "assumptions": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1, "maxLength": 200 }, "obligations": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "economicKey": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "label": { "type": "string", "minLength": 1, "maxLength": 2000 }, "totalAmountAtomic": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "installments": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "dueDay": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "amountAtomic": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" } }, "required": [ "id", "dueDay", "amountAtomic" ], "additionalProperties": false } } }, "required": [ "id", "economicKey", "label", "totalAmountAtomic", "installments" ], "additionalProperties": false } }, "conditionalInflows": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "economicKey": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "label": { "type": "string", "minLength": 1, "maxLength": 2000 }, "expectedDay": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "amountAtomic": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "condition": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "id", "economicKey", "label", "expectedDay", "amountAtomic", "condition" ], "additionalProperties": false } }, "allocations": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "economicKey": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "label": { "type": "string", "minLength": 1, "maxLength": 2000 }, "day": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "amountAtomic": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" } }, "required": [ "id", "economicKey", "label", "day", "amountAtomic" ], "additionalProperties": false } }, "ledgerObligationCoverage": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "ledgerObligationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "relation": { "type": "string", "enum": [ "SCHEDULED_HERE", "DECLARED_ALREADY_DEDUCTED", "UNRESOLVED" ] }, "scheduleIds": { "maxItems": 256, "type": "array", "items": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, "note": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "ledgerObligationId", "relation", "scheduleIds", "note" ], "additionalProperties": false } }, "expenseCoverage": { "type": "object", "properties": { "declaration": { "type": "string", "enum": [ "DECLARED_COMPLETE", "DECLARED_PARTIAL", "UNKNOWN" ] }, "omittedCategories": { "maxItems": 64, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "note": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "declaration", "omittedCategories", "note" ], "additionalProperties": false } }, "required": [ "title", "obligations", "conditionalInflows", "allocations", "ledgerObligationCoverage", "expenseCoverage" ], "additionalProperties": false }, "provenance": { "type": "string", "const": "ISSUER_DECLARED_UNVERIFIED" }, "verifiedExpenseCoverage": { "type": "string", "const": "UNKNOWN" }, "createdBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "recordedBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "spendability": { "type": "string", "const": "NOT_ESTABLISHED" }, "financialAuthority": { "type": "boolean", "const": false } }, "required": [ "schemaVersion", "organizationId", "id", "sequence", "resourceVersion", "reconciliation", "ledgerEntryIds", "unit", "assumptions", "provenance", "verifiedExpenseCoverage", "createdBy", "createdAt", "recordedBy", "recordedAt", "spendability", "financialAuthority" ], "additionalProperties": false }, "TreasuryAssumptionsWrite": { "type": "object", "properties": { "record": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "treasury-dated-assumptions-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "id": { "type": "string", "pattern": "^treasury_assumptions_[0-9a-f]{32}$" }, "sequence": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "reconciliation": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^reconciliation_[0-9a-f]{32}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion" ], "additionalProperties": false }, "ledgerEntryIds": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, "unit": { "type": "object", "properties": { "chainId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "genesisHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "asset": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "decimals": { "type": "integer", "minimum": 0, "maximum": 36 } }, "required": [ "chainId", "genesisHash", "asset", "decimals" ], "additionalProperties": false }, "assumptions": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1, "maxLength": 200 }, "obligations": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "economicKey": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "label": { "type": "string", "minLength": 1, "maxLength": 2000 }, "totalAmountAtomic": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "installments": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "dueDay": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "amountAtomic": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" } }, "required": [ "id", "dueDay", "amountAtomic" ], "additionalProperties": false } } }, "required": [ "id", "economicKey", "label", "totalAmountAtomic", "installments" ], "additionalProperties": false } }, "conditionalInflows": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "economicKey": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "label": { "type": "string", "minLength": 1, "maxLength": 2000 }, "expectedDay": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "amountAtomic": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "condition": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "id", "economicKey", "label", "expectedDay", "amountAtomic", "condition" ], "additionalProperties": false } }, "allocations": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "economicKey": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "label": { "type": "string", "minLength": 1, "maxLength": 2000 }, "day": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "amountAtomic": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" } }, "required": [ "id", "economicKey", "label", "day", "amountAtomic" ], "additionalProperties": false } }, "ledgerObligationCoverage": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "ledgerObligationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "relation": { "type": "string", "enum": [ "SCHEDULED_HERE", "DECLARED_ALREADY_DEDUCTED", "UNRESOLVED" ] }, "scheduleIds": { "maxItems": 256, "type": "array", "items": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, "note": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "ledgerObligationId", "relation", "scheduleIds", "note" ], "additionalProperties": false } }, "expenseCoverage": { "type": "object", "properties": { "declaration": { "type": "string", "enum": [ "DECLARED_COMPLETE", "DECLARED_PARTIAL", "UNKNOWN" ] }, "omittedCategories": { "maxItems": 64, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "note": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "declaration", "omittedCategories", "note" ], "additionalProperties": false } }, "required": [ "title", "obligations", "conditionalInflows", "allocations", "ledgerObligationCoverage", "expenseCoverage" ], "additionalProperties": false }, "provenance": { "type": "string", "const": "ISSUER_DECLARED_UNVERIFIED" }, "verifiedExpenseCoverage": { "type": "string", "const": "UNKNOWN" }, "createdBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "recordedBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "spendability": { "type": "string", "const": "NOT_ESTABLISHED" }, "financialAuthority": { "type": "boolean", "const": false } }, "required": [ "schemaVersion", "organizationId", "id", "sequence", "resourceVersion", "reconciliation", "ledgerEntryIds", "unit", "assumptions", "provenance", "verifiedExpenseCoverage", "createdBy", "createdAt", "recordedBy", "recordedAt", "spendability", "financialAuthority" ], "additionalProperties": false }, "replayed": { "type": "boolean" } }, "required": [ "record", "replayed" ], "additionalProperties": false }, "TreasuryAssumptionsList": { "type": "object", "properties": { "items": { "maxItems": 20, "type": "array", "items": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "treasury-dated-assumptions-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "id": { "type": "string", "pattern": "^treasury_assumptions_[0-9a-f]{32}$" }, "sequence": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "reconciliation": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^reconciliation_[0-9a-f]{32}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion" ], "additionalProperties": false }, "ledgerEntryIds": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, "unit": { "type": "object", "properties": { "chainId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "genesisHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "asset": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "decimals": { "type": "integer", "minimum": 0, "maximum": 36 } }, "required": [ "chainId", "genesisHash", "asset", "decimals" ], "additionalProperties": false }, "assumptions": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1, "maxLength": 200 }, "obligations": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "economicKey": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "label": { "type": "string", "minLength": 1, "maxLength": 2000 }, "totalAmountAtomic": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "installments": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "dueDay": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "amountAtomic": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" } }, "required": [ "id", "dueDay", "amountAtomic" ], "additionalProperties": false } } }, "required": [ "id", "economicKey", "label", "totalAmountAtomic", "installments" ], "additionalProperties": false } }, "conditionalInflows": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "economicKey": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "label": { "type": "string", "minLength": 1, "maxLength": 2000 }, "expectedDay": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "amountAtomic": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "condition": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "id", "economicKey", "label", "expectedDay", "amountAtomic", "condition" ], "additionalProperties": false } }, "allocations": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "economicKey": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "label": { "type": "string", "minLength": 1, "maxLength": 2000 }, "day": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "amountAtomic": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" } }, "required": [ "id", "economicKey", "label", "day", "amountAtomic" ], "additionalProperties": false } }, "ledgerObligationCoverage": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "ledgerObligationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "relation": { "type": "string", "enum": [ "SCHEDULED_HERE", "DECLARED_ALREADY_DEDUCTED", "UNRESOLVED" ] }, "scheduleIds": { "maxItems": 256, "type": "array", "items": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, "note": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "ledgerObligationId", "relation", "scheduleIds", "note" ], "additionalProperties": false } }, "expenseCoverage": { "type": "object", "properties": { "declaration": { "type": "string", "enum": [ "DECLARED_COMPLETE", "DECLARED_PARTIAL", "UNKNOWN" ] }, "omittedCategories": { "maxItems": 64, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "note": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "declaration", "omittedCategories", "note" ], "additionalProperties": false } }, "required": [ "title", "obligations", "conditionalInflows", "allocations", "ledgerObligationCoverage", "expenseCoverage" ], "additionalProperties": false }, "provenance": { "type": "string", "const": "ISSUER_DECLARED_UNVERIFIED" }, "verifiedExpenseCoverage": { "type": "string", "const": "UNKNOWN" }, "createdBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "recordedBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "spendability": { "type": "string", "const": "NOT_ESTABLISHED" }, "financialAuthority": { "type": "boolean", "const": false } }, "required": [ "schemaVersion", "organizationId", "id", "sequence", "resourceVersion", "reconciliation", "ledgerEntryIds", "unit", "assumptions", "provenance", "verifiedExpenseCoverage", "createdBy", "createdAt", "recordedBy", "recordedAt", "spendability", "financialAuthority" ], "additionalProperties": false } }, "nextCursor": { "anyOf": [ { "type": "string", "pattern": "^treasury_assumptions_[0-9a-f]{32}$" }, { "type": "null" } ] } }, "required": [ "items", "nextCursor" ], "additionalProperties": false }, "TreasuryAssumptionsHistory": { "type": "object", "properties": { "items": { "maxItems": 20, "type": "array", "items": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "treasury-dated-assumptions-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "id": { "type": "string", "pattern": "^treasury_assumptions_[0-9a-f]{32}$" }, "sequence": { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "reconciliation": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^reconciliation_[0-9a-f]{32}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion" ], "additionalProperties": false }, "ledgerEntryIds": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, "unit": { "type": "object", "properties": { "chainId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "genesisHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "asset": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "decimals": { "type": "integer", "minimum": 0, "maximum": 36 } }, "required": [ "chainId", "genesisHash", "asset", "decimals" ], "additionalProperties": false }, "assumptions": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1, "maxLength": 200 }, "obligations": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "economicKey": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "label": { "type": "string", "minLength": 1, "maxLength": 2000 }, "totalAmountAtomic": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "installments": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "dueDay": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "amountAtomic": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" } }, "required": [ "id", "dueDay", "amountAtomic" ], "additionalProperties": false } } }, "required": [ "id", "economicKey", "label", "totalAmountAtomic", "installments" ], "additionalProperties": false } }, "conditionalInflows": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "economicKey": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "label": { "type": "string", "minLength": 1, "maxLength": 2000 }, "expectedDay": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "amountAtomic": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "condition": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "id", "economicKey", "label", "expectedDay", "amountAtomic", "condition" ], "additionalProperties": false } }, "allocations": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "economicKey": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "label": { "type": "string", "minLength": 1, "maxLength": 2000 }, "day": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "amountAtomic": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" } }, "required": [ "id", "economicKey", "label", "day", "amountAtomic" ], "additionalProperties": false } }, "ledgerObligationCoverage": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "ledgerObligationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "relation": { "type": "string", "enum": [ "SCHEDULED_HERE", "DECLARED_ALREADY_DEDUCTED", "UNRESOLVED" ] }, "scheduleIds": { "maxItems": 256, "type": "array", "items": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" } }, "note": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "ledgerObligationId", "relation", "scheduleIds", "note" ], "additionalProperties": false } }, "expenseCoverage": { "type": "object", "properties": { "declaration": { "type": "string", "enum": [ "DECLARED_COMPLETE", "DECLARED_PARTIAL", "UNKNOWN" ] }, "omittedCategories": { "maxItems": 64, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "note": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "declaration", "omittedCategories", "note" ], "additionalProperties": false } }, "required": [ "title", "obligations", "conditionalInflows", "allocations", "ledgerObligationCoverage", "expenseCoverage" ], "additionalProperties": false }, "provenance": { "type": "string", "const": "ISSUER_DECLARED_UNVERIFIED" }, "verifiedExpenseCoverage": { "type": "string", "const": "UNKNOWN" }, "createdBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "recordedBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "spendability": { "type": "string", "const": "NOT_ESTABLISHED" }, "financialAuthority": { "type": "boolean", "const": false } }, "required": [ "schemaVersion", "organizationId", "id", "sequence", "resourceVersion", "reconciliation", "ledgerEntryIds", "unit", "assumptions", "provenance", "verifiedExpenseCoverage", "createdBy", "createdAt", "recordedBy", "recordedAt", "spendability", "financialAuthority" ], "additionalProperties": false } }, "nextCursor": { "anyOf": [ { "type": "string", "pattern": "^[1-9][0-9]{0,17}$" }, { "type": "null" } ] } }, "required": [ "items", "nextCursor" ], "additionalProperties": false }, "TreasuryProjectionCreate": { "type": "object", "properties": { "assumptions": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^treasury_assumptions_[0-9a-f]{32}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion" ], "additionalProperties": false }, "throughDay": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "restrictions": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "ledgerEntryId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "restrictedAmountAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "reason": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "ledgerEntryId", "restrictedAmountAtomic", "reason" ], "additionalProperties": false } }, "confirmation": { "type": "string", "const": "UNPAID_SCHEDULES_AND_RESTRICTIONS_EXCLUDE_THEM" } }, "required": [ "assumptions", "throughDay", "restrictions", "confirmation" ], "additionalProperties": false }, "TreasuryProjection": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "treasury-declared-projection-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "id": { "type": "string", "pattern": "^treasury_projection_[0-9a-f]{32}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "request": { "type": "object", "properties": { "assumptions": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^treasury_assumptions_[0-9a-f]{32}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion" ], "additionalProperties": false }, "throughDay": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "restrictions": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "ledgerEntryId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "restrictedAmountAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "reason": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "ledgerEntryId", "restrictedAmountAtomic", "reason" ], "additionalProperties": false } }, "confirmation": { "type": "string", "const": "UNPAID_SCHEDULES_AND_RESTRICTIONS_EXCLUDE_THEM" } }, "required": [ "assumptions", "throughDay", "restrictions", "confirmation" ], "additionalProperties": false }, "result": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "treasury-snapshot-projection-model-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "assumptions": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^treasury_assumptions_[0-9a-f]{32}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion" ], "additionalProperties": false }, "reconciliation": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^reconciliation_[0-9a-f]{32}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion" ], "additionalProperties": false }, "request": { "type": "object", "properties": { "assumptions": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^treasury_assumptions_[0-9a-f]{32}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion" ], "additionalProperties": false }, "throughDay": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "restrictions": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "ledgerEntryId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "restrictedAmountAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "reason": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "ledgerEntryId", "restrictedAmountAtomic", "reason" ], "additionalProperties": false } }, "confirmation": { "type": "string", "const": "UNPAID_SCHEDULES_AND_RESTRICTIONS_EXCLUDE_THEM" } }, "required": [ "assumptions", "throughDay", "restrictions", "confirmation" ], "additionalProperties": false }, "sourceBlock": { "type": "object", "properties": { "number": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "hash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "timestamp": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "number", "hash", "timestamp" ], "additionalProperties": false }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "unit": { "type": "object", "properties": { "chainId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "genesisHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "asset": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "decimals": { "type": "integer", "minimum": 0, "maximum": 36 } }, "required": [ "chainId", "genesisHash", "asset", "decimals" ], "additionalProperties": false }, "openingDay": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "throughDay": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "opening": { "type": "object", "properties": { "availableMappedAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,80})$" }, "declaredRestrictedAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,80})$" }, "scenarioBalanceAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,80})$" } }, "required": [ "availableMappedAtomic", "declaredRestrictedAtomic", "scenarioBalanceAtomic" ], "additionalProperties": false }, "selectedMappings": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "ledgerEntryId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "ledgerResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "custodyEvidenceId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "custodyResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "ledgerState": { "type": "string", "enum": [ "AVAILABLE", "DEPLOYED", "LOCKED", "AT_RISK", "FEE_GENERATING" ] }, "ledgerAmountAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "declaredRestrictedAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "restrictionReason": { "type": "string", "minLength": 1, "maxLength": 2000 }, "includedInOpening": { "type": "boolean" }, "disposition": { "type": "string", "enum": [ "AVAILABLE_DECLARED_SCENARIO", "NON_AVAILABLE_EXCLUDED" ] } }, "required": [ "ledgerEntryId", "ledgerResourceVersion", "custodyEvidenceId", "custodyResourceVersion", "ledgerState", "ledgerAmountAtomic", "declaredRestrictedAtomic", "restrictionReason", "includedInOpening", "disposition" ], "additionalProperties": false } }, "timeline": { "minItems": 1, "maxItems": 365, "type": "array", "items": { "type": "object", "properties": { "day": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "actualInflowsAtomic": { "type": "string", "const": "0" }, "obligationsAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,80})$" }, "allocationsAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,80})$" }, "conditionalInflowsAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,80})$" }, "closingBaselineAtomic": { "type": "string", "pattern": "^(0|-?[1-9][0-9]{0,80})$" }, "cumulativeConditionalAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,80})$" }, "closingConditionalScenarioAtomic": { "type": "string", "pattern": "^(0|-?[1-9][0-9]{0,80})$" } }, "required": [ "day", "actualInflowsAtomic", "obligationsAtomic", "allocationsAtomic", "conditionalInflowsAtomic", "closingBaselineAtomic", "cumulativeConditionalAtomic", "closingConditionalScenarioAtomic" ], "additionalProperties": false } }, "excludedEvents": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "kind": { "type": "string", "enum": [ "OBLIGATION", "ALLOCATION", "CONDITIONAL_INFLOW" ] }, "day": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "amountAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "reason": { "type": "string", "const": "AFTER_HORIZON" } }, "required": [ "id", "kind", "day", "amountAtomic", "reason" ], "additionalProperties": false } }, "firstShortfallDay": { "anyOf": [ { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, { "type": "null" } ] }, "minimumBaselineAtomic": { "type": "string", "pattern": "^(0|-?[1-9][0-9]{0,80})$" }, "closingBaselineAtomic": { "type": "string", "pattern": "^(0|-?[1-9][0-9]{0,80})$" }, "conditionalInflowsAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,80})$" }, "closingConditionalScenarioAtomic": { "type": "string", "pattern": "^(0|-?[1-9][0-9]{0,80})$" }, "declaredExpenseCoverage": { "type": "object", "properties": { "declaration": { "type": "string", "enum": [ "DECLARED_COMPLETE", "DECLARED_PARTIAL", "UNKNOWN" ] }, "omittedCategories": { "maxItems": 64, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "note": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "declaration", "omittedCategories", "note" ], "additionalProperties": false }, "provenance": { "type": "string", "const": "DECLARED_SCENARIO" }, "verifiedExpenseCoverage": { "type": "string", "const": "UNKNOWN" }, "spendability": { "type": "string", "const": "NOT_ESTABLISHED" }, "financialAuthority": { "type": "boolean", "const": false }, "limitations": { "minItems": 9, "maxItems": 9, "type": "array", "items": { "type": "string", "enum": [ "ISSUER_DECLARATIONS_ARE_NOT_VERIFIED_SPENDABILITY", "EXPENSE_COMPLETENESS_REMAINS_UNKNOWN", "SNAPSHOT_DAY_UNPAID_OUTFLOWS_ARE_INCLUDED", "DAILY_BUCKETS_DO_NOT_ESTABLISH_INTRADAY_SOLVENCY", "CONDITIONAL_INCOME_IS_NOT_SETTLED_CASH", "UNALLOCATED_CUSTODY_SURPLUS_IS_EXCLUDED", "NON_AVAILABLE_LEDGER_BALANCES_ARE_EXCLUDED", "RESTRICTIONS_ARE_DECLARED_SEPARATELY_FROM_SCHEDULES", "HISTORICAL_SOURCES_DO_NOT_ESTABLISH_CURRENT_APPLICABILITY" ] } }, "modelHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "schemaVersion", "organizationId", "assumptions", "reconciliation", "request", "sourceBlock", "sourceCutoff", "unit", "openingDay", "throughDay", "opening", "selectedMappings", "timeline", "excludedEvents", "firstShortfallDay", "minimumBaselineAtomic", "closingBaselineAtomic", "conditionalInflowsAtomic", "closingConditionalScenarioAtomic", "declaredExpenseCoverage", "provenance", "verifiedExpenseCoverage", "spendability", "financialAuthority", "limitations", "modelHash" ], "additionalProperties": false }, "sourceHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "createdBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "spendability": { "type": "string", "const": "NOT_ESTABLISHED" }, "financialAuthority": { "type": "boolean", "const": false } }, "required": [ "schemaVersion", "organizationId", "id", "resourceVersion", "request", "result", "sourceHash", "createdBy", "createdAt", "spendability", "financialAuthority" ], "additionalProperties": false }, "TreasuryProjectionWrite": { "type": "object", "properties": { "record": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "treasury-declared-projection-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "id": { "type": "string", "pattern": "^treasury_projection_[0-9a-f]{32}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "request": { "type": "object", "properties": { "assumptions": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^treasury_assumptions_[0-9a-f]{32}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion" ], "additionalProperties": false }, "throughDay": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "restrictions": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "ledgerEntryId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "restrictedAmountAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "reason": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "ledgerEntryId", "restrictedAmountAtomic", "reason" ], "additionalProperties": false } }, "confirmation": { "type": "string", "const": "UNPAID_SCHEDULES_AND_RESTRICTIONS_EXCLUDE_THEM" } }, "required": [ "assumptions", "throughDay", "restrictions", "confirmation" ], "additionalProperties": false }, "result": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "treasury-snapshot-projection-model-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "assumptions": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^treasury_assumptions_[0-9a-f]{32}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion" ], "additionalProperties": false }, "reconciliation": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^reconciliation_[0-9a-f]{32}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion" ], "additionalProperties": false }, "request": { "type": "object", "properties": { "assumptions": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^treasury_assumptions_[0-9a-f]{32}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion" ], "additionalProperties": false }, "throughDay": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "restrictions": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "ledgerEntryId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "restrictedAmountAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "reason": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "ledgerEntryId", "restrictedAmountAtomic", "reason" ], "additionalProperties": false } }, "confirmation": { "type": "string", "const": "UNPAID_SCHEDULES_AND_RESTRICTIONS_EXCLUDE_THEM" } }, "required": [ "assumptions", "throughDay", "restrictions", "confirmation" ], "additionalProperties": false }, "sourceBlock": { "type": "object", "properties": { "number": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "hash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "timestamp": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "number", "hash", "timestamp" ], "additionalProperties": false }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "unit": { "type": "object", "properties": { "chainId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "genesisHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "asset": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "decimals": { "type": "integer", "minimum": 0, "maximum": 36 } }, "required": [ "chainId", "genesisHash", "asset", "decimals" ], "additionalProperties": false }, "openingDay": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "throughDay": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "opening": { "type": "object", "properties": { "availableMappedAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,80})$" }, "declaredRestrictedAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,80})$" }, "scenarioBalanceAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,80})$" } }, "required": [ "availableMappedAtomic", "declaredRestrictedAtomic", "scenarioBalanceAtomic" ], "additionalProperties": false }, "selectedMappings": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "ledgerEntryId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "ledgerResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "custodyEvidenceId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "custodyResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "ledgerState": { "type": "string", "enum": [ "AVAILABLE", "DEPLOYED", "LOCKED", "AT_RISK", "FEE_GENERATING" ] }, "ledgerAmountAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "declaredRestrictedAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "restrictionReason": { "type": "string", "minLength": 1, "maxLength": 2000 }, "includedInOpening": { "type": "boolean" }, "disposition": { "type": "string", "enum": [ "AVAILABLE_DECLARED_SCENARIO", "NON_AVAILABLE_EXCLUDED" ] } }, "required": [ "ledgerEntryId", "ledgerResourceVersion", "custodyEvidenceId", "custodyResourceVersion", "ledgerState", "ledgerAmountAtomic", "declaredRestrictedAtomic", "restrictionReason", "includedInOpening", "disposition" ], "additionalProperties": false } }, "timeline": { "minItems": 1, "maxItems": 365, "type": "array", "items": { "type": "object", "properties": { "day": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "actualInflowsAtomic": { "type": "string", "const": "0" }, "obligationsAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,80})$" }, "allocationsAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,80})$" }, "conditionalInflowsAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,80})$" }, "closingBaselineAtomic": { "type": "string", "pattern": "^(0|-?[1-9][0-9]{0,80})$" }, "cumulativeConditionalAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,80})$" }, "closingConditionalScenarioAtomic": { "type": "string", "pattern": "^(0|-?[1-9][0-9]{0,80})$" } }, "required": [ "day", "actualInflowsAtomic", "obligationsAtomic", "allocationsAtomic", "conditionalInflowsAtomic", "closingBaselineAtomic", "cumulativeConditionalAtomic", "closingConditionalScenarioAtomic" ], "additionalProperties": false } }, "excludedEvents": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "kind": { "type": "string", "enum": [ "OBLIGATION", "ALLOCATION", "CONDITIONAL_INFLOW" ] }, "day": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "amountAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "reason": { "type": "string", "const": "AFTER_HORIZON" } }, "required": [ "id", "kind", "day", "amountAtomic", "reason" ], "additionalProperties": false } }, "firstShortfallDay": { "anyOf": [ { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, { "type": "null" } ] }, "minimumBaselineAtomic": { "type": "string", "pattern": "^(0|-?[1-9][0-9]{0,80})$" }, "closingBaselineAtomic": { "type": "string", "pattern": "^(0|-?[1-9][0-9]{0,80})$" }, "conditionalInflowsAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,80})$" }, "closingConditionalScenarioAtomic": { "type": "string", "pattern": "^(0|-?[1-9][0-9]{0,80})$" }, "declaredExpenseCoverage": { "type": "object", "properties": { "declaration": { "type": "string", "enum": [ "DECLARED_COMPLETE", "DECLARED_PARTIAL", "UNKNOWN" ] }, "omittedCategories": { "maxItems": 64, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "note": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "declaration", "omittedCategories", "note" ], "additionalProperties": false }, "provenance": { "type": "string", "const": "DECLARED_SCENARIO" }, "verifiedExpenseCoverage": { "type": "string", "const": "UNKNOWN" }, "spendability": { "type": "string", "const": "NOT_ESTABLISHED" }, "financialAuthority": { "type": "boolean", "const": false }, "limitations": { "minItems": 9, "maxItems": 9, "type": "array", "items": { "type": "string", "enum": [ "ISSUER_DECLARATIONS_ARE_NOT_VERIFIED_SPENDABILITY", "EXPENSE_COMPLETENESS_REMAINS_UNKNOWN", "SNAPSHOT_DAY_UNPAID_OUTFLOWS_ARE_INCLUDED", "DAILY_BUCKETS_DO_NOT_ESTABLISH_INTRADAY_SOLVENCY", "CONDITIONAL_INCOME_IS_NOT_SETTLED_CASH", "UNALLOCATED_CUSTODY_SURPLUS_IS_EXCLUDED", "NON_AVAILABLE_LEDGER_BALANCES_ARE_EXCLUDED", "RESTRICTIONS_ARE_DECLARED_SEPARATELY_FROM_SCHEDULES", "HISTORICAL_SOURCES_DO_NOT_ESTABLISH_CURRENT_APPLICABILITY" ] } }, "modelHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "schemaVersion", "organizationId", "assumptions", "reconciliation", "request", "sourceBlock", "sourceCutoff", "unit", "openingDay", "throughDay", "opening", "selectedMappings", "timeline", "excludedEvents", "firstShortfallDay", "minimumBaselineAtomic", "closingBaselineAtomic", "conditionalInflowsAtomic", "closingConditionalScenarioAtomic", "declaredExpenseCoverage", "provenance", "verifiedExpenseCoverage", "spendability", "financialAuthority", "limitations", "modelHash" ], "additionalProperties": false }, "sourceHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "createdBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "spendability": { "type": "string", "const": "NOT_ESTABLISHED" }, "financialAuthority": { "type": "boolean", "const": false } }, "required": [ "schemaVersion", "organizationId", "id", "resourceVersion", "request", "result", "sourceHash", "createdBy", "createdAt", "spendability", "financialAuthority" ], "additionalProperties": false }, "replayed": { "type": "boolean" } }, "required": [ "record", "replayed" ], "additionalProperties": false }, "TreasuryProjectionList": { "type": "object", "properties": { "items": { "maxItems": 20, "type": "array", "items": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "treasury-declared-projection-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "id": { "type": "string", "pattern": "^treasury_projection_[0-9a-f]{32}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "request": { "type": "object", "properties": { "assumptions": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^treasury_assumptions_[0-9a-f]{32}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion" ], "additionalProperties": false }, "throughDay": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "restrictions": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "ledgerEntryId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "restrictedAmountAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "reason": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "ledgerEntryId", "restrictedAmountAtomic", "reason" ], "additionalProperties": false } }, "confirmation": { "type": "string", "const": "UNPAID_SCHEDULES_AND_RESTRICTIONS_EXCLUDE_THEM" } }, "required": [ "assumptions", "throughDay", "restrictions", "confirmation" ], "additionalProperties": false }, "result": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "treasury-snapshot-projection-model-v1" }, "organizationId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "assumptions": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^treasury_assumptions_[0-9a-f]{32}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion" ], "additionalProperties": false }, "reconciliation": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^reconciliation_[0-9a-f]{32}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion" ], "additionalProperties": false }, "request": { "type": "object", "properties": { "assumptions": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^treasury_assumptions_[0-9a-f]{32}$" }, "resourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "id", "resourceVersion" ], "additionalProperties": false }, "throughDay": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "restrictions": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "ledgerEntryId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "restrictedAmountAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "reason": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "ledgerEntryId", "restrictedAmountAtomic", "reason" ], "additionalProperties": false } }, "confirmation": { "type": "string", "const": "UNPAID_SCHEDULES_AND_RESTRICTIONS_EXCLUDE_THEM" } }, "required": [ "assumptions", "throughDay", "restrictions", "confirmation" ], "additionalProperties": false }, "sourceBlock": { "type": "object", "properties": { "number": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "hash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "timestamp": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "number", "hash", "timestamp" ], "additionalProperties": false }, "sourceCutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "unit": { "type": "object", "properties": { "chainId": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "genesisHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "asset": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "decimals": { "type": "integer", "minimum": 0, "maximum": 36 } }, "required": [ "chainId", "genesisHash", "asset", "decimals" ], "additionalProperties": false }, "openingDay": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "throughDay": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "opening": { "type": "object", "properties": { "availableMappedAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,80})$" }, "declaredRestrictedAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,80})$" }, "scenarioBalanceAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,80})$" } }, "required": [ "availableMappedAtomic", "declaredRestrictedAtomic", "scenarioBalanceAtomic" ], "additionalProperties": false }, "selectedMappings": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "ledgerEntryId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "ledgerResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "custodyEvidenceId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "custodyResourceVersion": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "ledgerState": { "type": "string", "enum": [ "AVAILABLE", "DEPLOYED", "LOCKED", "AT_RISK", "FEE_GENERATING" ] }, "ledgerAmountAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "declaredRestrictedAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "restrictionReason": { "type": "string", "minLength": 1, "maxLength": 2000 }, "includedInOpening": { "type": "boolean" }, "disposition": { "type": "string", "enum": [ "AVAILABLE_DECLARED_SCENARIO", "NON_AVAILABLE_EXCLUDED" ] } }, "required": [ "ledgerEntryId", "ledgerResourceVersion", "custodyEvidenceId", "custodyResourceVersion", "ledgerState", "ledgerAmountAtomic", "declaredRestrictedAtomic", "restrictionReason", "includedInOpening", "disposition" ], "additionalProperties": false } }, "timeline": { "minItems": 1, "maxItems": 365, "type": "array", "items": { "type": "object", "properties": { "day": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "actualInflowsAtomic": { "type": "string", "const": "0" }, "obligationsAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,80})$" }, "allocationsAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,80})$" }, "conditionalInflowsAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,80})$" }, "closingBaselineAtomic": { "type": "string", "pattern": "^(0|-?[1-9][0-9]{0,80})$" }, "cumulativeConditionalAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,80})$" }, "closingConditionalScenarioAtomic": { "type": "string", "pattern": "^(0|-?[1-9][0-9]{0,80})$" } }, "required": [ "day", "actualInflowsAtomic", "obligationsAtomic", "allocationsAtomic", "conditionalInflowsAtomic", "closingBaselineAtomic", "cumulativeConditionalAtomic", "closingConditionalScenarioAtomic" ], "additionalProperties": false } }, "excludedEvents": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$" }, "kind": { "type": "string", "enum": [ "OBLIGATION", "ALLOCATION", "CONDITIONAL_INFLOW" ] }, "day": { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, "amountAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "reason": { "type": "string", "const": "AFTER_HORIZON" } }, "required": [ "id", "kind", "day", "amountAtomic", "reason" ], "additionalProperties": false } }, "firstShortfallDay": { "anyOf": [ { "type": "string", "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$" }, { "type": "null" } ] }, "minimumBaselineAtomic": { "type": "string", "pattern": "^(0|-?[1-9][0-9]{0,80})$" }, "closingBaselineAtomic": { "type": "string", "pattern": "^(0|-?[1-9][0-9]{0,80})$" }, "conditionalInflowsAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,80})$" }, "closingConditionalScenarioAtomic": { "type": "string", "pattern": "^(0|-?[1-9][0-9]{0,80})$" }, "declaredExpenseCoverage": { "type": "object", "properties": { "declaration": { "type": "string", "enum": [ "DECLARED_COMPLETE", "DECLARED_PARTIAL", "UNKNOWN" ] }, "omittedCategories": { "maxItems": 64, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "note": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "declaration", "omittedCategories", "note" ], "additionalProperties": false }, "provenance": { "type": "string", "const": "DECLARED_SCENARIO" }, "verifiedExpenseCoverage": { "type": "string", "const": "UNKNOWN" }, "spendability": { "type": "string", "const": "NOT_ESTABLISHED" }, "financialAuthority": { "type": "boolean", "const": false }, "limitations": { "minItems": 9, "maxItems": 9, "type": "array", "items": { "type": "string", "enum": [ "ISSUER_DECLARATIONS_ARE_NOT_VERIFIED_SPENDABILITY", "EXPENSE_COMPLETENESS_REMAINS_UNKNOWN", "SNAPSHOT_DAY_UNPAID_OUTFLOWS_ARE_INCLUDED", "DAILY_BUCKETS_DO_NOT_ESTABLISH_INTRADAY_SOLVENCY", "CONDITIONAL_INCOME_IS_NOT_SETTLED_CASH", "UNALLOCATED_CUSTODY_SURPLUS_IS_EXCLUDED", "NON_AVAILABLE_LEDGER_BALANCES_ARE_EXCLUDED", "RESTRICTIONS_ARE_DECLARED_SEPARATELY_FROM_SCHEDULES", "HISTORICAL_SOURCES_DO_NOT_ESTABLISH_CURRENT_APPLICABILITY" ] } }, "modelHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" } }, "required": [ "schemaVersion", "organizationId", "assumptions", "reconciliation", "request", "sourceBlock", "sourceCutoff", "unit", "openingDay", "throughDay", "opening", "selectedMappings", "timeline", "excludedEvents", "firstShortfallDay", "minimumBaselineAtomic", "closingBaselineAtomic", "conditionalInflowsAtomic", "closingConditionalScenarioAtomic", "declaredExpenseCoverage", "provenance", "verifiedExpenseCoverage", "spendability", "financialAuthority", "limitations", "modelHash" ], "additionalProperties": false }, "sourceHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "createdBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "spendability": { "type": "string", "const": "NOT_ESTABLISHED" }, "financialAuthority": { "type": "boolean", "const": false } }, "required": [ "schemaVersion", "organizationId", "id", "resourceVersion", "request", "result", "sourceHash", "createdBy", "createdAt", "spendability", "financialAuthority" ], "additionalProperties": false } }, "nextCursor": { "anyOf": [ { "type": "string", "pattern": "^treasury_projection_[0-9a-f]{32}$" }, { "type": "null" } ] } }, "required": [ "items", "nextCursor" ], "additionalProperties": false }, "MarketDiscoveryProject": { "type": "object", "properties": { "id": { "type": "integer", "minimum": 1 }, "name": { "type": "string", "maxLength": 200 }, "symbol": { "type": "string", "maxLength": 100 }, "chain": { "type": "string", "maxLength": 40 }, "address": { "anyOf": [ { "type": "string", "maxLength": 150 }, { "type": "null" } ] }, "imageUrl": { "anyOf": [ { "type": "string", "maxLength": 2048, "format": "uri", "description": "HTTPS Virtuals CDN image, if available." }, { "type": "null" } ] }, "url": { "type": "string", "maxLength": 2048, "description": "Canonical Virtuals project URL." } }, "required": [ "id", "name", "symbol", "chain", "address", "imageUrl", "url" ], "additionalProperties": false }, "MarketDiscoverySearch": { "type": "object", "properties": { "projects": { "type": "array", "items": { "$ref": "#/components/schemas/MarketDiscoveryProject" }, "maxItems": 12 }, "page": { "type": "integer", "minimum": 1, "maximum": 100 }, "hasMore": { "type": "boolean" } }, "required": [ "projects", "page", "hasMore" ], "additionalProperties": false }, "MarketDiscoveryPool": { "type": "object", "properties": { "id": { "type": "string", "maxLength": 80, "minLength": 1 }, "venue": { "type": "string", "maxLength": 80 }, "address": { "type": "string", "maxLength": 150, "minLength": 1 }, "quote": { "type": "string", "maxLength": 80 }, "priceUsd": { "anyOf": [ { "type": "number", "minimum": 0 }, { "type": "null" } ], "description": "Provider-reported approximate market figure. This is not an exact atomic balance or a finalized chain proof." }, "liquidityUsd": { "anyOf": [ { "type": "number", "minimum": 0 }, { "type": "null" } ], "description": "Provider-reported approximate market figure. This is not an exact atomic balance or a finalized chain proof." }, "volume24hUsd": { "anyOf": [ { "type": "number", "minimum": 0 }, { "type": "null" } ], "description": "Provider-reported approximate market figure. This is not an exact atomic balance or a finalized chain proof." }, "priceChange24hPercent": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "buys24h": { "anyOf": [ { "type": "number", "minimum": 0 }, { "type": "null" } ] }, "sells24h": { "anyOf": [ { "type": "number", "minimum": 0 }, { "type": "null" } ] }, "url": { "type": "string", "maxLength": 2048 } }, "required": [ "id", "venue", "address", "quote", "priceUsd", "liquidityUsd", "volume24hUsd", "priceChange24hPercent", "buys24h", "sells24h", "url" ], "additionalProperties": false }, "WorkflowVaultSnapshot": { "type": "object", "properties": { "id": { "type": "string", "maxLength": 160, "minLength": 1 }, "chainId": { "type": "integer", "minimum": 1 }, "capturedAt": { "type": "string", "format": "date-time" }, "blockNumber": { "type": "string", "pattern": "^[0-9]+$", "maxLength": 78 }, "blockHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "tokenBalance": { "type": "string", "pattern": "^[0-9]+(?:\\.[0-9]+)?$", "maxLength": 120, "description": "Exact decimal token units at the recorded snapshot; not USD or current spendable funds." }, "quoteBalance": { "type": "string", "pattern": "^[0-9]+(?:\\.[0-9]+)?$", "maxLength": 120, "description": "Exact decimal token units at the recorded snapshot; not USD or current spendable funds." }, "deployedTokenBalance": { "type": "string", "pattern": "^[0-9]+(?:\\.[0-9]+)?$", "maxLength": 120, "description": "Exact decimal token units at the recorded snapshot; not USD or current spendable funds." }, "deployedQuoteBalance": { "type": "string", "pattern": "^[0-9]+(?:\\.[0-9]+)?$", "maxLength": 120, "description": "Exact decimal token units at the recorded snapshot; not USD or current spendable funds." }, "protectedQuoteReserve": { "type": "string", "pattern": "^[0-9]+(?:\\.[0-9]+)?$", "maxLength": 120, "description": "Exact decimal token units at the recorded snapshot; not USD or current spendable funds." }, "quoteSymbol": { "type": "string", "maxLength": 100 }, "positions": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "paused": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, "required": [ "id", "chainId", "capturedAt", "blockNumber", "blockHash", "tokenBalance", "quoteBalance", "deployedTokenBalance", "deployedQuoteBalance", "protectedQuoteReserve", "quoteSymbol", "positions", "paused" ], "additionalProperties": false }, "WorkflowVaultContext": { "type": "object", "properties": { "vaultId": { "type": "string", "maxLength": 128, "minLength": 1 }, "name": { "type": "string", "maxLength": 200 }, "lifecycle": { "type": "string", "maxLength": 80 }, "mode": { "type": "string", "maxLength": 80 }, "projectToken": { "type": "string", "maxLength": 150 }, "quoteToken": { "type": "string", "maxLength": 150 }, "snapshot": { "anyOf": [ { "$ref": "#/components/schemas/WorkflowVaultSnapshot" }, { "type": "null" } ] }, "limitation": { "type": "string", "maxLength": 1500 } }, "required": [ "vaultId", "name", "lifecycle", "mode", "projectToken", "quoteToken", "snapshot", "limitation" ], "additionalProperties": false }, "MarketDiscoveryEvidence": { "type": "object", "properties": { "project": { "$ref": "#/components/schemas/MarketDiscoveryProject" }, "retrievedAt": { "type": "string", "format": "date-time" }, "pools": { "type": "array", "items": { "$ref": "#/components/schemas/MarketDiscoveryPool" }, "maxItems": 500 }, "metrics": { "type": "object", "properties": { "priceUsd": { "anyOf": [ { "type": "number", "minimum": 0 }, { "type": "null" } ], "description": "Provider-reported approximate market figure. This is not an exact atomic balance or a finalized chain proof." }, "liquidityUsd": { "anyOf": [ { "type": "number", "minimum": 0 }, { "type": "null" } ], "description": "Provider-reported approximate market figure. This is not an exact atomic balance or a finalized chain proof." }, "volume24hUsd": { "anyOf": [ { "type": "number", "minimum": 0 }, { "type": "null" } ], "description": "Provider-reported approximate market figure. This is not an exact atomic balance or a finalized chain proof." }, "priceChange24hPercent": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "largestPoolSharePercent": { "anyOf": [ { "type": "number", "minimum": 0, "maximum": 100 }, { "type": "null" } ] } }, "required": [ "priceUsd", "liquidityUsd", "volume24hUsd", "priceChange24hPercent", "largestPoolSharePercent" ], "additionalProperties": false }, "sources": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "maxLength": 80, "minLength": 1 }, "label": { "type": "string", "maxLength": 300 }, "url": { "type": "string", "maxLength": 2048 } }, "required": [ "id", "label", "url" ], "additionalProperties": false }, "maxItems": 502 }, "gaps": { "type": "array", "items": { "type": "string", "maxLength": 1500 }, "maxItems": 32 }, "workspace": { "$ref": "#/components/schemas/WorkflowVaultContext" } }, "required": [ "project", "retrievedAt", "pools", "metrics", "sources", "gaps" ], "additionalProperties": false }, "MarketDiscoveryCapabilities": { "type": "object", "properties": { "model": { "type": "string" }, "configured": { "type": "boolean" }, "access": { "const": "AUTHENTICATED_WORKSPACE" }, "execution": { "const": "READ_ONLY" } }, "required": [ "model", "configured", "access", "execution" ], "additionalProperties": false }, "WorkflowContext": { "type": "object", "properties": { "vaults": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "name" ], "additionalProperties": false }, "maxItems": 100 }, "available": { "type": "boolean" }, "persistence": { "type": "boolean" } }, "required": [ "vaults", "available", "persistence" ], "additionalProperties": false }, "WorkflowResearchRequest": { "type": "object", "properties": { "vaultId": { "type": "string", "maxLength": 128, "minLength": 1 }, "projectId": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "question": { "type": "string", "minLength": 3, "maxLength": 2400 }, "history": { "type": "array", "items": { "type": "object", "properties": { "question": { "type": "string", "maxLength": 2400 }, "answer": { "type": "string", "maxLength": 6000 } }, "required": [ "question", "answer" ], "additionalProperties": false }, "maxItems": 6, "default": [] } }, "required": [ "projectId", "question" ], "additionalProperties": false }, "WorkflowResearchAnswer": { "type": "object", "properties": { "headline": { "type": "string", "maxLength": 160, "minLength": 1 }, "explanation": { "type": "string", "maxLength": 4000, "minLength": 1 }, "findings": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string", "maxLength": 120, "minLength": 1 }, "detail": { "type": "string", "maxLength": 1000, "minLength": 1 }, "sourceIds": { "type": "array", "items": { "type": "string", "maxLength": 80, "minLength": 1 }, "minItems": 1, "maxItems": 12, "uniqueItems": true } }, "required": [ "title", "detail", "sourceIds" ], "additionalProperties": false }, "minItems": 1, "maxItems": 5 }, "nextSteps": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string", "maxLength": 120, "minLength": 1 }, "reason": { "type": "string", "maxLength": 1000, "minLength": 1 } }, "required": [ "title", "reason" ], "additionalProperties": false }, "minItems": 1, "maxItems": 4 }, "unknowns": { "type": "array", "items": { "type": "string", "maxLength": 600, "minLength": 1 }, "maxItems": 8 }, "followUps": { "type": "array", "items": { "type": "string", "maxLength": 200, "minLength": 1 }, "maxItems": 3 } }, "required": [ "headline", "explanation", "findings", "nextSteps", "unknowns", "followUps" ], "additionalProperties": false }, "WorkflowResearchResult": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "question": { "type": "string", "minLength": 3, "maxLength": 2400 }, "evidence": { "$ref": "#/components/schemas/MarketDiscoveryEvidence" }, "answer": { "$ref": "#/components/schemas/WorkflowResearchAnswer" }, "completedAt": { "type": "string", "format": "date-time" }, "execution": { "const": "READ_ONLY" } }, "required": [ "id", "question", "evidence", "answer", "completedAt", "execution" ], "additionalProperties": false }, "WorkflowResearchResponse": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "question": { "type": "string", "minLength": 3, "maxLength": 2400 }, "evidence": { "$ref": "#/components/schemas/MarketDiscoveryEvidence" }, "answer": { "$ref": "#/components/schemas/WorkflowResearchAnswer" }, "completedAt": { "type": "string", "format": "date-time" }, "execution": { "const": "READ_ONLY" }, "persistence": { "type": "string", "enum": [ "SAVED", "SESSION" ] } }, "required": [ "id", "question", "evidence", "answer", "completedAt", "execution", "persistence" ], "additionalProperties": false }, "CompletedWorkflowSummary": { "type": "object", "properties": { "organizationId": { "type": "string", "maxLength": 160, "minLength": 1 }, "requesterId": { "type": "string", "format": "uuid" }, "id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "vaultId": { "anyOf": [ { "type": "string", "maxLength": 128, "minLength": 1 }, { "type": "null" } ] }, "projectId": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "projectName": { "type": "string", "maxLength": 200 }, "question": { "type": "string", "minLength": 3, "maxLength": 2400 }, "headline": { "type": "string", "maxLength": 160, "minLength": 1 }, "completedAt": { "type": "string", "format": "date-time" }, "savedAt": { "type": "string", "format": "date-time" }, "contentHash": { "$ref": "#/components/schemas/Hash" } }, "required": [ "organizationId", "requesterId", "id", "vaultId", "projectId", "projectName", "question", "headline", "completedAt", "savedAt", "contentHash" ], "additionalProperties": false }, "CompletedWorkflowRun": { "type": "object", "properties": { "organizationId": { "type": "string", "maxLength": 160, "minLength": 1 }, "requesterId": { "type": "string", "format": "uuid" }, "id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "vaultId": { "anyOf": [ { "type": "string", "maxLength": 128, "minLength": 1 }, { "type": "null" } ] }, "projectId": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "projectName": { "type": "string", "maxLength": 200 }, "question": { "type": "string", "minLength": 3, "maxLength": 2400 }, "headline": { "type": "string", "maxLength": 160, "minLength": 1 }, "completedAt": { "type": "string", "format": "date-time" }, "savedAt": { "type": "string", "format": "date-time" }, "contentHash": { "$ref": "#/components/schemas/Hash" }, "result": { "$ref": "#/components/schemas/WorkflowResearchResult" } }, "required": [ "organizationId", "requesterId", "id", "vaultId", "projectId", "projectName", "question", "headline", "completedAt", "savedAt", "contentHash", "result" ], "additionalProperties": false }, "CompletedWorkflowPage": { "type": "object", "properties": { "runs": { "type": "array", "items": { "$ref": "#/components/schemas/CompletedWorkflowSummary" }, "maxItems": 20 }, "nextCursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] } }, "required": [ "runs", "nextCursor" ], "additionalProperties": false }, "SavedVirtualsProject": { "type": "object", "properties": { "kind": { "const": "VIRTUALS_DIRECTORY_PROJECT" }, "organizationId": { "type": "string", "maxLength": 160, "minLength": 1 }, "virtualsProjectId": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "project": { "type": "object", "properties": { "id": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 200, "minLength": 1 }, "symbol": { "type": "string", "maxLength": 100 }, "chain": { "type": "string", "maxLength": 40, "minLength": 1 }, "address": { "anyOf": [ { "type": "string", "maxLength": 150, "minLength": 1 }, { "type": "null" } ] }, "imageUrl": { "anyOf": [ { "type": "string", "maxLength": 2048, "format": "uri", "description": "HTTPS Virtuals CDN image, if available." }, { "type": "null" } ] }, "url": { "type": "string", "maxLength": 100 } }, "required": [ "id", "name", "symbol", "chain", "address", "imageUrl", "url" ], "additionalProperties": false }, "directoryObservedAt": { "type": "string", "format": "date-time" }, "savedAt": { "type": "string", "format": "date-time" }, "savedBy": { "type": "string", "format": "uuid" }, "resourceVersion": { "$ref": "#/components/schemas/Hash" } }, "required": [ "kind", "organizationId", "virtualsProjectId", "project", "directoryObservedAt", "savedAt", "savedBy", "resourceVersion" ], "additionalProperties": false }, "SavedVirtualsProjectPage": { "type": "object", "properties": { "projects": { "type": "array", "items": { "$ref": "#/components/schemas/SavedVirtualsProject" }, "maxItems": 20 }, "nextCursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] } }, "required": [ "projects", "nextCursor" ], "additionalProperties": false }, "SaveVirtualsProjectRequest": { "type": "object", "properties": { "virtualsProjectId": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "virtualsProjectId" ], "additionalProperties": false }, "SaveVirtualsProjectReceipt": { "type": "object", "properties": { "project": { "$ref": "#/components/schemas/SavedVirtualsProject" }, "replayed": { "type": "boolean" } }, "required": [ "project", "replayed" ], "additionalProperties": false }, "RemoveVirtualsProjectRequest": { "type": "object", "properties": { "expectedResourceVersion": { "$ref": "#/components/schemas/Hash" } }, "required": [ "expectedResourceVersion" ], "additionalProperties": false }, "RemoveVirtualsProjectReceipt": { "type": "object", "properties": { "virtualsProjectId": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "resourceVersion": { "$ref": "#/components/schemas/Hash" }, "removedAt": { "type": "string", "format": "date-time" }, "replayed": { "type": "boolean" } }, "required": [ "virtualsProjectId", "resourceVersion", "removedAt", "replayed" ], "additionalProperties": false }, "TreasuryLedgerVersionPage": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "organizationId": { "type": "string" }, "recordType": { "$ref": "#/components/schemas/OperatingSystemRecordType" }, "version": { "type": "integer", "minimum": 1 }, "status": { "$ref": "#/components/schemas/OperatingSystemRecordStatus" }, "payload": { "$ref": "#/components/schemas/TreasuryBucket" }, "artifactHash": { "$ref": "#/components/schemas/Hash" }, "evidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" } }, "createdBy": { "type": "string" }, "reason": { "type": "string" }, "requestId": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "supersedesVersion": { "type": "integer", "minimum": 1 }, "resourceVersion": { "$ref": "#/components/schemas/Hash" } }, "required": [ "id", "organizationId", "recordType", "version", "status", "payload", "artifactHash", "evidenceHashes", "createdBy", "reason", "requestId", "createdAt", "updatedAt", "resourceVersion" ], "additionalProperties": false }, "maxItems": 100 }, "nextCursor": { "anyOf": [ { "type": "string", "maxLength": 256 }, { "type": "null" } ] } }, "required": [ "items", "nextCursor" ], "additionalProperties": false }, "ProposalReviewDecisionEvent": { "type": "object", "properties": { "organizationId": { "type": "string" }, "eventId": { "type": "string" }, "recordType": { "const": "PROPOSAL_WORKSPACE" }, "recordId": { "type": "string" }, "eventKind": { "const": "PROPOSAL_INTERNAL_DECISION" }, "payload": { "oneOf": [ { "type": "object", "properties": { "actorId": { "type": "string" }, "actorRole": { "type": "string" }, "decidedAt": { "type": "string", "format": "date-time" }, "proposalPacketHash": { "$ref": "#/components/schemas/Hash" }, "decision": { "const": "APPROVE" }, "evidenceHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" } }, "required": [ "actorId", "actorRole", "decidedAt", "proposalPacketHash", "decision", "evidenceHash" ], "additionalProperties": false }, { "type": "object", "properties": { "actorId": { "type": "string" }, "actorRole": { "type": "string" }, "decidedAt": { "type": "string", "format": "date-time" }, "proposalPacketHash": { "$ref": "#/components/schemas/Hash" }, "decision": { "const": "REJECT" }, "rejectionReason": { "type": "string", "minLength": 10, "maxLength": 2000 }, "evidenceHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" } }, "required": [ "actorId", "actorRole", "decidedAt", "proposalPacketHash", "decision", "rejectionReason" ], "additionalProperties": false } ] }, "artifactHash": { "$ref": "#/components/schemas/Hash" }, "createdBy": { "type": "string" }, "actorRole": { "type": "string" }, "reason": { "type": "string" }, "requestId": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" } }, "required": [ "organizationId", "eventId", "recordType", "recordId", "eventKind", "payload", "artifactHash", "createdBy", "actorRole", "reason", "requestId", "createdAt" ], "additionalProperties": false }, "ProposalReviewCommentEvent": { "type": "object", "properties": { "organizationId": { "type": "string" }, "eventId": { "type": "string" }, "recordType": { "const": "PROPOSAL_WORKSPACE" }, "recordId": { "type": "string" }, "eventKind": { "const": "COMMENT_APPENDED" }, "payload": { "type": "object", "properties": { "id": { "type": "string" }, "proposalWorkspaceId": { "type": "string" }, "authorId": { "type": "string" }, "body": { "type": "string", "maxLength": 4000, "minLength": 1 }, "mentions": { "type": "array", "items": { "type": "string", "format": "uuid" }, "maxItems": 50 }, "supersedesCommentId": { "type": "string" }, "supersedesCommentArtifactHash": { "$ref": "#/components/schemas/Hash" } }, "required": [ "id", "proposalWorkspaceId", "authorId", "body", "mentions" ], "additionalProperties": false }, "artifactHash": { "$ref": "#/components/schemas/Hash" }, "createdBy": { "type": "string" }, "actorRole": { "type": "string" }, "reason": { "type": "string" }, "requestId": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" } }, "required": [ "organizationId", "eventId", "recordType", "recordId", "eventKind", "payload", "artifactHash", "createdBy", "actorRole", "reason", "requestId", "createdAt" ], "additionalProperties": false }, "ProposalReviewSafeSubmissionEvent": { "type": "object", "properties": { "organizationId": { "type": "string" }, "eventId": { "type": "string" }, "recordType": { "const": "PROPOSAL_WORKSPACE" }, "recordId": { "type": "string" }, "eventKind": { "const": "PROPOSAL_SAFE_SUBMISSION_VERIFIED" }, "payload": { "type": "object", "properties": { "schemaVersion": { "const": "proposal-safe-submission-evidence-v1" }, "proposalId": { "type": "string", "maxLength": 180 }, "proposalPacketHash": { "$ref": "#/components/schemas/Hash" }, "chainId": { "type": "integer", "enum": [ 677, 968 ] }, "safeAddress": { "$ref": "#/components/schemas/Address" }, "target": { "$ref": "#/components/schemas/Address" }, "value": { "const": "0" }, "operation": { "const": 0 }, "calldata": { "type": "string", "pattern": "^0x(?:[0-9a-fA-F]{2})+$", "maxLength": 200000 }, "calldataHash": { "$ref": "#/components/schemas/Hash" }, "decodedControllerExecution": { "$ref": "#/components/schemas/ControllerExecutionBindingV2" }, "decodedControllerExecutionHash": { "$ref": "#/components/schemas/Hash" }, "transactionHash": { "$ref": "#/components/schemas/Hash" }, "safeTransactionHash": { "$ref": "#/components/schemas/Hash" }, "finalizedBlockNumber": { "type": "string", "pattern": "^[0-9]+$" }, "finalizedBlockHash": { "$ref": "#/components/schemas/Hash" }, "finalizedAt": { "type": "string", "format": "date-time" }, "finalityDepth": { "type": "integer", "minimum": 1, "maximum": 1000000 }, "receiptStatus": { "const": 1 }, "executionResult": { "type": "object", "properties": { "schemaVersion": { "const": "canonical-evm-execution-result-v1" }, "executionSucceeded": { "const": true }, "returnDataHash": { "$ref": "#/components/schemas/Hash" }, "logsHash": { "$ref": "#/components/schemas/Hash" }, "stateDeltaHash": { "$ref": "#/components/schemas/Hash" } }, "required": [ "schemaVersion", "executionSucceeded", "returnDataHash", "logsHash", "stateDeltaHash" ], "additionalProperties": false }, "executionResultHash": { "$ref": "#/components/schemas/Hash" }, "finalityEvidenceHash": { "$ref": "#/components/schemas/Hash" }, "reconciliationBlockNumber": { "type": "string", "pattern": "^[0-9]+$" }, "reconciliationBlockHash": { "$ref": "#/components/schemas/Hash" }, "reconciledAt": { "type": "string", "format": "date-time" }, "reconciliationStatus": { "const": "MATCHED" }, "reconciliationEvidenceHash": { "$ref": "#/components/schemas/Hash" }, "safeVerificationId": { "type": "string" }, "safeVerificationEvidenceHash": { "$ref": "#/components/schemas/Hash" }, "signedReleaseDigest": { "$ref": "#/components/schemas/Hash" }, "vaultId": { "type": "string" }, "vaultDeploymentProvenanceHash": { "$ref": "#/components/schemas/Hash" }, "vaultDeploymentBlockHash": { "$ref": "#/components/schemas/Hash" }, "venueId": { "type": "string" }, "venueResourceVersion": { "$ref": "#/components/schemas/Hash" }, "venueArtifactHash": { "$ref": "#/components/schemas/Hash" }, "callerSuppliedTransactionHashAccepted": { "const": false }, "executionPerformedByRoute": { "const": false }, "checkedAt": { "type": "string", "format": "date-time" } }, "required": [ "schemaVersion", "proposalId", "proposalPacketHash", "chainId", "safeAddress", "target", "value", "operation", "calldata", "calldataHash", "decodedControllerExecution", "decodedControllerExecutionHash", "transactionHash", "safeTransactionHash", "finalizedBlockNumber", "finalizedBlockHash", "finalizedAt", "finalityDepth", "receiptStatus", "executionResult", "executionResultHash", "finalityEvidenceHash", "reconciliationBlockNumber", "reconciliationBlockHash", "reconciledAt", "reconciliationStatus", "reconciliationEvidenceHash", "safeVerificationId", "safeVerificationEvidenceHash", "vaultId", "vaultDeploymentProvenanceHash", "vaultDeploymentBlockHash", "venueId", "venueResourceVersion", "venueArtifactHash", "callerSuppliedTransactionHashAccepted", "executionPerformedByRoute", "checkedAt" ], "additionalProperties": false }, "artifactHash": { "$ref": "#/components/schemas/Hash" }, "createdBy": { "type": "string" }, "actorRole": { "type": "string" }, "reason": { "type": "string" }, "requestId": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" } }, "required": [ "organizationId", "eventId", "recordType", "recordId", "eventKind", "payload", "artifactHash", "createdBy", "actorRole", "reason", "requestId", "createdAt" ], "additionalProperties": false }, "ProposalWorkspaceReview": { "type": "object", "properties": { "schemaVersion": { "const": "proposal-review-view-v1" }, "proposal": { "type": "object", "properties": { "id": { "type": "string" }, "organizationId": { "type": "string" }, "recordType": { "$ref": "#/components/schemas/OperatingSystemRecordType" }, "version": { "type": "integer", "minimum": 1 }, "status": { "$ref": "#/components/schemas/OperatingSystemRecordStatus" }, "payload": { "$ref": "#/components/schemas/ProposalWorkspace" }, "artifactHash": { "$ref": "#/components/schemas/Hash" }, "evidenceHashes": { "type": "array", "items": { "$ref": "#/components/schemas/Hash" } }, "createdBy": { "type": "string" }, "reason": { "type": "string" }, "requestId": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "supersedesVersion": { "type": "integer", "minimum": 1 }, "resourceVersion": { "$ref": "#/components/schemas/Hash" } }, "required": [ "id", "organizationId", "recordType", "version", "status", "payload", "artifactHash", "evidenceHashes", "createdBy", "reason", "requestId", "createdAt", "updatedAt", "resourceVersion" ], "additionalProperties": false }, "proposalPacketHash": { "$ref": "#/components/schemas/Hash" }, "reviewEvidenceHash": { "$ref": "#/components/schemas/Hash" }, "observedAt": { "type": "string", "format": "date-time" }, "approvals": { "type": "array", "items": { "type": "object", "properties": { "actorId": { "type": "string" }, "decidedAt": { "type": "string", "format": "date-time" }, "evidenceHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" } }, "required": [ "actorId", "decidedAt", "evidenceHash" ], "additionalProperties": false } }, "approvalProgress": { "type": "object", "properties": { "approved": { "type": "integer", "minimum": 0 }, "required": { "type": "integer", "minimum": 0 } }, "required": [ "approved", "required" ], "additionalProperties": false }, "decisions": { "type": "array", "items": { "$ref": "#/components/schemas/ProposalReviewDecisionEvent" } }, "comments": { "type": "array", "items": { "$ref": "#/components/schemas/ProposalReviewCommentEvent" } }, "safeSubmissions": { "type": "array", "items": { "$ref": "#/components/schemas/ProposalReviewSafeSubmissionEvent" } }, "viewer": { "type": "object", "properties": { "actorId": { "type": "string" }, "role": { "type": "string" }, "hasApproved": { "type": "boolean" }, "mayComment": { "type": "boolean" }, "mayApprove": { "type": "boolean" }, "mayReject": { "type": "boolean" } }, "required": [ "actorId", "role", "hasApproved", "mayComment", "mayApprove", "mayReject" ], "additionalProperties": false }, "executionAuthorityGranted": { "const": false } }, "required": [ "schemaVersion", "proposal", "proposalPacketHash", "reviewEvidenceHash", "observedAt", "approvals", "approvalProgress", "decisions", "comments", "safeSubmissions", "viewer", "executionAuthorityGranted" ], "additionalProperties": false }, "WorkflowRequestError": { "type": "object", "properties": { "error": { "type": "object", "properties": { "message": { "type": "string" } }, "required": [ "message" ], "additionalProperties": false } }, "required": [ "error" ], "additionalProperties": false }, "WorkflowRateLimitError": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "const": "RATE_LIMITED" }, "message": { "type": "string" }, "retryable": { "const": true }, "retryAfterSeconds": { "type": "integer", "minimum": 1 } }, "required": [ "code", "message", "retryable", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "error" ], "additionalProperties": false } } } }