@reverbia/portal 1.0.0

package/README.md

@@ -0,0 +1,58 @@
+# AI Portal
+
+AI Portal is a prepaid escrow-based API gateway for wallet-authenticated LLM
+usage. It provides an OpenAI-compatible API with on-chain settlement for AI
+inference costs.
+
+- `server`: Handles API requests, user authentication, billing, and manages
+  communication with LLM providers.
+- `worker`: Processes AI inference settlements.
+
+## Getting Started
+
+### Prerequisites
+
+- Go 1.23+
+- PostgreSQL 15+
+- ZetaChain RPC endpoint
+- golangci-lint v2 (for development)
+  ```bash
+  go install github.com/golangci/golangci-lint/v2/cmd/golangci-lint@v2.1.6
+  ```
+
+### Installation
+
+```bash
+make install
+```
+
+**Install only server**
+
+```bash
+make install-server
+```
+
+**Install only worker**
+
+```bash
+make install-worker
+```
+
+### Configuration
+
+See `.env.example` for available configuration options.
+
+### Running Tests
+
+```bash
+make test
+```
+
+### Generate API specification and client
+
+```bash
+make generate
+```
+
+This command regenerates both the Swagger specification in `docs` and the
+TypeScript client in `typescript`.

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@reverbia/portal",
+  "version": "1.0.0",
+  "description": "AI Portal is a prepaid escrow-based API gateway for wallet-authenticated LLM usage. It provides an OpenAI-compatible API with on-chain settlement for AI inference costs.",
+  "main": "index.js",
+  "directories": {
+    "doc": "docs"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "prepack": "node -e \"require('fs').copyFileSync('docs/swagger.json','swagger.json')\"",
+    "postpack": "node -e \"try{require('fs').unlinkSync('swagger.json')}catch(e){if(e.code!=='ENOENT')throw e;}\""
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zeta-chain/ai-portal.git"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "type": "commonjs",
+  "files": [
+    "swagger.json"
+  ],
+  "bugs": {
+    "url": "https://github.com/zeta-chain/ai-portal/issues"
+  },
+  "homepage": "https://github.com/zeta-chain/ai-portal#readme"
+}

package/swagger.json

@@ -0,0 +1,7 @@
+{
+    "components": {"schemas":{"github_com_zeta-chain_ai-portal_pkg_llmapi.ChatCompletionRequest":{"properties":{"messages":{"description":"Messages is the conversation history","items":{"$ref":"#/components/schemas/github_com_zeta-chain_ai-portal_pkg_llmapi.Message"},"type":"array","uniqueItems":false},"model":{"description":"Model is the model identifier","type":"string"},"stream":{"description":"Stream indicates if response should be streamed","type":"boolean"}},"type":"object"},"github_com_zeta-chain_ai-portal_pkg_llmapi.ChatCompletionResponse":{"properties":{"choices":{"description":"Choices contains the completion choices","items":{"$ref":"#/components/schemas/github_com_zeta-chain_ai-portal_pkg_llmapi.Choice"},"type":"array","uniqueItems":false},"id":{"description":"ID is the completion ID","type":"string"},"model":{"description":"Model is the model used","type":"string"}},"type":"object"},"github_com_zeta-chain_ai-portal_pkg_llmapi.Choice":{"properties":{"finish_reason":{"description":"FinishReason indicates why the completion stopped","type":"string"},"index":{"description":"Index is the choice index","type":"integer"},"message":{"$ref":"#/components/schemas/github_com_zeta-chain_ai-portal_pkg_llmapi.Message"}},"type":"object"},"github_com_zeta-chain_ai-portal_pkg_llmapi.Message":{"description":"Message is the generated message","properties":{"content":{"description":"Content is the message content","type":"string"},"role":{"$ref":"#/components/schemas/github_com_zeta-chain_ai-portal_pkg_llmapi.Role"}},"type":"object"},"github_com_zeta-chain_ai-portal_pkg_llmapi.Role":{"description":"Role is the message role (system, user, assistant)","type":"string","x-enum-varnames":["RoleAssistant","RoleUser","RoleSystem"]},"github_com_zeta-chain_ai-portal_pkg_response.ErrorResponse":{"properties":{"error":{"type":"string"}},"type":"object"},"internal_api_handlers.HealthResponse":{"properties":{"status":{"description":"Status indicates the service health status","type":"string"},"timestamp":{"description":"Timestamp is the Unix timestamp of the response","type":"integer"},"version":{"description":"Version is the current API version","type":"string"}},"type":"object"}}},
+    "info": {"title":"","version":""},
+    "externalDocs": {"description":"","url":""},
+    "paths": {"/api/v1/chat/completions":{"post":{"description":"Generates a chat completion using the configured gateway.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/github_com_zeta-chain_ai-portal_pkg_llmapi.ChatCompletionRequest"}}},"description":"Chat completion request","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/github_com_zeta-chain_ai-portal_pkg_llmapi.ChatCompletionResponse"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/github_com_zeta-chain_ai-portal_pkg_response.ErrorResponse"}}},"description":"Bad Request"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/github_com_zeta-chain_ai-portal_pkg_response.ErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Create chat completion","tags":["Chat"]}},"/health":{"get":{"description":"Returns the current health status of the service.","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/internal_api_handlers.HealthResponse"}}},"description":"OK"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/github_com_zeta-chain_ai-portal_pkg_response.ErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Health check","tags":["Health"]}}},
+    "openapi": "3.1.0"
+}