openapi: 3.2.0
info:
  title: Livepeer CLI Local HTTP Staking API
  description: 'Local control-plane HTTP endpoints exposed by the Livepeer node.


    The CLI HTTP API provides programmatic access to node management functions

    including status monitoring, staking operations, orchestrator configuration,

    and broadcast settings.


    **Default Ports:**

    - Gateway: http://localhost:5935

    - Orchestrator: http://localhost:7935

    '
  version: 1.0.0
  contact:
    name: Livepeer Documentation
    url: https://docs.livepeer.org
servers:
- url: http://localhost:5935
  description: Gateway CLI API (default)
- url: http://localhost:7935
  description: Orchestrator CLI API
tags:
- name: Staking
  description: Token bonding and delegation operations
paths:
  /bond:
    post:
      tags:
      - Staking
      summary: Bond tokens to an orchestrator
      description: Delegate LPT tokens to an orchestrator
      operationId: bondTokens
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - amount
              - to
              properties:
                amount:
                  type: string
                  description: Amount of LPT to bond (in wei)
                  example: '1000000000000000000'
                to:
                  type: string
                  description: Orchestrator address to bond to
                  example: '0x1234567890abcdef1234567890abcdef12345678'
      responses:
        '200':
          description: Bond successful
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransactionResponse'
  /unbond:
    post:
      tags:
      - Staking
      summary: Unbond tokens
      description: Remove delegated tokens (starts unbonding period)
      operationId: unbondTokens
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - amount
              properties:
                amount:
                  type: string
                  description: Amount of LPT to unbond (in wei)
                  example: '1000000000000000000'
      responses:
        '200':
          description: Unbond initiated successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransactionResponse'
  /rebond:
    post:
      tags:
      - Staking
      summary: Rebond tokens
      description: Rebond tokens in unbonding state
      operationId: rebondTokens
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                unbondingLockId:
                  type: integer
                  description: ID of the unbonding lock to rebond
                  example: 0
      responses:
        '200':
          description: Rebond successful
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransactionResponse'
components:
  schemas:
    TransactionResponse:
      type: object
      properties:
        txHash:
          type: string
          description: Transaction hash
          example: 0x...
        status:
          type: string
          description: Transaction status
          example: success