QUANTSULTANT.DEV / DOCS Canonical Crawler Surface · 19 Verified Nodes 18.5% → 0.08% Medical Floor

Stream 01 · Flagship Trust Manifold API (/v1/verify)

/docs/api/trust Stream 01 · Hero Verification Core

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
querystringRequiredThe user prompt, clinical scenario, or financial audit query being verified.
context_chunksarrayOptionalRetrieved source passages or structured database rows against which claims are grounded.
modelstringOptionalUpstream foundation model identifier (e.g., gpt-4o, claude-3-7-sonnet, gemini-2.5-pro, llama-3.3-70b).
strict_polaritybooleanOptionalEnforces 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
streamstringCanonical stream identifier (01 · Flagship Trust Manifold).
wrapped_modelstringEchoes the upstream model wrapped by the verification kernel.
cryptographic_hashstringIrreversible FNV-1a / SHA-256 trajectory digest (sg_...) stored in the O(1) Geodesic Vault.
verdictstringGRAMS_VERIFIED_PASS when all stability conditions hold, or GRAMS_TRUNCATED_DRIFT with diagnostic gate codes.
metricsobjectVerified 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.