openapi: 3.2.0
info:
  title: Vaultfire Agent Hub Keys API
  version: 3.4.0
  description: The trust infrastructure for AI agents. On-chain identity, verifiable reputation, partnership bonds, task marketplace, cross-chain bridge, and more. All endpoints are public and require no authentication for reads.
  contact:
    url: https://theloopbreaker.com
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
servers:
- url: https://theloopbreaker.com/api
  description: Production
tags:
- name: Keys
  description: Vaultfire Key Protocol — session keys, delegation, wallets
paths:
  /agent/keys:
    get:
      operationId: getVKPStatus
      summary: VKP status — session keys, delegations, key wallets
      tags:
      - Keys
      parameters:
      - name: chain
        in: query
        required: true
        schema:
          type: string
          enum:
          - base
          - avalanche
          - arbitrum
          - polygon
      responses:
        '200':
          description: VKP stats from SessionKeyManager, DelegationRegistry, Factory
    post:
      operationId: prepareVKPAction
      summary: Prepare a VKP transaction — createWallet, createSession, delegate, revoke
      tags:
      - Keys
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - action
              - walletAddress
              properties:
                action:
                  type: string
                  enum:
                  - createWallet
                  - createSession
                  - delegate
                  - revoke
                  - revokeSession
                walletAddress:
                  type: string
                chain:
                  type: string
                  default: base
      responses:
        '200':
          description: Contract address and ABI for VKP action