API Reference

http://localhost:4200
https://yourname.ela.city

Authorization: Bearer <session_token>
Cookie: session=<session_token>

GET /whoami

{
  "user": {
    "uuid": "123e4567-e89b-12d3-a456-426614174000",
    "username": "alice",
    "wallet": "0x1234567890abcdef...",
    "authenticated": true
  }
}

{
  "user": {
    "authenticated": false
  }
}

POST /auth/particle
Content-Type: application/json
 
{
  "uuid": "particle-user-id",
  "address": "0x1234567890abcdef...",
  "token": "particle-jwt-token"
}

{
  "success": true,
  "user": { ... },
  "sessionToken": "abc123..."
}

GET /read?path=/Documents/hello.txt

Hello, World!

POST /write
Content-Type: multipart/form-data
 
path: /Documents/hello.txt
file: <file data>

{
  "success": true,
  "path": "/Documents/hello.txt"
}

GET /readdir?path=/Documents

[
  {
    "name": "hello.txt",
    "type": "file",
    "size": 13,
    "modified": "2024-01-15T10:30:00Z"
  },
  {
    "name": "subfolder",
    "type": "directory",
    "modified": "2024-01-14T08:00:00Z"
  }
]

GET /stat?path=/Documents/hello.txt

{
  "name": "hello.txt",
  "path": "/Documents/hello.txt",
  "type": "file",
  "size": 13,
  "modified": "2024-01-15T10:30:00Z",
  "created": "2024-01-15T10:30:00Z"
}

POST /mkdir
Content-Type: application/json
 
{
  "path": "/Documents/newfolder"
}

{
  "success": true,
  "path": "/Documents/newfolder"
}

POST /delete
Content-Type: application/json
 
{
  "path": "/Documents/hello.txt"
}

{
  "success": true
}

POST /move
Content-Type: application/json
 
{
  "source": "/Documents/hello.txt",
  "destination": "/Documents/renamed.txt"
}

{
  "success": true,
  "path": "/Documents/renamed.txt"
}

POST /api/wasm/execute-file
Content-Type: application/json
 
{
  "filepath": "/apps/calculator.wasm",
  "function": "add",
  "args": [5, 3]
}

{
  "success": true,
  "result": 8
}

POST /api/wasm/execute
Content-Type: application/json
 
{
  "wasmBytes": "<base64-encoded-wasm>",
  "function": "calculate",
  "args": [10, 20]
}

POST /api/ai/chat
Content-Type: application/json
 
{
  "provider": "openai",
  "model": "gpt-4o",
  "messages": [
    {"role": "user", "content": "Hello!"}
  ],
  "stream": true
}

data: {"chunk": "Hello"}
data: {"chunk": "! How"}
data: {"chunk": " can I help?"}
data: [DONE]

GET /api/ai/models

{
  "providers": {
    "ollama": ["deepseek-r1:7b", "llama3"],
    "openai": ["gpt-4o", "gpt-4o-mini"],
    "anthropic": ["claude-3-opus", "claude-3-sonnet"]
  }
}

GET /api/update/version

{
  "version": "1.0.0",
  "commit": "abc123",
  "buildDate": "2024-01-15T10:00:00Z"
}

GET /api/update/status

{
  "currentVersion": "1.0.0",
  "latestVersion": "1.1.0",
  "updateAvailable": true,
  "releaseNotes": "Bug fixes and performance improvements"
}

POST /api/update/check

{
  "updateAvailable": true,
  "latestVersion": "1.1.0"
}

POST /api/update/install

{
  "success": true,
  "message": "Update started"
}

GET /api/update/progress

{
  "isUpdating": true,
  "progress": "Installing dependencies..."
}

POST /api/backup/create

{
  "success": true,
  "filename": "backup-2024-01-15-103000.tar.gz",
  "size": 15728640
}

GET /api/backup/list

{
  "backups": [
    {
      "filename": "backup-2024-01-15-103000.tar.gz",
      "size": 15728640,
      "created": "2024-01-15T10:30:00Z"
    }
  ]
}

GET /api/backup/download/:filename

GET /health

{
  "status": "ok",
  "database": "connected",
  "ipfs": "available",
  "uptime": 86400
}

GET /api/boson/status

{
  "nodeId": "2abc...",
  "did": "did:boson:2abc...",
  "connected": true,
  "proxyEnabled": true,
  "allocatedPort": 25001
}

{
  "error": true,
  "message": "Description of error",
  "code": "ERROR_CODE"
}