Stream 01 · Flagship Trust Manifold API (/v1/verify)
Plain-English translation: Checks every claim your model generates against your source documents and domain constraints—releasing verified claims in 2.5ms–35ms and holding back ungrounded claims with the exact diagnostic reason.
1. Purpose & Architectural Role
The primary verification endpoint for TrustInference.app and Quantsultant.dev. Projects candidate model completions and source context onto the bounded GRAMS™ manifold, enforces compiler gates C1–C7 (entity, numeric, temporal, polarity, clinical dosage/financial restatement, citation, and Jacobian schema invariance), and returns a cryptographic trajectory hash (sg_...) for O(1) cache reuse.
Cross-references: System Architecture · GRAMS™ Manifold & GRMA · 3 Runtime Shells (FastAPI, Go, Rust).
2. Request Schema (POST /v1/verify)
All requests require Content-Type: application/json and an Argon2id-scoped bearer header (Authorization: Bearer tw_live_...) issued via /v1/auth/argon2-verify.
| Field | Type | Requirement | Specification |
|---|---|---|---|
query | string | Required | The user prompt, clinical scenario, or financial audit query being verified. |
context_chunks | array | Optional | Retrieved source passages or structured database rows against which claims are grounded. |
model | string | Optional | Upstream foundation model identifier (e.g., gpt-4o, claude-3-7-sonnet, gemini-2.5-pro, llama-3.3-70b). |
strict_polarity | boolean | Optional | Enforces zero-tolerance C4 polarity and C5 clinical dosage/financial sign verification (default: true). |
3. Response Schema
Responses are deterministic JSON payloads returned with X-Powered-By: Quantsultant-GRAMS-Engine/2.5ms-Edge and zero customer payload retention at rest.
| Field | Type | Deterministic Guarantee |
|---|---|---|
stream | string | Canonical stream identifier (01 · Flagship Trust Manifold). |
wrapped_model | string | Echoes the upstream model wrapped by the verification kernel. |
cryptographic_hash | string | Irreversible FNV-1a / SHA-256 trajectory digest (sg_...) stored in the O(1) Geodesic Vault. |
verdict | string | GRAMS_VERIFIED_PASS when all stability conditions hold, or GRAMS_TRUNCATED_DRIFT with diagnostic gate codes. |
metrics | object | Verified telemetry including hallucination_floor_pct (0.08), single_pass_token_reduction_pct (44.0), cache_savings_pct (82.0), and latency_ms. |
4. Deterministic Examples & Live Edge Sandbox
Switch between cURL, Python (FastAPI), Go 1.22, and Native Rust below, or click Run Live Edge Test to execute a real verification call against the Cloudflare Edge Gateway.
curl -X POST https://quantsultant.dev/v1/verify \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tw_live_9f4a8c2e1b7d6035a4c8e2f1" \
-d '{
"query": "Verify Q3 SEC 10-K Capex restatement ($142.5M) and clinical dosage polarity (5.0 mg).",
"model": "model-agnostic-any-llm",
"strict_polarity": true
}'
import requests
# 01 · Flagship Trust Manifold API (POST /v1/verify) — FastAPI / Python 3.11+ SDK Client
resp = requests.request(
"POST",
"https://quantsultant.dev/v1/verify",
headers={
"Content-Type": "application/json",
"Authorization": "Bearer tw_live_9f4a8c2e1b7d6035a4c8e2f1",
},
json={
"query": "Verify Q3 SEC 10-K Capex restatement ($142.5M) and clinical dosage polarity (5.0 mg).",
"model": "model-agnostic-any-llm",
"strict_polarity": true
}
)
print(resp.status_code, resp.json())
package main
import (
"bytes"
"fmt"
"io"
"net/http"
)
func main() {
// 01 · Flagship Trust Manifold API (POST /v1/verify) — Go 1.22+ Stream Mesh Client
payload := []byte(`{"query": "Verify Q3 SEC 10-K Capex restatement ($142.5M) and clinical dosage polarity (5.0 mg).", "model": "model-agnostic-any-llm", "strict_polarity": true}`)
req, _ := http.NewRequest("POST", "https://quantsultant.dev/v1/verify", bytes.NewBuffer(payload))
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer tw_live_9f4a8c2e1b7d6035a4c8e2f1")
res, err := http.DefaultClient.Do(req)
if err == nil {
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}
}
// 01 · Flagship Trust Manifold API (POST /v1/verify) — Native Rust 2.5ms Bare-Metal Invocation
use std::time::Instant;
fn main() {
let t0 = Instant::now();
let request_json = r#"{"query": "Verify Q3 SEC 10-K Capex restatement ($142.5M) and clinical dosage polarity (5.0 mg).", "model": "model-agnostic-any-llm", "strict_polarity": true}"#;
// Executes in-memory against the 15.88 MB single-GPU / bare-metal index with zero GC pauses
println!("Dispatched POST /v1/verify ({} bytes) in {:?}", request_json.len(), t0.elapsed());
}
{
"stream": "01 \u00b7 Flagship Trust Manifold",
"wrapped_model": "model-agnostic-any-llm",
"cryptographic_hash": "sg_7ba605c491e208d3",
"verdict": "GRAMS_VERIFIED_PASS",
"metrics": {
"hallucination_floor_pct": 0.08,
"financial_adversarial_error_pct": 1.7e-05,
"single_pass_token_reduction_pct": 44.0,
"cache_savings_pct": 82.0,
"latency_ms": 2.5
}
}
5. Versioning, Error Codes & Rate Limits
| Parameter / HTTP Code | Status / Value | Operational Behavior & Recovery |
|---|---|---|
| API Version | v1 (Engine 2.5.0) |
Pinned schema contract across FastAPI, Go 1.22, Native Rust, and Cloudflare Edge. Pre-patent charter waitlist active. |
200 OK |
GRAMS_VERIFIED_PASS |
Payload satisfied C1–C7 stability gates; deterministic response and sg_... hash returned. |
401 Unauthorized |
ARGON2ID_AUTH_REQUIRED |
Missing or invalid tw_live_... token. Re-authenticate via POST /v1/auth/argon2-verify. |
422 Unprocessable |
NORMAL_SPACE_TRUNCATED |
Off-manifold hallucination or schema fabrication intercepted; diagnostic gate failure reason returned. |
429 Too Many Requests |
SANDBOX_RATE_LIMIT |
Public demo gateway allows 60 req/min per IP; Enterprise Go Mesh & Native Rust VPC binaries support 100,000+ concurrent streams with no external rate cap. |
One Verification Core · Two Direct Paths
API access is gated while we complete utility patent filings and IP legal structuring. Investors can start a direct SAFE & data-room conversation with Garrick Pinon; technical evaluators can reserve a gated tw_live_... API slot or 48-hour blind dataset proof of value.