┌─────────────────────────────────────────────────────────────────────────────┐
│                    DRIVERS OF INSTITUTIONAL ADOPTION                        │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                             │
│  ┌──────────────────────────────────────────────────────────────────────┐   │
│  │                    ASSET PERFORMANCE                                │   │
│  │  • Bitcoin has outperformed traditional assets over 10+ years      │   │
│  │  • Portfolio diversification benefits                              │   │
│  │  • Inflation hedge potential                                       │   │
│  └──────────────────────────────────────────────────────────────────────┘   │
│                                                                             │
│  ┌──────────────────────────────────────────────────────────────────────┐   │
│  │                    REGULATORY CLARITY                               │   │
│  │  • Clearer frameworks (MiCA, SEC guidance)                         │   │
│  │  • Custody and compliance solutions                                │   │
│  │  • Reduced regulatory risk                                         │   │
│  └──────────────────────────────────────────────────────────────────────┘   │
│                                                                             │
│  ┌──────────────────────────────────────────────────────────────────────┐   │
│  │                    INFRASTRUCTURE MATURITY                          │   │
│  │  • Institutional-grade custody                                      │   │
│  │  • Regulated exchanges                                              │   │
│  │  • Professional services                                            │   │
│  └──────────────────────────────────────────────────────────────────────┘   │
│                                                                             │
│  ┌──────────────────────────────────────────────────────────────────────┐   │
│  │                    CUSTOMER DEMAND                                  │   │
│  │  • Growing interest from clients                                   │   │
│  │  • Demand for crypto products                                      │   │
│  │  • Competitive pressure                                            │   │
│  └──────────────────────────────────────────────────────────────────────┘   │
│                                                                             │
│  ┌──────────────────────────────────────────────────────────────────────┐   │
│  │                    TECHNOLOGICAL ADVANCEMENTS                       │   │
│  │  • Scalability improvements                                         │   │
│  │  • Interoperability solutions                                      │   │
│  │  • Privacy-enhancing technologies                                  │   │
│  └──────────────────────────────────────────────────────────────────────┘   │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────────────────┐
│                    TRADITIONAL FINANCE INTEGRATION MODELS                   │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                             │
│  1. COMPLETE SEPARATION                                                    │
│  ┌──────────────────────────────────────────────────────────────────────┐   │
│  │ • Traditional finance and DeFi operate separately                   │   │
│  │ • No integration                                                     │   │
│  │ • Examples: Traditional banks (pre-2020)                           │   │
│  └──────────────────────────────────────────────────────────────────────┘   │
│                                                                             │
│  2. CEIF - CENTRALISED FINANCE WITH CRYPTO EXPOSURE                       │
│  ┌──────────────────────────────────────────────────────────────────────┐   │
│  │ • Traditional institutions offer crypto products                   │   │
│  │ • Centralised custody and execution                                │   │
│  │ • Examples: Crypto ETFs, custody services                          │   │
│  └──────────────────────────────────────────────────────────────────────┘   │
│                                                                             │
│  3. HYBRID APPROACH                                                        │
│  ┌──────────────────────────────────────────────────────────────────────┐   │
│  │ • Traditional finance + DeFi components                             │   │
│  │ • Some DeFi exposure                                                 │   │
│  │ • Examples: Some banks offering crypto lending                      │   │
│  └──────────────────────────────────────────────────────────────────────┘   │
│                                                                             │
│  4. FULL INTEGRATION                                                      │
│  ┌──────────────────────────────────────────────────────────────────────┐   │
│  │ • Traditional finance and DeFi fully integrated                      │   │
│  │ • Programmable money, smart contracts                               │   │
│  │ • Examples: Future state                                             │   │
│  └──────────────────────────────────────────────────────────────────────┘   │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘

# ===================================================================
# MODULE 8, LESSON 4: INSTITUTIONAL ADOPTION AND TRADITIONAL FINANCE INTEGRATION
# ===================================================================

import pandas as pd
import matplotlib.pyplot as plt
import numpy as np
from typing import Dict, List
import warnings
warnings.filterwarnings('ignore')

print("="*70)
print("INSTITUTIONAL ADOPTION AND TRADITIONAL FINANCE INTEGRATION")
print("="*70)

# ----------------------------------------------------------------
# PART A: INSTITUTIONAL PORTFOLIO SIMULATION
# ----------------------------------------------------------------

print("\n" + "-"*60)
print("PART A: Institutional Portfolio Simulation")
print("-"*60)

class InstitutionalPortfolio:
    """
    Simulated institutional portfolio with crypto allocation.
    """
    def __init__(self, name: str, total_assets: float):
        self.name = name
        self.total_assets = total_assets
        self.allocations = {}
        self.performances = {}
        self.history = []
    
    def add_asset_class(self, asset: str, allocation: float, expected_return: float, volatility: float):
        self.allocations[asset] = allocation
        self.performances[asset] = {
            'expected_return': expected_return,
            'volatility': volatility
        }
    
    def simulate_returns(self, years: int = 5) -> pd.DataFrame:
        """Simulate portfolio returns over time."""
        np.random.seed(42)
        data = []
        current_values = {}
        
        for year in range(years + 1):
            year_data = {'Year': year}
            total_value = 0
            
            for asset, allocation in self.allocations.items():
                if year == 0:
                    value = allocation * self.total_assets
                else:
                    # Simulate return with random noise
                    ret = self.performances[asset]['expected_return'] + np.random.normal(0, self.performances[asset]['volatility'])
                    value = current_values[asset] * (1 + ret)
                
                current_values[asset] = value
                year_data[asset] = value
                total_value += value
            
            year_data['Total'] = total_value
            data.append(year_data)
        
        return pd.DataFrame(data)

# Create institutional portfolio
portfolio = InstitutionalPortfolio("Institutional Digital Asset Fund", 100000000)

# Add asset classes
portfolio.add_asset_class('Bitcoin', 0.30, 0.40, 0.50)
portfolio.add_asset_class('Ethereum', 0.20, 0.35, 0.45)
portfolio.add_asset_class('Equities', 0.25, 0.08, 0.15)
portfolio.add_asset_class('Bonds', 0.15, 0.04, 0.05)
portfolio.add_asset_class('Cash', 0.10, 0.02, 0.01)

print("Institutional Portfolio Allocation:")
for asset, allocation in portfolio.allocations.items():
    print(f"  {asset}: {allocation:.1%}")

# Simulate performance
df = portfolio.simulate_returns(5)
print(f"\nPortfolio Performance (5 years):")
print(f"  Initial Value: ${df.iloc[0]['Total']:,.0f}")
print(f"  Final Value: ${df.iloc[-1]['Total']:,.0f}")
print(f"  Total Return: {((df.iloc[-1]['Total'] / df.iloc[0]['Total']) - 1) * 100:.1f}%")

# Visualise
fig, ax = plt.subplots(figsize=(12, 6))
years = df['Year']
total = df['Total'] / 1000000  # in millions

ax.plot(years, total, color='blue', linewidth=2, label='Total Portfolio Value')
for asset in portfolio.allocations.keys():
    if asset in df.columns:
        ax.plot(years, df[asset] / 1000000, linestyle='--', alpha=0.5, label=asset)

ax.set_xlabel('Year')
ax.set_ylabel('Value (USD Millions)')
ax.set_title('Institutional Portfolio Performance')
ax.legend()
ax.grid(True, alpha=0.3)

plt.tight_layout()
plt.savefig('institutional_portfolio.png', dpi=300, bbox_inches='tight')
plt.show()
print("Institutional portfolio chart saved as 'institutional_portfolio.png'")

# ----------------------------------------------------------------
# PART B: INSTITUTIONAL ADOPTION TIMELINE
# ----------------------------------------------------------------

print("\n" + "-"*60)
print("PART B: Institutional Adoption Timeline")
print("-"*60)

adoption_timeline = {
    'Year': ['2009-2015', '2016-2018', '2019-2021', '2022-2023', '2024-2025', '2026+'],
    'Phase': ['Dormant', 'Early Interest', 'FOMO', 'Correction & Maturity', 'Regulated Growth', 'Mainstream'],
    'Key Events': [
        'Bitcoin launch, early adoption',
        'First regulated exchanges, ICO boom',
        'Institutional interest, crypto ETFs',
        'Market crash, regulatory action',
        'MiCA, institutional infrastructure',
        'Full integration with TradFi'
    ],
    'Institutional Participation': [
        'None',
        'Limited (pioneers)',
        'Growing (hedge funds)',
        'Selective (banks)',
        'Broad (asset managers)',
        'Universal (all institutions)'
    ]
}

timeline_df = pd.DataFrame(adoption_timeline)
print(timeline_df.to_string(index=False))

# ----------------------------------------------------------------
# PART C: CUSTODY PROVIDER COMPARISON
# -----------------------------------------------------------------

print("\n" + "-"*60)
print("PART C: Custody Provider Comparison")
print("-"*60)

custody_data = {
    'Provider': ['Fireblocks', 'Coinbase Custody', 'Anchorage', 'BitGo', 'Fidelity Digital'],
    'Type': ['Infrastructure', 'Exchange', 'Bank', 'Enterprise', 'Traditional'],
    'Insurance': ['$100M+', '$100M+', '$100M+', '$100M+', '$100M+'],
    'Regulatory': ['NYDFS', 'NYDFS', 'US Regulator', 'NYDFS', 'SEC/FINRA'],
    'Supported Assets': ['50+', '100+', '200+', '100+', '5+'],
    'Key Clients': ['Exchanges, TradFi', 'Institutions', 'Banks', 'Enterprises', 'Institutions']
}

custody_df = pd.DataFrame(custody_data)
print(custody_df.to_string(index=False))

# ----------------------------------------------------------------
# PART D: TRADITIONAL FINANCE INTEGRATION FRAMEWORK
# -----------------------------------------------------------------

print("\n" + "-"*60)
print("PART D: Traditional Finance Integration Framework")
print("-"*60)

integration_framework = {
    "Stage 1: Awareness": {
        "Description": "Traditional institutions become aware of blockchain",
        "Activities": ["Research, education, monitoring"],
        "Examples": ["Internal blockchain taskforces"]
    },
    "Stage 2: Experimentation": {
        "Description": "Small-scale pilot projects",
        "Activities": ["PoCs, small investments"],
        "Examples": ["JP Morgan's JPM Coin"]
    },
    "Stage 3: Integration": {
        "Description": "Integration with existing systems",
        "Activities": ["Custody, trading, compliance"],
        "Examples": ["Fidelity Digital Assets"]
    },
    "Stage 4: Transformation": {
        "Description": "Fundamental business model changes",
        "Activities": ["DeFi integration, tokenisation"],
        "Examples": ["Future state"]
    }
}

for stage, details in integration_framework.items():
    print(f"\n{stage.upper()}:")
    print(f"  Description: {details['Description']}")
    print("  Activities:")
    for activity in details['Activities']:
        print(f"    • {activity}")
    print(f"  Examples: {details['Examples']}")

# ----------------------------------------------------------------
# PART E: SUMMARY AND RECOMMENDATIONS
# -----------------------------------------------------------------

print("\n" + "="*70)
print("PART E: Summary and Recommendations")
print("="*70)

print("""
Institutional Adoption and Traditional Finance Integration – Key Takeaways:

1. Institutional adoption driven by asset performance, regulatory clarity, infrastructure maturity.
2. Key players: asset managers (BlackRock), banks (JPMorgan), exchanges (Coinbase), hedge funds.
3. Institutional custody: multi-layer security, insurance, compliance, reporting.
4. Integration models: complete separation, CEFI with crypto exposure, hybrid, full integration.
5. Regulatory enablers: MiCA, SEC guidance, FATF standards, Basel III.
6. Timeline: early interest → FOMO → correction → regulated growth → mainstream.

Recommendations:
  - Build institutional-grade infrastructure (custody, compliance).
  - Engage with regulators proactively.
  - Develop clear compliance frameworks.
  - Consider hybrid models (CeFi + DeFi).
  - Focus on security and risk management.
  - Educate institutional clients on digital assets.
""")