{ "openapi": "3.1.0", "x-klineo-canonical-public-operations": [ "get /session", "post /invitations", "post /invitations/:token/accept", "get /organizations", "get /organizations/:orgId/members", "post /organizations/:orgId/members", "patch /organizations/:orgId/members/:memberId", "post /organizations/:orgId/safes/challenge", "post /organizations/:orgId/safes/verify", "post /projects", "get /projects/:projectId", "post /projects/:projectId/eligibility-assessments", "post /projects/:projectId/data-room/uploads", "post /projects/:projectId/lifecycle-transitions", "get /vaults", "post /vaults", "get /vaults/:vaultId", "post /vaults/:vaultId/deployment-preview", "post /vaults/:vaultId/deploy", "post /vaults/:vaultId/funding-intents", "post /vaults/:vaultId/pause", "post /vaults/:vaultId/exit-preview", "post /vaults/:vaultId/exit", "get /vaults/:vaultId/positions", "get /vaults/:vaultId/balances", "post /simulations", "get /simulations/:simulationId", "get /simulations/:simulationId/artifacts", "post /vaults/:vaultId/strategy-evaluations", "get /vaults/:vaultId/strategy-state", "get /vaults/:vaultId/policies", "post /vaults/:vaultId/policies", "post /vaults/:vaultId/policies/:version/review", "post /vaults/:vaultId/policies/:version/approve", "post /vaults/:vaultId/policies/:version/activate", "post /vaults/:vaultId/policies/:version/revoke", "get /proposals", "post /vaults/:vaultId/proposals", "get /proposals/:proposalId", "post /proposals/:proposalId/approve", "post /proposals/:proposalId/reject", "post /proposals/:proposalId/safe-bundle", "post /proposals/:proposalId/submit", "get /proposals/:proposalId/execution", "get /proposals/:proposalId/reconciliation", "get /vaults/:vaultId/market-quality", "get /vaults/:vaultId/data-health", "get /vaults/:vaultId/incidents", "post /vaults/:vaultId/incidents/:incidentId/acknowledge", "get /vaults/:vaultId/evidence", "get /vaults/:vaultId/events", "post /vaults/:vaultId/reports", "get /reports/:reportId", "get /reports/:reportId/download", "post /reports/:reportId/publish", "get /organizations/:orgId/fee-schedule", "get /organizations/:orgId/invoices", "get /public/proofs/:slug", "get /public/proofs/:slug/artifacts", "get /status" ], "info": { "title": "KlineO Liquidity Studio API", "version": "1.0.0", "description": "Invitation-only issuer liquidity operations on BOT Chain 677 mainnet and BOT Chain 968 testnet. All economic amounts are atomic integer strings." }, "servers": [ { "url": "/api/liquidity-studio/v1" } ], "paths": { "/openapi.json": { "get": { "operationId": "getOpenapiJson", "tags": [ "openapi.json" ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getOpenapiJsonResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/status": { "get": { "operationId": "getStatus", "tags": [ "status" ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getStatusResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/retirement/status": { "get": { "operationId": "getRetirementStatus", "tags": [ "retirement" ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getRetirementStatusResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/access-requests": { "post": { "operationId": "postAccessRequests", "tags": [ "access-requests" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccessRequestSubmission" } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/AccessRequestReceipt" } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/public/proofs/{slug}": { "get": { "operationId": "getPublicProofsBySlug", "tags": [ "public" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getPublicProofsBySlugResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/public/proofs/{slug}/bundle": { "get": { "operationId": "getPublicProofsBySlugBundle", "tags": [ "public" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getPublicProofsBySlugBundleResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/public/proofs/{slug}/artifacts": { "get": { "operationId": "getPublicProofsBySlugArtifacts", "tags": [ "public" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getPublicProofsBySlugArtifactsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/session": { "get": { "operationId": "getSession", "tags": [ "session" ], "security": [ { "sessionCookie": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getSessionResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/organizations": { "post": { "operationId": "postOrganizations", "tags": [ "organizations" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "name", "slug", "termsVersion", "termsSource", "provisioningToken", "reason" ], "properties": { "name": { "type": "string", "minLength": 2, "maxLength": 160 }, "slug": { "type": "string", "minLength": 1, "maxLength": 80 }, "termsVersion": { "type": "string", "minLength": 1, "maxLength": 80 }, "termsSource": { "type": "string", "format": "uri", "maxLength": 2000 }, "provisioningToken": { "type": "string", "pattern": "^[A-Za-z0-9_-]{32,256}$" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postOrganizationsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } }, "get": { "operationId": "getOrganizations", "tags": [ "organizations" ], "security": [ { "sessionCookie": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getOrganizationsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/invitations/accept": { "post": { "operationId": "postInvitationsAccept", "tags": [ "invitations" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "token", "reason" ], "properties": { "token": { "type": "string", "minLength": 32, "maxLength": 256 }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postInvitationsAcceptResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/invitations/{token}/accept": { "post": { "operationId": "postInvitationsByTokenAccept", "tags": [ "invitations" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "token", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 160 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "reason" ], "properties": { "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postInvitationsByTokenAcceptResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/organization": { "get": { "operationId": "getOrganization", "tags": [ "organization" ], "security": [ { "sessionCookie": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getOrganizationResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } }, "patch": { "operationId": "patchOrganization", "tags": [ "organization" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "name", "reason" ], "properties": { "name": { "type": "string", "minLength": 2, "maxLength": 160 }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "patchOrganizationResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/members": { "get": { "operationId": "getMembers", "tags": [ "members" ], "security": [ { "sessionCookie": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getMembersResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/invitations": { "get": { "operationId": "getInvitations", "tags": [ "invitations" ], "security": [ { "sessionCookie": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getInvitationsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } }, "post": { "operationId": "postInvitations", "tags": [ "invitations" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "email", "role", "expiresAt", "reason" ], "properties": { "email": { "type": "string", "format": "email", "maxLength": 320 }, "role": { "type": "string", "enum": [ "ORGANIZATION_OWNER", "TREASURY_ADMIN", "APPROVER", "ANALYST", "VIEWER", "KLINEO_OPERATOR", "RISK_GUARDIAN", "INTERNAL_AUDITOR" ] }, "expiresAt": { "type": "string", "format": "date-time" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postInvitationsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/members/{actorId}": { "patch": { "operationId": "patchMembersByActorId", "tags": [ "members" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "actorId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "role", "reason" ], "properties": { "role": { "type": "string", "enum": [ "ORGANIZATION_OWNER", "TREASURY_ADMIN", "APPROVER", "ANALYST", "VIEWER", "KLINEO_OPERATOR", "RISK_GUARDIAN", "INTERNAL_AUDITOR" ] }, "expiresAt": { "type": "string", "format": "date-time" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "patchMembersByActorIdResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/members/{actorId}/revoke": { "post": { "operationId": "postMembersByActorIdRevoke", "tags": [ "members" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "actorId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "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": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postMembersByActorIdRevokeResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/organizations/{orgId}/projects": { "get": { "operationId": "getOrganizationsByOrgIdProjects", "tags": [ "organizations" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "orgId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getOrganizationsByOrgIdProjectsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/assets/{chainId}/{address}/eligibility": { "get": { "operationId": "getAssetsByChainIdByAddressEligibility", "tags": [ "assets" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "chainId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getAssetsByChainIdByAddressEligibilityResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/assets/{chainId}/{address}/assessments": { "get": { "operationId": "getAssetsByChainIdByAddressAssessments", "tags": [ "assets" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "chainId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getAssetsByChainIdByAddressAssessmentsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } }, "post": { "operationId": "postAssetsByChainIdByAddressAssessments", "tags": [ "assets" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "chainId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "reason" ], "properties": { "reason": { "type": "string", "minLength": 12, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postAssetsByChainIdByAddressAssessmentsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/venues/bdex/deployments/current": { "get": { "operationId": "getVenuesBdexDeploymentsCurrent", "tags": [ "venues" ], "security": [ { "sessionCookie": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getVenuesBdexDeploymentsCurrentResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/venues/bdex/deployments/{factoryAddress}/assessments": { "get": { "operationId": "getVenuesBdexDeploymentsByFactoryAddressAssessments", "tags": [ "venues" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "factoryAddress", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getVenuesBdexDeploymentsByFactoryAddressAssessmentsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/venues/bdex/deployments/assessments": { "post": { "operationId": "postVenuesBdexDeploymentsAssessments", "tags": [ "venues" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "factoryAddress", "reason" ], "properties": { "factoryAddress": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "reason": { "type": "string", "minLength": 12, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVenuesBdexDeploymentsAssessmentsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/pools/{address}/health": { "get": { "operationId": "getPoolsByAddressHealth", "tags": [ "pools" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getPoolsByAddressHealthResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/pools/{address}/assessments": { "get": { "operationId": "getPoolsByAddressAssessments", "tags": [ "pools" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getPoolsByAddressAssessmentsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } }, "post": { "operationId": "postPoolsByAddressAssessments", "tags": [ "pools" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "reason" ], "properties": { "reason": { "type": "string", "minLength": 12, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postPoolsByAddressAssessmentsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/organizations/{orgId}/safes/challenge": { "post": { "operationId": "postOrganizationsByOrgIdSafesChallenge", "tags": [ "organizations" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "orgId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "safeAddress", "reason" ], "properties": { "safeAddress": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postOrganizationsByOrgIdSafesChallengeResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/organizations/{orgId}/safes/verify": { "post": { "operationId": "postOrganizationsByOrgIdSafesVerify", "tags": [ "organizations" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "orgId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "challengeId", "signature", "reason" ], "properties": { "challengeId": { "type": "string", "minLength": 1 }, "signature": { "type": "string", "pattern": "^0x[0-9a-fA-F]+$" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postOrganizationsByOrgIdSafesVerifyResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults": { "get": { "operationId": "getVaults", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getVaultsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } }, "post": { "operationId": "postVaults", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "name", "projectToken", "quoteToken", "quoteProfile", "ownerSafe", "poolAddress", "launchContext", "strategy", "qualification", "reason" ], "properties": { "name": { "type": "string", "minLength": 2, "maxLength": 80 }, "projectToken": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "quoteToken": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "quoteProfile": { "type": "string", "enum": [ "USDT", "WBOT" ] }, "ownerSafe": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "poolAddress": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "launchContext": { "type": "string", "enum": [ "PRE_TGE", "POST_LAUNCH" ] }, "strategy": { "type": "object", "additionalProperties": false, "required": [ "kind", "version", "targetInventoryPips", "rebalanceThresholdPips", "quoteReserveFloor", "maxCandidateAmount", "rangeWidthTicks", "diversificationTriggerPips" ], "properties": { "kind": { "type": "string", "enum": [ "BOOTSTRAP", "MAINTAIN", "DIVERSIFY" ] }, "version": { "type": "string", "minLength": 1, "maxLength": 80 }, "targetInventoryPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "rebalanceThresholdPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "quoteReserveFloor": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "maxCandidateAmount": { "type": "string", "pattern": "^[1-9][0-9]*$" }, "rangeWidthTicks": { "type": "integer", "exclusiveMinimum": 0, "maximum": 1774544 }, "diversificationTriggerPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "diversificationMandate": { "type": "object", "additionalProperties": false, "required": [ "executionMode", "totalTokenSaleCap", "dailyTokenSaleCap", "hourlyTokenSaleCap", "maximumOrganicVolumeParticipationPips", "minimumSalePriceX18", "minimumRetainedTokenBalance", "targetProtectedQuoteReserve", "validUntil", "proceedsRule", "repurchaseAllowed", "unlockDisclosureArtifactHash", "insiderWalletDisclosureArtifactHash", "publicReportingMode" ], "properties": { "executionMode": { "const": "ISSUER_SAFE_APPROVAL_ONLY" }, "totalTokenSaleCap": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "dailyTokenSaleCap": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "hourlyTokenSaleCap": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "maximumOrganicVolumeParticipationPips": { "type": "integer", "minimum": 1, "maximum": 1000000 }, "minimumSalePriceX18": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "minimumRetainedTokenBalance": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "targetProtectedQuoteReserve": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "validUntil": { "type": "string", "format": "date-time" }, "proceedsRule": { "const": "PROTECTED_QUOTE_RESERVE" }, "repurchaseAllowed": { "const": false }, "unlockDisclosureArtifactHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "insiderWalletDisclosureArtifactHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "publicReportingMode": { "type": "string", "enum": [ "PRIVATE", "ISSUER_APPROVED_PUBLIC" ] } } } } }, "qualification": { "type": "object", "additionalProperties": false, "required": [ "legalEntityName", "projectName", "maximumDeployableTokenAtomic", "maximumDeployableQuoteAtomic", "protectedQuoteReserveAtomic", "reserveRationale", "executionRecipientPolicy", "exitRecipient", "intendedPolicyTerm", "contacts", "launch", "tokenDisclosureArtifactHash", "governanceApprovalArtifactHash", "dataRoom", "desiredOutcomes", "prohibitedBehaviors", "referenceVenueIds", "oracleSourceAddresses" ], "properties": { "legalEntityName": { "type": "string", "minLength": 2, "maxLength": 200 }, "projectName": { "type": "string", "minLength": 2, "maxLength": 160 }, "maximumDeployableTokenAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "maximumDeployableQuoteAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "protectedQuoteReserveAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "reserveRationale": { "type": "string", "minLength": 12, "maxLength": 1000 }, "executionRecipientPolicy": { "const": "IMMUTABLE_VAULT_ONLY" }, "exitRecipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "intendedPolicyTerm": { "type": "object", "additionalProperties": false, "required": [ "validAfter", "validUntil" ], "properties": { "validAfter": { "type": "string", "format": "date-time" }, "validUntil": { "type": "string", "format": "date-time" } } }, "contacts": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "kind", "name", "email", "responseWindowMinutes" ], "properties": { "kind": { "type": "string", "enum": [ "OPERATIONS", "EMERGENCY", "GOVERNANCE" ] }, "name": { "type": "string", "minLength": 2, "maxLength": 120 }, "email": { "type": "string", "format": "email", "maxLength": 254 }, "responseWindowMinutes": { "type": "integer", "minimum": 1, "maximum": 10080 } } }, "minItems": 2, "maxItems": 12 }, "launch": { "type": "object", "additionalProperties": false, "required": [ "launchDate", "unlockScheduleArtifactHash" ], "properties": { "launchDate": { "type": "string", "format": "date-time" }, "unlockScheduleArtifactHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" } } }, "tokenDisclosureArtifactHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "governanceApprovalArtifactHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "dataRoom": { "type": "object", "additionalProperties": false, "required": [ "termsVersion", "termsSource", "acceptedAt" ], "properties": { "termsVersion": { "type": "string", "minLength": 1, "maxLength": 120 }, "termsSource": { "type": "string", "minLength": 3, "maxLength": 500 }, "acceptedAt": { "type": "string", "format": "date-time" } } }, "desiredOutcomes": { "type": "array", "items": { "type": "string", "minLength": 3, "maxLength": 500 }, "minItems": 1, "maxItems": 20 }, "prohibitedBehaviors": { "type": "array", "items": { "type": "string", "minLength": 3, "maxLength": 500 }, "minItems": 1, "maxItems": 20 }, "referenceVenueIds": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 }, "minItems": 1, "maxItems": 20 }, "oracleSourceAddresses": { "type": "array", "items": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "minItems": 2, "maxItems": 2 } } }, "reason": { "type": "string", "minLength": 12, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVaultsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/preview-deployment": { "post": { "operationId": "postVaultsPreviewDeployment", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "vaultId" ], "properties": { "vaultId": { "type": "string", "minLength": 1 } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVaultsPreviewDeploymentResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}": { "get": { "operationId": "getVaultsByVaultId", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getVaultsByVaultIdResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/issuer-exit-kit": { "get": { "operationId": "getVaultsByVaultIdIssuerExitKit", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getVaultsByVaultIdIssuerExitKitResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/positions": { "get": { "operationId": "getVaultsByVaultIdPositions", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getVaultsByVaultIdPositionsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/inventory": { "get": { "operationId": "getVaultsByVaultIdInventory", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getVaultsByVaultIdInventoryResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/depth": { "get": { "operationId": "getVaultsByVaultIdDepth", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getVaultsByVaultIdDepthResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/depth-history": { "get": { "operationId": "getVaultsByVaultIdDepthHistory", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getVaultsByVaultIdDepthHistoryResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/policy": { "get": { "operationId": "getVaultsByVaultIdPolicy", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getVaultsByVaultIdPolicyResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/deployment-preview": { "post": { "operationId": "postVaultsByVaultIdDeploymentPreview", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVaultsByVaultIdDeploymentPreviewResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/deployment-handoff": { "post": { "operationId": "postVaultsByVaultIdDeploymentHandoff", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "amount0", "amount1", "minimumReceived0", "minimumReceived1", "reason" ], "properties": { "amount0": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "amount1": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "minimumReceived0": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "minimumReceived1": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVaultsByVaultIdDeploymentHandoffResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/runtime-deployment-handoff": { "post": { "operationId": "postVaultsByVaultIdRuntimeDeploymentHandoff", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "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": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVaultsByVaultIdRuntimeDeploymentHandoffResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/deployment-finalization": { "post": { "operationId": "postVaultsByVaultIdDeploymentFinalization", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "transactionHash", "reason" ], "properties": { "transactionHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVaultsByVaultIdDeploymentFinalizationResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/deployment-handoff/cancel-expired": { "post": { "operationId": "postVaultsByVaultIdDeploymentHandoffCancelExpired", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "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": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVaultsByVaultIdDeploymentHandoffCancelExpiredResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/deployment-risk/reassess": { "post": { "operationId": "postVaultsByVaultIdDeploymentRiskReassess", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "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": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVaultsByVaultIdDeploymentRiskReassessResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/lifecycle-transitions": { "post": { "operationId": "postVaultsByVaultIdLifecycleTransitions", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "to", "reason" ], "properties": { "to": { "type": "string", "enum": [ "LEAD", "QUALIFIED", "DATA_ROOM", "SIMULATED", "POLICY_DRAFT", "TESTNET", "SHADOW", "FUND_READY", "LIVE_CAPPED", "LIVE_EXPANDED" ] }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVaultsByVaultIdLifecycleTransitionsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/testnet-mechanics-gates": { "post": { "operationId": "postVaultsByVaultIdTestnetMechanicsGates", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "exerciseWindowStart", "exerciseWindowEnd", "proofs", "reason" ], "properties": { "exerciseWindowStart": { "type": "string", "format": "date-time" }, "exerciseWindowEnd": { "type": "string", "format": "date-time" }, "proofs": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "mechanic", "status", "artifactKind", "artifactId", "evidenceHash", "transactionHashes", "observedAt" ], "properties": { "mechanic": { "type": "string", "enum": [ "VAULT_DEPLOYMENT", "SAFE_OWNERSHIP", "DEPOSIT", "PARTIAL_WITHDRAWAL", "FULL_WITHDRAWAL", "POSITION_CREATION", "POSITION_ADJUSTMENT", "FEE_COLLECTION", "UNWIND", "ORACLE_FAILURE", "EXECUTOR_FAILURE", "KEY_ROTATION", "PAUSE_AND_ISSUER_EXIT", "REORG_AND_REPLACEMENT", "REPORT_GENERATION" ] }, "status": { "const": "PASSED" }, "artifactKind": { "type": "string", "enum": [ "CHAIN_EXECUTION", "SAFE_AUTHORITY", "INCIDENT_DRILL", "RECONCILIATION_RUN", "REPORT_BUNDLE" ] }, "artifactId": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{0,159}$" }, "evidenceHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "transactionHashes": { "type": "array", "items": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "maxItems": 100 }, "observedAt": { "type": "string", "format": "date-time" } } }, "minItems": 15, "maxItems": 15 }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVaultsByVaultIdTestnetMechanicsGatesResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/testnet-mechanics-gates/{artifactId}/approval": { "post": { "operationId": "postVaultsByVaultIdTestnetMechanicsGatesByArtifactIdApproval", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "artifactId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "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": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVaultsByVaultIdTestnetMechanicsGatesByArtifactIdApprovalResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/live-expansion-gates": { "post": { "operationId": "postVaultsByVaultIdLiveExpansionGates", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "customerSuccessTrend", "customerSuccessEvidenceHash", "strategyNetResultUnderstandingHash", "proposedCapitalCapAtomic", "reason" ], "properties": { "customerSuccessTrend": { "type": "string", "enum": [ "IMPROVING", "STABLE", "NEGATIVE_UNDERSTOOD" ] }, "customerSuccessEvidenceHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "strategyNetResultUnderstandingHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "proposedCapitalCapAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVaultsByVaultIdLiveExpansionGatesResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/live-expansion-gates/{artifactId}/approval": { "post": { "operationId": "postVaultsByVaultIdLiveExpansionGatesByArtifactIdApproval", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "artifactId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "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": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVaultsByVaultIdLiveExpansionGatesByArtifactIdApprovalResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/capital-top-up-handoffs": { "post": { "operationId": "postVaultsByVaultIdCapitalTopUpHandoffs", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "amount0", "amount1", "minimumReceived0", "minimumReceived1", "reason" ], "properties": { "amount0": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "amount1": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "minimumReceived0": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "minimumReceived1": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVaultsByVaultIdCapitalTopUpHandoffsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/capital-top-up-handoffs/{handoffId}/finalization": { "post": { "operationId": "postVaultsByVaultIdCapitalTopUpHandoffsByHandoffIdFinalization", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "handoffId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "transactionHash", "reason" ], "properties": { "transactionHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVaultsByVaultIdCapitalTopUpHandoffsByHandoffIdFinalizationResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/capital-top-up-finalizations/{finalizationId}/reassessment": { "post": { "operationId": "postVaultsByVaultIdCapitalTopUpFinalizationsByFinalizationIdReassessment", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "finalizationId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "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": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVaultsByVaultIdCapitalTopUpFinalizationsByFinalizationIdReassessmentResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/control-handoffs": { "post": { "operationId": "postVaultsByVaultIdControlHandoffs", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "action", "reason" ], "properties": { "action": { "type": "string", "enum": [ "PAUSE", "RESUME", "SCHEDULE_AUTOMATION", "ACTIVATE_AUTOMATION", "DISABLE_AUTOMATION", "PARTIAL_WITHDRAW", "ENTER_EXITING", "FINALIZE_EXIT" ] }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 }, "resumeLifecycle": { "type": "string", "enum": [ "TESTNET", "SHADOW", "FUND_READY", "LIVE_CAPPED", "LIVE_EXPANDED" ] }, "exitMinimums": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "positionId", "amount0Min", "amount1Min" ], "properties": { "positionId": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "amount0Min": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "amount1Min": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" } } }, "maxItems": 64 }, "withdrawalAmounts": { "type": "object", "additionalProperties": false, "required": [ "amount0", "amount1" ], "properties": { "amount0": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "amount1": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" } } } } } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVaultsByVaultIdControlHandoffsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/control-handoffs/{handoffId}/finalization": { "post": { "operationId": "postVaultsByVaultIdControlHandoffsByHandoffIdFinalization", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "handoffId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "transactionHash", "reason" ], "properties": { "transactionHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVaultsByVaultIdControlHandoffsByHandoffIdFinalizationResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/policy-drafts": { "post": { "operationId": "postVaultsByVaultIdPolicyDrafts", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "policy", "reason" ], "properties": { "policy": { "type": "object", "additionalProperties": false, "required": [ "id", "version", "strategy", "strategyVersion", "configHash", "validAfter", "validUntil", "cooldownSeconds", "maxPositions", "maxOracleDeviationPips", "maxTwapDeviationPips", "minOracleConfidencePips", "minOracleObservationAgeSeconds", "maxSwapSlippagePips", "maxDailyTurnoverPips", "minActiveLiquidityPips", "minQuoteReservePips", "maxSwapPerAction", "maxSwapPerDay", "maxGasReimbursement", "maxRealizedLossPerDay", "maxCapitalPerPosition", "maxActionsPerDay", "minimumTick", "maximumTick", "maximumPositionWidthTicks", "minimumPositionWidthTicks", "allowedPools", "allowedRecipients", "executor", "guardian", "oracleGuard", "quoteProfile" ], "properties": { "id": { "type": "string", "minLength": 1 }, "version": { "type": "integer", "exclusiveMinimum": 0 }, "strategy": { "type": "string", "enum": [ "BOOTSTRAP", "MAINTAIN", "DIVERSIFY" ] }, "strategyVersion": { "type": "string", "minLength": 1 }, "configHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "validAfter": { "type": "string", "format": "date-time" }, "validUntil": { "type": "string", "format": "date-time" }, "cooldownSeconds": { "type": "integer", "minimum": 0, "maximum": 4294967295 }, "maxPositions": { "type": "integer", "exclusiveMinimum": 0, "maximum": 32 }, "maxOracleDeviationPips": { "type": "integer", "minimum": 0, "maximum": 100000 }, "maxTwapDeviationPips": { "type": "integer", "minimum": 0, "maximum": 100000 }, "minOracleConfidencePips": { "type": "integer", "minimum": 800000, "maximum": 1000000 }, "minOracleObservationAgeSeconds": { "type": "integer", "minimum": 1, "maximum": 3600 }, "maxSwapSlippagePips": { "type": "integer", "minimum": 0, "maximum": 100000 }, "maxDailyTurnoverPips": { "type": "integer", "minimum": 0, "maximum": 500000 }, "minActiveLiquidityPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "minQuoteReservePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "maxSwapPerAction": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "maxSwapPerDay": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "maxGasReimbursement": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "maxRealizedLossPerDay": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "maxCapitalPerPosition": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "maxActionsPerDay": { "type": "integer", "exclusiveMinimum": 0, "maximum": 10000 }, "minimumTick": { "type": "integer", "minimum": -887272, "maximum": 887272 }, "maximumTick": { "type": "integer", "minimum": -887272, "maximum": 887272 }, "maximumPositionWidthTicks": { "type": "integer", "exclusiveMinimum": 0, "maximum": 16777215 }, "minimumPositionWidthTicks": { "type": "integer", "exclusiveMinimum": 0, "maximum": 16777215 }, "allowedPools": { "type": "array", "items": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "minItems": 1, "maxItems": 32 }, "allowedRecipients": { "type": "array", "items": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "minItems": 1, "maxItems": 32 }, "executor": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "guardian": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "oracleGuard": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "quoteProfile": { "type": "string", "enum": [ "USDT", "WBOT" ] } } }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 }, "sourceSimulationId": { "type": "string", "minLength": 1 } } } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVaultsByVaultIdPolicyDraftsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } }, "get": { "operationId": "getVaultsByVaultIdPolicyDrafts", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getVaultsByVaultIdPolicyDraftsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/policy-drafts/{policyId}/approve": { "post": { "operationId": "postVaultsByVaultIdPolicyDraftsByPolicyIdApprove", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "policyId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "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": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVaultsByVaultIdPolicyDraftsByPolicyIdApproveResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/policy-drafts/{policyId}/handoffs": { "post": { "operationId": "postVaultsByVaultIdPolicyDraftsByPolicyIdHandoffs", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "policyId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "phase", "reason" ], "properties": { "phase": { "type": "string", "enum": [ "PROPOSE", "ACTIVATE" ] }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVaultsByVaultIdPolicyDraftsByPolicyIdHandoffsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/policy-handoffs/{handoffId}/finalization": { "post": { "operationId": "postVaultsByVaultIdPolicyHandoffsByHandoffIdFinalization", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "handoffId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "transactionHash", "reason" ], "properties": { "transactionHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVaultsByVaultIdPolicyHandoffsByHandoffIdFinalizationResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/simulations": { "post": { "operationId": "postSimulations", "tags": [ "simulations" ], "x-klineo-if-match-required-when": "body.vaultId is present", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": false, "description": "One quoted strong entity tag; required when body.vaultId is present.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "quoteProfile", "config", "assumptions", "observations", "reason" ], "properties": { "vaultId": { "type": "string", "minLength": 1 }, "quoteProfile": { "type": "string", "enum": [ "USDT", "WBOT" ] }, "config": { "type": "object", "additionalProperties": false, "required": [ "kind", "version", "targetInventoryPips", "rebalanceThresholdPips", "quoteReserveFloor", "maxCandidateAmount", "rangeWidthTicks", "diversificationTriggerPips" ], "properties": { "kind": { "type": "string", "enum": [ "BOOTSTRAP", "MAINTAIN", "DIVERSIFY" ] }, "version": { "type": "string", "minLength": 1, "maxLength": 80 }, "targetInventoryPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "rebalanceThresholdPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "quoteReserveFloor": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "maxCandidateAmount": { "type": "string", "pattern": "^[1-9][0-9]*$" }, "rangeWidthTicks": { "type": "integer", "exclusiveMinimum": 0, "maximum": 1774544 }, "diversificationTriggerPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "diversificationMandate": { "type": "object", "additionalProperties": false, "required": [ "executionMode", "totalTokenSaleCap", "dailyTokenSaleCap", "hourlyTokenSaleCap", "maximumOrganicVolumeParticipationPips", "minimumSalePriceX18", "minimumRetainedTokenBalance", "targetProtectedQuoteReserve", "validUntil", "proceedsRule", "repurchaseAllowed", "unlockDisclosureArtifactHash", "insiderWalletDisclosureArtifactHash", "publicReportingMode" ], "properties": { "executionMode": { "const": "ISSUER_SAFE_APPROVAL_ONLY" }, "totalTokenSaleCap": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "dailyTokenSaleCap": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "hourlyTokenSaleCap": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "maximumOrganicVolumeParticipationPips": { "type": "integer", "minimum": 1, "maximum": 1000000 }, "minimumSalePriceX18": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "minimumRetainedTokenBalance": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "targetProtectedQuoteReserve": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "validUntil": { "type": "string", "format": "date-time" }, "proceedsRule": { "const": "PROTECTED_QUOTE_RESERVE" }, "repurchaseAllowed": { "const": false }, "unlockDisclosureArtifactHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "insiderWalletDisclosureArtifactHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "publicReportingMode": { "type": "string", "enum": [ "PRIVATE", "ISSUER_APPROVED_PUBLIC" ] } } } } }, "assumptions": { "type": "object", "additionalProperties": false, "required": [ "gasCostQuote", "platformFeePips", "volatilityShockPips", "keeperDelaySeconds" ], "properties": { "initialTokenBalance": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "initialQuoteBalance": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "gasCostQuote": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "platformFeePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "volatilityShockPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "keeperDelaySeconds": { "type": "integer", "minimum": 0, "maximum": 86400 }, "oracleOutageAt": { "type": "integer", "minimum": 0 }, "oneWayFlowShockPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "gasSpikePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "incentiveIncomeQuote": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "reorgDepth": { "type": "integer", "minimum": 0, "maximum": 1000 } } }, "observations": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "timestamp", "tokenPriceX18", "tokenDecimals", "quoteDecimals", "tokenBalance", "quoteBalance", "grossFeesQuote", "gasSpentQuote", "depthQuote", "inPolicyBand" ], "properties": { "blockNumber": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "blockHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "transactionHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "transactionIndex": { "type": "integer", "minimum": 0 }, "logIndex": { "type": "integer", "minimum": 0 }, "sourceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "eventType": { "type": "string", "enum": [ "SWAP", "MINT", "BURN", "COLLECT" ] }, "eventProvenance": { "type": "string", "enum": [ "EXTERNAL_POOL_FLOW", "KLINEO_ACTION" ] }, "gasAccounting": { "type": "string", "enum": [ "MODELED_ACTION_ASSUMPTION", "OBSERVED_KLINEO_ACTION" ] }, "amount0Delta": { "type": "string", "pattern": "^-?(0|[1-9][0-9]*)$" }, "amount1Delta": { "type": "string", "pattern": "^-?(0|[1-9][0-9]*)$" }, "liquidityDelta": { "type": "string", "pattern": "^-?(0|[1-9][0-9]*)$" }, "modeledPoolFee0Atomic": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "modeledPoolFee1Atomic": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "feeModel": { "const": "GROSS_INPUT_FEE_PIPS_V1" }, "vaultStateBefore": { "type": "object", "additionalProperties": false, "required": [ "idleToken0", "idleToken1", "accruedFees0", "accruedFees1", "positions" ], "properties": { "idleToken0": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "idleToken1": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "accruedFees0": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "accruedFees1": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "positions": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "positionId", "tickLower", "tickUpper", "liquidity" ], "properties": { "positionId": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "tickLower": { "type": "integer" }, "tickUpper": { "type": "integer" }, "liquidity": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" } } } } } }, "timestamp": { "type": "string", "format": "date-time" }, "tokenPriceX18": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "tokenDecimals": { "type": "integer", "minimum": 0, "maximum": 36 }, "quoteDecimals": { "type": "integer", "minimum": 0, "maximum": 36 }, "tokenBalance": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "quoteBalance": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "grossFeesQuote": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "gasSpentQuote": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "depthQuote": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "inPolicyBand": { "type": "boolean" }, "sqrtPriceX96": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "tick": { "type": "integer", "minimum": -887272, "maximum": 887272 }, "tickSpacing": { "type": "integer", "exclusiveMinimum": 0, "maximum": 16384 }, "activeLiquidity": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "activeLiquidityPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "policyState": { "type": "object", "additionalProperties": false, "required": [ "finalized", "sourceMaximumStalenessSeconds", "positionCount", "protectedQuoteReserve", "realizedLossToday", "turnoverToday", "actionsToday", "sources" ], "properties": { "finalized": { "const": true }, "sourceMaximumStalenessSeconds": { "type": "integer", "exclusiveMinimum": 0, "maximum": 2592000 }, "positionCount": { "type": "integer", "minimum": 0 }, "protectedQuoteReserve": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "realizedLossToday": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "turnoverToday": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "actionsToday": { "type": "integer", "minimum": 0 }, "lastActionAt": { "type": "string", "format": "date-time" }, "sources": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "sourceId", "sourceKind", "status", "observedAt", "blockNumber", "priceX18", "confidencePips" ], "properties": { "sourceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "sourceKind": { "type": "string", "enum": [ "PRIMARY_ORACLE", "SECONDARY_ORACLE", "POOL_TWAP" ] }, "status": { "type": "string", "enum": [ "OK", "DEGRADED", "STALE", "DIVERGENT", "UNAVAILABLE" ] }, "observedAt": { "type": "string", "format": "date-time" }, "blockNumber": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "priceX18": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "confidencePips": { "type": "integer", "minimum": 0, "maximum": 1000000 } } }, "minItems": 3 } } } } }, "minItems": 2, "maxItems": 100000 }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "202": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/BackgroundJob" } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/simulations/indexed": { "post": { "operationId": "postSimulationsIndexed", "tags": [ "simulations" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "vaultId", "datasetId", "config", "policy", "assumptions", "reason" ], "properties": { "vaultId": { "type": "string", "minLength": 1 }, "datasetId": { "type": "string", "minLength": 1 }, "config": { "type": "object", "additionalProperties": false, "required": [ "kind", "version", "targetInventoryPips", "rebalanceThresholdPips", "quoteReserveFloor", "maxCandidateAmount", "rangeWidthTicks", "diversificationTriggerPips" ], "properties": { "kind": { "type": "string", "enum": [ "BOOTSTRAP", "MAINTAIN", "DIVERSIFY" ] }, "version": { "type": "string", "minLength": 1, "maxLength": 80 }, "targetInventoryPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "rebalanceThresholdPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "quoteReserveFloor": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "maxCandidateAmount": { "type": "string", "pattern": "^[1-9][0-9]*$" }, "rangeWidthTicks": { "type": "integer", "exclusiveMinimum": 0, "maximum": 1774544 }, "diversificationTriggerPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "diversificationMandate": { "type": "object", "additionalProperties": false, "required": [ "executionMode", "totalTokenSaleCap", "dailyTokenSaleCap", "hourlyTokenSaleCap", "maximumOrganicVolumeParticipationPips", "minimumSalePriceX18", "minimumRetainedTokenBalance", "targetProtectedQuoteReserve", "validUntil", "proceedsRule", "repurchaseAllowed", "unlockDisclosureArtifactHash", "insiderWalletDisclosureArtifactHash", "publicReportingMode" ], "properties": { "executionMode": { "const": "ISSUER_SAFE_APPROVAL_ONLY" }, "totalTokenSaleCap": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "dailyTokenSaleCap": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "hourlyTokenSaleCap": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "maximumOrganicVolumeParticipationPips": { "type": "integer", "minimum": 1, "maximum": 1000000 }, "minimumSalePriceX18": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "minimumRetainedTokenBalance": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "targetProtectedQuoteReserve": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "validUntil": { "type": "string", "format": "date-time" }, "proceedsRule": { "const": "PROTECTED_QUOTE_RESERVE" }, "repurchaseAllowed": { "const": false }, "unlockDisclosureArtifactHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "insiderWalletDisclosureArtifactHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "publicReportingMode": { "type": "string", "enum": [ "PRIVATE", "ISSUER_APPROVED_PUBLIC" ] } } } } }, "policy": { "type": "object", "additionalProperties": false, "required": [ "id", "version", "strategy", "strategyVersion", "configHash", "validAfter", "validUntil", "cooldownSeconds", "maxPositions", "maxOracleDeviationPips", "maxTwapDeviationPips", "minOracleConfidencePips", "minOracleObservationAgeSeconds", "maxSwapSlippagePips", "maxDailyTurnoverPips", "minActiveLiquidityPips", "minQuoteReservePips", "maxSwapPerAction", "maxSwapPerDay", "maxGasReimbursement", "maxRealizedLossPerDay", "maxCapitalPerPosition", "maxActionsPerDay", "minimumTick", "maximumTick", "maximumPositionWidthTicks", "minimumPositionWidthTicks", "allowedPools", "allowedRecipients", "executor", "guardian", "oracleGuard", "quoteProfile" ], "properties": { "id": { "type": "string", "minLength": 1 }, "version": { "type": "integer", "exclusiveMinimum": 0 }, "strategy": { "type": "string", "enum": [ "BOOTSTRAP", "MAINTAIN", "DIVERSIFY" ] }, "strategyVersion": { "type": "string", "minLength": 1 }, "configHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "validAfter": { "type": "string", "format": "date-time" }, "validUntil": { "type": "string", "format": "date-time" }, "cooldownSeconds": { "type": "integer", "minimum": 0, "maximum": 4294967295 }, "maxPositions": { "type": "integer", "exclusiveMinimum": 0, "maximum": 32 }, "maxOracleDeviationPips": { "type": "integer", "minimum": 0, "maximum": 100000 }, "maxTwapDeviationPips": { "type": "integer", "minimum": 0, "maximum": 100000 }, "minOracleConfidencePips": { "type": "integer", "minimum": 800000, "maximum": 1000000 }, "minOracleObservationAgeSeconds": { "type": "integer", "minimum": 1, "maximum": 3600 }, "maxSwapSlippagePips": { "type": "integer", "minimum": 0, "maximum": 100000 }, "maxDailyTurnoverPips": { "type": "integer", "minimum": 0, "maximum": 500000 }, "minActiveLiquidityPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "minQuoteReservePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "maxSwapPerAction": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "maxSwapPerDay": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "maxGasReimbursement": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "maxRealizedLossPerDay": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "maxCapitalPerPosition": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "maxActionsPerDay": { "type": "integer", "exclusiveMinimum": 0, "maximum": 10000 }, "minimumTick": { "type": "integer", "minimum": -887272, "maximum": 887272 }, "maximumTick": { "type": "integer", "minimum": -887272, "maximum": 887272 }, "maximumPositionWidthTicks": { "type": "integer", "exclusiveMinimum": 0, "maximum": 16777215 }, "minimumPositionWidthTicks": { "type": "integer", "exclusiveMinimum": 0, "maximum": 16777215 }, "allowedPools": { "type": "array", "items": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "minItems": 1, "maxItems": 32 }, "allowedRecipients": { "type": "array", "items": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "minItems": 1, "maxItems": 32 }, "executor": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "guardian": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "oracleGuard": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "quoteProfile": { "type": "string", "enum": [ "USDT", "WBOT" ] } } }, "assumptions": { "type": "object", "additionalProperties": false, "required": [ "gasCostQuote", "platformFeePips", "volatilityShockPips", "keeperDelaySeconds" ], "properties": { "initialTokenBalance": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "initialQuoteBalance": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "gasCostQuote": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "platformFeePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "volatilityShockPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "keeperDelaySeconds": { "type": "integer", "minimum": 0, "maximum": 86400 }, "oracleOutageAt": { "type": "integer", "minimum": 0 }, "oneWayFlowShockPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "gasSpikePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "incentiveIncomeQuote": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "reorgDepth": { "type": "integer", "minimum": 0, "maximum": 1000 } } }, "strategyMigrationReason": { "type": "string", "minLength": 12, "maxLength": 500 }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "202": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/BackgroundJob" } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/jobs/{jobId}": { "get": { "operationId": "getJobsByJobId", "tags": [ "jobs" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "jobId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/BackgroundJob" } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/simulation-datasets": { "get": { "operationId": "getSimulationDatasets", "tags": [ "simulation-datasets" ], "security": [ { "sessionCookie": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getSimulationDatasetsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/simulations/{simulationId}": { "get": { "operationId": "getSimulationsBySimulationId", "tags": [ "simulations" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "simulationId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getSimulationsBySimulationIdResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/simulations/{simulationId}/policy-draft": { "post": { "operationId": "postSimulationsBySimulationIdPolicyDraft", "tags": [ "simulations" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "simulationId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "vaultId", "policy", "reason" ], "properties": { "vaultId": { "type": "string", "minLength": 1 }, "policy": { "type": "object", "additionalProperties": false, "required": [ "id", "version", "strategy", "strategyVersion", "configHash", "validAfter", "validUntil", "cooldownSeconds", "maxPositions", "maxOracleDeviationPips", "maxTwapDeviationPips", "minOracleConfidencePips", "minOracleObservationAgeSeconds", "maxSwapSlippagePips", "maxDailyTurnoverPips", "minActiveLiquidityPips", "minQuoteReservePips", "maxSwapPerAction", "maxSwapPerDay", "maxGasReimbursement", "maxRealizedLossPerDay", "maxCapitalPerPosition", "maxActionsPerDay", "minimumTick", "maximumTick", "maximumPositionWidthTicks", "minimumPositionWidthTicks", "allowedPools", "allowedRecipients", "executor", "guardian", "oracleGuard", "quoteProfile" ], "properties": { "id": { "type": "string", "minLength": 1 }, "version": { "type": "integer", "exclusiveMinimum": 0 }, "strategy": { "type": "string", "enum": [ "BOOTSTRAP", "MAINTAIN", "DIVERSIFY" ] }, "strategyVersion": { "type": "string", "minLength": 1 }, "configHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "validAfter": { "type": "string", "format": "date-time" }, "validUntil": { "type": "string", "format": "date-time" }, "cooldownSeconds": { "type": "integer", "minimum": 0, "maximum": 4294967295 }, "maxPositions": { "type": "integer", "exclusiveMinimum": 0, "maximum": 32 }, "maxOracleDeviationPips": { "type": "integer", "minimum": 0, "maximum": 100000 }, "maxTwapDeviationPips": { "type": "integer", "minimum": 0, "maximum": 100000 }, "minOracleConfidencePips": { "type": "integer", "minimum": 800000, "maximum": 1000000 }, "minOracleObservationAgeSeconds": { "type": "integer", "minimum": 1, "maximum": 3600 }, "maxSwapSlippagePips": { "type": "integer", "minimum": 0, "maximum": 100000 }, "maxDailyTurnoverPips": { "type": "integer", "minimum": 0, "maximum": 500000 }, "minActiveLiquidityPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "minQuoteReservePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "maxSwapPerAction": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "maxSwapPerDay": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "maxGasReimbursement": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "maxRealizedLossPerDay": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "maxCapitalPerPosition": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "maxActionsPerDay": { "type": "integer", "exclusiveMinimum": 0, "maximum": 10000 }, "minimumTick": { "type": "integer", "minimum": -887272, "maximum": 887272 }, "maximumTick": { "type": "integer", "minimum": -887272, "maximum": 887272 }, "maximumPositionWidthTicks": { "type": "integer", "exclusiveMinimum": 0, "maximum": 16777215 }, "minimumPositionWidthTicks": { "type": "integer", "exclusiveMinimum": 0, "maximum": 16777215 }, "allowedPools": { "type": "array", "items": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "minItems": 1, "maxItems": 32 }, "allowedRecipients": { "type": "array", "items": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "minItems": 1, "maxItems": 32 }, "executor": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "guardian": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "oracleGuard": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "quoteProfile": { "type": "string", "enum": [ "USDT", "WBOT" ] } } }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postSimulationsBySimulationIdPolicyDraftResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/proposals": { "get": { "operationId": "getProposals", "tags": [ "proposals" ], "security": [ { "sessionCookie": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/ProposalRecord" } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/proposals": { "get": { "operationId": "getVaultsByVaultIdProposals", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/ProposalRecord" } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } }, "post": { "operationId": "postVaultsByVaultIdProposals", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "trigger" ], "properties": { "trigger": { "type": "string", "minLength": 3, "maxLength": 500 }, "simulationId": { "type": "string", "minLength": 1 }, "action": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "kind", "amount" ], "properties": { "kind": { "const": "WRAP_BOT" }, "amount": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "amount", "recipient" ], "properties": { "kind": { "const": "UNWRAP_WBOT" }, "amount": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } } } ], "discriminator": { "propertyName": "kind" } } } } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/ProposalRecord" } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/proposals/{proposalId}": { "get": { "operationId": "getProposalsByProposalId", "tags": [ "proposals" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "proposalId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/ProposalRecord" } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/proposals/{proposalId}/approve": { "post": { "operationId": "postProposalsByProposalIdApprove", "tags": [ "proposals" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "proposalId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "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": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/ProposalRecord" } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/proposals/{proposalId}/approve": { "post": { "operationId": "postVaultsByVaultIdProposalsByProposalIdApprove", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "proposalId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "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": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/ProposalRecord" } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/proposals/{proposalId}/safe-bundle": { "post": { "operationId": "postProposalsByProposalIdSafeBundle", "tags": [ "proposals" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "proposalId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "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": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/ProposalRecord" } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/proposals/{proposalId}/safe-bundle": { "post": { "operationId": "postVaultsByVaultIdProposalsByProposalIdSafeBundle", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "proposalId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "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": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/ProposalRecord" } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/proposals/{proposalId}/submissions": { "post": { "operationId": "postProposalsByProposalIdSubmissions", "tags": [ "proposals" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "proposalId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "transactionHash", "reason" ], "properties": { "transactionHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/ProposalRecord" } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/incidents": { "get": { "operationId": "getIncidents", "tags": [ "incidents" ], "security": [ { "sessionCookie": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getIncidentsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/alert-policies": { "get": { "operationId": "getAlertPolicies", "tags": [ "alert-policies" ], "security": [ { "sessionCookie": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getAlertPoliciesResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } }, "post": { "operationId": "postAlertPolicies", "tags": [ "alert-policies" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "rules", "recipients", "reason" ], "properties": { "rules": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "id", "detector", "severity", "threshold", "recipientIds", "acknowledgementDeadlineSeconds", "escalationAfterSeconds", "automaticPause" ], "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{0,79}$" }, "detector": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{2,119}$" }, "severity": { "type": "string", "enum": [ "WARNING", "CRITICAL" ] }, "threshold": { "type": "object", "additionalProperties": false, "required": [ "occurrences", "windowSeconds" ], "properties": { "occurrences": { "type": "integer", "minimum": 1, "maximum": 100 }, "windowSeconds": { "type": "integer", "minimum": 1, "maximum": 86400 } } }, "recipientIds": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 80 }, "minItems": 1, "maxItems": 25 }, "acknowledgementDeadlineSeconds": { "type": "integer", "minimum": 30, "maximum": 3600 }, "escalationAfterSeconds": { "type": "integer", "minimum": 30, "maximum": 86400 }, "automaticPause": { "type": "boolean" } } }, "minItems": 1, "maxItems": 50 }, "recipients": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "id", "label", "channel", "destination", "enabled" ], "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_-]{0,79}$" }, "label": { "type": "string", "minLength": 1, "maxLength": 120 }, "channel": { "type": "string", "enum": [ "EMAIL", "WEBHOOK" ] }, "destination": { "type": "string", "minLength": 3, "maxLength": 500 }, "enabled": { "type": "boolean" } } }, "minItems": 1, "maxItems": 25 }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postAlertPoliciesResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/alert-deliveries": { "get": { "operationId": "getAlertDeliveries", "tags": [ "alert-deliveries" ], "security": [ { "sessionCookie": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getAlertDeliveriesResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/safety-pause-commands": { "get": { "operationId": "getSafetyPauseCommands", "tags": [ "safety-pause-commands" ], "security": [ { "sessionCookie": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getSafetyPauseCommandsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/executions": { "get": { "operationId": "getVaultsByVaultIdExecutions", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getVaultsByVaultIdExecutionsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/incidents/{incidentId}/acknowledge": { "post": { "operationId": "postIncidentsByIncidentIdAcknowledge", "tags": [ "incidents" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "incidentId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "message" ], "properties": { "message": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postIncidentsByIncidentIdAcknowledgeResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/incidents/{incidentId}/mitigate": { "post": { "operationId": "postIncidentsByIncidentIdMitigate", "tags": [ "incidents" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "incidentId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "message", "ownerIds", "evidence" ], "properties": { "message": { "type": "string", "minLength": 3, "maxLength": 500 }, "ownerIds": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 120 }, "minItems": 1, "maxItems": 20 }, "evidence": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 500 }, "minItems": 1, "maxItems": 100 } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postIncidentsByIncidentIdMitigateResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/incidents/{incidentId}/resolve": { "post": { "operationId": "postIncidentsByIncidentIdResolve", "tags": [ "incidents" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "incidentId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "message", "evidence" ], "properties": { "message": { "type": "string", "minLength": 3, "maxLength": 500 }, "evidence": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 500 }, "minItems": 1, "maxItems": 100 }, "postmortemArtifactHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postIncidentsByIncidentIdResolveResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/billing": { "get": { "operationId": "getBilling", "tags": [ "billing" ], "security": [ { "sessionCookie": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getBillingResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/commercial-terms": { "post": { "operationId": "postVaultsByVaultIdCommercialTerms", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "schedule", "benchmark", "validAfter", "validUntil", "preparationReason" ], "properties": { "schedule": { "type": "object", "additionalProperties": false, "required": [ "setupFeeQuoteAtomic", "serviceFeeQuoteAtomic", "serviceFeeCadence", "performanceFeePips", "performanceFeeCapQuoteAtomic", "gasReimbursement", "gasReimbursementCapQuoteAtomic", "passThroughCostCapQuoteAtomic", "totalFeeCapQuoteAtomic", "paymentRecipient" ], "properties": { "setupFeeQuoteAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "serviceFeeQuoteAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "serviceFeeCadence": { "type": "string", "enum": [ "DAILY", "WEEKLY" ] }, "performanceFeePips": { "type": "integer", "minimum": 0, "maximum": 300000 }, "performanceFeeCapQuoteAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "gasReimbursement": { "type": "string", "enum": [ "NONE", "ACTUAL_FINALIZED_RECEIPT_GAS" ] }, "gasReimbursementCapQuoteAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "passThroughCostCapQuoteAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "totalFeeCapQuoteAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "paymentRecipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } } }, "benchmark": { "type": "object", "additionalProperties": false, "required": [ "version", "kind", "highWaterMark", "negativeCarry", "reset" ], "properties": { "version": { "const": "klineo-commercial-benchmark-v1" }, "kind": { "type": "string", "enum": [ "HOLD_OPENING_INVENTORY", "PASSIVE_FULL_RANGE" ] }, "highWaterMark": { "const": "CUMULATIVE_ALPHA_PER_SIGNED_TERMS" }, "negativeCarry": { "const": true }, "reset": { "const": "NEW_SIGNED_TERMS_ONLY" } } }, "validAfter": { "type": "string", "format": "date-time" }, "validUntil": { "type": "string", "format": "date-time" }, "preparationReason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVaultsByVaultIdCommercialTermsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/commercial-terms/{termsId}/acceptance": { "post": { "operationId": "postVaultsByVaultIdCommercialTermsByTermsIdAcceptance", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "termsId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "signature", "reason" ], "properties": { "signature": { "type": "string", "pattern": "^0x[0-9a-fA-F]+$" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVaultsByVaultIdCommercialTermsByTermsIdAcceptanceResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/reports/{reportId}/fee-accrual-preview": { "get": { "operationId": "getReportsByReportIdFeeAccrualPreview", "tags": [ "reports" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "reportId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getReportsByReportIdFeeAccrualPreviewResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/reports/{reportId}/fee-accruals": { "post": { "operationId": "postReportsByReportIdFeeAccruals", "tags": [ "reports" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "reportId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "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": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postReportsByReportIdFeeAccrualsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/invoices": { "post": { "operationId": "postInvoices", "tags": [ "invoices" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "vaultId", "accrualIds", "reason" ], "properties": { "vaultId": { "type": "string", "minLength": 1, "maxLength": 200 }, "accrualIds": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 }, "minItems": 1, "maxItems": 400 }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postInvoicesResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/invoices/{invoiceId}/payment-reconciliations": { "post": { "operationId": "postInvoicesByInvoiceIdPaymentReconciliations", "tags": [ "invoices" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "invoiceId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "transactionHash", "reason" ], "properties": { "transactionHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postInvoicesByInvoiceIdPaymentReconciliationsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/reports": { "get": { "operationId": "getReports", "tags": [ "reports" ], "security": [ { "sessionCookie": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getReportsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/reports/{reportId}/exports/{format}": { "get": { "operationId": "getReportsByReportIdExportsByFormat", "tags": [ "reports" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "reportId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "format", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getReportsByReportIdExportsByFormatResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/reports/{period}": { "get": { "operationId": "getVaultsByVaultIdReportsByPeriod", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "period", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getVaultsByVaultIdReportsByPeriodResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/reports/{reportId}/publish": { "post": { "operationId": "postReportsByReportIdPublish", "tags": [ "reports" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "reportId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "slug", "disclosure", "reason" ], "properties": { "slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "disclosure": { "type": "object", "additionalProperties": false, "required": [ "showTreasuryAmounts", "showPolicyLimits", "showIncidents" ], "properties": { "showTreasuryAmounts": { "type": "boolean" }, "showPolicyLimits": { "type": "boolean" }, "showIncidents": { "type": "boolean" } } }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postReportsByReportIdPublishResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/reports/{reportId}/publication-finalization": { "post": { "operationId": "postReportsByReportIdPublicationFinalization", "tags": [ "reports" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "reportId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "transactionHash", "reason" ], "properties": { "transactionHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postReportsByReportIdPublicationFinalizationResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/data-health": { "get": { "operationId": "getDataHealth", "tags": [ "data-health" ], "security": [ { "sessionCookie": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getDataHealthResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/ai/outputs": { "get": { "operationId": "getAiOutputs", "tags": [ "ai" ], "security": [ { "sessionCookie": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getAiOutputsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } }, "post": { "operationId": "postAiOutputs", "tags": [ "ai" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "outputType", "subject", "question" ], "properties": { "outputType": { "type": "string", "enum": [ "LIQUIDITY_DIAGNOSIS", "SIMULATION_NARRATIVE", "POLICY_DIFF_EXPLANATION", "REBALANCE_EXPLANATION", "INCIDENT_SUMMARY", "WEEKLY_LIQUIDITY_REPORT", "DATA_QUALITY_EXPLANATION" ] }, "subject": { "type": "object", "additionalProperties": false, "properties": { "vaultId": { "type": "string", "minLength": 1, "maxLength": 200 }, "simulationId": { "type": "string", "minLength": 1, "maxLength": 200 }, "policyId": { "type": "string", "minLength": 1, "maxLength": 200 }, "comparisonPolicyId": { "type": "string", "minLength": 1, "maxLength": 200 }, "proposalId": { "type": "string", "minLength": 1, "maxLength": 200 }, "incidentId": { "type": "string", "minLength": 1, "maxLength": 200 }, "reportId": { "type": "string", "minLength": 1, "maxLength": 200 } } }, "question": { "type": "string", "minLength": 3, "maxLength": 1500 } } } } } }, "responses": { "202": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/BackgroundJob" } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/ai/outputs/{outputId}": { "get": { "operationId": "getAiOutputsByOutputId", "tags": [ "ai" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "outputId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getAiOutputsByOutputIdResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/audit-events": { "get": { "operationId": "getAuditEvents", "tags": [ "audit-events" ], "security": [ { "sessionCookie": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getAuditEventsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/organizations/{orgId}/members": { "get": { "operationId": "getOrganizationsByOrgIdMembers", "tags": [ "organizations" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "orgId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getOrganizationsByOrgIdMembersResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } }, "post": { "operationId": "postOrganizationsByOrgIdMembers", "tags": [ "organizations" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "orgId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "email", "role", "expiresAt", "reason" ], "properties": { "email": { "type": "string", "format": "email", "maxLength": 320 }, "role": { "type": "string", "enum": [ "ORGANIZATION_OWNER", "TREASURY_ADMIN", "APPROVER", "ANALYST", "VIEWER", "KLINEO_OPERATOR", "RISK_GUARDIAN", "INTERNAL_AUDITOR" ] }, "expiresAt": { "type": "string", "format": "date-time" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postOrganizationsByOrgIdMembersResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/organizations/{orgId}/members/{memberId}": { "patch": { "operationId": "patchOrganizationsByOrgIdMembersByMemberId", "tags": [ "organizations" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "orgId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "memberId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "role", "reason" ], "properties": { "role": { "type": "string", "enum": [ "ORGANIZATION_OWNER", "TREASURY_ADMIN", "APPROVER", "ANALYST", "VIEWER", "KLINEO_OPERATOR", "RISK_GUARDIAN", "INTERNAL_AUDITOR" ] }, "expiresAt": { "type": "string", "format": "date-time" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "patchOrganizationsByOrgIdMembersByMemberIdResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/projects": { "post": { "operationId": "postProjects", "tags": [ "projects" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "name", "projectToken", "quoteToken", "quoteProfile", "ownerSafe", "poolAddress", "launchContext", "strategy", "qualification", "reason" ], "properties": { "name": { "type": "string", "minLength": 2, "maxLength": 80 }, "projectToken": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "quoteToken": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "quoteProfile": { "type": "string", "enum": [ "USDT", "WBOT" ] }, "ownerSafe": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "poolAddress": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "launchContext": { "type": "string", "enum": [ "PRE_TGE", "POST_LAUNCH" ] }, "strategy": { "type": "object", "additionalProperties": false, "required": [ "kind", "version", "targetInventoryPips", "rebalanceThresholdPips", "quoteReserveFloor", "maxCandidateAmount", "rangeWidthTicks", "diversificationTriggerPips" ], "properties": { "kind": { "type": "string", "enum": [ "BOOTSTRAP", "MAINTAIN", "DIVERSIFY" ] }, "version": { "type": "string", "minLength": 1, "maxLength": 80 }, "targetInventoryPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "rebalanceThresholdPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "quoteReserveFloor": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "maxCandidateAmount": { "type": "string", "pattern": "^[1-9][0-9]*$" }, "rangeWidthTicks": { "type": "integer", "exclusiveMinimum": 0, "maximum": 1774544 }, "diversificationTriggerPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "diversificationMandate": { "type": "object", "additionalProperties": false, "required": [ "executionMode", "totalTokenSaleCap", "dailyTokenSaleCap", "hourlyTokenSaleCap", "maximumOrganicVolumeParticipationPips", "minimumSalePriceX18", "minimumRetainedTokenBalance", "targetProtectedQuoteReserve", "validUntil", "proceedsRule", "repurchaseAllowed", "unlockDisclosureArtifactHash", "insiderWalletDisclosureArtifactHash", "publicReportingMode" ], "properties": { "executionMode": { "const": "ISSUER_SAFE_APPROVAL_ONLY" }, "totalTokenSaleCap": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "dailyTokenSaleCap": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "hourlyTokenSaleCap": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "maximumOrganicVolumeParticipationPips": { "type": "integer", "minimum": 1, "maximum": 1000000 }, "minimumSalePriceX18": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "minimumRetainedTokenBalance": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "targetProtectedQuoteReserve": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "validUntil": { "type": "string", "format": "date-time" }, "proceedsRule": { "const": "PROTECTED_QUOTE_RESERVE" }, "repurchaseAllowed": { "const": false }, "unlockDisclosureArtifactHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "insiderWalletDisclosureArtifactHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "publicReportingMode": { "type": "string", "enum": [ "PRIVATE", "ISSUER_APPROVED_PUBLIC" ] } } } } }, "qualification": { "type": "object", "additionalProperties": false, "required": [ "legalEntityName", "projectName", "maximumDeployableTokenAtomic", "maximumDeployableQuoteAtomic", "protectedQuoteReserveAtomic", "reserveRationale", "executionRecipientPolicy", "exitRecipient", "intendedPolicyTerm", "contacts", "launch", "tokenDisclosureArtifactHash", "governanceApprovalArtifactHash", "dataRoom", "desiredOutcomes", "prohibitedBehaviors", "referenceVenueIds", "oracleSourceAddresses" ], "properties": { "legalEntityName": { "type": "string", "minLength": 2, "maxLength": 200 }, "projectName": { "type": "string", "minLength": 2, "maxLength": 160 }, "maximumDeployableTokenAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "maximumDeployableQuoteAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "protectedQuoteReserveAtomic": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "reserveRationale": { "type": "string", "minLength": 12, "maxLength": 1000 }, "executionRecipientPolicy": { "const": "IMMUTABLE_VAULT_ONLY" }, "exitRecipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "intendedPolicyTerm": { "type": "object", "additionalProperties": false, "required": [ "validAfter", "validUntil" ], "properties": { "validAfter": { "type": "string", "format": "date-time" }, "validUntil": { "type": "string", "format": "date-time" } } }, "contacts": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "kind", "name", "email", "responseWindowMinutes" ], "properties": { "kind": { "type": "string", "enum": [ "OPERATIONS", "EMERGENCY", "GOVERNANCE" ] }, "name": { "type": "string", "minLength": 2, "maxLength": 120 }, "email": { "type": "string", "format": "email", "maxLength": 254 }, "responseWindowMinutes": { "type": "integer", "minimum": 1, "maximum": 10080 } } }, "minItems": 2, "maxItems": 12 }, "launch": { "type": "object", "additionalProperties": false, "required": [ "launchDate", "unlockScheduleArtifactHash" ], "properties": { "launchDate": { "type": "string", "format": "date-time" }, "unlockScheduleArtifactHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" } } }, "tokenDisclosureArtifactHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "governanceApprovalArtifactHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "dataRoom": { "type": "object", "additionalProperties": false, "required": [ "termsVersion", "termsSource", "acceptedAt" ], "properties": { "termsVersion": { "type": "string", "minLength": 1, "maxLength": 120 }, "termsSource": { "type": "string", "minLength": 3, "maxLength": 500 }, "acceptedAt": { "type": "string", "format": "date-time" } } }, "desiredOutcomes": { "type": "array", "items": { "type": "string", "minLength": 3, "maxLength": 500 }, "minItems": 1, "maxItems": 20 }, "prohibitedBehaviors": { "type": "array", "items": { "type": "string", "minLength": 3, "maxLength": 500 }, "minItems": 1, "maxItems": 20 }, "referenceVenueIds": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 }, "minItems": 1, "maxItems": 20 }, "oracleSourceAddresses": { "type": "array", "items": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "minItems": 2, "maxItems": 2 } } }, "reason": { "type": "string", "minLength": 12, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postProjectsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/projects/{projectId}": { "get": { "operationId": "getProjectsByProjectId", "tags": [ "projects" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "projectId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getProjectsByProjectIdResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/projects/{projectId}/eligibility-assessments": { "post": { "operationId": "postProjectsByProjectIdEligibilityAssessments", "tags": [ "projects" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "projectId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "reason" ], "properties": { "reason": { "type": "string", "minLength": 12, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postProjectsByProjectIdEligibilityAssessmentsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/projects/{projectId}/data-room/uploads": { "post": { "operationId": "postProjectsByProjectIdDataRoomUploads", "tags": [ "projects" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "projectId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DataRoomUploadRequest" } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/DataRoomUploadResponse" } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/projects/{projectId}/lifecycle-transitions": { "post": { "operationId": "postProjectsByProjectIdLifecycleTransitions", "tags": [ "projects" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "projectId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "to", "reason" ], "properties": { "to": { "type": "string", "enum": [ "LEAD", "QUALIFIED", "DATA_ROOM", "SIMULATED", "POLICY_DRAFT", "TESTNET", "SHADOW", "FUND_READY", "LIVE_CAPPED", "LIVE_EXPANDED" ] }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postProjectsByProjectIdLifecycleTransitionsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/deploy": { "post": { "operationId": "postVaultsByVaultIdDeploy", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "amount0", "amount1", "minimumReceived0", "minimumReceived1", "reason" ], "properties": { "amount0": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "amount1": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "minimumReceived0": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "minimumReceived1": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, { "type": "object", "additionalProperties": false, "required": [ "reason" ], "properties": { "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } ] } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVaultsByVaultIdDeployResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/funding-intents": { "post": { "operationId": "postVaultsByVaultIdFundingIntents", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "amount0", "amount1", "minimumReceived0", "minimumReceived1", "reason" ], "properties": { "amount0": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "amount1": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "minimumReceived0": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "minimumReceived1": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVaultsByVaultIdFundingIntentsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/pause": { "post": { "operationId": "postVaultsByVaultIdPause", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "reason" ], "properties": { "action": { "type": "string", "enum": [ "PAUSE" ] }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 }, "resumeLifecycle": { "type": "string", "enum": [ "TESTNET", "SHADOW", "FUND_READY", "LIVE_CAPPED", "LIVE_EXPANDED" ] }, "exitMinimums": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "positionId", "amount0Min", "amount1Min" ], "properties": { "positionId": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "amount0Min": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "amount1Min": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" } } }, "maxItems": 64 }, "withdrawalAmounts": { "type": "object", "additionalProperties": false, "required": [ "amount0", "amount1" ], "properties": { "amount0": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "amount1": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" } } } } } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVaultsByVaultIdPauseResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/exit-preview": { "post": { "operationId": "postVaultsByVaultIdExitPreview", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "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": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVaultsByVaultIdExitPreviewResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/exit": { "post": { "operationId": "postVaultsByVaultIdExit", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "reason" ], "properties": { "action": { "type": "string", "enum": [ "PARTIAL_WITHDRAW", "ENTER_EXITING", "FINALIZE_EXIT" ] }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 }, "resumeLifecycle": { "type": "string", "enum": [ "TESTNET", "SHADOW", "FUND_READY", "LIVE_CAPPED", "LIVE_EXPANDED" ] }, "exitMinimums": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "positionId", "amount0Min", "amount1Min" ], "properties": { "positionId": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "amount0Min": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "amount1Min": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" } } }, "maxItems": 64 }, "withdrawalAmounts": { "type": "object", "additionalProperties": false, "required": [ "amount0", "amount1" ], "properties": { "amount0": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "amount1": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" } } } } } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVaultsByVaultIdExitResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/balances": { "get": { "operationId": "getVaultsByVaultIdBalances", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getVaultsByVaultIdBalancesResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/simulations/{simulationId}/artifacts": { "get": { "operationId": "getSimulationsBySimulationIdArtifacts", "tags": [ "simulations" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "simulationId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getSimulationsBySimulationIdArtifactsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/strategy-evaluations": { "post": { "operationId": "postVaultsByVaultIdStrategyEvaluations", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "trigger" ], "properties": { "trigger": { "type": "string", "minLength": 3, "maxLength": 500 }, "simulationId": { "type": "string", "minLength": 1 }, "action": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "kind", "amount" ], "properties": { "kind": { "const": "WRAP_BOT" }, "amount": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "amount", "recipient" ], "properties": { "kind": { "const": "UNWRAP_WBOT" }, "amount": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } } } ], "discriminator": { "propertyName": "kind" } } } } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/ProposalRecord" } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/strategy-state": { "get": { "operationId": "getVaultsByVaultIdStrategyState", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getVaultsByVaultIdStrategyStateResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/policies": { "get": { "operationId": "getVaultsByVaultIdPolicies", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getVaultsByVaultIdPoliciesResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } }, "post": { "operationId": "postVaultsByVaultIdPolicies", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "policy", "reason" ], "properties": { "policy": { "type": "object", "additionalProperties": false, "required": [ "id", "version", "strategy", "strategyVersion", "configHash", "validAfter", "validUntil", "cooldownSeconds", "maxPositions", "maxOracleDeviationPips", "maxTwapDeviationPips", "minOracleConfidencePips", "minOracleObservationAgeSeconds", "maxSwapSlippagePips", "maxDailyTurnoverPips", "minActiveLiquidityPips", "minQuoteReservePips", "maxSwapPerAction", "maxSwapPerDay", "maxGasReimbursement", "maxRealizedLossPerDay", "maxCapitalPerPosition", "maxActionsPerDay", "minimumTick", "maximumTick", "maximumPositionWidthTicks", "minimumPositionWidthTicks", "allowedPools", "allowedRecipients", "executor", "guardian", "oracleGuard", "quoteProfile" ], "properties": { "id": { "type": "string", "minLength": 1 }, "version": { "type": "integer", "exclusiveMinimum": 0 }, "strategy": { "type": "string", "enum": [ "BOOTSTRAP", "MAINTAIN", "DIVERSIFY" ] }, "strategyVersion": { "type": "string", "minLength": 1 }, "configHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "validAfter": { "type": "string", "format": "date-time" }, "validUntil": { "type": "string", "format": "date-time" }, "cooldownSeconds": { "type": "integer", "minimum": 0, "maximum": 4294967295 }, "maxPositions": { "type": "integer", "exclusiveMinimum": 0, "maximum": 32 }, "maxOracleDeviationPips": { "type": "integer", "minimum": 0, "maximum": 100000 }, "maxTwapDeviationPips": { "type": "integer", "minimum": 0, "maximum": 100000 }, "minOracleConfidencePips": { "type": "integer", "minimum": 800000, "maximum": 1000000 }, "minOracleObservationAgeSeconds": { "type": "integer", "minimum": 1, "maximum": 3600 }, "maxSwapSlippagePips": { "type": "integer", "minimum": 0, "maximum": 100000 }, "maxDailyTurnoverPips": { "type": "integer", "minimum": 0, "maximum": 500000 }, "minActiveLiquidityPips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "minQuoteReservePips": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "maxSwapPerAction": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "maxSwapPerDay": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "maxGasReimbursement": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "maxRealizedLossPerDay": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "maxCapitalPerPosition": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "maxActionsPerDay": { "type": "integer", "exclusiveMinimum": 0, "maximum": 10000 }, "minimumTick": { "type": "integer", "minimum": -887272, "maximum": 887272 }, "maximumTick": { "type": "integer", "minimum": -887272, "maximum": 887272 }, "maximumPositionWidthTicks": { "type": "integer", "exclusiveMinimum": 0, "maximum": 16777215 }, "minimumPositionWidthTicks": { "type": "integer", "exclusiveMinimum": 0, "maximum": 16777215 }, "allowedPools": { "type": "array", "items": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "minItems": 1, "maxItems": 32 }, "allowedRecipients": { "type": "array", "items": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "minItems": 1, "maxItems": 32 }, "executor": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "guardian": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "oracleGuard": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "quoteProfile": { "type": "string", "enum": [ "USDT", "WBOT" ] } } }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 }, "sourceSimulationId": { "type": "string", "minLength": 1 } } } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVaultsByVaultIdPoliciesResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/policies/{version}/review": { "post": { "operationId": "postVaultsByVaultIdPoliciesByVersionReview", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "version", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "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": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVaultsByVaultIdPoliciesByVersionReviewResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/policies/{version}/approve": { "post": { "operationId": "postVaultsByVaultIdPoliciesByVersionApprove", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "version", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "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": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVaultsByVaultIdPoliciesByVersionApproveResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/policies/{version}/activate": { "post": { "operationId": "postVaultsByVaultIdPoliciesByVersionActivate", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "version", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "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": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVaultsByVaultIdPoliciesByVersionActivateResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/policies/{version}/revoke": { "post": { "operationId": "postVaultsByVaultIdPoliciesByVersionRevoke", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "version", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "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": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVaultsByVaultIdPoliciesByVersionRevokeResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/proposals/{proposalId}/reject": { "post": { "operationId": "postProposalsByProposalIdReject", "tags": [ "proposals" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "proposalId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "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": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/ProposalRecord" } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/proposals/{proposalId}/submit": { "post": { "operationId": "postProposalsByProposalIdSubmit", "tags": [ "proposals" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "proposalId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "transactionHash", "reason" ], "properties": { "transactionHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/ProposalRecord" } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/proposals/{proposalId}/execution": { "get": { "operationId": "getProposalsByProposalIdExecution", "tags": [ "proposals" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "proposalId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/ProposalRecord" } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/proposals/{proposalId}/reconciliation": { "get": { "operationId": "getProposalsByProposalIdReconciliation", "tags": [ "proposals" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "proposalId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/ProposalRecord" } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/market-quality": { "get": { "operationId": "getVaultsByVaultIdMarketQuality", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getVaultsByVaultIdMarketQualityResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/data-health": { "get": { "operationId": "getVaultsByVaultIdDataHealth", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getVaultsByVaultIdDataHealthResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/incidents": { "get": { "operationId": "getVaultsByVaultIdIncidents", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getVaultsByVaultIdIncidentsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/incidents/{incidentId}/acknowledge": { "post": { "operationId": "postVaultsByVaultIdIncidentsByIncidentIdAcknowledge", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "incidentId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "message" ], "properties": { "message": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "postVaultsByVaultIdIncidentsByIncidentIdAcknowledgeResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/evidence": { "get": { "operationId": "getVaultsByVaultIdEvidence", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getVaultsByVaultIdEvidenceResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/events": { "get": { "operationId": "getVaultsByVaultIdEvents", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getVaultsByVaultIdEventsResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/vaults/{vaultId}/reports": { "post": { "operationId": "postVaultsByVaultIdReports", "tags": [ "vaults" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "vaultId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 163 } }, { "name": "If-Match", "in": "header", "required": true, "description": "One quoted strong entity tag for the exact aggregate version reviewed by the actor.", "schema": { "type": "string", "minLength": 3, "pattern": "^\"[^\"\\\\\\r\\n]+\"$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "cadence", "reason" ], "properties": { "cadence": { "type": "string", "enum": [ "DAILY", "WEEKLY" ] }, "periodEnd": { "type": "string", "format": "date-time" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } } } }, "responses": { "202": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/BackgroundJob" } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/reports/{reportId}": { "get": { "operationId": "getReportsByReportId", "tags": [ "reports" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "reportId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getReportsByReportIdResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/reports/{reportId}/performance-series": { "get": { "operationId": "getReportsByReportIdPerformanceSeries", "tags": [ "reports" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "reportId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/ReportPerformanceSeries" } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/reports/{reportId}/download": { "get": { "operationId": "getReportsByReportIdDownload", "tags": [ "reports" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "reportId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getReportsByReportIdDownloadResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/organizations/{orgId}/fee-schedule": { "get": { "operationId": "getOrganizationsByOrgIdFeeSchedule", "tags": [ "organizations" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "orgId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getOrganizationsByOrgIdFeeScheduleResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } }, "/organizations/{orgId}/invoices": { "get": { "operationId": "getOrganizationsByOrgIdInvoices", "tags": [ "organizations" ], "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "orgId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true, "title": "getOrganizationsByOrgIdInvoicesResult", "description": "The typed runtime domain record returned by this operation." } } } } } }, "default": { "description": "Structured API error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorEnvelope" } } } } } } } }, "components": { "securitySchemes": { "sessionCookie": { "type": "apiKey", "in": "cookie", "name": "__Host-klineo_session", "description": "Backend-owned PostgreSQL session cookie. Local non-TLS development uses klineo_session." } }, "schemas": { "VaultLifecycle": { "type": "string", "enum": [ "LEAD", "QUALIFIED", "DATA_ROOM", "SIMULATED", "POLICY_DRAFT", "TESTNET", "SHADOW", "FUND_READY", "LIVE_CAPPED", "LIVE_EXPANDED", "PAUSED", "EXITING", "CLOSED" ] }, "VaultMode": { "type": "string", "enum": [ "OBSERVE", "RECOMMEND", "BOUNDED_EXECUTE", "EMERGENCY" ] }, "StrategyKind": { "type": "string", "enum": [ "BOOTSTRAP", "MAINTAIN", "DIVERSIFY" ] }, "QuoteProfile": { "type": "string", "enum": [ "USDT", "WBOT" ] }, "SourceStatus": { "type": "string", "enum": [ "OK", "DEGRADED", "STALE", "DIVERGENT", "UNAVAILABLE" ] }, "OracleStatus": { "type": "string", "enum": [ "OK", "DEGRADED", "STALE", "DIVERGENT", "UNAVAILABLE" ] }, "RiskDelta": { "type": "string", "enum": [ "REDUCING", "NEUTRAL", "EXPANDING" ] }, "ProposalState": { "type": "string", "enum": [ "DRAFT", "INPUT_VALIDATED", "STRATEGY_COMPUTED", "POLICY_ALLOWED", "POLICY_REJECTED", "TX_SIMULATED", "SHADOWED", "SIMULATION_FAILED", "APPROVAL_PENDING", "AUTO_AUTHORIZED", "READY", "SUBMITTING", "SUBMITTED", "REPLACED", "INCLUDED", "FINALIZED", "EXECUTION_FAILED", "RECONCILED", "RECONCILIATION_FAILED", "ATTRIBUTED", "REJECTED", "EXPIRED", "SUPERSEDED", "CANCELLED" ] }, "ClaimClassification": { "type": "string", "enum": [ "PROVEN", "SUPPORTED", "INFERRED", "PROJECTED" ] }, "IncidentSeverity": { "type": "string", "enum": [ "WARNING", "CRITICAL" ] }, "BackgroundJobState": { "type": "string", "enum": [ "PENDING", "LEASED", "COMPLETED", "FAILED", "DEAD_LETTER" ] }, "StrategyVersion": { "type": "string", "minLength": 1 }, "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" } } } } }, "ApiErrorEnvelope": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "$ref": "#/components/schemas/ApiError" } } }, "PolicyVersion": { "type": "object", "additionalProperties": true, "required": [ "id", "version", "strategy", "strategyVersion", "configHash", "validAfter", "validUntil" ], "properties": { "id": { "type": "string" }, "version": { "type": "integer", "minimum": 1 }, "strategy": { "$ref": "#/components/schemas/StrategyKind" }, "strategyVersion": { "$ref": "#/components/schemas/StrategyVersion" }, "configHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "validAfter": { "type": "string", "format": "date-time" }, "validUntil": { "type": "string", "format": "date-time" }, "riskDelta": { "$ref": "#/components/schemas/RiskDelta" }, "onchainPolicyHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" } } }, "TypedVaultAction": { "oneOf": [ { "type": "object", "additionalProperties": true, "required": [ "kind" ], "properties": { "kind": { "const": "COLLECT_FEES" } } }, { "type": "object", "additionalProperties": true, "required": [ "kind" ], "properties": { "kind": { "const": "OPEN_POSITION" } } }, { "type": "object", "additionalProperties": true, "required": [ "kind" ], "properties": { "kind": { "const": "INCREASE_LIQUIDITY" } } }, { "type": "object", "additionalProperties": true, "required": [ "kind" ], "properties": { "kind": { "const": "REBALANCE_POSITION" } } }, { "type": "object", "additionalProperties": true, "required": [ "kind" ], "properties": { "kind": { "const": "DECREASE_LIQUIDITY" } } }, { "type": "object", "additionalProperties": true, "required": [ "kind" ], "properties": { "kind": { "const": "CLOSE_POSITION" } } }, { "type": "object", "additionalProperties": true, "required": [ "kind" ], "properties": { "kind": { "const": "SWAP_EXACT_INPUT" } } }, { "type": "object", "additionalProperties": true, "required": [ "kind" ], "properties": { "kind": { "const": "PROTECT_RESERVE" } } }, { "type": "object", "additionalProperties": true, "required": [ "kind" ], "properties": { "kind": { "const": "WRAP_BOT" } } }, { "type": "object", "additionalProperties": true, "required": [ "kind" ], "properties": { "kind": { "const": "UNWRAP_WBOT" } } } ], "discriminator": { "propertyName": "kind" } }, "EvidenceReference": { "type": "object", "additionalProperties": false, "required": [ "id", "kind", "contentHash", "freshness" ], "properties": { "id": { "type": "string" }, "kind": { "type": "string" }, "contentHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "observedAt": { "type": "string", "format": "date-time" }, "freshness": { "type": "string", "enum": [ "CURRENT", "STALE", "DEGRADED", "HISTORICAL", "UNAVAILABLE" ] } } }, "ApprovalRequirement": { "type": "object", "additionalProperties": false, "required": [ "role", "required", "collected" ], "properties": { "role": { "type": "string" }, "required": { "type": "integer", "minimum": 1 }, "collected": { "type": "integer", "minimum": 0 }, "satisfied": { "type": "boolean" } } }, "DecisionPacket": { "type": "object", "additionalProperties": true, "required": [ "id", "state", "action", "evidence", "approvals" ], "properties": { "id": { "type": "string" }, "state": { "$ref": "#/components/schemas/ProposalState" }, "action": { "$ref": "#/components/schemas/TypedVaultAction" }, "evidence": { "type": "array", "items": { "$ref": "#/components/schemas/EvidenceReference" } }, "approvals": { "type": "array", "items": { "$ref": "#/components/schemas/ApprovalRequirement" } } } }, "ProposalRecord": { "type": "object", "additionalProperties": true, "required": [ "id", "organizationId", "vaultId", "state", "trigger", "strategyResult", "replacementTransactionHashes", "createdAt", "updatedAt" ], "properties": { "id": { "type": "string" }, "organizationId": { "type": "string" }, "vaultId": { "type": "string" }, "state": { "$ref": "#/components/schemas/ProposalState" }, "trigger": { "type": "string" }, "strategyResult": { "type": "object", "additionalProperties": true }, "action": { "$ref": "#/components/schemas/TypedVaultAction" }, "simulationId": { "type": "string" }, "transactionHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "replacementTransactionHashes": { "type": "array", "items": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" } }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" } } }, "SafeTransactionBundle": { "type": "object", "additionalProperties": false, "required": [ "version", "chainId", "createdAt", "meta", "transactions" ], "properties": { "version": { "const": "1.0" }, "chainId": { "type": "string", "enum": [ "677", "968" ] }, "createdAt": { "type": "string", "format": "date-time" }, "meta": { "type": "object", "additionalProperties": true, "required": [ "name", "description", "createdFromSafeAddress" ], "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "createdFromSafeAddress": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } } }, "transactions": { "type": "array", "minItems": 1, "items": { "type": "object", "additionalProperties": true, "required": [ "to", "value", "data", "contractMethod", "contractInputsValues" ], "properties": { "to": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "value": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)$" }, "data": { "type": "string", "pattern": "^0x(?:[0-9a-fA-F]{2})*$" } } } } } }, "ExecutionReceipt": { "type": "object", "additionalProperties": false, "required": [ "transactionHash", "blockNumber", "blockHash", "status" ], "properties": { "transactionHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "blockNumber": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)$" }, "blockHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "status": { "type": "string", "enum": [ "INCLUDED", "FINALIZED", "REVERTED" ] }, "gasUsed": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)$" }, "observedAt": { "type": "string", "format": "date-time" } } }, "ReconciliationResult": { "type": "object", "additionalProperties": false, "required": [ "status", "mismatches", "evidenceHash" ], "properties": { "status": { "type": "string", "enum": [ "MATCHED", "MISMATCH", "RETRYING", "ESCALATED" ] }, "mismatches": { "type": "array", "items": { "type": "string" } }, "evidenceHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" } } }, "SimulationScenario": { "type": "string", "enum": [ "BASE", "PRICE_GAP", "ONE_WAY_FLOW", "KEEPER_DELAY", "ORACLE_OUTAGE", "REORG", "GAS_SPIKE", "INCENTIVE_REMOVAL" ] }, "SimulationResult": { "type": "object", "additionalProperties": true, "required": [ "evidenceMode", "strategy", "strategyVersion", "quoteProfile", "startingValueQuote", "endingValueQuote", "netResultQuote" ], "properties": { "evidenceMode": { "type": "string", "enum": [ "CANONICAL_V3_REPLAY", "DIAGNOSTIC_AGGREGATE" ] }, "strategy": { "$ref": "#/components/schemas/StrategyKind" }, "strategyVersion": { "$ref": "#/components/schemas/StrategyVersion" }, "quoteProfile": { "$ref": "#/components/schemas/QuoteProfile" }, "startingValueQuote": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)$" }, "endingValueQuote": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)$" }, "netResultQuote": { "type": "string", "pattern": "^-?(?:0|[1-9][0-9]*)$" } } }, "MarketSnapshot": { "type": "object", "additionalProperties": true, "required": [ "id", "chainId", "blockNumber", "blockHash", "finalized", "capturedAt", "poolAddress", "sources" ], "properties": { "id": { "type": "string" }, "chainId": { "type": "integer", "enum": [ 677, 968 ] }, "blockNumber": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)$" }, "blockHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "finalized": { "type": "boolean" }, "capturedAt": { "type": "string", "format": "date-time" }, "poolAddress": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "sources": { "type": "array", "items": { "type": "object", "additionalProperties": true } } } }, "MarketQualityMetric": { "type": "object", "additionalProperties": false, "required": [ "name", "value", "unit", "status", "evidence" ], "properties": { "name": { "type": "string" }, "value": { "type": "string" }, "unit": { "type": "string" }, "status": { "$ref": "#/components/schemas/SourceStatus" }, "evidence": { "type": "array", "items": { "$ref": "#/components/schemas/EvidenceReference" } } } }, "PublicProofDisclosure": { "type": "object", "additionalProperties": false, "required": [ "showTreasuryAmounts", "showPolicyLimits", "showIncidents" ], "properties": { "showTreasuryAmounts": { "type": "boolean" }, "showPolicyLimits": { "type": "boolean" }, "showIncidents": { "type": "boolean" } } }, "AccessRequestSubmission": { "type": "object", "additionalProperties": false, "required": [ "name", "email", "project", "cf-turnstile-response" ], "properties": { "name": { "type": "string", "minLength": 2, "maxLength": 120 }, "email": { "type": "string", "format": "email", "maxLength": 254 }, "project": { "type": "string", "minLength": 2, "maxLength": 160 }, "cf-turnstile-response": { "type": "string", "minLength": 1, "maxLength": 2048, "writeOnly": true } } }, "AccessRequestReceipt": { "type": "object", "additionalProperties": false, "required": [ "referenceId", "status", "receivedAt", "supportEmail" ], "properties": { "referenceId": { "type": "string" }, "status": { "const": "RECEIVED" }, "receivedAt": { "type": "string", "format": "date-time" }, "supportEmail": { "type": "string", "format": "email" } } }, "DataRoomUploadRequest": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "action", "artifactKind", "fileName", "mediaType", "sizeBytes", "reason" ], "properties": { "action": { "const": "PREPARE" }, "artifactKind": { "type": "string", "minLength": 2, "maxLength": 120 }, "fileName": { "type": "string", "minLength": 1, "maxLength": 240 }, "mediaType": { "type": "string", "minLength": 3, "maxLength": 160 }, "sizeBytes": { "type": "string", "pattern": "^[1-9][0-9]*$", "description": "1 byte to 50 MiB" }, "expectedArtifactHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } }, { "type": "object", "additionalProperties": false, "required": [ "action", "uploadId", "expectedArtifactHash", "reason" ], "properties": { "action": { "const": "FINALIZE" }, "uploadId": { "type": "string", "minLength": 1, "maxLength": 512 }, "expectedArtifactHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "reason": { "type": "string", "minLength": 3, "maxLength": 500 } } } ], "discriminator": { "propertyName": "action" } }, "DataRoomUploadResponse": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "status", "receiptId", "uploadId", "method", "uploadUrl", "requiredHeaders", "expiresAt", "preparationEvidenceHash" ], "properties": { "status": { "const": "UPLOAD_AUTHORIZED" }, "receiptId": { "type": "string" }, "uploadId": { "type": "string" }, "method": { "const": "PUT" }, "uploadUrl": { "type": "string", "format": "uri", "writeOnly": true }, "requiredHeaders": { "type": "object", "additionalProperties": { "type": "string" }, "writeOnly": true }, "expiresAt": { "type": "string", "format": "date-time" }, "preparationEvidenceHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" } } }, { "type": "object", "additionalProperties": false, "required": [ "status", "receiptId", "uploadId", "expiresAt", "preparationEvidenceHash" ], "properties": { "status": { "const": "UPLOAD_AUTHORIZATION_NOT_RETAINED" }, "receiptId": { "type": "string" }, "uploadId": { "type": "string" }, "expiresAt": { "type": "string", "format": "date-time" }, "preparationEvidenceHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" } } }, { "type": "object", "additionalProperties": false, "required": [ "status", "receiptId", "uploadId", "artifactKind", "artifactHash", "mediaType", "sizeBytes", "source", "objectVersion", "scanProvider", "scanEvidenceHash", "scannedAt", "evidenceHash" ], "properties": { "status": { "const": "CLEAN" }, "receiptId": { "type": "string" }, "uploadId": { "type": "string" }, "artifactKind": { "type": "string" }, "artifactHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "mediaType": { "type": "string" }, "sizeBytes": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)$" }, "source": { "type": "string", "format": "uri" }, "objectVersion": { "type": "string" }, "scanProvider": { "type": "string" }, "scanEvidenceHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "scannedAt": { "type": "string", "format": "date-time" }, "evidenceHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" } } } ], "discriminator": { "propertyName": "status" } }, "BackgroundJob": { "type": "object", "additionalProperties": false, "required": [ "id", "kind", "resultId", "state", "attempts", "availableAt", "createdAt", "updatedAt" ], "properties": { "id": { "type": "string", "minLength": 1 }, "kind": { "type": "string", "enum": [ "DIAGNOSTIC_SIMULATION", "INDEXED_SIMULATION", "AI_OUTPUT", "REPORT_GENERATION" ] }, "resultId": { "type": "string", "minLength": 1 }, "state": { "$ref": "#/components/schemas/BackgroundJobState" }, "attempts": { "type": "integer", "minimum": 0, "maximum": 5 }, "availableAt": { "type": "string", "format": "date-time" }, "lastErrorCode": { "type": "string" }, "result": { "type": "object", "additionalProperties": false, "required": [ "resourceType", "resourceIds", "evidenceHashes" ], "properties": { "resourceType": { "type": "string", "enum": [ "simulation", "ai_output", "report" ] }, "resourceIds": { "type": "array", "minItems": 1, "maxItems": 1, "items": { "type": "string" } }, "evidenceHashes": { "type": "array", "minItems": 1, "maxItems": 1, "items": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" } } } }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "completedAt": { "type": "string", "format": "date-time" } } }, "ReportPerformanceSeriesPoint": { "type": "object", "additionalProperties": false, "required": [ "at", "valueQuote", "snapshotHash", "blockNumber", "dailyReportId", "dailyReportContentHash" ], "properties": { "at": { "type": "string", "format": "date-time" }, "valueQuote": { "type": "string", "pattern": "^-?(?:0|[1-9][0-9]*)$" }, "snapshotHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "blockNumber": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)$" }, "dailyReportId": { "type": "string" }, "dailyReportContentHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "benchmarkArtifactHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" } } }, "ReportPerformanceSeriesLane": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "status", "points" ], "properties": { "status": { "const": "AVAILABLE" }, "points": { "type": "array", "minItems": 7, "maxItems": 7, "items": { "$ref": "#/components/schemas/ReportPerformanceSeriesPoint" } } } }, { "type": "object", "additionalProperties": false, "required": [ "status", "reason" ], "properties": { "status": { "const": "UNAVAILABLE" }, "reason": { "type": "string", "minLength": 1 } } } ], "discriminator": { "propertyName": "status" } }, "ReportPerformanceSeries": { "description": "Evidence-backed daily quote-token atomic values for the selected seven-day UTC report. Each lane may independently be unavailable; values are not USD.", "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "status", "reportId", "reason" ], "properties": { "status": { "const": "UNAVAILABLE" }, "reportId": { "type": "string" }, "reason": { "type": "string", "minLength": 1 } } }, { "type": "object", "additionalProperties": false, "required": [ "status", "reportId", "reportContentHash", "reportBundleHash", "periodStart", "periodEnd", "quoteToken", "quoteProfile", "quoteDecimals", "openingNavQuote", "portfolio", "hold", "fullRange" ], "properties": { "status": { "const": "AVAILABLE" }, "reportId": { "type": "string" }, "reportContentHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "reportBundleHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "periodStart": { "type": "string", "format": "date-time" }, "periodEnd": { "type": "string", "format": "date-time" }, "quoteToken": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "quoteProfile": { "$ref": "#/components/schemas/QuoteProfile" }, "quoteDecimals": { "type": "integer", "minimum": 0, "maximum": 255 }, "openingNavQuote": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)$" }, "portfolio": { "$ref": "#/components/schemas/ReportPerformanceSeriesLane" }, "hold": { "$ref": "#/components/schemas/ReportPerformanceSeriesLane" }, "fullRange": { "$ref": "#/components/schemas/ReportPerformanceSeriesLane" } } } ], "discriminator": { "propertyName": "status" } } } } }