arkhe-origin-chain/crates/origin-coin-tokenomics/src/lib.rs

//! # origin-coin-tokenomics
//!
//! $OGC token implementation per **CHN-2** + multi-tier fee matrix per **CHN-8** +
//! multi-source burn enforcement per CHN-2/CHN-8. Stub crate in v0.0.1.
//!
//! ## Phase 1 milestones
//!
//! - 1.3 `pallet_balances` con OGC token (1B supply genesis)
//! - 1.7 Genesis config: allocation 40/25/15/15/5 per BM V2
//!
//! ## Phase 2 milestones
//!
//! - 2.4 `fee_for_transaction(tier, quality) -> Ogc` implementation
//! - 2.5 Fee matrix: EmbeddedArm 0.1×, Portable 0.3×, Desktop 1.0×, Ultra 0.7×
//! - 2.6 Hero surcharge: Desktop +0.5×, Ultra +0.3×
//!
//! ## Canonical burn matrix
//!
//! Per CHN-2 + CHN-8 + Pillar 6/7 docs:
//!
//! | Source | Burn rate |
//! |--------|-----------|
//! | Gas fees | 100% |
//! | Seeds Hosting payments | 20% |
//! | Marketplace 9% Treasury share | 50% (2% del 9%) |
//! | ONS registration | 50% |
//! | OIT Oracle | 30% |
//! | Escrow commissions | 20% |
//! | Resonance slashing | 25% |
//! | Ticket commissions | 30% |
//! | Reputation stake slashing | 50% |
//! | Ethos net revenue buy-back | 5% |

#![deny(missing_docs)]

/// Placeholder marker for the tokenomics module. Replaced by concrete pallet in Phase 1.3.
#[derive(Debug, Clone, Copy, Default)]
pub struct TokenomicsConfig;

#[cfg(test)]
mod tests {
    use super::*;
    use origin_chain_types::fees::compute_fee;
    use origin_chain_types::{AssetQualityTier, HardwareTier, Ogc};

    // Sanity test: the trait crate's compute_fee returns canonical values.
    // This proves the workspace dependency wires up correctly.
    #[test]
    fn cross_crate_fee_calculation_canonical() {
        let fee = compute_fee(
            Ogc::from_whole(10),
            HardwareTier::EmbeddedArm,
            AssetQualityTier::Standard,
        );
        assert_eq!(fee.as_base_units(), Ogc::from_whole(1).as_base_units());
    }

    #[test]
    fn stub_crate_compiles() {
        let _cfg = TokenomicsConfig;
    }
}