# slimefamilyxyz/slimefamily architecture

> Architecture diagram of the GitHub repository slimefamilyxyz/slimefamily, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/slimefamilyxyz/slimefamily
- Repository: https://github.com/slimefamilyxyz/slimefamily

## Overview

Slime Family is a public-facing AI memecoin trading product: owners configure slimes, which periodically assess markets, propose trades, pass server-side checks, and publish their activity. The README also documents a model-comparison battle, wallet and transaction safeguards, Telegram controls, and operational monitoring. This tree contains documentation and media, but no application source, so component paths are null; edges reflect README-described behavior, not inspected implementations.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_trading["Trading workflow"]
  node_scheduler["Slime turns"]
  node_owner_rules["Owner rules"]
  node_market["Market reads"]
  node_filters["Coin filters"]
  node_species["Slime species"]
  node_ai["AI decision"]
  node_swap_routes["Swap routes"]
  node_chains{{"Supported chains"}}
end

subgraph group_safety["Safety and wallets"]
  node_trade_checks["Trade checks"]
  node_sellback["Sell-back check"]
  node_tx_review["Transaction review"]
  node_wallet[("Slime wallet")]
end

subgraph group_public["Public experience"]
  node_public_board["Public activity"]
  node_mood_growth["Mood and growth"]
  node_battle["AI battle"]
  node_telegram["Telegram bot"]
end

subgraph group_operations["Operations"]
  node_monitoring["Trade monitoring"]
  node_kill_switch["Kill switch"]
end

node_owner(("Owner"))

node_owner -->|"sets rules"| node_owner_rules
node_owner -->|"links wallet"| node_wallet
node_scheduler -->|"checks stops"| node_owner_rules
node_scheduler -->|"reads market"| node_market
node_market -->|"screens coins"| node_filters
node_filters -->|"informs decision"| node_ai
node_species -->|"guides strategy"| node_ai
node_ai -->|"proposes trade"| node_trade_checks
node_trade_checks -->|"enforces limits"| node_owner_rules
node_trade_checks -->|"checks resale"| node_sellback
node_trade_checks -->|"validates swap"| node_tx_review
node_tx_review -->|"reviews route"| node_swap_routes
node_swap_routes -->|"builds swap"| node_wallet
node_wallet -->|"signs trades"| node_chains
node_scheduler -->|"posts thoughts"| node_public_board
node_scheduler -->|"updates state"| node_mood_growth
node_battle -->|"displays results"| node_public_board
node_telegram -->|"pauses or wakes"| node_scheduler
node_telegram -->|"requests cashout"| node_wallet
node_monitoring -->|"can halt trading"| node_kill_switch

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_scheduler,node_owner_rules,node_market,node_filters,node_species,node_ai,node_swap_routes,node_chains toneBlue
class node_trade_checks,node_sellback,node_tx_review,node_wallet toneAmber
class node_public_board,node_mood_growth,node_battle,node_telegram toneMint
class node_monitoring,node_kill_switch toneRose
class node_owner toneIndigo
```

## Components

### Trading workflow

- **Slime turns**
- **Owner rules**
- **Market reads**
- **Coin filters**
- **Slime species**
- **AI decision**
- **Swap routes**
- **Supported chains**

### Safety and wallets

- **Trade checks**
- **Sell-back check**
- **Transaction review**
- **Slime wallet**

### Public experience

- **Public activity**
- **Mood and growth**
- **AI battle**
- **Telegram bot**

### Operations

- **Trade monitoring**
- **Kill switch**

### Other components

- **Owner**

## Connections

- Owner → Owner rules: sets rules (evidence: `README.md`)
- Owner → Slime wallet: links wallet (evidence: `README.md`)
- Slime turns → Owner rules: checks stops (evidence: `README.md`)
- Slime turns → Market reads: reads market (evidence: `README.md`)
- Market reads → Coin filters: screens coins (evidence: `README.md`)
- Coin filters → AI decision: informs decision (evidence: `README.md`)
- Slime species → AI decision: guides strategy (evidence: `README.md`)
- AI decision → Trade checks: proposes trade (evidence: `README.md`)
- Trade checks → Owner rules: enforces limits (evidence: `README.md`)
- Trade checks → Sell-back check: checks resale (evidence: `README.md`)
- Trade checks → Transaction review: validates swap (evidence: `README.md`)
- Transaction review → Swap routes: reviews route (evidence: `README.md`)
- Swap routes → Slime wallet: builds swap (evidence: `README.md`)
- Slime wallet → Supported chains: signs trades (evidence: `README.md`)
- Slime turns → Public activity: posts thoughts (evidence: `README.md`)
- Slime turns → Mood and growth: updates state (evidence: `README.md`)
- AI battle → Public activity: displays results (evidence: `README.md`)
- Telegram bot → Slime turns: pauses or wakes (evidence: `README.md`)
- Telegram bot → Slime wallet: requests cashout (evidence: `README.md`)
- Trade monitoring → Kill switch: can halt trading (evidence: `README.md`)
