Skip to content
NOHN-AIPublic

Repository files navigation

ANTARES banner

protocol quic federation

Global Federated Stable Interoperability Protocol v1.0

✦ About

ANTARES is GFSIP v1.0 — the Global Federated Stable Interoperability Protocol. It provides encrypted, multi-channel, recoverable cross-domain communication for services, AI agents, devices, and organizations with no central authority required. Built on QUIC as the mandatory transport layer and deterministic CBOR serialization, it includes built-in session recovery, idempotent deduplication, and causal auditing as the stable foundation for decentralized networks.

ANTARES overview

— ✦ —

✦ Key Capabilities

#CapabilityDescription
1Encrypted SessionsMutual-TLS or token-based authenticated sessions over QUIC
2Multi-ChannelIndependent logical channels within a single session
3Session RecoveryResume sessions across network switches without re-authentication
4Idempotent Side EffectsLimited-window deduplication via idempotency keys
5Causal Audit (opt-in)Signed event records with declared causal predecessors
6Cross-Domain FederationMulti-trust-anchor routing with signed domain descriptors
7Fault IsolationSingle-domain failure does not block intra-domain traffic

— ✦ —

✦ On the Wire

GFSIP uses a 44-byte fixed header over QUIC with ALPN gfsip/1. Extension headers use deterministic CBOR (big-endian, shortest encoding). 18 standard message types (0x01–0x16) cover the full lifecycle: handshake, channel management, data transfer, session recovery, audit events, and federation routing.

— ✦ —

✦ Repository Contents

FilePurpose
GFSIP_v1.0_protocol_spec.mdFull protocol specification (33 sections)
gfsip-state-machine.jsonMachine-readable state machine definition
gfsip-message-schema.jsonLogical message JSON Schema
gfsip-error-registry.jsonNumeric error code registry
gfsip-conformance-checklist.csvConformance test checklist
reference-impl/Python reference implementation — frame codec, state machine, channel manager, auth, dedupe, resume, audit, federation, end-to-end demo (9/9 conformance vectors pass)

— ✦ —

✦ Protocol Profiles

Core/1 (Mandatory) — QUIC transport, version negotiation, mutual auth, session & channel management, session recovery, structured errors, and graceful shutdown.

Audit/1 (Optional) — Signed causal event recording with declared predecessors, actor identity, rule version, and state-before/after hashes. Self-loop and known-cycle rejection.

Federation/1 (Optional) — Cross-domain routing via signed DomainDescriptor objects, multi-trust-anchor configuration, and descriptor expiry/revocation with fault isolation.

— ✦ —

✦ Quick Start

git clone git@github.com:NOHN-AI/ANTARES.git
cd ANTARES/reference-impl
pip install -r requirements.txt
python demo.py          # end-to-end demo: handshake → channel → data → dedupe → recovery
python conformance.py   # 9 minimum conformance vectors — all passing

— ✦ —

✦ Use Cases

  • AI Agent Networks — Multi-agent task coordination with auditable trails across organizational boundaries
  • Enterprise Integration — Cross-organization workflow orchestration without a central authority
  • IoT / Edge — Device-to-cloud session recovery across network changes
  • Finance / Compliance — Signed causal audit trails for regulatory reporting
  • Healthcare — Federated data exchange with domain-level policy enforcement
  • Robotics — Reliable command channels with idempotent safety operations

— ✦ —

✦ Project Status

MilestoneStatus
Specification v1.0 (interface frozen)✅ Complete
Machine-readable state machine & schema✅ Complete
Python reference implementation (9/9 conformance)✅ Complete
Independent second implementation🔲 In progress
Public interoperability report🔲 Pending
Production pilot domains🔲 Pending

— ✦ —

NOHN-AI  ·  nohnlins.com  ·  ai@nohnlins.com

NOHN AI · ANTARES

Releases

Packages

Contributors

Languages