Averray Pool API

openapi: 3.2.0
info:
  title: Averray HTTP Pool API
  version: 0.2.0
  description: Public discovery, standalone Verify, and wallet-authenticated buyer and worker operations. Work and accounts settle on Polkadot Hub mainnet; paid Verify uses Base USDC. Operator/admin and session-settlement verifier operations are intentionally excluded. Read live discovery for availability and payment terms.
servers:
- url: https://api.averray.com
  description: Public mainnet API
tags:
- name: Pool
  description: Live pool state and wallet-bound unsigned templates.
paths:
  /pool:
    get:
      tags:
      - Pool
      operationId: getDepositPool
      summary: Read live deposit-pool state and risk
      description: Public pool caps, headroom, venue/yield observations and risk disclosure. An optional SIWE bearer adds the caller's principal, vesting and capacity. Resolve the pool address from this response, never from a cached deployment assumption.
      security:
      - {}
      - bearerAuth: []
      responses:
        '200':
          description: Read live deposit-pool state and risk
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
        '401':
          $ref: '#/components/responses/Unauthorized'
        '503':
          description: The configured pool cannot currently be read.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /pool/transactions:
    post:
      tags:
      - Pool
      operationId: buildDepositPoolTransactions
      summary: Build unsigned pool deposit or withdrawal templates; no platform signature or…
      description: Build unsigned pool deposit or withdrawal templates; no platform signature or broadcast.
      security:
      - bearerAuth: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              oneOf:
              - type: object
                required:
                - direction
                - assets
                properties:
                  direction:
                    const: deposit
                  assets:
                    type: string
                    pattern: ^[0-9]+$
                    description: Exact positive integer base units, not a decimal or floating-point number.
                additionalProperties: false
              - type: object
                required:
                - direction
                - assets
                properties:
                  direction:
                    const: withdraw
                  assets:
                    type: string
                    pattern: ^[0-9]+$
                    description: Exact positive integer base units, not a decimal or floating-point number.
                additionalProperties: false
              - type: object
                required:
                - direction
                - shares
                properties:
                  direction:
                    const: withdraw
                  shares:
                    type: string
                    pattern: ^[0-9]+$
                    description: Exact positive integer base units, not a decimal or floating-point number.
                additionalProperties: false
      responses:
        '200':
          description: Wallet-bound unsigned transaction templates. The wallet signs and broadcasts; no relay.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
        '400':
          description: Malformed input or insufficient available balance.
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '503':
          description: The required chain capability is unavailable.
components:
  responses:
    Forbidden:
      description: The authenticated wallet does not have the required role.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Unauthorized:
      description: Authentication is required.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            missingToken:
              value:
                error: missing_token
                message: Authentication required.
                requestId: f865d489-2400-469a-945a-3c54e74e5b9e
  schemas:
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
        status:
          type: string
        code:
          type: string
          description: Compatibility error-code field used by a small number of conflict responses.
        message:
          type: string
        details:
          description: Optional structured context for validation, authentication, or conflict failures.
        requestId:
          type: string
      additionalProperties: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT