This Week In Chia - JSON Format Specification

Overview

This document defines the standardized JSON format for storing all "This Week In Chia" historical data, ensuring consistency across 2.5 years of content and enabling robust API development.

Root Structure

{
  "weeks": [...],
  "metadata": {...}
}

Week Object

{
  "weekId": "2025-06-15",           // ISO date of week start
  "startDate": "2025-06-15",       // ISO date string
  "endDate": "2025-06-21",         // ISO date string  
  "advertisement": {...} | null,    // Optional advertisement
  "weeklyHighlight": {...} | null,  // Optional weekly highlight
  "posts": [...]                   // Array of post objects
}

Advertisement Object

{
  "title": "World Meme Championships",
  "imageUrl": "ads/20250615.jpg",
  "linkUrl": "https://tanggang.life/wmc/",
  "altText": "World Meme Championships"
}

Weekly Highlight Object

{
  "name": "Spacescan",
  "description": "A well deserving core community member...",
  "donationAddress": "xch1a6cd558gqs...",
  "supportUrl": "https://www.spacescan.io/support-us",
  "bannerImage": "assets/images/spacescan.png", 
  "donationImage": "donations/20250615.png",
  "websiteUrl": "https://www.spacescan.io/"
}

Post Object (Core Structure)

{
  "postId": "2025-06-15-1",        // Unique identifier: date-index
  "date": "2025-06-15",            // ISO date string
  "dayOfWeek": "SUNDAY" | null,    // Day name or null for older posts
  "categories": {
    "primary": "Community",         // Main category
    "secondary": "Space"            // Sub-category  
  },
  "categoryIcons": ["🌎", "🚀"],   // Emoji icons array
  "type": "X Space",               // Standardized post type
  "author": {...},                 // Author object
  "title": "...",                  // Extracted title
  "content": "...",                // Full post content
  "mentions": [...],               // Array of @mentions
  "links": [...],                  // Array of external links
  "topics": [...],                 // Array of topic strings
  "version": {...} | null,         // Version info for releases
  "metadata": {...}                // Post metadata flags
}

Author Object

{
  "handle": "@DracattusDev",       // Social handle or name
  "url": "https://x.com/...",      // Profile URL (empty string if none)
  "displayName": "DracattusDev",   // Clean display name
  "role": "host"                   // "host" | "author" | "organization"
}

Mention Object

{
  "handle": "@hoffmang",
  "url": "https://x.com/hoffmang",
  "context": "named as CEO"        // Brief context of mention
}

Link Object

{
  "type": "listen",                // Standardized link type
  "url": "https://...",            // Full URL
  "text": "Listen"                   // Link text from original
}

Standardized Link Types

• "announcement" - Official announcements
• "source" - Primary source links
• "listen" - Audio content (X Spaces, podcasts)
• "watch" - Video content
• "read" - Articles, blog posts, documentation
• "details" - More information pages
• "website" - Main websites
• "download" - Download links
• "thread" - Twitter/X thread links
• "external" - Other external links

Version Object

{
  "product": "Chia Client",        // Product name
  "number": "1.6.2",              // Version number
  "type": "stable"                 // "stable" | "beta" | "alpha"
}

Metadata Object

{
  "hasMedia": false,               // Contains images/video
  "hasThread": false,              // Is a Twitter thread
  "isLive": false                  // Live content (streams, etc.)
}

Standardized Post Types

• "X Space" - Twitter/X Spaces
• "Announcement" - General announcements
• "Major Announcement" - High-impact news (CEO changes, etc.)
• "Release" - Product/software releases
• "Version Release" - Specific version releases
• "Publication" - Articles, blog posts
• "Video" - Video content
• "Thread" - Twitter/X threads
• "Event" - Events and meetups
• "General" - Other content

Categories

Primary Categories

• "Community" - Community-driven content
• "Chia" - Official Chia Network content

Secondary Categories

• "News" - News and announcements
• "Space" - X Spaces and audio content
• "Video" - Video content
• "Thread" - Social media threads
• "Article" - Written articles
• "Version" - Software versions
• "NFT" - NFT-related content
• "Event" - Events and meetups

Global Metadata

{
  "totalWeeks": 130,
  "totalPosts": 2847,
  "dateRange": {
    "earliest": "2023-01-01",
    "latest": "2025-06-21"
  },
  "generatedAt": "2025-06-16T10:30:00Z",
  "version": "1.0"
}

Design Principles

Consistency

• All dates in ISO format (YYYY-MM-DD)
• All arrays, even if empty
• Consistent null handling for missing data
• Standardized enums for types and categories

API-Ready

• Unique postIds for direct access
• Filterable metadata flags
• Structured objects for complex data
• Predictable field names and types

Extensible

• Can add new link types without breaking existing data
• New metadata flags can be added
• Topics array allows for new categorization
• Version object can be extended

Tool-Friendly

• JSONPath queries work consistently
• Easy to filter and search
• Structured for database import
• Clear separation of concerns

Example Queries

posts.filter(p => p.type === "X Space")

posts.filter(p => p.author.handle === "@DracattusDev")

posts.filter(p => 
  p.type === "Version Release" && 
  p.date >= "2024-01-01" && 
  p.date <= "2024-12-31"
)

posts.filter(p => 
  p.mentions.some(m => m.handle === "@hoffmang")
)