lineage-rs 0.2.2

Software identity preserved through irreversible change
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84

//! # Lineage Finance - Evolutionary AI Trading Platform
//!
//! This module extends Lineage with financial domain concepts:
//! - Irreversible trades with no rollback capability
//! - Finite capital (energy) as resource constraint
//! - Permanent damage from losses (scars)
//! - Evolutionary spawning of successful agents
//! - Trust scoring based on performance history
//! - Multi-agent competitive simulations
//!
//! ## Core Philosophy
//!
//! Financial agents in this system face real consequences:
//! - Losses leave permanent scars that increase future costs
//! - Poor performance leads to death (zero capital)
//! - Successful agents spawn inheriting optimized traits
//! - History is append-only and auditable forever

pub mod agent;
pub mod trade;
pub mod traits;
pub mod data_providers;
pub mod visualization;
pub mod metrics;
pub mod scars;
pub mod spawning;
pub mod trust_scoring;
pub mod arena;
pub mod advanced;
pub mod market_data;

// ML module (optional feature)
#[cfg(feature = "ml")]
pub mod ml;

// Re-export public API
pub use agent::{FinanceAgent, AgentId, AgentMetrics, FinanceAgentStatus};
pub use traits::{
    TradingStrategy, MarketDataProvider, EventHandler, VisualizationProvider,
    MarketSnapshot, PricePoint, TradeDecision, AgentEvent, VisualizationFormat,
};
pub use trade::{Trade, TradeOperation, TradeResult, TradeDirection, ExecutionError};
pub use scars::{FinancialScar, ScarImpact, FinancialDamage};
pub use spawning::{Offspring, OffspringTraits, InheritanceStrategy};
pub use trust_scoring::{PerformanceScore, TrustFormula, TrustGrant};
pub use arena::{Arena, CompetitionResult, MarketState};
pub use advanced::{BlockchainHook, EvolutionaryStrategy, GovernanceVote, ResurrectionMechanic, ResurrectionRecord};
pub use market_data::{MarketDataClient, PriceData, MarketDataConfig, MarketDataError, CircuitBreakerState};
pub use metrics::{MetricsCollector, MetricsSnapshot};

/// Configuration for finance agents
#[derive(Debug, Clone)]
pub struct FinanceConfig {
    /// Percentage of trade value lost as fee (0-100)
    pub fee_percentage: f32,
    
    /// Maximum leverage allowed for an agent
    pub max_leverage: f32,
    
    /// Drawdown percentage threshold that triggers scars
    pub scar_threshold: f32,
    
    /// Cost multiplier per scar (increments trading costs)
    pub scar_cost_multiplier: f32,
    
    /// Minimum capital to spawn offspring
    pub min_spawn_capital: u64,
    
    /// Percentage of capital required to spawn (is lost in spawn)
    pub spawn_cost_percentage: f32,
}

impl Default for FinanceConfig {
    fn default() -> Self {
        FinanceConfig {
            fee_percentage: 0.1,           // 0.1% fees
            max_leverage: 5.0,             // 5x leverage max
            scar_threshold: 5.0,           // 5% drawdown triggers scar
            scar_cost_multiplier: 1.05,   // 5% cost increase per scar
            min_spawn_capital: 10000,
            spawn_cost_percentage: 25.0,   // 25% capital cost to spawn
        }
    }
}