# daulathussain/multi-currency-ico-dapp-starter-file architecture

> Architecture diagram of the GitHub repository daulathussain/multi-currency-ico-dapp-starter-file, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-14). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/daulathussain/multi-currency-ico-dapp-starter-file
- Repository: https://github.com/daulathussain/multi-currency-ico-dapp-starter-file

## Overview

##### Project type and purpose
- This is a full-stack Web3 DApp comprising:
- A React/Next.js frontend (UI, pages, components, context and state management)
- Solidity smart contracts managed with Hardhat (ICO, staking, referral)
- Web3 integration via Wagmi, React context and custom hooks
- External services (Alchemy RPC, Pinata IPFS, Formspree, WalletConnect)

##### File structure
- Top-level “components”, “context”, “provider”, “pages” and “styles” folders → Next.js frontend
- Next.config.js, postcss.config.js, tailwind.config.js → build & styling config for Next.js
- “web3” subfolder → Hardhat project: contracts, artifacts, build-info, deploy scripts, config
- Env files (.env.local, web3/.env, .env.local.main) → keys for RPC, IPFS, API services
- package.json in root and web3 → separate dependencies for frontend vs smart-contracts
- provider/hooks.js & wagmiConfigs.js → centralized configuration for Web3 client

##### README for insights
- Purpose: Multi-Currency ICO, staking and referral DApp on EVM
- Tech stack: Next.js, Solidity, Wagmi, Hardhat, Tailwind CSS
- Key features: multi-token ICO smart contract, staking mechanism, referral rewards, wallet connect

##### Main components and interactions
a. Frontend Presentation Layer
- Next.js pages (index.js, dashboard.js, _app.js)
- React components (UI modules under components/*)
- Global context (ToastContext, Utility, Web3Provider)
b. Web3 Client Layer
- wagmi client (provider/wagmiConfigs.js)
- custom hooks (provider/hooks.js)
- WalletConnect UI component
c. Smart Contract Layer
- Solidity contracts (web3/contracts)
- Deployment scripts (web3/scripts/deploy.js)
- Hardhat config (web3/hardhat.config.js)
- Artifacts & ABIs (web3/artifacts)
d. Blockchain Infrastructure
- EVM network (e.g., Ethereum testnet/mainnet via Alchemy or other RPC)
- Hardhat local node (for development)
e. External Services
- Alchemy (RPC provider)
- Pinata (IPFS for whitepaper, metadata)
- Formspree (contact forms)
- WalletConnect or Reown relay

##### Architectural patterns and design principles
- Layered architecture: Presentation → Web3 Client → Smart Contracts → Blockchain
- Component-based UI (modular React components)
- Context API for cross-cutting state (toasts, utility functions, Web3 provider)
- Wagmi for declarative Web3 hooks and provider management
- Hardhat for contract compilation, testing, and deployment

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Presentation Layer
    subgraph "Presentation Layer"
        direction TB
        A1["_app.js"]:::frontend
        A2["index.js"]:::frontend
        A3["dashboard.js"]:::frontend
        subgraph "Components"
            direction TB
            C1["Global"]:::frontend
            C2["HomePage"]:::frontend
            C3["AdminOverview"]:::frontend
            C4["AdminFunctions"]:::frontend
            C5["ContactUs"]:::frontend
            C6["Dashboard"]:::frontend
            C7["TokenCalculator"]:::frontend
            C8["TokenDocumentation"]:::frontend
            C9["TokenSale"]:::frontend
            C10["TokenTransfer"]:::frontend
            C11["Transaction"]:::frontend
            C12["UserDashboard"]:::frontend
            C13["WithdrawTokens"]:::frontend
        end
        subgraph "Styles & Config"
            direction TB
            S1["globals.css"]:::frontend
            S2["tailwind.config.js"]:::frontend
            S3["postcss.config.js"]:::frontend
            S4["next.config.js"]:::frontend
        end
        subgraph "Context"
            direction TB
            CT1["ToastContext.js"]:::frontend
            CT2["Utility.js"]:::frontend
            CT3["Web3Provider.js"]:::frontend
        end
    end

    %% Web3 Client Layer
    subgraph "Web3 Client Layer"
        direction TB
        WC1["wagmiConfigs.js"]:::web3client
        WC2["hooks.js"]:::web3client
        WC3["WalletConnect.jsx"]:::web3client
    end

    %% Smart Contract Layer
    subgraph "Smart Contract Layer"
        direction TB
        SC1["contracts"]:::contract
        SC2["hardhat.config.js"]:::contract
        subgraph "Deployment Scripts"
            direction TB
            SC3["deploy.js"]:::contract
            SC4["main.js"]:::contract
        end
        SC5["artifacts"]:::contract
    end

    %% Blockchain Infrastructure
    subgraph "Blockchain Infrastructure"
        direction TB
        I1["Hardhat Local Node"]:::infra
        I2["Alchemy RPC"]:::infra
    end

    %% External Services
    subgraph "External Services"
        direction TB
        E1["Pinata IPFS"]:::external
        E2["Formspree"]:::external
        E3["WalletConnect Relay"]:::external
    end

    %% Connections
    CT3 -->|"provides Web3 context"| WC1
    WC3 -->|"uses Wagmi client"| WC1
    WC1 -->|"JSON-RPC calls"| I2
    WC1 -->|"JSON-RPC calls"| I1
    A1 -->|"uploads whitepaper"| E1
    A1 -->|"submits form"| E2
    A2 -->|"uploads metadata"| E1
    SC3 -->|"deploys contracts"| SC1
    SC3 -->|"runs on node"| I1
    I2 -->|"reads/writes state"| SC1
    I1 -->|"reads/writes state"| SC1
    A1 -->|"loads ABIs"| SC5

    %% Click Events
    click A1 "https://github.com/daulathussain/multi-currency-ico-dapp-starter-file/blob/main/pages/_app.js"
    click A2 "https://github.com/daulathussain/multi-currency-ico-dapp-starter-file/blob/main/pages/index.js"
    click A3 "https://github.com/daulathussain/multi-currency-ico-dapp-starter-file/blob/main/pages/dashboard.js"
    click C1 "https://github.com/daulathussain/multi-currency-ico-dapp-starter-file/tree/main/components/Global"
    click C2 "https://github.com/daulathussain/multi-currency-ico-dapp-starter-file/tree/main/components/HomePage"
    click C3 "https://github.com/daulathussain/multi-currency-ico-dapp-starter-file/blob/main/components/AdminOverview/AdminOverview.jsx"
    click C4 "https://github.com/daulathussain/multi-currency-ico-dapp-starter-file/blob/main/components/AdminFunctions/AdminFunctions.jsx"
    click C5 "https://github.com/daulathussain/multi-currency-ico-dapp-starter-file/blob/main/components/ContactUs/ContactUs.jsx"
    click C6 "https://github.com/daulathussain/multi-currency-ico-dapp-starter-file/blob/main/components/Dashboard/Dashboard.jsx"
    click C7 "https://github.com/daulathussain/multi-currency-ico-dapp-starter-file/blob/main/components/TokenCalculator/TokenCalculator.jsx"
    click C8 "https://github.com/daulathussain/multi-currency-ico-dapp-starter-file/blob/main/components/TokenDocumentation/TokenDocumentation.jsx"
    click C9 "https://github.com/daulathussain/multi-currency-ico-dapp-starter-file/blob/main/components/TokenSale/TokenSale.jsx"
    click C10 "https://github.com/daulathussain/multi-currency-ico-dapp-starter-file/blob/main/components/TokenTransfer/TokenTransfer.jsx"
    click C11 "https://github.com/daulathussain/multi-currency-ico-dapp-starter-file/blob/main/components/Transaction/Transaction.jsx"
    click C12 "https://github.com/daulathussain/multi-currency-ico-dapp-starter-file/blob/main/components/UserDashboard/UserDashboard.jsx"
    click C13 "https://github.com/daulathussain/multi-currency-ico-dapp-starter-file/blob/main/components/WithdrawTokens/WithdrawTokens.jsx"
    click S1 "https://github.com/daulathussain/multi-currency-ico-dapp-starter-file/blob/main/styles/globals.css"
    click S2 "https://github.com/daulathussain/multi-currency-ico-dapp-starter-file/blob/main/tailwind.config.js"
    click S3 "https://github.com/daulathussain/multi-currency-ico-dapp-starter-file/blob/main/postcss.config.js"
    click S4 "https://github.com/daulathussain/multi-currency-ico-dapp-starter-file/blob/main/next.config.js"
    click CT1 "https://github.com/daulathussain/multi-currency-ico-dapp-starter-file/blob/main/context/ToastContext.js"
    click CT2 "https://github.com/daulathussain/multi-currency-ico-dapp-starter-file/blob/main/context/Utility.js"
    click CT3 "https://github.com/daulathussain/multi-currency-ico-dapp-starter-file/blob/main/context/Web3Provider.js"
    click WC1 "https://github.com/daulathussain/multi-currency-ico-dapp-starter-file/blob/main/provider/wagmiConfigs.js"
    click WC2 "https://github.com/daulathussain/multi-currency-ico-dapp-starter-file/blob/main/provider/hooks.js"
    click WC3 "https://github.com/daulathussain/multi-currency-ico-dapp-starter-file/blob/main/components/Global/WalletConnect.jsx"
    click SC1 "https://github.com/daulathussain/multi-currency-ico-dapp-starter-file/tree/main/web3/contracts"
    click SC2 "https://github.com/daulathussain/multi-currency-ico-dapp-starter-file/blob/main/web3/hardhat.config.js"
    click SC3 "https://github.com/daulathussain/multi-currency-ico-dapp-starter-file/blob/main/web3/scripts/deploy.js"
    click SC4 "https://github.com/daulathussain/multi-currency-ico-dapp-starter-file/blob/main/web3/scripts/main.js"
    click SC5 "https://github.com/daulathussain/multi-currency-ico-dapp-starter-file/tree/main/web3/artifacts"

    %% Styles
    classDef frontend fill:#f0f8ff,stroke:#333,stroke-width:1px
    classDef web3client fill:#fffacd,stroke:#333,stroke-width:1px
    classDef contract fill:#e0ffe0,stroke:#333,stroke-width:1px
    classDef infra fill:#e0f7ff,stroke:#333,stroke-width:1px
    classDef external fill:#fce4ec,stroke:#333,stroke-width:1px
```
