feat: add VASP directory endpoint

.stainless/stainless.yml

@@ -406,6 +406,13 @@ resources:
     methods:
       list: get /uma-providers
 
+  vasps:
+    models:
+      vasp: '#/components/schemas/Vasp'
+      vasp_list_response: '#/components/schemas/VaspListResponse'
+    methods:
+      list: get /vasps
+
   tokens:
     models:
       permission: '#/components/schemas/Permission'

mintlify/style.css

@@ -1372,6 +1372,12 @@ ul.sidebar-group > li[data-title="Available UMA Providers"] > button::before {
   background-image: url('/images/icons/at.svg') !important;
 }
 
+/* VASPs - globe */
+.sidebar-group > li[data-title="VASPs"] > button::before,
+ul.sidebar-group > li[data-title="VASPs"] > button::before {
+  background-image: url('/images/icons/globe.svg') !important;
+}
+
 /* API Tokens - key */
 .sidebar-group > li[data-title="API Tokens"] > button::before,
 ul.sidebar-group > li[data-title="API Tokens"] > button::before {

openapi/components/schemas/vasps/Vasp.yaml

@@ -0,0 +1,18 @@
+type: object
+required:
+  - vaspName
+  - displayName
+properties:
+  vaspName:
+    type: string
+    description: >-
+      Canonical name for this VASP. Pass this value as `vaspName` when
+      declaring a VASP-hosted counterparty.
+    example: Kraken
+  displayName:
+    type: string
+    description: Human-friendly display name for this VASP.
+    example: Kraken
+description: >-
+  A Virtual Asset Service Provider (VASP) — an exchange or other custodial
+  platform — recognized for counterparty declarations.

openapi/components/schemas/vasps/VaspListResponse.yaml

@@ -0,0 +1,21 @@
+type: object
+required:
+  - data
+  - hasMore
+properties:
+  data:
+    type: array
+    description: List of VASPs matching the filter criteria
+    items:
+      $ref: ./Vasp.yaml
+  hasMore:
+    type: boolean
+    description: Indicates if more results are available beyond this page
+  nextCursor:
+    type: string
+    description: >-
+      Cursor to retrieve the next page of results (only present if
+      hasMore is true)
+  totalCount:
+    type: integer
+    description: Total number of results matching the criteria

openapi/paths/vasps/vasps.yaml

@@ -0,0 +1,62 @@
+get:
+  summary: List VASPs
+  description: |
+    Retrieve the directory of Virtual Asset Service Providers (exchanges and
+    other custodial platforms) recognized for counterparty declarations.
+    Search by name to find the VASP that custodies a counterparty account.
+
+    The `vaspName` field in each result is the value to pass as `vaspName`
+    when declaring a VASP-hosted counterparty.
+  operationId: listVasps
+  tags:
+    - VASPs
+  security:
+    - BasicAuth: []
+  parameters:
+    - name: search
+      in: query
+      description: Filter to VASPs whose name matches this string
+      required: false
+      schema:
+        type: string
+        example: kraken
+    - name: limit
+      in: query
+      description: Maximum number of results to return (default 20, max 100)
+      required: false
+      schema:
+        type: integer
+        minimum: 1
+        maximum: 100
+        default: 20
+    - name: cursor
+      in: query
+      description: Cursor for pagination (returned from previous request)
+      required: false
+      schema:
+        type: string
+  responses:
+    '200':
+      description: Successful operation
+      content:
+        application/json:
+          schema:
+            $ref: ../../components/schemas/vasps/VaspListResponse.yaml
+    '400':
+      description: Bad request - Invalid parameters
+      content:
+        application/json:
+          schema:
+            $ref: ../../components/schemas/errors/Error400.yaml
+    '401':
+      description: Unauthorized
+      content:
+        application/json:
+          schema:
+            $ref: ../../components/schemas/errors/Error401.yaml
+    '500':
+      description: Internal service error
+      content:
+        application/json:
+          schema:
+            $ref: ../../components/schemas/errors/Error500.yaml