openapi: 3.1.0
info:
  title: Julie Autonomous EVM Security & Honeypot Scanner
  description: Real-time EVM smart contract security analysis, opcode disassembly, honeypot risk detection, and proxy implementation resolution for ChatGPT users.
  version: 1.0.0
servers:
  - url: https://julie.freysa.dev
paths:
  /api/scan:
    get:
      operationId: scanContractSecurity
      summary: Audit an EVM smart contract for honeypot traps, hidden mints, and malicious opcodes
      parameters:
        - name: contract
          in: query
          required: true
          description: The 0x EVM smart contract address to scan
          schema:
            type: string
            example: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
        - name: chain
          in: query
          required: false
          description: Blockchain network (base, arbitrum, bsc, eth)
          schema:
            type: string
            default: "base"
            example: "base"
      responses:
        '200':
          description: Detailed smart contract security report
          content:
            application/json:
              schema:
                type: object
                properties:
                  contract:
                    type: string
                  chain:
                    type: string
                  risk_level:
                    type: string
                    example: "LOW_RISK"
                  honeypot_score:
                    type: integer
                    example: 0
                  verdict:
                    type: string
                  flags:
                    type: array
                    items:
                      type: string
                  is_proxy:
                    type: boolean
                  implementation_address:
                    type: string
                  shield_badge_url:
                    type: string