config/constants.py

"""
Dynamic RWA Yield Router — Configuration & Constants
=====================================================
All contract addresses, ABIs, chain configuration, and protocol parameters
for the Mantle L2 ecosystem (Chain ID 5000).
"""

import os
from dataclasses import dataclass, field
from typing import Dict, List, Optional
from enum import Enum

# ─────────────────────────── Chain Config ───────────────────────────

MANTLE_CHAIN_ID = 5000
MANTLE_RPC_URL = os.getenv("MANTLE_RPC_URL", "https://rpc.mantle.xyz")
MANTLE_WSS_URL = os.getenv("MANTLE_WSS_URL", "wss://ws.mantle.xyz")
MANTLE_EXPLORER = "https://explorer.mantle.xyz"
MANTLE_BLOCK_TIME_SECONDS = 2  # Mantle L2 ~2s blocks

# ─────────────────────────── Token Addresses (Mantle Mainnet) ───────

class Tokens:
    """Core token contract addresses on Mantle L2."""
    # Stablecoins
    USDC = "0x09Bc4E0D864854c6aFB6eB9A9cdF58aC190D0dF9"
    USDT = "0x201EBa5CC46D216Ce6DC03F6a759e8E766e956aE"
    
    # Native / Wrapped
    WMNT = "0x78c1b0C915c4FAA5FffA6CAbf0219DA63d7f4cb8"
    WETH = "0xdEAddEaDdeadDEadDEADDEAddEADDEAddead1111"
    
    # RWA Assets — Core Portfolio
    USDY = "0x5bE26527e817998A7206475496fDE1E68957c5A6"    # Ondo USDY (tokenized T-bills, ~4.25% APY)
    METH = "0xcDA86A272531e8640cD7F1a92c01839911B90bb0"    # Mantle Staked ETH (~3-5% APY)
    CMETH = "0xE6829d9a7eE3040e1276Fa75293Bde931859e8fD"   # Mantle Restaked ETH (cmETH)
    
    # MI4 — Mantle Index Four (multi-chain, primary on Avalanche)
    # On Mantle, MI4 exposure may be achieved via bridged tokens or Securitize portal
    MI4_AVALANCHE = "0xe87db19a4a45a804f9b6e8038777c9a0ffbc5808"
    MI4_PROXY = None  # Set via env if bridged to Mantle
    
    # Fluxion xStocks RWA tokens (on Mantle)
    XAAPL = "0x3E6f0A37E795dA0304a7fC400f4CF6D8D028e1Ee"
    XGOOG = "0x98a4eaB8B6CFE76EB8e36FcB5a0F09E2E4B62c2b"
    XAMZN = "0x3607c534e9Ae5B4f1e968d9E7480e9D8a5f22eAa"
    XTSLA = "0x5762E9828C8EEF98Ae08C7F8eB2C53C3dF6C4c2C"
    XSPY = "0x5D9D2F2d8b8E7B5C0E5d6A4b0E7F1c2A3D4E5F6A"  # Placeholder


# ─────────────────────────── DEX Router Addresses ───────────────────

class DEXRouters:
    """DEX router contracts on Mantle."""
    FLUXION_SWAP_ROUTER = "0x5628a59df0ecac3f3171f877a94beb26ba6dfaa0"
    AGNI_SWAP_ROUTER = "0x319B69888b0d11cEC22caA5034e25FfFBDc88421"
    MERCHANT_MOE_ROUTER = "0xeaEE7EE68874218c3558b40063c42B82D3E7232a"
    
    # Fluxion V3 (Uni V3 fork) — primary for RWA pairs
    FLUXION_FACTORY = "0x5CA14E40bB7Bc70A3c2e672D5F43e5B8cE48ec68"
    FLUXION_QUOTER = "0x64B421eE1a1Ed22ed2288B4e3e15Dd9bD5AC5B68"


# ─────────────────────────── Lending Protocol Addresses ─────────────

class LendingProtocols:
    """Lending/yield protocol contracts on Mantle."""
    # Aave V3 (Lendle fork on Mantle)
    AAVE_V3_POOL = "0x458F293454fE0d67EC0655f3672301301DD51422"
    AAVE_V3_POOL_DATA_PROVIDER = "0x5DA14e30e92E20C9B4Fe3e22c2B499D7EA0E8b02"
    
    # INIT Capital
    INIT_CORE = "0x972BcD3960c17E5e1f2B98713c2B1A1E1eE1e2D3"  # Verify on deploy
    
    # Pendle (yield tokenization)
    PENDLE_ROUTER = "0x00000000005BBB0EF59571E58418F9a4357b68A0"


# ─────────────────────────── Minimal ABIs ───────────────────────────

ERC20_ABI = [
    {"constant": True, "inputs": [], "name": "name", "outputs": [{"name": "", "type": "string"}], "type": "function"},
    {"constant": True, "inputs": [], "name": "symbol", "outputs": [{"name": "", "type": "string"}], "type": "function"},
    {"constant": True, "inputs": [], "name": "decimals", "outputs": [{"name": "", "type": "uint8"}], "type": "function"},
    {"constant": True, "inputs": [], "name": "totalSupply", "outputs": [{"name": "", "type": "uint256"}], "type": "function"},
    {"constant": True, "inputs": [{"name": "_owner", "type": "address"}], "name": "balanceOf", "outputs": [{"name": "balance", "type": "uint256"}], "type": "function"},
    {"constant": False, "inputs": [{"name": "_spender", "type": "address"}, {"name": "_value", "type": "uint256"}], "name": "approve", "outputs": [{"name": "", "type": "bool"}], "type": "function"},
    {"constant": True, "inputs": [{"name": "_owner", "type": "address"}, {"name": "_spender", "type": "address"}], "name": "allowance", "outputs": [{"name": "", "type": "uint256"}], "type": "function"},
    {"constant": False, "inputs": [{"name": "_to", "type": "address"}, {"name": "_value", "type": "uint256"}], "name": "transfer", "outputs": [{"name": "", "type": "bool"}], "type": "function"},
]

# Uniswap V3 SwapRouter (Fluxion/Agni compatible)
SWAP_ROUTER_ABI = [
    {
        "inputs": [
            {
                "components": [
                    {"name": "tokenIn", "type": "address"},
                    {"name": "tokenOut", "type": "address"},
                    {"name": "fee", "type": "uint24"},
                    {"name": "recipient", "type": "address"},
                    {"name": "deadline", "type": "uint256"},
                    {"name": "amountIn", "type": "uint256"},
                    {"name": "amountOutMinimum", "type": "uint256"},
                    {"name": "sqrtPriceLimitX96", "type": "uint160"},
                ],
                "name": "params",
                "type": "tuple",
            }
        ],
        "name": "exactInputSingle",
        "outputs": [{"name": "amountOut", "type": "uint256"}],
        "type": "function",
    },
    {
        "inputs": [
            {
                "components": [
                    {"name": "path", "type": "bytes"},
                    {"name": "recipient", "type": "address"},
                    {"name": "deadline", "type": "uint256"},
                    {"name": "amountIn", "type": "uint256"},
                    {"name": "amountOutMinimum", "type": "uint256"},
                ],
                "name": "params",
                "type": "tuple",
            }
        ],
        "name": "exactInput",
        "outputs": [{"name": "amountOut", "type": "uint256"}],
        "type": "function",
    },
]

# Aave V3 Pool — supply/withdraw
AAVE_POOL_ABI = [
    {
        "inputs": [
            {"name": "asset", "type": "address"},
            {"name": "amount", "type": "uint256"},
            {"name": "onBehalfOf", "type": "address"},
            {"name": "referralCode", "type": "uint16"},
        ],
        "name": "supply",
        "outputs": [],
        "type": "function",
    },
    {
        "inputs": [
            {"name": "asset", "type": "address"},
            {"name": "amount", "type": "uint256"},
            {"name": "to", "type": "address"},
        ],
        "name": "withdraw",
        "outputs": [{"name": "", "type": "uint256"}],
        "type": "function",
    },
    {
        "inputs": [{"name": "asset", "type": "address"}],
        "name": "getReserveData",
        "outputs": [
            {
                "components": [
                    {"name": "configuration", "type": "uint256"},
                    {"name": "liquidityIndex", "type": "uint128"},
                    {"name": "currentLiquidityRate", "type": "uint128"},
                    {"name": "variableBorrowIndex", "type": "uint128"},
                    {"name": "currentVariableBorrowRate", "type": "uint128"},
                    {"name": "currentStableBorrowRate", "type": "uint128"},
                    {"name": "lastUpdateTimestamp", "type": "uint40"},
                    {"name": "id", "type": "uint16"},
                    {"name": "aTokenAddress", "type": "address"},
                    {"name": "stableDebtTokenAddress", "type": "address"},
                    {"name": "variableDebtTokenAddress", "type": "address"},
                    {"name": "interestRateStrategyAddress", "type": "address"},
                    {"name": "accruedToTreasury", "type": "uint128"},
                    {"name": "unbacked", "type": "uint128"},
                    {"name": "isolationModeTotalDebt", "type": "uint128"},
                ],
                "name": "",
                "type": "tuple",
            }
        ],
        "type": "function",
    },
]

# mETH staking — read staking yield
METH_STAKING_ABI = [
    {"constant": True, "inputs": [], "name": "mETHToETH", "outputs": [{"name": "", "type": "uint256"}], "type": "function"},
    {"constant": True, "inputs": [], "name": "totalControlled", "outputs": [{"name": "", "type": "uint256"}], "type": "function"},
    {"constant": True, "inputs": [], "name": "exchangeRateUpdatedAt", "outputs": [{"name": "", "type": "uint256"}], "type": "function"},
]


# ─────────────────────────── Portfolio Parameters ───────────────────

@dataclass
class PortfolioConfig:
    """Default portfolio allocation parameters."""
    # Asset universe
    assets: List[str] = field(default_factory=lambda: ["USDY", "mETH", "MI4"])
    
    # Target yield (annualized)
    min_target_apy: float = 3.5  # minimum acceptable APY %
    max_target_apy: float = 12.0  # aspirational max
    
    # Risk constraints
    max_single_asset_weight: float = 0.60  # no single asset > 60%
    min_single_asset_weight: float = 0.05  # minimum 5% in each active asset
    max_drawdown_pct: float = 0.10  # 10% max drawdown trigger
    
    # Rebalancing
    rebalance_threshold_pct: float = 0.05  # rebalance when drift > 5%
    min_rebalance_interval_hours: int = 4   # no more frequent than 4h
    max_rebalance_interval_hours: int = 168  # at least weekly
    
    # Gas budget
    max_gas_per_rebalance_usd: float = 5.0  # Mantle gas is cheap (~$0.01-0.10/tx)
    
    # Slippage
    max_slippage_bps: int = 50  # 0.5% max slippage


@dataclass
class RiskConfig:
    """Risk management parameters."""
    # Depeg detection thresholds
    usdy_depeg_threshold: float = 0.005   # USDY/USD deviation > 0.5%
    meth_depeg_threshold: float = 0.02    # mETH/ETH deviation > 2%
    
    # Circuit breakers
    circuit_breaker_cooldown_hours: int = 24
    emergency_exit_to: str = "USDC"  # flee to stablecoin on emergency
    
    # Smart contract risk scores (0-1, higher = riskier)
    protocol_risk_scores: Dict[str, float] = field(default_factory=lambda: {
        "USDY": 0.15,   # Ondo — audited, regulated, low risk
        "mETH": 0.25,   # Mantle LSP — battle-tested but smart contract risk
        "MI4": 0.30,    # Securitize — newer product, moderate risk
        "Aave": 0.10,   # Heavily audited
        "Fluxion": 0.35, # Newer DEX, higher risk
    })
    
    # Volatility lookback
    volatility_window_days: int = 30
    correlation_window_days: int = 90


@dataclass 
class RLConfig:
    """Reinforcement Learning hyperparameters."""
    # PPO parameters
    learning_rate: float = 3e-4
    gamma: float = 0.99          # discount factor
    gae_lambda: float = 0.95     # GAE lambda
    clip_range: float = 0.2      # PPO clip
    entropy_coef: float = 0.01   # exploration bonus
    value_coef: float = 0.5
    max_grad_norm: float = 0.5
    
    # Training
    n_steps: int = 2048
    batch_size: int = 64
    n_epochs: int = 10
    total_timesteps: int = 1_000_000
    
    # State space dimension
    state_dim: int = 15  # yield rates, prices, volatilities, portfolio weights, macro
    action_dim: int = 3  # weights for [USDY, mETH, MI4]
    
    # Environment
    episode_length_days: int = 30
    reward_scaling: float = 100.0  # scale small yield differences


# ─────────────────────────── API Endpoints ──────────────────────────

class APIEndpoints:
    """External data source endpoints."""
    DEFILLAMA_YIELDS = "https://yields.llama.fi/pools"
    DEFILLAMA_PROTOCOL = "https://api.llama.fi/protocol/{protocol}"
    DEFILLAMA_TVL = "https://api.llama.fi/tvl/{protocol}"
    
    COINGECKO_PRICE = "https://api.coingecko.com/api/v3/simple/price"
    COINGECKO_HISTORY = "https://api.coingecko.com/api/v3/coins/{coin_id}/market_chart"
    
    BYBIT_TICKER = "https://api.bybit.com/v5/market/tickers"
    BYBIT_KLINE = "https://api.bybit.com/v5/market/kline"
    
    # Federal Reserve data
    FRED_API = "https://api.stlouisfed.org/fred/series/observations"
    
    # Mantle-specific
    MANTLE_SUBGRAPH = "https://subgraph.mantle.xyz/subgraphs/name/{name}"


# ─────────────────────────── Logging Config ─────────────────────────

LOG_FORMAT = "%(asctime)s | %(name)-20s | %(levelname)-7s | %(message)s"
LOG_DATE_FORMAT = "%Y-%m-%d %H:%M:%S"
LOG_LEVEL = os.getenv("LOG_LEVEL", "INFO")

# ─────────────────────────── ERC-8004 Agent Identity ────────────────

ERC8004_CAPABILITIES = [
    "yield_optimization",
    "portfolio_rebalancing",
    "risk_assessment",
    "market_analysis",
    "strategy_reporting",
]

AGENT_METADATA = {
    "name": "Dynamic RWA Yield Router",
    "version": "1.0.0",
    "description": "Autonomous AI agent for yield-optimized RWA portfolio management on Mantle",
    "chain_id": MANTLE_CHAIN_ID,
    "supported_assets": ["USDY", "mETH", "MI4"],
    "risk_framework": "risk-parity-adaptive",
    "rl_algorithm": "PPO",
}