hoox Gateway Isolate Profile

​

🏗️ Architectural Topology

​

⚡ 1. Declared Wrangler Configurations & Bindings

{
  "name": "hoox",
  "main": "src/index.ts",
  "compatibility_date": "2026-05-19",
  "compatibility_flags": ["nodejs_compat"],
  "account_id": "debc6545e63bea36be059cbc82d80ec8",
  "placement": {
    "mode": "smart",
  },
  "vars": {
    "ENVIRONMENT": "production",
  },
  "kv_namespaces": [
    {
      "binding": "CONFIG_KV",
      "id": "c5917667a21745e390ff969f32b1847d",
    },
    {
      "binding": "SESSIONS_KV",
      "id": "ff70a58b492e45d79880a7a8213c745c",
    },
  ],
  "services": [
    { "binding": "TRADE_SERVICE", "service": "trade-worker" },
    { "binding": "TELEGRAM_SERVICE", "service": "telegram-worker" },
  ],
  "queues": {
    "producers": [{ "queue": "trade-execution", "binding": "TRADE_QUEUE" }],
  },
  "durable_objects": {
    "bindings": [
      { "name": "IDEMPOTENCY_STORE", "class_name": "IdempotencyStore" },
    ],
  },
  "migrations": [
    {
      "tag": "v1",
      "new_sqlite_classes": ["IdempotencyStore"],
    },
  ],
}

​

🔑 2. Environmental Variables & Encrypted Secrets

• WEBHOOK_API_KEY: The custom authentication passkey expected inside incoming signal payloads.
• INTERNAL_KEY_BINDING: The shared bearer authorization token used by requireInternalAuth middleware to invoke internal V8 isolates.

​

Local Development Mocking (.dev.vars)

WEBHOOK_API_KEY=dev_webhook_auth_passkey
INTERNAL_KEY_BINDING=dev_shared_internal_security_key

​

🛜 3. API Route Specifications

Note: For the canonical endpoint directory with full request/response examples across all workers, see /docs/devops/api/endpoints.

​

A. Ingest Signal Webhook

• Endpoint: /webhook
• Method: POST
• JSON Payload:
  {
    "apiKey": "dev_webhook_auth_passkey",
    "exchange": "bybit",
    "action": "LONG",
    "symbol": "BTCUSDT",
    "quantity": 0.01,
    "leverage": 10,
    "idempotencyKey": "uuid-9b1deb4d-3b7d"
  }
  
• Success Response (200 OK):
  {
    "success": true,
    "requestId": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
    "exchange": "bybit",
    "symbol": "BTCUSDT",
    "action": "LONG",
    "result": { "orderId": "18049284739", "status": "Filled" }
  }
  

​

B. Gateway Health Diagnostics

• Endpoint: /health
• Method: GET
• Success Response (200 OK):
  {
    "status": "ok",
    "timestamp": 1779261050000,
    "bindings": {
      "d1": "connected",
      "kv": "connected",
      "queue": "active"
    }
  }
  

​

🔗 Next Steps

• trade-worker Spec — Review how trade executions, order math, and margin settings compile on the edge.
• D1 Database Operations — Manage schema migrations, query ledgers, and execute SQL scripts.