# aboutcircles/5ecret-garden architecture

> Architecture diagram of the GitHub repository aboutcircles/5ecret-garden, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aboutcircles/5ecret-garden
- Repository: https://github.com/aboutcircles/5ecret-garden

## Overview

##### Main System Components

a) Frontend Application Layer
- SvelteKit Framework
- Component Library
- Pages/Routes
- Stores (State Management)

b) Integration Layer
- Circles SDK Integration
- Web3 Wallet Connections
- Safe Integration

c) Blockchain Layer
- Circles Protocol (V2.0)
- Smart Contracts
- Token Management

##### Component Organization

a) Frontend Architecture:
- Routes Structure (/src/routes)
- Authentication flows (_new/connect-wallet)
- Dashboard views (_new/dashboard)
- Registration flows (_new/register)
- Settings management

b) Core Components (/src/lib/components):
- Wallet Management
- Profile Management
- Transaction Handling
- Asset Management

c) State Management (/src/lib/stores):
- Circles-specific stores
- Avatar/Profile stores
- Transaction stores
- Wallet connection stores

##### Data Flow Representation

- User interaction flows
- Authentication processes
- Transaction processes
- State updates

##### Specific Implementation Details

a) Key Features:
- Wallet Connection Options (Metamask, Cometh, Safe)
- Profile Management
- Token Operations (Wrap/Unwrap)
- Contact Management
- Management

b) State Management:
- Circles Balance Management
- Transaction History
- Contact Lists
- Profile Data

##### Component Relationships

Clear connections between:
- UI Components → Stores
- Stores → SDK Integration
- SDK → Blockchain
- Wallet Connections → Safe/Web3 Providers

##### Technical Stack Indicators

Technology badges for:
- SvelteKit
- Circles SDK
- Web3 Technologies
- Safe Protocol
- Tailwind CSS

**User Interface Layer**
- ↓
**State Management Layer**
- ↓
**Integration Layer**
- ↓
**Blockchain Layer**

Special Considerations:

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph UI["User Interface Layer"]
        Routes["Routes Structure"]
        Dashboard["Dashboard Interface"]
        WalletConnect["Wallet Connection"]
        Registration["Registration System"]
        Settings["Settings Management"]
        
        subgraph CoreComponents["Core Components"]
            ProfileEditor["Profile Editor"]
            BalanceDisplay["Balance Display"]
            TokenOperations["Token Operations"]
            ContactsUI["Contacts Interface"]
            GroupsUI["Groups Interface"]
        end
    end

    subgraph State["State Management Layer"]
        ProfileStore["Profile Store"]
        BalanceStore["Balance Store"]
        TransactionStore["Transaction Store"]
        ContactStore["Contact Store"]
        GroupStore["Group Store"]
    end

    subgraph Integration["Integration Layer"]
        CirclesSDK["Circles SDK"]
        Web3Wallet["Web3 Wallet"]
        SafeProtocol["Safe Protocol"]
        
        subgraph Flows["Core Flows"]
            SendFlow["Send Flow"]
            MintFlow["Mint Flow"]
            MigrateFlow["Migration Flow"]
            AddContactFlow["Add Contact Flow"]
        end
    end

    subgraph Blockchain["Blockchain Layer"]
        CirclesV2["Circles Protocol V2"]
        SmartContracts["Smart Contracts"]
        TokenManagement["Token Management"]
    end

    %% Relationships
    Routes --> Dashboard
    Routes --> WalletConnect
    Routes --> Registration
    Routes --> Settings

    CoreComponents --> State
    State --> Integration
    Integration --> Blockchain

    %% Click events
    click Routes "https://github.com/aboutcircles/5ecret-garden/tree/main//src/routes/_new"
    click Dashboard "https://github.com/aboutcircles/5ecret-garden/tree/main//src/routes/_new/dashboard"
    click WalletConnect "https://github.com/aboutcircles/5ecret-garden/tree/main//src/routes/_new/connect-wallet"
    click Registration "https://github.com/aboutcircles/5ecret-garden/tree/main//src/routes/_new/register"
    click Settings "https://github.com/aboutcircles/5ecret-garden/tree/main//src/routes/settings"
    click ProfileEditor "https://github.com/aboutcircles/5ecret-garden/blob/main//src/lib/components/ProfileEditor.svelte"
    click BalanceDisplay "https://github.com/aboutcircles/5ecret-garden/blob/main//src/lib/components/TotalBalance.svelte"
    click ContactsUI "https://github.com/aboutcircles/5ecret-garden/tree/main//src/routes/_new/contacts"
    click GroupsUI "https://github.com/aboutcircles/5ecret-garden/tree/main//src/routes/_new/groups"
    click ProfileStore "https://github.com/aboutcircles/5ecret-garden/blob/main//src/lib/stores/profile.ts"
    click BalanceStore "https://github.com/aboutcircles/5ecret-garden/blob/main//src/lib/stores/circlesBalances.ts"
    click TransactionStore "https://github.com/aboutcircles/5ecret-garden/blob/main//src/lib/stores/transactionHistory.ts"
    click ContactStore "https://github.com/aboutcircles/5ecret-garden/blob/main//src/lib/stores/contacts.ts"
    click GroupStore "https://github.com/aboutcircles/5ecret-garden/blob/main//src/lib/stores/groups.ts"
    click SendFlow "https://github.com/aboutcircles/5ecret-garden/tree/main//src/lib/flows/send"
    click MintFlow "https://github.com/aboutcircles/5ecret-garden/tree/main//src/lib/flows/mintGroupTokens"
    click MigrateFlow "https://github.com/aboutcircles/5ecret-garden/tree/main//src/lib/flows/migrateToV2"
    click AddContactFlow "https://github.com/aboutcircles/5ecret-garden/tree/main//src/lib/flows/addContact"

    %% Styling
    classDef frontend fill:#3498db,stroke:#2980b9,color:white
    classDef state fill:#2ecc71,stroke:#27ae60,color:white
    classDef integration fill:#f1c40f,stroke:#f39c12,color:black
    classDef blockchain fill:#9b59b6,stroke:#8e44ad,color:white
    classDef security fill:#e74c3c,stroke:#c0392b,color:white

    class Routes,Dashboard,WalletConnect,Registration,Settings,CoreComponents,ProfileEditor,BalanceDisplay,TokenOperations,ContactsUI,GroupsUI frontend
    class ProfileStore,BalanceStore,TransactionStore,ContactStore,GroupStore state
    class CirclesSDK,Web3Wallet,SafeProtocol,Flows,SendFlow,MintFlow,MigrateFlow,AddContactFlow integration
    class CirclesV2,SmartContracts,TokenManagement blockchain
    class WalletConnect security
```
