> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clyrbot.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# NFT Mint Radar

> How Clyr ingests, parses, normalizes, and schedules daily generative NFT drop schedules across multiple blockchain networks.

## Overview

Staying ahead of generative NFT drop schedules across different Discord servers, timezones, and chains is difficult for community members.

The **Clyr Mint Radar** (`MintRadarService`) automates this workflow: it ingests alpha drop schedules directly from Discord alpha channels, standardizes chaotic timestamps into local timezones, classifies multi-chain metadata, and delivers structured daily intelligence cards directly into WhatsApp communities.

```
┌─────────────────────────────────────────────────────────────────────────────┐
│                       MINT RADAR PIPELINE                                   │
├─────────────────────────────────────────────────────────────────────────────┤
│  1. Ingestion: Raw Discord embed schedules ingested via API / Dashboard     │
│  2. Timestamp Normalization: Discord <t:1700000000:t> ──> 1:30 PM WAT       │
│  3. Chain Classification: Regex assigns chain badges (⟠ ETH, 🔵 Base, etc.) │
│  4. Link Categorization: Detects X/Twitter, OpenSea, Whitelist, Website     │
│  5. Distribution: Morning 08:00 WAT auto-broadcast or on-demand /mints      │
└─────────────────────────────────────────────────────────────────────────────┘
```

***

## Data Enrichment & Normalization

When raw mint schedules are ingested, the `MintRadarService` executes several transformation passes:

### 1. Automated Unix Timestamp Conversion

Discord schedules frequently use dynamic unix time tags (e.g. `<t:1700000000:t>` or `<t:1700000000:F>`). The engine parses the epoch seconds, adjusts for daylight savings, and converts the times into standard **West Africa Time (WAT / UTC+1)** and **UTC** for crystal-clear comprehension.

### 2. Multi-Chain Badge Decoration

Projects are mapped to their native blockchain with visual chain badges:

* `⟠ Ethereum`
* `🔵 Base`
* `◎ Solana`
* `🟣 Polygon / MATIC`
* `🟡 Binance Smart Chain (BNB)`
* `🔶 Arbitrum One`
* `🔺 Avalanche (AVAX)`

### 3. Smart Link Extraction

Hyperlinks within the announcement are classified and labeled with contextual icons:

* 🐦 **X / Twitter**: Official project account or spaces link
* 🌊 **OpenSea**: Official verified collection or drop page
* ✅ **Whitelist Checker**: Official portal to verify wallet eligibility
* 👾 **Discord**: Official Discord server invite
* 🌐 **Website**: Project homepage or mint dApp

***

## Output Card Format

Here is how a processed drop schedule renders inside WhatsApp:

```text theme={null}
🎨 *TODAY'S CURATED NFT MINTS* (14 Oct 2026)

━━━━━━━━━━━━━━━━━━━━
1. *CyberSamurai Evolution* 🔵 Base
• Supply: 3,333 items
• WL Mint: Free (2:00 PM WAT)
• Public Mint: 0.005 ETH (4:30 PM WAT)
• Verified Links:
  🐦 x.com/cybersamurai
  🌊 opensea.io/collection/cybersamurai
  ✅ check.cybersamurai.io

━━━━━━━━━━━━━━━━━━━━
2. *SolGods: The Ascension* ◎ Solana
• Supply: 2,500 items
• WL Mint: 1.25 SOL (5:00 PM WAT)
• Public Mint: 1.80 SOL (7:00 PM WAT)
• Verified Links:
  🐦 x.com/solgods
  🌐 solgods.xyz
```

***

## Delivery Mechanisms

### 1. On-Demand Retrieval (`/mints`)

Any group member can query the current day's active drop schedule at any time:

```bash theme={null}
/mints
```

### 2. Automated Scheduled Broadcasts (`/mint-on`)

Group administrators can subscribe the group to automatic morning drops. Every morning at **08:00 WAT (07:00 UTC)**, the background cron service fetches the active schedule and posts it to all subscribed groups.

```bash theme={null}
/mint-on    # Enables automatic morning broadcasts
/mint-off   # Mutes scheduled drop broadcasts
```

***

## Admin Dispatcher (Sentinel Dashboard)

Community administrators with access to the **Sentinel Web Dashboard** (`http://localhost:3334`) can manage the schedule visually:

1. **Schedule Staging**: Paste raw text or Discord JSON embeds directly into the dashboard editor.
2. **Real-Time Card Preview**: Inspect the live WhatsApp layout and link resolutions before publishing.
3. **One-Click Multi-Group Broadcast**: Dispatch the validated schedule across all groups simultaneously with built-in anti-spam spacing.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.