VLN Math API Documentation

Version 0.4.0 • Base URL: https://math.api.caleralabs.com

Overview

VLN Math provides high-performance, hardware-anchored mathematical execution on the Volumetric Lattice Network. The API enforces 1-Tick physical stability refusal for computational physics and O(1) logarithmic factor superposition walks with zero float64 accumulation drift.

Authentication

All requests require a domain-scoped API key passed via the X-API-Key header or standard Bearer token:

Authorization: Bearer vln_math_live_samplekey12345
X-API-Key: vln_math_live_samplekey12345

Endpoints

POST /v1/math/evaluate

Evaluates numerical expressions, PDE stability conditions, or logarithmic factor chains.

Request Body (CFL Stability Check)

{
  "mode": "cfl_check",
  "params": {
    "dt": 0.05,
    "dx": 0.5,
    "alpha": 1.0
  }
}

Response (200 OK)

{
  "status": 200,
  "evaluation": {
    "mode": "cfl_stability_refusal",
    "cfl_ratio": 0.2,
    "cfl_limit": 0.5,
    "stable": true,
    "tick_cost_ns": 142
  }
}

Python & Node.js Examples

Python

import requests

response = requests.post(
    "https://math.api.caleralabs.com/v1/math/evaluate",
    headers={"X-API-Key": "vln_math_your_api_key"},
    json={
        "mode": "cfl_check",
        "params": {"dt": 0.05, "dx": 0.5, "alpha": 1.0}
    }
)
print(response.json())

JavaScript / cURL

curl -X POST https://math.api.caleralabs.com/v1/math/evaluate \
  -H "X-API-Key: vln_math_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"mode":"cfl_check","params":{"dt":0.05,"dx":0.5,"alpha":1.0}}'