ringkernel_txmon/
lib.rs

1//! RingKernel Transaction Monitoring (TxMon)
2//!
3//! GPU-accelerated real-time transaction monitoring showcase demonstrating
4//! RingKernel capabilities for banking/AML compliance.
5//!
6//! # Features
7//!
8//! - **Transaction Factory**: Configurable synthetic transaction generation
9//! - **Compliance Rules**: Velocity breach, amount threshold, structuring, geographic anomaly
10//! - **Real-time GUI**: Live transaction feed, alerts panel, statistics dashboard
11//! - **Multi-backend**: CPU and optional CUDA GPU acceleration
12//!
13//! # GPU Backend Approaches
14//!
15//! The `cuda` module provides three different GPU-accelerated approaches:
16//!
17//! ## 1. Batch Kernel (High Throughput)
18//! Each thread processes one transaction independently. Best for maximum throughput
19//! on large batches (10M+ TPS on modern GPUs).
20//!
21//! ## 2. Ring Kernel (Actor-based Streaming)
22//! Persistent GPU kernels with HLC timestamps and K2K messaging. Best for low-latency
23//! streaming with complex multi-stage pipelines.
24//!
25//! ## 3. Stencil Kernel (Pattern Detection)
26//! Uses GridPos for spatial pattern detection in transaction networks. Detects circular
27//! trading, velocity anomalies, and coordinated activity patterns.
28
29pub mod factory;
30pub mod gui;
31pub mod monitoring;
32pub mod types;
33
34#[cfg(feature = "cuda-codegen")]
35pub mod cuda;
36
37pub use factory::{FactoryState, GeneratorConfig, TransactionGenerator};
38pub use monitoring::{MonitoringConfig, MonitoringEngine};
39pub use types::{
40    AlertSeverity, AlertStatus, AlertType, CustomerRiskLevel, CustomerRiskProfile, MonitoringAlert,
41    Transaction, TransactionType,
42};