graph TB
    subgraph "User Interface"
        UI[User Input/Commands]
        CHAT[Chat Mode]
        AUTO[Autonomous Mode]
    end
    
    subgraph "AI Layer"
        LLM[GPT-4o-mini<br/>Language Model]
        AGENT[ReAct Agent<br/>LangGraph]
    end
    
    subgraph "Action Providers"
        ERC20[ERC-20 Actions]
        WALLET[Wallet Operations]
        WETH[WETH Actions]
        PYTH[Pyth Oracle]
        SUPERETH[SuperETH Tools]
    end
    
    subgraph "Blockchain Layer"
        ETH[Ethereum<br/>Sepolia]
        BASE[Base<br/>Sepolia]
        OPT[Optimism<br/>Sepolia]
    end
    
    subgraph "Storage"
        KEYS[Encrypted Wallets]
        CONFIG[Configuration Files]
    end
    
    UI --> CHAT
    UI --> AUTO
    CHAT --> AGENT
    AUTO --> AGENT
    
    AGENT <--> LLM
    AGENT --> ERC20
    AGENT --> WALLET
    AGENT --> WETH
    AGENT --> PYTH
    AGENT --> SUPERETH
    
    ERC20 --> ETH
    ERC20 --> BASE
    ERC20 --> OPT
    
    WALLET --> ETH
    WALLET --> BASE
    WALLET --> OPT
    
    SUPERETH --> OPT
    
    AGENT <--> KEYS
    AGENT <--> CONFIG
    
    style LLM fill:#412991,color:#fff
    style AGENT fill:#1C3C3C,color:#fff
    style SUPERETH fill:#FF0420,color:#fff

flowchart TD
    START([Start Application]) --> LOAD[Load Environment Variables]
    LOAD --> CHECK{Required Config?}
    CHECK -->|Missing| ERROR[Display Error & Exit]
    CHECK -->|Valid| SETUP[Setup Wallet Provider]
    
    SETUP --> WALLET{Wallet Exists?}
    WALLET -->|No| CREATE[Create New Wallet]
    WALLET -->|Yes| LOAD_WALLET[Load Existing Wallet]
    
    CREATE --> INIT[Initialize Agent]
    LOAD_WALLET --> INIT
    
    INIT --> MODE{Select Mode}
    MODE -->|Chat| CHAT_LOOP[Interactive Chat Loop]
    MODE -->|Autonomous| AUTO_LOOP[Autonomous Execution Loop]
    
    CHAT_LOOP --> INPUT[Wait for User Input]
    INPUT --> PROCESS[Process with Agent]
    PROCESS --> ACTION{Action Required?}
    
    ACTION -->|Blockchain Op| EXECUTE[Execute Blockchain Action]
    ACTION -->|Response Only| RESPOND[Generate Response]
    
    EXECUTE --> CHAIN{Which Chain?}
    CHAIN -->|Ethereum| ETH_ACTION[Ethereum Transaction]
    CHAIN -->|Base| BASE_ACTION[Base Transaction]
    CHAIN -->|Optimism| OPT_ACTION[Optimism Transaction]
    CHAIN -->|Cross-Chain| CROSS_ACTION[SuperETH Cross-Chain]
    
    ETH_ACTION --> RESPOND
    BASE_ACTION --> RESPOND
    OPT_ACTION --> RESPOND
    CROSS_ACTION --> RESPOND
    
    RESPOND --> DISPLAY[Display Result]
    DISPLAY --> EXIT_CHECK{Exit Command?}
    EXIT_CHECK -->|No| INPUT
    EXIT_CHECK -->|Yes| END([End])
    
    AUTO_LOOP --> AUTO_ACTION[Generate Autonomous Action]
    AUTO_ACTION --> AUTO_EXECUTE[Execute Action]
    AUTO_EXECUTE --> WAIT[Wait Interval]
    WAIT --> AUTO_ACTION
    
    ERROR --> END
    
    style START fill:#e1f5fe
    style INIT fill:#e8f5e8
    style EXECUTE fill:#fff3e0
    style CROSS_ACTION fill:#ffebee
    style END fill:#f3e5f5

sequenceDiagram
    participant User
    participant Agent
    participant LLM as GPT-4o-mini
    participant Wallet
    participant Optimism
    participant Base
    participant Ethereum
    
    User->>Agent: "Mint 100 SuperETH on Optimism"
    Agent->>LLM: Process natural language
    LLM->>Agent: Generate action plan
    Agent->>Wallet: Get account details
    Wallet->>Agent: Account info
    Agent->>Optimism: Execute mint transaction
    Optimism->>Agent: Transaction receipt
    Agent->>User: "Successfully minted 100 SuperETH"
    
    User->>Agent: "Check Base balance"
    Agent->>Base: Query balance
    Base->>Agent: Balance data
    Agent->>User: "Your Base balance is 2.5 ETH"