OPTXOPTX DOCS
Authentication

JETT Auth

552520

Unified auth surface for JettChat — supports both xChat Native and Phantom Mode.

JETT Auth is the unified authentication layer behind JettChat. It supports both modes the chat client ships with.

Two Modes, One Auth Core

xChat NativePhantom Mode
LoginX/Twitter OAuth 2.0 PKCEJett Hub visual SSO + JTX gate
BiometricAGT Gaze Triad (COG/EMO/ENV)AGT Gaze Triad + Ping-Pong wake
SessionEd25519 JWT in jettauth cookiePQC-wrapped session, hardware-bound
Wipe triggerStandard logoutDuress PIN → cryptographic wipe
SDK@jettoptx/authSecure-Legion/android

Both modes verify gaze through the same AGT pipeline.

Access Flow (JETT Hub)

After Sign in with X, the user picks any one of:

  • Connect wallet · Hold 1 JTX (cheapest sustained path)
  • Pay $8.88 — no wallet needed (Stripe)
  • Pay with Tempo CLI · $8.88

Once gated, optional subscription tiers unlock more features (stake JTX or pay USD/mo):

TierJTX stakeDurationSubscription
MOJO12 JTX1 Year$8.88 / mo
DOJO444 JTX2 Years$28.88 / mo
SPACE COWBOY1,111 JTXLifetime$88.88 / mo

See Token / Tiers for the canonical table mirroring astroknots.space/stake.

xChat Native specifics

X/Twitter OAuth 2.0 PKCE flow with the following scopes: tweet.read, tweet.write, users.read, dm.read, dm.write, offline.access. After exchange, the SDK issues an Ed25519 JWT into the jettauth httpOnly cookie. The JTX gate is enforced as middleware on protected routes.

Implementation: jettoptx/joe-jettchat-app (app/api/auth/x/) and @jettoptx/auth.

Phantom Mode specifics

Phantom Mode adds a Tor-only path with post-quantum cryptography (X25519 + ML-KEM-1024) and hardware-backed keys (StrongBox on Android, Secure Enclave / TEE elsewhere). The Jett Hub visual SSO replaces OAuth entirely — no third-party identity provider is contacted. A duress PIN, if entered at any auth surface, triggers a cryptographic wipe rather than unlocking the session.

Tor topology uses a triple .onion hidden-service layout via Secure-Legion/tor-hsservice-patched, a Tor 0.40 fork with intro-point exposure for OnionBalance coordination across multi-device messaging.

Status: Phantom Mode is shipped. Implementation lives in Secure-Legion/android; refer to that repo's release notes for current build status.