System Architecture Overview
Relevant source files
The following files were used as context for generating this wiki page:
X3 Atomic Star is a high-throughput, survivable blockchain infrastructure project characterized by its GPU-accelerated execution, cross-VM settlement engine, and a multi-layered agent "swarm" architecture. The system is designed to provide institutional-grade verifiability and survivability across heterogeneous environments, including Ethereum (EVM) and Solana (SVM) ecosystems.
Sources: apps/x3-desktop/src-tauri/src/crm/agents.rs:36-40, X3_END_TO_END_GAPS_MASTER_PLAN.md:1-10, crates/x3-relayer/PHASE_13F_MASTER_INDEX.md:14-25
1. Core Blockchain Architecture
The X3 architecture utilizes a three-plane separation model to isolate concerns between user interaction, autonomous operations, and the immutable ledger.
- Blockchain/Runtime Plane: Responsible for ledger state, consensus, and executing outputs that satisfy protocol rules. It incorporates a "Flash Finality" model and GPU-parallel execution.
- Swarm Control Plane: An orchestration layer that plans, simulates, scores, and routes work before it reaches the runtime.
- User Plane: The interface layer where user requests are resolved into approved intents.
Sources: X3_END_TO_END_GAPS_MASTER_PLAN.md:140-146, X3_END_TO_END_GAPS_MASTER_PLAN.md:231-236
1.1 Logical Three-Plane Model
The following diagram illustrates the separation of concerns across the architectural planes:
The system enforces typed interfaces and audit logs between these planes to prevent unauthorized state mutations.
Sources: X3_END_TO_END_GAPS_MASTER_PLAN.md:140-148
2. Surgical Swarm Architecture
The project employs a 15-agent "Surgical Swarm" organized into four specialized layers. These agents are powered by local LLMs (Ollama) and manage everything from technical positioning to automated lead funnels and technical documentation.
2.1 Layered Agent Roster
| Layer | Agents | Primary Responsibility |
|---|---|---|
| Strategic | ArchNode, BrandForge, VaultGuard, ScopeX | Infrastructure positioning, branding, InfoSec, and competitive intelligence. |
| Execution | WebWeaver, DocForge, ProofEngine, NodeForce, DealForge | Website SEO, documentation, benchmarking, validator ops, and enterprise outreach. |
| Media | FrameX, CutPro, PixelForge | Motion graphics, video production, and UI visualization. |
| Growth | ConvertX, InsightGrid, SignalForge | Funnel optimization, CRM analytics, and community narrative. |
Sources: apps/x3-desktop/src-tauri/src/crm/agents.rs:36-318
2.2 Agent Interaction & RAG Integration
Agents utilize a Retrieval-Augmented Generation (RAG) system to index project markdown files and build context for tasks. This allows the swarm to maintain narrative consistency and technical accuracy.
3. Bridge & Relayer System
The bridge architecture enables cross-chain interoperability between EVM, SVM, and Bitcoin through a dedicated Relayer service.
- EVM/SVM Polling: The Relayer polls blocks from both Ethereum and Solana environments.
- Proof Submission: Proofs are submitted to the X3 runtime to finalize cross-chain transitions.
- Failover Resilience: The system supports a 3-provider failover architecture (e.g., Alchemy, Infura, QuickNode for Ethereum) to ensure 99.9% uptime.
3.1 Relayer Operation Flow
4. Validator Infrastructure
The validator subsystem focuses on performance visualization and orchestration.
- ValidatorGlobe: A React/Three.js 3D visualization component that displays validator nodes, connection topology, and real-time status.
- Leaderboard Pallet: Tracks performance metrics including TPS, latency, and uptime.
- Inferstructor Dashboard: A Tauri-based desktop application providing metrics, telemetry, and validator orchestration controls.
Sources: plans/PHASE_5_IMPLEMENTATION_PLAN.md:18-40, plans/PHASE_5_IMPLEMENTATION_PLAN.md:130-145
5. Security & Invariant Enforcement
System integrity is maintained through an Enforceable Runtime Invariant Registry.
- Atomic Settlement Integrity: Ensures cross-VM state agreement.
- Capability Envelopes: Restricts what agents and nodes can read, write, or spend.
- Emergency Powers: Explicit "kill switches" and quarantine semantics for runtime modules.
Sources: X3_END_TO_END_GAPS_MASTER_PLAN.md:86-105, knowledge-audit-report.md:73-81
6. Data Storage & Schema
The desktop application and CRM components utilize a local SQLite database (CrmDb) to manage agents, tasks, and leads.
6.1 Core Entity Relationship
Conclusion
The X3 Atomic Star architecture integrates high-performance blockchain logic with an autonomous agent swarm. By separating the system into distinct planes and enforcing cryptographic invariants, the project aims to deliver a resilient, auditable, and self-improving infrastructure for cross-chain settlement and decentralized computing.