Struct CircularFlowRatio 

pub struct CircularFlowRatio { /* private fields */ }

Circular flow detection kernel.

Detects circular transactions using Strongly Connected Components (SCC). High circular flow ratio indicates potential money laundering.

Implementations

impl CircularFlowRatio

pub fn new() -> Self

Create a new circular flow detection kernel.

pub fn add_edge( &self, source_id: u64, dest_id: u64, amount: f64, ) -> (bool, u32, f64)

Add an edge to the transaction graph. Returns (cycle_detected, cycle_size, source_ratio).

pub fn query_entity(&self, entity_id: u64) -> (f64, u32, u64)

Query circular flow ratio for an entity.

pub fn compute( transactions: &[Transaction], min_amount: f64, ) -> CircularFlowResult

Detect circular flows in transactions.

Arguments

• transactions - List of transactions to analyze
• min_amount - Minimum total amount for a cycle to be flagged

Trait Implementations

impl BatchKernel<CircularFlowInput, CircularFlowOutput> for CircularFlowRatio

fn execute<'life0, 'async_trait>( &'life0 self, input: CircularFlowInput, ) -> Pin<Box<dyn Future<Output = Result<CircularFlowOutput>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Execute the kernel with the given input.

fn validate_input(&self, _input: &I) -> Result<(), KernelError>

Validate the input before execution.

impl Clone for CircularFlowRatio

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CircularFlowRatio

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for CircularFlowRatio

fn default() -> Self

Returns the “default value” for a type.

impl GpuKernel for CircularFlowRatio

fn metadata(&self) -> &KernelMetadata

Returns the kernel metadata.

fn validate(&self) -> Result<(), KernelError>

Validate kernel configuration.

fn id(&self) -> &str

Returns the kernel ID.

fn requires_gpu_native(&self) -> bool

Returns true if this kernel requires GPU-native execution.

impl RingKernelHandler<AddGraphEdgeRing, AddGraphEdgeResponse> for CircularFlowRatio

Ring handler for adding edges to the transaction graph.

fn handle<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 mut RingContext<'_>, msg: AddGraphEdgeRing, ) -> Pin<Box<dyn Future<Output = Result<AddGraphEdgeResponse>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Handle an incoming message.

fn initialize<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 mut RingContext<'_>, ) -> Pin<Box<dyn Future<Output = Result<(), KernelError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: Sync + 'async_trait,

Initialize the kernel state.

fn shutdown<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 mut RingContext<'_>, ) -> Pin<Box<dyn Future<Output = Result<(), KernelError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: Sync + 'async_trait,

Called when the kernel is being shut down.

impl RingKernelHandler<QueryCircularRatioRing, QueryCircularRatioResponse> for CircularFlowRatio

Ring handler for querying circular flow ratio.

fn handle<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 mut RingContext<'_>, msg: QueryCircularRatioRing, ) -> Pin<Box<dyn Future<Output = Result<QueryCircularRatioResponse>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Handle an incoming message.

fn initialize<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 mut RingContext<'_>, ) -> Pin<Box<dyn Future<Output = Result<(), KernelError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: Sync + 'async_trait,

Initialize the kernel state.

fn shutdown<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 mut RingContext<'_>, ) -> Pin<Box<dyn Future<Output = Result<(), KernelError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: Sync + 'async_trait,

Called when the kernel is being shut down.