Skip to content

Repository files navigation

πŸ¦… Cynan IMS Core

Version License Rust Status

The Next-Generation, Post-Quantum Secure IMS Core for Modern Telecommunications.


Warning

DEVELOPMENT SOFTWARE - NOT FOR PRODUCTION USE This implementation is currently under active development and has not been production-hardened. Comprehensive security audits, performance validation, and regulatory compliance testing are required before any production deployment.

πŸ’Ž Why Cynan?

While standard IMS solutions from industry incumbents are built on decades-old legacy codebases, Cynan offers a Quantum-Ready, Memory-Safe alternative designed for the future:

  • πŸ›‘οΈ Quantum-Safe Today: Our mission is to secure the digital future. Cynan implements NIST-standardized Post-Quantum Cryptography (ML-KEM, ML-DSA) natively, ensuring your data remains private and secure against future threats.
  • πŸ¦€ 100% Memory Safety: Built in Rust with zero unsafe blocks. This means simplicity and reliability for your engineering teams, eliminating the buffer overflows and data races that plague legacy C++ signaling cores.
  • 🌐 Zero-Trust Architecture: We empower organizations to manage and share data effectively. Every internal signaling jump between modules is signed and validatedβ€”protecting the people behind the devices.
  • ⚑ Lightweight Agility: A cloud-native microservice architecture designed for efficiency. Achieve carrier-grade throughput (1000+ CPS) with fewer resources, reducing operational complexity and infrastructure costs.

πŸ“ž Supported Voice Services

Cynan IMS Core is designed to be the signaling heart for a wide range of modern telecommunications services:

  • Voice over LTE (VoLTE): Seamlessly bridges voice services over 4G/LTE networks using standard 3GPP functional elements.
  • Voice over New Radio (VoNR): Full support for 5G voice services through optimized signaling and low-latency transport.
  • Voice over WiFi (VoWiFi): Enhances coverage and reliability by facilitating secure calls over non-3GPP access networks.
  • Voice over Broadband (VoBB): Flexible voice services delivered over fixed broadband connections for residential and enterprise users.

πŸ—οΈ Architecture Overview

Cynan implements the full 3GPP IMS architecture, providing seamless control and orchestration for SIP-based multimedia services.

graph TB
    subgraph "External Entities"
        UE["User Equipment (SIP/TLS)"]
        HSS["HSS (PostgreSQL/Diameter)"]
        SBC["SBC / Inter-operator peer"]
    end

    subgraph "Cynan IMS Core"
        subgraph "Transport Layers"
            UDP["UDP Listener"]
            TCP["TCP Listener"]
            TLS["PQC-TLS Listener"]
        end

        subgraph "Signaling Modules"
            PCSCF["P-CSCF (Proxy)"]
            ICSCF["I-CSCF (Interrogating)"]
            SCSCF["S-CSCF (Serving)"]
            IBCF["IBCF (Border Control)"]
        end

        subgraph "Integration Planes"
            ARM["Armoricore Bridge (gRPC)"]
            DIA["Diameter Interface (Cx/Sh/Rx)"]
            SEC["Security Enforcer (IPsec/PQC)"]
            AS["AS Integration Manager"]
        end
    end

    UE <-->|"Gm (SIP/PQC-TLS)"| PCSCF
    PCSCF <--> ICSCF
    ICSCF <--> SCSCF
    ICSCF <-->|"Cx/Dx"| HSS
    SCSCF <-->|"Cx/Sh"| HSS
    SCSCF <-->|"Routing"| IBCF
    IBCF <-->|"Interconnect"| SBC
    SCSCF <--> AS
    SCSCF <--> ARM
    SCSCF -.->|"O2 (REST)"| SMO["O-RAN SMO"]
Loading

⚑ Key Technical Features

�️ Post-Quantum Security (NIST Standards)

  • Zero Trust Architecture: Every interconnect is signed and validated.
  • Hybrid PQC-TLS: ML-KEM-768 for quantum-safe key exchange with ECDHE fallback.
  • Eagle-Fast Auth: Falcon-512 signatures providing high-throughput SIP authentication.
  • Inter-Operator PQC: ML-DSA signatures for IBCF peer validation.

πŸš€ Performance & Scalability

  • Async-First: Powered by the Tokio runtime for 1000+ CPS on commodity hardware.
  • Memory Safety: 100% Rust memory safety (Zero unsafe blocks).
  • Modular Design: Hot-swappable functional modules based on standardized Rust traits.

πŸŽ₯ Integration & Media

  • Armoricore Bridge: Native gRPC/TLS interface for secure media orchestration.
  • IPsec XFRM: Native Linux kernel integration for Gm interface security.
  • Diameter Pipeline: Comprehensive Cx, Sh, and Rx interfaces for HSS connectivity.

☁️ O-RAN & Cloud-Native

  • O2 Interface: REST API for O-Cloud resource management and SMO orchestration (Discovery, Registration, Alarms).
  • CUPS Architecture: Complete Control & User Plane Separation with gRPC-based media control.
  • CNF Ready: Fully containerized (Docker/distroless) with specialized Helm charts for Kubernetes deployment.

πŸ“Š Implementation Status (v0.8.5)

Category Component Status Description
Core Transport Layer βœ… UDP, TCP, and PQC-enabled TLS 1.3 listeners.
IMS Modules βœ… P-CSCF, I-CSCF, S-CSCF, BGCF, MGCF, IBCF, SLF.
Security PQC primitives βœ… NIST Level 3 safety with ML-KEM, ML-DSA, Falcon.
IPsec (Gm) βœ… Native Linux XFRM integration (RFC 3329).
Integration Diameter βœ… Full Cx, Sh, and Rx interface implementations.
Armoricore βœ… Secure gRPC bridge for media engine control.
Media Plane βœ… RTP Parsing complete; Routing logic active via gRPC bridge.
Infrastructure Cloud-Native βœ… Dockerized (Distroless) & Helm Charts ready.
O-RAN O2 βœ… O2-IMS REST API for SMO Registration/Discovery.

πŸ“š Documentation & Guides

Explore our detailed technical artifacts for deep dives into Cynan's internals:


οΏ½ System Requirements

Cynan is engineered for high-performance execution on modern hardware. For carrier-grade production deployments (1000+ CPS), we recommend the following:

Hardware Requirements

  • CPU: 2+ Core modern x86_64 or ARM64 (AVX2/AES-NI recommended for high-performance PQC).
  • RAM: 4GB Minimum (8GB+ recommended for large subscriber location caches).
  • Storage: 10GB Available space (primarily for logs and HSS database).
  • Network: 1Gbps Ethernet minimum; 10Gbps recommended for IBCF interconnects.

Software Requirements

  • Operating System: Linux (Kernel 5.15+ for IPsec) or Kubernetes (for Helm deployment).
  • Database: PostgreSQL 15.0+ (HSS/Subscriber storage).
  • Dependencies: docker, helm (for cloud-native) OR libssl-dev, pkg-config (for bare metal).

πŸš€ Getting Started

Prerequisites

  • Rust Toolchain: 1.75+

Automated Installation (Recommended for Servers)

For a professional, automated deployment on Ubuntu, Debian, or RHEL, run our official installation script as root:

chmod +x scripts/install.sh
sudo ./scripts/install.sh

This script will:

  1. Detect your OS and install all required system dependencies.
  2. Install the Rust toolchain if not present.
  3. Build the production-optimized cynan binary.
  4. Configure /etc/cynan and /var/log/cynan system directories.
  5. Install and enable the cynan.service in systemd for carrier-grade persistence.

Post-Installation Setup

After the installation script completes, perform the following two steps to prepare the system for operation:

1. Initialize PostgreSQL HSS Database

Create the database and user as defined in /etc/cynan/cynan.yaml:

# Switch to the postgres user
sudo -u postgres psql

# Create the user and database (adjust names/passwords as needed)
CREATE USER cynan WITH PASSWORD 'change_me';
CREATE DATABASE cynan_hss OWNER cynan;
\q

# Apply migrations
sqlx migrate run

2. Configure TLS Certificates

Place your carrier-grade or development certificates in the designated security directory:

  • Path: /etc/cynan/certs/
  • Required Files: core.crt and core.key (or as specified in cynan.yaml).

3. Start the Service

Once configured, start the Cynan IMS Core:

sudo systemctl start cynan
sudo systemctl status cynan

Manual Build

🀝 Acknowledgments

Cynan IMS Core is built upon a foundation of high-quality open-source and professional-grade libraries. We gratefully acknowledge the following projects:

πŸ” Cryptography & Security

πŸš€ Infrastructure & Protocols

  • tokio: High-performance async runtime.
  • tonic: Robust gRPC stack.
  • sqlx: Type-safe database connection pooling.
  • rsip: Comprehensive SIP protocol engine.

πŸ“œ License

Copyright Β© 2026 Fastcomcorp, LLC. All rights reserved.

This software is dual-licensed:

Feature Community Edition Commercial Edition
License Apache 2.0 Proprietary
Usage Personal / Educational Commercial / Production
Support Community-based Customized Enterprise Support
SLA & Uptime Best-effort Production SLAs Available
Legal As-is / No Warranty Full Indemnification
Compliance Community-led Carrier & Regulatory Assistance
Updates Public Release Early Access & Priority Fixes
  1. Apache License, Version 2.0: For non-commercial, personal, and educational use.
  2. Commercial License: Required for all commercial use, distribution, or revenue-generating deployment. Each commercial agreement is tailored to provide the specific Enterprise Support, SLAs, and legal protections required for mission-critical telecommunications.

See the LICENSE file for the full legal text. For inquiries regarding customized commercial terms, or to learn how Fastcomcorp can partner with your organization to unlock the power of people-centered technology, contact licensing@fastcomcorp.com.

About

Cynan is a next-generation IMS core currently in active development that combines the performance characteristics of C/C++ telecom systems with the memory safety and concurrency guarantees of Rust.

Topics

Resources

Security policy

Stars

2 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages