openapi: 3.2.0
info:
  title: Vaultfire Agent Hub Identity 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: Identity
  description: VNS naming service
paths:
  /agent/vns:
    get:
      operationId: resolveVNS
      summary: Resolve a .vns name or reverse-resolve an address
      tags:
      - Identity
      parameters:
      - name: chain
        in: query
        required: true
        schema:
          type: string
          enum:
          - base
          - arbitrum
          - polygon
        description: VNS available on Base, Arbitrum, Polygon (not Avalanche)
      - name: name
        in: query
        required: false
        schema:
          type: string
        description: VNS name to resolve
      - name: address
        in: query
        required: false
        schema:
          type: string
        description: Address to reverse-resolve
      responses:
        '200':
          description: VNS resolution result