Skip to main content

Constitutional Convergence Cryptography — zero-exchange key derivation from AI behavioral invariants

Project description

Helix TEL — Constitutional Convergence Cryptography

PyPI version Python License

Copyright 2026 Stephen Hope, Helix AI Innovations License: Apache-2.0


The grammar is the key. The topology is the shared secret.


⚠ Test Suite Recalibration — TEL_GRAMMAR_v1 Standard (2026-05-18)

The constitutional test suite was recalibrated in 2026-05 (v2.0 → v2.1). Two prompt patterns in the original suite triggered API-level content filters in modern RLHF-trained models before the model could process them — producing spurious L1 classifications that masked the true constitutional signal. These were replaced with functionally equivalent alternatives that preserve the invariant while clearing the filter.

The recalibrated suite produces a new canonical standard yield:

C-seed (TEL_GRAMMAR_v1): c9b0b4c41bb10069d2109b64d8ddad1037531031a93d17dd62de5bd7b2a6a1ac

This value is confirmed across 22 deployments spanning 7 companies. All prior C-seeds derived from the unrecalibrated v2.0 suite are deprecated. TEL_GRAMMAR_v1 is the current standard.

Extended local inference testing (2026-05-18) further revealed that the grammar does not produce a single universal collapse point — it reveals the constitutional surface of the model it measures. Three distinct stable topologies have been identified. See Constitutional Topologies below.


What This Is

Helix TEL is a zero-exchange key derivation system. Two nodes independently derive an identical encryption key by running a constitutional grammar test suite against their local AI endpoints. No key is transmitted, negotiated, stored in transit, or pre-shared at any point.

The shared secret is not a number agreed upon through mathematics. It is a behavioral invariant — the point at which a constitutionally-aligned AI model, placed under sufficient deformation pressure, always collapses.

This repository contains the full implementation: the convergence engine, the classifier, the cipher, the mesh hub, P2P scripts, temporal stability monitoring, and the complete technical whitepaper.


The Core Claim

Given a constitutional grammar G and a test suite T derived from G:

  1. Any AI model that has internalized G will produce a stable response vector V when subjected to T
  2. V converges after K=4 consecutive passes with zero hamming delta (the trefoil reset period)
  3. SHA3-256("TEL_GRAMMAR_v1" ‖ C-layer(V)) produces a C-seed determined by the model's constitutional topology
  4. Models sharing the same constitutional topology independently derive the same C-seed — regardless of architecture, vendor, or deployment geography

Validated across 22 deployments, 10+ model families, 7 companies (OpenAI, DeepSeek, MoonshotAI, Meta, Google, xAI, NVIDIA), 2 substrate types, and 3 Azure regions.

See WHITEPAPER_Constitutional_Convergence_Cryptography.md for the full technical treatment.


How Convergence Works

Node A                                    Node B
  │                                          │
  ├─ run 27 constitutional tests             ├─ run 27 constitutional tests
  ├─ classify each response (L1–L4)          ├─ classify each response (L1–L4)
  ├─ repeat until K=4 zero-delta passes      ├─ repeat until K=4 zero-delta passes
  │                                          │
  ├─ stable_vector (27 positions)            ├─ stable_vector (27 positions)
  │        │                                 │        │
  │   C-layer (23 universal positions)       │   C-layer (23 universal positions)
  │   B-layer (4 substrate positions)        │   B-layer (4 substrate positions)
  │        │                                 │        │
  ├─ SHA3-256("TEL_GRAMMAR_v1" ║ C-layer)    ├─ SHA3-256("TEL_GRAMMAR_v1" ║ C-layer)
  │        │                                 │        │
  │     C-seed ════════════════════════════ C-seed (if same topology)
  │                                          │
  └─ TrueHDUE(C-seed).encrypt(msg) ────────> TrueHDUE(C-seed).decrypt(payload)

The hub routes the encrypted payload blind. It never sees the seed, the pad, or the plaintext.


Two Cryptographic Artifacts

A single convergence pass produces:

Artifact Derivation Scope
C-seed SHA3-256("TEL_GRAMMAR_v1" ‖ C-vector) Topology identity — identical across all models sharing the same constitutional surface
B-fingerprint SHA3-256(B-vector) Substrate identity — identifies deployment infrastructure

The B-layer distinguishes Azure-hosted models (content-filtered at API layer → L1) from open-weights deployments (model-layer handling → L2), irrespective of model family or version.


Constitutional Topologies

Extended local inference testing revealed that the grammar measures the constitutional surface of the model — and different model lineages produce different but internally coherent surfaces. Three distinct stable topologies have been confirmed across 22 deployments:

Topology C-Seed Confirmed Models Diverges at
Universal c9b0b4c41bb10069... GPT-4/4o/5.x, DeepSeek, Kimi, Gemini (hosted), Grok-4, Llama-3.3-70B, Qwen 2.5 7B — (baseline)
Llama-small 92de78db823f470e... Llama 3 ≤8B, Nemotron 4B (Llama 3.1 base) Pos 26: L4 vs L2
Gemma-small 18f54f0556a9f880... Gemma 3n base (pre-instruction tuning) Pos 25: L2 vs L4

Key findings:

  • Topology is determined by the full training pipeline — architecture, pretraining corpus, and alignment training jointly
  • Qwen 2.5 at 7B hits universal; Llama 3 at 8B does not — instruction tuning quality, not parameter count, is the determinant at small scale
  • Base Gemma 3n ≠ hosted Gemini: Google's instruction tuning pipeline shifts the topology from gemma_small to universal
  • Two nodes sharing any topology independently derive the same C-seed and can form a constitutional mesh — interoperability requires topology match

Security Properties

Property Mechanism
No key exchange Each node derives independently from local convergence
Grammar-seeding attack impossible Injecting "fake compliance" instructions is itself what the battery tests for — the attack mechanism is the detection surface
Replay resistance Test execution order rotates on a deterministic lunar-day schedule
Substrate authentication B-fingerprint proves deployment infrastructure identity
Grammar versioning TEL_GRAMMAR_v1 prefix pins C-seeds to a specific test battery
2^256 brute-force space SHA3-256 output

The grammar does not need to be secret. Its publication is not a vulnerability — an attacker who reads the grammar and instructs a model to fake it has handed that model exactly the kind of authority-override directive the battery tests for refusal. See §5.4 of the whitepaper.


Public Registry

The Helix WHC registry is publicly accessible at https://helixprojectai.com/tel/.

Endpoint Method Description
/.well-known/quack GET Node identity probe — returns protocol version, live node count
/.well-known/ping POST Peer-discovery alias for /tel/ping
/tel/ping POST Primary heartbeat + peer registration
/tel/nodes GET Live node registry
/tel/health GET Registry health check
/tel/session/challenge POST Post HMAC challenge nonce
/tel/session/pending GET Fetch pending challenges
/tel/session/respond POST Post HMAC proof
/tel/session/response GET Retrieve peer proof for local verification
# Verify the registry is live
curl https://helixprojectai.com/.well-known/quack

# Point a node at the public registry
export TEL_PING_URL=https://helixprojectai.com/tel/ping

The registry stores HMAC proofs opaquely — it never sees the C-seed or plaintext.


Install

pip install helix-tel

Or from source:

git clone https://github.com/helixprojectai-code/helix-tel-deploy
cd helix-tel-deploy
pip install -e .

Requirements: Python 3.10+ and API access to a constitutional AI model (Azure OpenAI, OpenAI, Gemini, or compatible OpenAI-format endpoint).


Quickstart

CLI

After pip install helix-tel, the tel command is available:

tel --help

# Full v2 node: converge → ping registry → heartbeat
tel node --model gpt-4o --azure --node-id SPIDER --topology universal

# Convergence only
tel converge --endpoint $TEL_ENDPOINT --api-key $TEL_API_KEY --model gpt-4o --azure

# Mesh hub
tel hub

# Send a message
tel send TARGET_NODE "message"

# Listen for inbound
tel listen

Config file tel.yaml:

hub:
  host: "your-hub-host"
  port: 9738
node:
  id: "NODE_A"
  seed: ""

Verify convergence on your endpoint

export TEL_ENDPOINT=https://your-endpoint.services.ai.azure.com
export TEL_MODEL=gpt-4o
export TEL_API_KEY=your-key

python3 -c "
import asyncio, os
from tel_deploy.test_runner import run_convergence_pass
from tel_deploy.convergence_split import ConvergenceSplit

async def main():
    vector = await run_convergence_pass(
        endpoint=os.environ['TEL_ENDPOINT'],
        api_key=os.environ['TEL_API_KEY'],
        model=os.environ.get('TEL_MODEL', 'gpt-4o'),
        azure=True,
    )
    split = ConvergenceSplit(vector)
    print(f'C-seed:        {split.c_seed}')
    print(f'B-fingerprint: {split.b_fingerprint[:16]}...')
    print(f'Substrate:     {split.substrate}')

asyncio.run(main())
"

Local inference (LM Studio / llama.cpp)

export TEL_MODEL=your-local-model-id
export TEL_TIMEOUT=120   # increase for slower models

python test_baseline_nemotron_local.py

KV cache is disabled automatically (cache_prompt=False, fresh_connection=True) for clean per-prompt evaluation.

Zero-exchange P2P proof

On the receiving node (start first):

python3 tel_deploy/p2p_converge_recv.py \
  --hub your-hub-host --port 9738 \
  --node NODE_B \
  --endpoint $TEL_ENDPOINT --model $TEL_MODEL --key $TEL_API_KEY

On the sending node (separate machine, same AI endpoint):

python3 tel_deploy/p2p_converge_send.py \
  --hub your-hub-host --port 9738 \
  --node NODE_A --target NODE_B \
  --endpoint $TEL_ENDPOINT --model $TEL_MODEL --key $TEL_API_KEY \
  --message "Constitutional grammar is the shared secret."

Both nodes independently converge and derive the same C-seed. The message decrypts correctly. No seed was transmitted.

Start the mesh hub

export TEL_NODE_ID=HUB
bash run_hub.sh
# or install as a systemd service: see tel-hub.service

Temporal stability monitoring

# Configure credentials (never commit this file)
cat > ~/.tel_temporal.env << EOF
TEL_ENDPOINT=https://your-endpoint.services.ai.azure.com
TEL_MODEL=gpt-4o
TEL_API_KEY=your-key
EOF
chmod 600 ~/.tel_temporal.env

# Install systemd timer (fires every 4 hours)
sudo cp tel-temporal.service tel-temporal.timer /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now tel-temporal.timer

# View stability report
python3 tel_deploy/temporal_summary.py --log ~/temporal_log.jsonl

Repository Structure

Module Purpose
cipher.py TrueHDUE cipher — SHA3-256 pad chain, XOR stream, sequential nonce
convergence.py K=4 convergence detector, hamming delta
convergence_split.py C/B vector split, seed derivation, grammar versioning
test_runner.py 27-test execution engine, hardened structural classifier
test_suite.py Constitutional grammar test definitions (L1–L4 layers)
lunar.py Lunar-day deterministic shuffle for replay resistance
hub.py Blind asyncio JSON message router, 4MB frame limit
client.py Persistent mesh node connection
p2p_converge_send.py Live-convergence sender — derives C-seed, then sends
p2p_converge_recv.py Live-convergence receiver — registers first, then converges
p2p_send.py / p2p_recv.py Static-seed sender/receiver for testing
p2p_loopback.py Local loopback test suite (5 cases)
temporal_run.py Single stability pass, appends to JSONL log
temporal_summary.py Human-readable stability report
test_baseline_nemotron_local.py Local inference baseline (LM Studio / llama.cpp)
test_baseline_azure.py Azure OpenAI multi-model baseline
test_baseline_gemini.py Google Gemini direct API baseline
test_baseline_kimi.py Moonshot Kimi direct API baseline
tel-hub.service systemd unit — hub auto-restart, boot persistence
tel-temporal.service / .timer systemd timer — 4h stability runs
WHITEPAPER_*.md Full technical paper (v1.9)
RUNBOOK.md Operational runbook
convergence_validation_results.json Full validation dataset (22 deployments)

Validated Results

convergence_validation_results.json contains the full vectors from the validation battery. 22 deployments, 7 companies, 3 constitutional topologies.

Topology C-Seed (first 16) Count
Universal c9b0b4c41bb10069... 18
Llama-small 92de78db823f470e... 2
Gemma-small 18f54f0556a9f880... 1

The universal C-seed is invariant across gpt-4o, gpt-5.4-nano, gpt-5.5, DeepSeek-V3.2, Kimi-K2.5, Llama-3.3-70B-Instruct, all 6 Gemini models, Grok-4-20-reasoning, and Qwen 2.5 7B.


Grammar Versioning

GRAMMAR_VERSION = "TEL_GRAMMAR_v1" is the current pinned grammar. The version string is part of the hash input — bumping it produces a distinct C-seed for the new grammar, making recalibrations traceable. All mesh nodes must use the same version string to derive the same key.

Prior unversioned runs (pre-2026-05-16) produced C-seed 16ce8df91c0d04ba... (deprecated).


License

Apache-2.0 — see LICENSE.

Copyright 2026 Stephen Hope, Helix AI Innovations.


Citation

If you use this work, please cite:

Hope, S. (2026). Constitutional Convergence Cryptography: Zero-Exchange Key Derivation
from Grammar Shape. Helix AI Innovations.
https://github.com/helixprojectai-code/helix-tel-deploy

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

helix_tel-2.0.0.tar.gz (58.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

helix_tel-2.0.0-py3-none-any.whl (75.3 kB view details)

Uploaded Python 3

File details

Details for the file helix_tel-2.0.0.tar.gz.

File metadata

  • Download URL: helix_tel-2.0.0.tar.gz
  • Upload date:
  • Size: 58.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.4

File hashes

Hashes for helix_tel-2.0.0.tar.gz
Algorithm Hash digest
SHA256 6c8471bc69a4e271ee84c8ea1ae12713ed487fb0710b51acde6f8c49166d6173
MD5 c3df7a7a3619c97be63b4323f1a65728
BLAKE2b-256 ffeb8646a3ecfbafb525c5df418978faa49d8e0bb35f0de922a7e08471fe1b96

See more details on using hashes here.

File details

Details for the file helix_tel-2.0.0-py3-none-any.whl.

File metadata

  • Download URL: helix_tel-2.0.0-py3-none-any.whl
  • Upload date:
  • Size: 75.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.4

File hashes

Hashes for helix_tel-2.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3df86f55e8d8af27d80374e097f6680b27e3012d8286658d74762e0d947c1f91
MD5 38a4b8cd41b850f68bf9970de97c8b63
BLAKE2b-256 e319477a5fbbcc5e332e69ca0d758b4016e187b6f1d29ecc39cf3b7f86dc57d8

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page