# guardianorg/alt-fun-defender-contest-guardian architecture

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

- Interactive diagram: https://gitdiagram.com/guardianorg/alt-fun-defender-contest-guardian
- Repository: https://github.com/guardianorg/alt-fun-defender-contest-guardian

## Overview

Alt Fun is a HyperEVM token launchpad. Its documented on-chain flow is token trading through a bonding curve whose reserve asset is a BounceTech leveraged token; trades generate contract events consumed by the indexer. The supplied tree exposes the contracts package and vendored OpenZeppelin tooling, but not the launchpad contracts themselves or the app, API, and indexer source, so those runtime components are shown only at the documented package or service level. The vendor scripts are not product runtime components.

Main entry points: [`packages/contracts`](https://github.com/guardianorg/alt-fun-defender-contest-guardian/tree/main/packages/contracts) (Launchpad contracts)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_trade["Token trading"]
  node_web["Web app"]
end

subgraph group_protocol["On-chain protocol"]
  node_contracts["Launchpad contracts"]
  node_curve["Bonding curve"]
  node_ltreserve["LT reserve asset"]
  node_hyperevm[("HyperEVM")]
end

subgraph group_readpath["Event read path"]
  node_indexer["Ponder indexer"]
  node_graphql["GraphQL read path"]
end

node_trader(("Trader"))

node_trader -->|"initiates trades"| node_web
node_web -->|"submits transactions"| node_contracts
node_contracts -.->|"executes trades"| node_curve
node_curve -->|"holds reserve"| node_ltreserve
node_contracts -->|"runs on"| node_hyperevm
node_contracts -->|"emits events"| node_indexer
node_indexer -->|"provides reads"| node_graphql

click node_contracts "https://github.com/guardianorg/alt-fun-defender-contest-guardian/tree/main/packages/contracts"
click node_curve "https://github.com/guardianorg/alt-fun-defender-contest-guardian/tree/main/packages/contracts"

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_web toneBlue
class node_contracts,node_curve,node_ltreserve,node_hyperevm toneAmber
class node_indexer,node_graphql toneMint
class node_trader toneIndigo
```

## Components

### Token trading

- **Web app**

### On-chain protocol

- [Launchpad contracts](https://github.com/guardianorg/alt-fun-defender-contest-guardian/tree/main/packages/contracts): `packages/contracts`
- [Bonding curve](https://github.com/guardianorg/alt-fun-defender-contest-guardian/tree/main/packages/contracts): `packages/contracts`
- **LT reserve asset**
- **HyperEVM**

### Event read path

- **Ponder indexer**
- **GraphQL read path**

### Other components

- **Trader**

## Connections

- Trader → Web app: initiates trades (evidence: `README.md`)
- Web app → Launchpad contracts: submits transactions (evidence: `README.md`)
- Launchpad contracts → Bonding curve: executes trades
- Bonding curve → LT reserve asset: holds reserve (evidence: `README.md`)
- Launchpad contracts → HyperEVM: runs on (evidence: `README.md`)
- Launchpad contracts → Ponder indexer: emits events (evidence: `README.md`)
- Ponder indexer → GraphQL read path: provides reads (evidence: `README.md`)
