OPTXOPTX DOCS
AARON Protocol

Client Integration

453025

Connect your app to the AARON router — session, verify, and on-chain attestation.

Integrate gaze attestation using the official AARON router at https://aaron.jettoptics.ai. Source: jettoptx-aaron-router.

Quick Start — TypeScript

const AARON = "https://aaron.jettoptics.ai";

// 1. Create a gaze session
const session = await fetch(`${AARON}/session`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ user_id: "your-user-id" }),
}).then((r) => r.json());

// 2. After gaze capture, verify the proof
const result = await fetch(`${AARON}/verify`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    session_id: session.session_id,
    proof_hash: "<opaque-32-byte-hex>",
    agt_sequence: ["COG", "EMO", "ENV"],
    hold_durations_ms: [520, 480, 510],
    confidence: 0.87,
  }),
}).then((r) => r.json());

console.log(result.verified); // true → ready for on-chain attestation

Official SDKs

The router ships client libraries in the repo:

LanguagePath
TypeScriptsdk/typescript/aaron-client.ts
Pythonsdk/python/aaron_client.py
import { AaronClient } from "./sdk/typescript/aaron-client";

const client = new AaronClient({ baseUrl: "https://aaron.jettoptics.ai" });
const session = await client.createSession({ userId: "demo" });
const verified = await client.verifySession({
  sessionId: session.session_id,
  proofHash: "...",
  agtSequence: ["COG", "EMO", "ENV"],
  holdDurationsMs: [500, 500, 500],
  confidence: 0.9,
});

MOJO Handshake (Mobile)

For first-gaze AGT attestation from iOS, use the web-to-iOS handshake documented in MOJO:

  • POST /handshake/start — generate QR payload
  • POST /handshake/done — MOJO submits verified gaze proof
  • GET /handshake/status/{id} — poll until complete

Response Shape

{
  "verified": true,
  "session_id": "a1b2c3d4-...",
  "proof_hash": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
  "agt_primary": "COG",
  "confidence": 0.87,
  "attestation_ready": true
}

Next Steps