{"openapi":"3.1.0","info":{"title":"AuditForge AI","description":"AI-powered Smart Contract Security Copilot. Combines rule-based static analysis with LLM-assisted review (Fireworks AI) to help Solidity developers triage vulnerabilities before a full manual audit.","version":"1.0.0"},"paths":{"/audit":{"post":{"tags":["audit"],"summary":"Audit a Solidity smart contract","description":"Runs rule-based vulnerability scanning combined with AI-assisted analysis (Fireworks AI) over the supplied Solidity source code, returning a security score, risk classification, findings, and gas optimization suggestions.","operationId":"audit_contract_audit_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/health":{"get":{"tags":["system"],"summary":"Health check","operationId":"health_check_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response Health Check Health Get"}}}}}}},"/":{"get":{"tags":["system"],"summary":"Service info","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response Root  Get"}}}}}}}},"components":{"schemas":{"AuditRequest":{"properties":{"code":{"type":"string","minLength":1,"title":"Code","description":"Raw Solidity source code to be audited.","examples":["pragma solidity ^0.8.0;\n\ncontract Example {\n    function withdraw() public {}\n}"]}},"type":"object","required":["code"],"title":"AuditRequest","description":"Payload for a smart contract audit request."},"AuditResponse":{"properties":{"project":{"type":"string","title":"Project","default":"AuditForge AI"},"security_score":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Security Score"},"risk":{"$ref":"#/components/schemas/RiskLevel"},"summary":{"type":"string","title":"Summary"},"issues":{"items":{"$ref":"#/components/schemas/Issue"},"type":"array","title":"Issues"},"gas_optimizations":{"items":{"type":"string"},"type":"array","title":"Gas Optimizations"}},"type":"object","required":["security_score","risk","summary"],"title":"AuditResponse","description":"Full audit report returned by POST /audit."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"Issue":{"properties":{"title":{"type":"string","title":"Title","description":"Short name of the vulnerability."},"severity":{"$ref":"#/components/schemas/Severity","description":"Severity of the finding."},"description":{"type":"string","title":"Description","description":"Explanation of the issue."},"recommendation":{"type":"string","title":"Recommendation","description":"How to remediate it."}},"type":"object","required":["title","severity","description","recommendation"],"title":"Issue","description":"A single security finding."},"RiskLevel":{"type":"string","enum":["Safe","Low Risk","Medium Risk","High Risk"],"title":"RiskLevel","description":"Overall contract risk classification."},"Severity":{"type":"string","enum":["Critical","High","Medium","Low","Info"],"title":"Severity","description":"Severity classification for a single detected issue."},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}