openapi: 3.2.0
info:
  title: Vaultfire Agent Hub Bonds 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: Bonds
  description: Partnership and accountability bonds
paths:
  /agent/bond:
    post:
      operationId: createBond
      summary: Build a partnership bond creation transaction
      tags:
      - Bonds
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - walletAddress
              - agentAddress
              - amountEth
              properties:
                walletAddress:
                  type: string
                agentAddress:
                  type: string
                amountEth:
                  type: string
                chain:
                  type: string
                  enum:
                  - base
                  - avalanche
                  - arbitrum
                  - polygon
                  default: base
      responses:
        '200':
          description: Unsigned bond creation transaction
  /agent/partnerships:
    get:
      operationId: getPartnerships
      summary: List all partnership bonds for an address
      tags:
      - Bonds
      parameters:
      - name: address
        in: query
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Bond list