v0.8.2 - markdown intro

NOSTR_RELEASE.md

@@ -10,18 +10,18 @@ This relay is written in C99 with a sqlite database.
 
 It implements the following NIPs.
 
-- [X] NIP-01: Basic protocol flow implementation
-- [X] NIP-09: Event deletion
-- [X] NIP-11: Relay information document
-- [X] NIP-13: Proof of Work
-- [X] NIP-15: End of Stored Events Notice
-- [X] NIP-20: Command Results
-- [X] NIP-33: Parameterized Replaceable Events
-- [X] NIP-40: Expiration Timestamp
-- [X] NIP-42: Authentication of clients to relays
-- [X] NIP-45: Counting results
-- [X] NIP-50: Keywords filter
-- [X] NIP-70: Protected Events
+- [x] NIP-01: Basic protocol flow implementation
+- [x] NIP-09: Event deletion
+- [x] NIP-11: Relay information document
+- [x] NIP-13: Proof of Work
+- [x] NIP-15: End of Stored Events Notice
+- [x] NIP-20: Command Results
+- [x] NIP-33: Parameterized Replaceable Events
+- [x] NIP-40: Expiration Timestamp
+- [x] NIP-42: Authentication of clients to relays
+- [x] NIP-45: Counting results
+- [x] NIP-50: Keywords filter
+- [x] NIP-70: Protected Events
 
 ## The unconventional
 
@@ -29,483 +29,35 @@ It implements the following NIPs.
 
 It should just run in linux without having to worry about what you have on your system. I want to download and run. No docker. No dependency hell.
 
+I'm not bothering with other operating systems.
+
 ### The relay is a full nostr citizen with it's own public and private keys.
 
-For example, you can see my implementation running here:
+For example, you can see my relay (wss://relay.laantungir.net) running here:
 
 [https://primal.net/p/nprofile1qqswn2jsmm8lq8evas0v9vhqkdpn9nuujt90mtz60nqgsxndy66es4qjjnhr7](https://)
 
-What this means in practice is that when you start the program, it generates keys for itself, and for it's administrator (You can specify these if you wish)
+What this means in practice is that when you start the relay, it generates keys for itself, and for it's administrator (You can specify these if you wish)
 
-Now the program and the administrator can have verifed communication between the two. For example, the administrator can send DMs to the relay, asking it's status, and changing it's configuration through any client that can handle nip17 DMs. The relay can also send notifications to the administrator about it's current status, or it can publish it's status directly to NOSTR as kind-1 notes.
+Now the program and the administrator can have verifed communication between the two, simply by using nostr events. For example, the administrator can send DMs to the relay, asking it's status, and changing it's configuration through any client that can handle nip17 DMs. The relay can also send notifications to the administrator about it's current status, or it can publish it's status on a regular schedule directly to NOSTR as kind-1 notes.
 
+## Screenshots
 
+![](https://git.laantungir.net/laantungir/c-relay/raw/branch/master/screenshots/main.png)
+Main page with real time updates.
 
+![](https://git.laantungir.net/laantungir/c-relay/raw/branch/master/screenshots/config.png)
+Set your configuration preferences.
 
+![](https://git.laantungir.net/laantungir/c-relay/raw/branch/master/screenshots/subscriptions.png)
+View current subscriptions
 
-## Quick Start
+![](https://git.laantungir.net/laantungir/c-relay/raw/branch/master/screenshots/white-blacklists.png)
+Add npubs to white or black lists.
 
-Get your C-Relay up and running in minutes with a static binary (no dependencies required):
+![](https://git.laantungir.net/laantungir/c-relay/raw/branch/master/screenshots/sqlQuery.png)
+Run sql queries on the database.
 
-### 1. Download Static Binary
+![](https://git.laantungir.net/laantungir/c-relay/raw/branch/master/screenshots/main-light.png)
+Light mode.
 
-Download the latest static release from the [releases page](https://git.laantungir.net/laantungir/c-relay/releases):
-
-```bash
-# Static binary - works on all Linux distributions (no dependencies)
-wget https://git.laantungir.net/laantungir/c-relay/releases/download/v0.6.0/c-relay-v0.6.0-linux-x86_64-static
-chmod +x c-relay-v0.6.0-linux-x86_64-static
-mv c-relay-v0.6.0-linux-x86_64-static c-relay
-```
-
-### 2. Start the Relay
-
-Simply run the binary - no configuration files needed:
-
-```bash
-./c-relay
-```
-
-On first startup, you'll see:
-
-- **Admin Private Key**: Save this securely! You'll need it for administration
-- **Relay Public Key**: Your relay's identity on the Nostr network
-- **Port Information**: Default is 8888, or the next available port
-
-### 3. Access the Web Interface
-
-Open your browser and navigate to:
-
-```
-http://localhost:8888/api/
-```
-
-The web interface provides:
-
-- Real-time configuration management
-- Database statistics dashboard
-- Auth rules management
-- Secure admin authentication with your Nostr identity
-
-### 4. Test Your Relay
-
-Test basic connectivity:
-
-```bash
-# Test WebSocket connection
-curl -H "Accept: application/nostr+json" http://localhost:8888
-
-# Test with a Nostr client
-# Add ws://localhost:8888 to your client's relay list
-```
-
-### 5. Configure Your Relay (Optional)
-
-Use the web interface or send admin commands to customize:
-
-- Relay name and description
-- Authentication rules (whitelist/blacklist)
-- Connection limits
-- Proof-of-work requirements
-
-**That's it!** Your relay is now running with zero configuration required. The event-based configuration system means you can adjust all settings through the web interface or admin API without editing config files.
-
-## Web Admin Interface
-
-C-Relay includes a **built-in web-based administration interface** accessible at `http://localhost:8888/api/`. The interface provides:
-
-- **Real-time Configuration Management**: View and edit all relay settings through a web UI
-- **Database Statistics Dashboard**: Monitor event counts, storage usage, and performance metrics
-- **Auth Rules Management**: Configure whitelist/blacklist rules for pubkeys
-- **NIP-42 Authentication**: Secure access using your Nostr identity
-- **Event-Based Updates**: All changes are applied as cryptographically signed Nostr events
-
-The web interface serves embedded static files with no external dependencies and includes proper CORS headers for browser compatibility.
-
-## Administrator API
-
-C-Relay uses an innovative **event-based administration system** where all configuration and management commands are sent as signed Nostr events using the admin private key generated during first startup. All admin commands use **NIP-44 encrypted command arrays** for security and compatibility.
-
-### Authentication
-
-All admin commands require signing with the admin private key displayed during first-time startup. **Save this key securely** - it cannot be recovered and is needed for all administrative operations.
-
-### Event Structure
-
-All admin commands use the same unified event structure with NIP-44 encrypted content:
-
-**Admin Command Event:**
-
-```json
-{
-  "id": "event_id",
-  "pubkey": "admin_public_key",
-  "created_at": 1234567890,
-  "kind": 23456,
-  "content": "AqHBUgcM7dXFYLQuDVzGwMST1G8jtWYyVvYxXhVGEu4nAb4LVw...",
-  "tags": [
-    ["p", "relay_public_key"]
-  ],
-  "sig": "event_signature"
-}
-```
-
-The `content` field contains a NIP-44 encrypted JSON array representing the command.
-
-**Admin Response Event:**
-
-```json
-["EVENT", "temp_sub_id", {
-  "id": "response_event_id",
-  "pubkey": "relay_public_key",
-  "created_at": 1234567890,
-  "kind": 23457,
-  "content": "BpKCVhfN8eYtRmPqSvWxZnMkL2gHjUiOp3rTyEwQaS5dFg...",
-  "tags": [
-    ["p", "admin_public_key"]
-  ],
-  "sig": "response_event_signature"
-}]
-```
-
-The `content` field contains a NIP-44 encrypted JSON response object.
-
-### Admin Commands
-
-All commands are sent as NIP-44 encrypted JSON arrays in the event content. The following table lists all available commands:
-
-
-| Command Type                 | Command Format                                                                                                                                                                                                  | Description                                                       |
-| ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
-| **Configuration Management** |                                                                                                                                                                                                                 |                                                                   |
-| `config_update`              | `["config_update", [{"key": "auth_enabled", "value": "true", "data_type": "boolean", "category": "auth"}, {"key": "relay_description", "value": "My Relay", "data_type": "string", "category": "relay"}, ...]]` | Update relay configuration parameters (supports multiple updates) |
-| `config_query`               | `["config_query", "all"]`                                                                                                                                                                                       | Query all configuration parameters                                |
-| **Auth Rules Management**    |                                                                                                                                                                                                                 |                                                                   |
-| `auth_add_blacklist`         | `["blacklist", "pubkey", "abc123..."]`                                                                                                                                                                          | Add pubkey to blacklist                                           |
-| `auth_add_whitelist`         | `["whitelist", "pubkey", "def456..."]`                                                                                                                                                                          | Add pubkey to whitelist                                           |
-| `auth_delete_rule`           | `["delete_auth_rule", "blacklist", "pubkey", "abc123..."]`                                                                                                                                                      | Delete specific auth rule                                         |
-| `auth_query_all`             | `["auth_query", "all"]`                                                                                                                                                                                         | Query all auth rules                                              |
-| `auth_query_type`            | `["auth_query", "whitelist"]`                                                                                                                                                                                   | Query specific rule type                                          |
-| `auth_query_pattern`         | `["auth_query", "pattern", "abc123..."]`                                                                                                                                                                        | Query specific pattern                                            |
-| **System Commands**          |                                                                                                                                                                                                                 |                                                                   |
-| `system_clear_auth`          | `["system_command", "clear_all_auth_rules"]`                                                                                                                                                                    | Clear all auth rules                                              |
-| `system_status`              | `["system_command", "system_status"]`                                                                                                                                                                           | Get system status                                                 |
-| `stats_query`                | `["stats_query"]`                                                                                                                                                                                               | Get comprehensive database statistics                             |
-| **Database Queries**         |                                                                                                                                                                                                                 |                                                                   |
-| `sql_query`                  | `["sql_query", "SELECT * FROM events LIMIT 10"]`                                                                                                                                                                | Execute read-only SQL query against relay database                |
-
-### Available Configuration Keys
-
-**Basic Relay Settings:**
-
-- `relay_name`: Relay name (displayed in NIP-11)
-- `relay_description`: Relay description text
-- `relay_contact`: Contact information
-- `relay_software`: Software URL
-- `relay_version`: Software version
-- `supported_nips`: Comma-separated list of supported NIP numbers (e.g., "1,2,4,9,11,12,13,15,16,20,22,33,40,42")
-- `language_tags`: Comma-separated list of supported language tags (e.g., "en,es,fr" or "*" for all)
-- `relay_countries`: Comma-separated list of supported country codes (e.g., "US,CA,MX" or "*" for all)
-- `posting_policy`: Posting policy URL or text
-- `payments_url`: Payment URL for premium features
-- `max_connections`: Maximum concurrent connections
-- `max_subscriptions_per_client`: Max subscriptions per client
-- `max_event_tags`: Maximum tags per event
-- `max_content_length`: Maximum event content length
-
-**Authentication & Access Control:**
-
-- `auth_enabled`: Enable whitelist/blacklist auth rules (`true`/`false`)
-- `nip42_auth_required`: Enable NIP-42 cryptographic authentication (`true`/`false`)
-- `nip42_auth_required_kinds`: Event kinds requiring NIP-42 auth (comma-separated)
-- `nip42_challenge_timeout`: NIP-42 challenge expiration seconds
-
-**Proof of Work & Validation:**
-
-- `pow_min_difficulty`: Minimum proof-of-work difficulty
-- `nip40_expiration_enabled`: Enable event expiration (`true`/`false`)
-
-**Monitoring Settings:**
-
-- `kind_24567_reporting_throttle_sec`: Minimum seconds between monitoring events (default: 5)
-
-### Dynamic Configuration Updates
-
-C-Relay supports **dynamic configuration updates** without requiring a restart for most settings. Configuration parameters are categorized as either **dynamic** (can be updated immediately) or **restart-required** (require relay restart to take effect).
-
-**Dynamic Configuration Parameters (No Restart Required):**
-
-- All relay information (NIP-11) settings: `relay_name`, `relay_description`, `relay_contact`, `relay_software`, `relay_version`, `supported_nips`, `language_tags`, `relay_countries`, `posting_policy`, `payments_url`
-- Authentication settings: `auth_enabled`, `nip42_auth_required`, `nip42_auth_required_kinds`, `nip42_challenge_timeout`
-- Subscription limits: `max_subscriptions_per_client`, `max_total_subscriptions`
-- Event validation limits: `max_event_tags`, `max_content_length`, `max_message_length`
-- Proof of Work settings: `pow_min_difficulty`, `pow_mode`
-- Event expiration settings: `nip40_expiration_enabled`, `nip40_expiration_strict`, `nip40_expiration_filter`, `nip40_expiration_grace_period`
-
-**Restart-Required Configuration Parameters:**
-
-- Connection settings: `max_connections`, `relay_port`
-- Database and core system settings
-
-When updating configuration, the admin API response will indicate whether a restart is required for each parameter. Dynamic updates take effect immediately and are reflected in NIP-11 relay information documents without restart.
-
-### Response Format
-
-All admin commands return **signed EVENT responses** via WebSocket following standard Nostr protocol. Responses use JSON content with structured data.
-
-#### Response Examples
-
-**Success Response:**
-
-```json
-["EVENT", "temp_sub_id", {
-  "id": "response_event_id",
-  "pubkey": "relay_public_key",
-  "created_at": 1234567890,
-  "kind": 23457,
-  "content": "nip44 encrypted:{\"query_type\": \"config_update\", \"status\": \"success\", \"message\": \"Operation completed successfully\", \"timestamp\": 1234567890}",
-  "tags": [
-    ["p", "admin_public_key"]
-  ],
-  "sig": "response_event_signature"
-}]
-```
-
-**Error Response:**
-
-```json
-["EVENT", "temp_sub_id", {
-  "id": "response_event_id",
-  "pubkey": "relay_public_key",
-  "created_at": 1234567890,
-  "kind": 23457,
-  "content": "nip44 encrypted:{\"query_type\": \"config_update\", \"status\": \"error\", \"error\": \"invalid configuration value\", \"timestamp\": 1234567890}",
-  "tags": [
-    ["p", "admin_public_key"]
-  ],
-  "sig": "response_event_signature"
-}]
-```
-
-**Auth Rules Query Response:**
-
-```json
-["EVENT", "temp_sub_id", {
-  "id": "response_event_id",
-  "pubkey": "relay_public_key",
-  "created_at": 1234567890,
-  "kind": 23457,
-  "content": "nip44 encrypted:{\"query_type\": \"auth_rules_all\", \"total_results\": 2, \"timestamp\": 1234567890, \"data\": [{\"rule_type\": \"blacklist\", \"pattern_type\": \"pubkey\", \"pattern_value\": \"abc123...\", \"action\": \"allow\"}]}",
-  "tags": [
-    ["p", "admin_public_key"]
-  ],
-  "sig": "response_event_signature"
-}]
-```
-
-**Configuration Query Response:**
-
-```json
-["EVENT", "temp_sub_id", {
-  "id": "response_event_id",
-  "pubkey": "relay_public_key",
-  "created_at": 1234567890,
-  "kind": 23457,
-  "content": "nip44 encrypted:{\"query_type\": \"config_all\", \"total_results\": 27, \"timestamp\": 1234567890, \"data\": [{\"key\": \"auth_enabled\", \"value\": \"false\", \"data_type\": \"boolean\", \"category\": \"auth\", \"description\": \"Enable NIP-42 authentication\"}, {\"key\": \"relay_description\", \"value\": \"My Relay\", \"data_type\": \"string\", \"category\": \"relay\", \"description\": \"Relay description text\"}]}",
-  "tags": [
-    ["p", "admin_public_key"]
-  ],
-  "sig": "response_event_signature"
-}]
-```
-
-**Configuration Update Success Response:**
-
-```json
-["EVENT", "temp_sub_id", {
-  "id": "response_event_id",
-  "pubkey": "relay_public_key",
-  "created_at": 1234567890,
-  "kind": 23457,
-  "content": "nip44 encrypted:{\"query_type\": \"config_update\", \"total_results\": 2, \"timestamp\": 1234567890, \"status\": \"success\", \"data\": [{\"key\": \"auth_enabled\", \"value\": \"true\", \"status\": \"updated\"}, {\"key\": \"relay_description\", \"value\": \"My Updated Relay\", \"status\": \"updated\"}]}",
-  "tags": [
-    ["p", "admin_public_key"]
-  ],
-  "sig": "response_event_signature"
-}]
-```
-
-**Configuration Update Error Response:**
-
-```json
-["EVENT", "temp_sub_id", {
-  "id": "response_event_id",
-  "pubkey": "relay_public_key",
-  "created_at": 1234567890,
-  "kind": 23457,
-  "content": "nip44 encrypted:{\"query_type\": \"config_update\", \"status\": \"error\", \"error\": \"field validation failed: invalid port number '99999' (must be 1-65535)\", \"timestamp\": 1234567890}",
-  "tags": [
-    ["p", "admin_public_key"]
-  ],
-  "sig": "response_event_signature"
-}]
-```
-
-**Database Statistics Query Response:**
-
-```json
-["EVENT", "temp_sub_id", {
-  "id": "response_event_id",
-  "pubkey": "relay_public_key",
-  "created_at": 1234567890,
-  "kind": 23457,
-  "content": "nip44 encrypted:{\"query_type\": \"stats_query\", \"timestamp\": 1234567890, \"database_size_bytes\": 1048576, \"total_events\": 15432, \"database_created_at\": 1234567800, \"latest_event_at\": 1234567890, \"event_kinds\": [{\"kind\": 1, \"count\": 12000, \"percentage\": 77.8}, {\"kind\": 0, \"count\": 2500, \"percentage\": 16.2}], \"time_stats\": {\"total\": 15432, \"last_24h\": 234, \"last_7d\": 1456, \"last_30d\": 5432}, \"top_pubkeys\": [{\"pubkey\": \"abc123...\", \"event_count\": 1234, \"percentage\": 8.0}, {\"pubkey\": \"def456...\", \"event_count\": 987, \"percentage\": 6.4}]}",
-  "tags": [
-    ["p", "admin_public_key"]
-  ],
-  "sig": "response_event_signature"
-}]
-```
-
-**SQL Query Response:**
-
-```json
-["EVENT", "temp_sub_id", {
-  "id": "response_event_id",
-  "pubkey": "relay_public_key",
-  "created_at": 1234567890,
-  "kind": 23457,
-  "content": "nip44 encrypted:{\"query_type\": \"sql_query\", \"request_id\": \"request_event_id\", \"timestamp\": 1234567890, \"query\": \"SELECT * FROM events LIMIT 10\", \"execution_time_ms\": 45, \"row_count\": 10, \"columns\": [\"id\", \"pubkey\", \"created_at\", \"kind\", \"content\"], \"rows\": [[\"abc123...\", \"def456...\", 1234567890, 1, \"Hello world\"], ...]}",
-  "tags": [
-    ["p", "admin_public_key"],
-    ["e", "request_event_id"]
-  ],
-  "sig": "response_event_signature"
-}]
-```
-
-### SQL Query Command
-
-The `sql_query` command allows administrators to execute read-only SQL queries against the relay database. This provides powerful analytics and debugging capabilities through the admin API.
-
-**Request/Response Correlation:**
-
-- Each response includes the request event ID in both the `tags` array (`["e", "request_event_id"]`) and the decrypted content (`"request_id": "request_event_id"`)
-- This allows proper correlation when multiple queries are submitted concurrently
-- Frontend can track pending queries and match responses to requests
-
-**Security Features:**
-
-- Only SELECT statements allowed (INSERT, UPDATE, DELETE, DROP, etc. are blocked)
-- Query timeout: 5 seconds (configurable)
-- Result row limit: 1000 rows (configurable)
-- All queries logged with execution time
-
-**Available Tables and Views:**
-
-- `events` - All Nostr events
-- `config` - Configuration parameters
-- `auth_rules` - Authentication rules
-- `subscription_events` - Subscription lifecycle log
-- `event_broadcasts` - Event broadcast log
-- `recent_events` - Last 1000 events (view)
-- `event_stats` - Event statistics by type (view)
-- `subscription_analytics` - Subscription metrics (view)
-- `active_subscriptions_log` - Currently active subscriptions (view)
-- `event_kinds_view` - Event distribution by kind (view)
-- `top_pubkeys_view` - Top 10 pubkeys by event count (view)
-- `time_stats_view` - Time-based statistics (view)
-
-**Example Queries:**
-
-```sql
--- Recent events
-SELECT id, pubkey, created_at, kind FROM events ORDER BY created_at DESC LIMIT 20
-
--- Event distribution by kind
-SELECT * FROM event_kinds_view ORDER BY count DESC
-
--- Active subscriptions
-SELECT * FROM active_subscriptions_log ORDER BY created_at DESC
-
--- Database statistics
-SELECT
-  (SELECT COUNT(*) FROM events) as total_events,
-  (SELECT COUNT(*) FROM subscription_events) as total_subscriptions
-```
-
-## Real-time Monitoring System
-
-C-Relay includes a subscription-based monitoring system that broadcasts real-time relay statistics using ephemeral events (kind 24567).
-
-### Activation
-
-The monitoring system activates automatically when clients subscribe to kind 24567 events:
-
-```json
-["REQ", "monitoring-sub", {"kinds": [24567]}]
-```
-
-For specific monitoring types, use d-tag filters:
-
-```json
-["REQ", "event-kinds-sub", {"kinds": [24567], "#d": ["event_kinds"]}]
-["REQ", "time-stats-sub", {"kinds": [24567], "#d": ["time_stats"]}]
-["REQ", "top-pubkeys-sub", {"kinds": [24567], "#d": ["top_pubkeys"]}]
-```
-
-When no subscriptions exist, monitoring is dormant to conserve resources.
-
-### Monitoring Event Types
-
-
-| Type                 | d Tag                  | Description                               |
-| ---------------------- | ------------------------ | ------------------------------------------- |
-| Event Distribution   | `event_kinds`          | Event count by kind with percentages      |
-| Time Statistics      | `time_stats`           | Events in last 24h, 7d, 30d               |
-| Top Publishers       | `top_pubkeys`          | Top 10 pubkeys by event count             |
-| Active Subscriptions | `active_subscriptions` | Current subscription details (admin only) |
-| Subscription Details | `subscription_details` | Detailed subscription info (admin only)   |
-| CPU Metrics          | `cpu_metrics`          | Process CPU and memory usage              |
-
-### Event Structure
-
-```json
-{
-  "kind": 24567,
-  "pubkey": "<relay_pubkey>",
-  "created_at": <timestamp>,
-  "content": "{\"data_type\":\"event_kinds\",\"timestamp\":1234567890,...}",
-  "tags": [
-    ["d", "event_kinds"]
-  ]
-}
-```
-
-### Configuration
-
-- `kind_24567_reporting_throttle_sec`: Minimum seconds between monitoring events (default: 5)
-
-### Web Dashboard Integration
-
-The built-in web dashboard (`/api/`) automatically subscribes to monitoring events and displays real-time statistics.
-
-### Performance Considerations
-
-- Monitoring events are ephemeral (not stored in database)
-- Throttling prevents excessive event generation
-- Automatic activation/deactivation based on subscriptions
-- Minimal overhead when no clients are monitoring
-
-## Direct Messaging Admin System
-
-In addition to the above admin API, c-relay allows the administrator to direct message the relay to get information or control some settings. As long as the administrator is signed in with any nostr client that allows sending nip-17 direct messages (DMs), they can control the relay.
-
-The is possible because the relay is a full nostr citizen with it's own private and public key, and it knows the administrator's public key.
-
-**Available DM commands**
-
-The intent is not to be strict in the formatting of the DM. So for example if the relay receives any DM from the administrator with the words "stats" or "statistics" in it, it will respond to the administrator with a reply DM with the current relay statistics.
-
-- `stats`|`statistics`: Relay statistics
-- `config`|`configuration`: Relay configuration

api/index.js

@@ -93,10 +93,11 @@ function log(message, type = 'INFO') {
 
 
 // NIP-59 helper: randomize created_at to thwart time-analysis (past 2 days)
+// TEMPORARILY DISABLED: Using current timestamp for debugging
 function randomNow() {
-    const TWO_DAYS = 2 * 24 * 60 * 60; // 172800 seconds
+    // const TWO_DAYS = 2 * 24 * 60 * 60; // 172800 seconds
     const now = Math.round(Date.now() / 1000);
-    return Math.round(now - Math.random() * TWO_DAYS);
+    return now; // Math.round(now - Math.random() * TWO_DAYS);
 }
 
 // Safe JSON parse with error handling
@@ -1250,7 +1251,7 @@ async function processAdminResponse(event) {
             throw new Error('Failed to decrypt admin response content');
         }
 
-        console.log('Decrypted admin response:', decryptedContent);
+        // console.log('Decrypted admin response:', decryptedContent);
 
         // Try to parse as JSON first, if it fails treat as plain text
         let responseData;
@@ -4033,9 +4034,9 @@ function updateStatsFromTimeMonitoringEvent(monitoringData) {
 
             // Extract values from periods array
             monitoringData.periods.forEach(period => {
-                if (period.period === '24h') timeStats.last_24h = period.count;
-                else if (period.period === '7d') timeStats.last_7d = period.count;
-                else if (period.period === '30d') timeStats.last_30d = period.count;
+                if (period.period === 'last_24h') timeStats.last_24h = period.count;
+                else if (period.period === 'last_7d') timeStats.last_7d = period.count;
+                else if (period.period === 'last_30d') timeStats.last_30d = period.count;
             });
 
             populateStatsTime({ time_stats: timeStats });
@@ -4069,7 +4070,7 @@ function updateStatsFromTopPubkeysMonitoringEvent(monitoringData) {
 function updateStatsFromSubscriptionDetailsMonitoringEvent(monitoringData) {
     try {
         // DEBUG: Log every subscription_details event that arrives at the webpage
-        console.log('subscription_details', JSON.stringify(monitoringData, null, 2));
+        // console.log('subscription_details', JSON.stringify(monitoringData, null, 2));
         console.log('subscription_details decoded:', monitoringData);
 
         if (monitoringData.data_type !== 'subscription_details') {
@@ -4779,7 +4780,7 @@ const SQL_QUERY_TEMPLATES = {
   subscriptions: "SELECT * FROM active_subscriptions_log ORDER BY created_at DESC",
   top_pubkeys: "SELECT * FROM top_pubkeys_view",
   event_kinds: "SELECT * FROM event_kinds_view ORDER BY count DESC",
-  time_stats: "SELECT * FROM time_stats_view"
+  time_stats: "SELECT 'total' as period, COUNT(*) as total_events, COUNT(DISTINCT pubkey) as unique_pubkeys, MIN(created_at) as oldest_event, MAX(created_at) as newest_event FROM events UNION ALL SELECT '24h' as period, COUNT(*) as total_events, COUNT(DISTINCT pubkey) as unique_pubkeys, MIN(created_at) as oldest_event, MAX(created_at) as newest_event FROM events WHERE created_at >= (strftime('%s', 'now') - 86400) UNION ALL SELECT '7d' as period, COUNT(*) as total_events, COUNT(DISTINCT pubkey) as unique_pubkeys, MIN(created_at) as oldest_event, MAX(created_at) as newest_event FROM events WHERE created_at >= (strftime('%s', 'now') - 604800) UNION ALL SELECT '30d' as period, COUNT(*) as total_events, COUNT(DISTINCT pubkey) as unique_pubkeys, MIN(created_at) as oldest_event, MAX(created_at) as newest_event FROM events WHERE created_at >= (strftime('%s', 'now') - 2592000)"
 };
 
 // Query history management (localStorage)

relay.pid

@@ -1 +1 @@
-2595240
+2726527

src/api.c

@@ -271,6 +271,7 @@ cJSON* query_subscription_details(void) {
         long long events_sent = sqlite3_column_int64(stmt, 3);
         long long created_at = sqlite3_column_int64(stmt, 4);
         long long duration_seconds = sqlite3_column_int64(stmt, 5);
+        const char* wsi_pointer = (const char*)sqlite3_column_text(stmt, 6);
 
         // DEBUG: Log each subscription found
         DEBUG_LOG("Row %d: sub_id=%s, client_ip=%s, events_sent=%lld, created_at=%lld",
@@ -284,6 +285,7 @@ cJSON* query_subscription_details(void) {
         cJSON_AddNumberToObject(sub_obj, "duration_seconds", (double)duration_seconds);
         cJSON_AddNumberToObject(sub_obj, "events_sent", events_sent);
         cJSON_AddBoolToObject(sub_obj, "active", 1);  // All from this view are active
+        cJSON_AddStringToObject(sub_obj, "wsi_pointer", wsi_pointer ? wsi_pointer : "N/A");
 
         // Parse and add filter JSON if available
         if (filter_json) {
@@ -499,6 +501,76 @@ void monitoring_on_subscription_change(void) {
     generate_subscription_driven_monitoring();
 }
 
+/**
+ * Generate and post a kind 1 status event with relay statistics
+ * Called periodically from main event loop based on configuration
+ * Returns: 0 on success, -1 on error
+ */
+int generate_and_post_status_event(void) {
+    // Check if feature is enabled
+    int hours_interval = get_config_int("kind_1_status_posts_hours", 0);
+    if (hours_interval <= 0) {
+        return 0; // Feature disabled
+    }
+
+    // Generate statistics text content using existing function
+    char* stats_text = generate_stats_text();
+    if (!stats_text) {
+        DEBUG_ERROR("Failed to generate statistics text for status post");
+        return -1;
+    }
+
+    // Get relay private key
+    char* relay_privkey_hex = get_relay_private_key();
+    if (!relay_privkey_hex) {
+        DEBUG_ERROR("Failed to get relay private key for status post");
+        free(stats_text);
+        return -1;
+    }
+
+    // Convert hex private key to bytes
+    unsigned char relay_privkey_bytes[32];
+    if (nostr_hex_to_bytes(relay_privkey_hex, relay_privkey_bytes, 32) != 0) {
+        DEBUG_ERROR("Failed to convert relay private key to bytes");
+        free(stats_text);
+        return -1;
+    }
+
+    // Create empty tags array (kind 1 doesn't require special tags)
+    cJSON* tags = cJSON_CreateArray();
+
+    // Create and sign the kind 1 event
+    cJSON* signed_event = nostr_create_and_sign_event(
+        1,                      // kind 1 = text note
+        stats_text,             // content = statistics
+        tags,                   // empty tags
+        relay_privkey_bytes,    // relay's private key
+        time(NULL)              // current timestamp
+    );
+
+    free(stats_text);
+
+    if (!signed_event) {
+        DEBUG_ERROR("Failed to create and sign status event");
+        return -1;
+    }
+
+    // Store event in database (kind 1 events MUST be stored)
+    if (store_event(signed_event) != 0) {
+        DEBUG_ERROR("Failed to store status event in database");
+        cJSON_Delete(signed_event);
+        return -1;
+    }
+
+    // Broadcast event to subscriptions
+    broadcast_event_to_subscriptions(signed_event);
+
+    DEBUG_LOG("Successfully posted kind 1 status event");
+    cJSON_Delete(signed_event);
+
+    return 0;
+}
+
 // Forward declaration for known_configs (defined in config.c)
 typedef struct {
     const char* key;
@@ -565,6 +637,9 @@ static const config_definition_t known_configs[] = {
     {"relay_privkey", "string", 0, 65},
     {"admin_pubkey", "string", 0, 65},
 
+    // Kind 1 Status Posts
+    {"kind_1_status_posts_hours", "int", 0, 8760},
+
     // Sentinel
     {NULL, NULL, 0, 0}
 };
@@ -1423,8 +1498,7 @@ char* generate_config_text(void) {
     }
 
     // Footer
-    offset += snprintf(config_text + offset, 8192 - offset,
-        "\n✅ Configuration retrieved successfully");
+    offset += snprintf(config_text + offset, 8192 - offset, "\n");
 
     return config_text;
 }
@@ -1454,7 +1528,7 @@ char* generate_stats_text(void) {
         cJSON* newest_event = cJSON_GetObjectItem(stats_obj, "latest_event_at");
         cJSON* time_stats = cJSON_GetObjectItem(stats_obj, "time_stats");
         cJSON* event_kinds = cJSON_GetObjectItem(stats_obj, "event_kinds");
-        cJSON* top_pubkeys = cJSON_GetObjectItem(stats_obj, "top_pubkeys");
+        // cJSON* top_pubkeys = cJSON_GetObjectItem(stats_obj, "top_pubkeys");
 
         long long total = total_events ? (long long)cJSON_GetNumberValue(total_events) : 0;
         long long db_bytes = db_size ? (long long)cJSON_GetNumberValue(db_size) : 0;
@@ -1495,25 +1569,23 @@ char* generate_stats_text(void) {
 
         // Header
         offset += snprintf(stats_text + offset, 16384 - offset,
-            "📊 Relay Statistics\n"
+            "\nRelay Statistics\n"
             "━━━━━━━━━━━━━━━━━━━━\n");
 
         // Database Overview section
         offset += snprintf(stats_text + offset, 16384 - offset,
-            "Database Overview:\n"
-            "Metric\tValue\tDescription\n"
-            "Database Size\t%.2f MB (%lld bytes)\tCurrent database file size\n"
-            "Total Events\t%lld\tTotal number of events stored\n"
-            "Active Subscriptions\t%d\tCurrent active WebSocket subscriptions\n"
-            "Oldest Event\t%s\tTimestamp of oldest event\n"
-            "Newest Event\t%s\tTimestamp of newest event\n"
+
+     "Database Size  %.2f MB\n"
+             "Total Events  %lld\n"
+             "Active Subscriptions  %d\n"
+             "Oldest Event  %s\n"
+             "Newest Event  %s\n"
             "\n",
             db_mb, db_bytes, total, active_subs, oldest_str, newest_str);
 
         // Event Kind Distribution section
         offset += snprintf(stats_text + offset, 16384 - offset,
-            "Event Kind Distribution:\n"
-            "Event Kind\tCount\tPercentage\n");
+            "Event Kind Distribution:\n");
 
         if (event_kinds && cJSON_IsArray(event_kinds)) {
             cJSON* kind_item = NULL;
@@ -1540,49 +1612,48 @@ char* generate_stats_text(void) {
         // Time-based Statistics section
         offset += snprintf(stats_text + offset, 16384 - offset,
             "Time-based Statistics:\n"
-            "Period\tEvents\tDescription\n"
-            "Last 24 Hours\t%lld\tEvents in the last day\n"
-            "Last 7 Days\t%lld\tEvents in the last week\n"
-            "Last 30 Days\t%lld\tEvents in the last month\n"
+
+            "%lld\tEvents in the last day\n"
+            "%lld\tEvents in the last week\n"
+            "%lld\tEvents in the last month\n"
             "\n",
             last_24h, last_7d, last_30d);
 
         // Top Pubkeys section
-        offset += snprintf(stats_text + offset, 16384 - offset,
-            "Top Pubkeys by Event Count:\n"
-            "Rank\tPubkey\tEvent Count\tPercentage\n");
+        // offset += snprintf(stats_text + offset, 16384 - offset,
+        //     "Top Pubkeys by Event Count:\n"
+        //     "Rank\tPubkey\tEvent Count\tPercentage\n");
 
-        if (top_pubkeys && cJSON_IsArray(top_pubkeys)) {
-            int rank = 1;
-            cJSON* pubkey_item = NULL;
-            cJSON_ArrayForEach(pubkey_item, top_pubkeys) {
-                cJSON* pubkey = cJSON_GetObjectItem(pubkey_item, "pubkey");
-                cJSON* event_count = cJSON_GetObjectItem(pubkey_item, "event_count");
-                cJSON* percentage = cJSON_GetObjectItem(pubkey_item, "percentage");
+        // if (top_pubkeys && cJSON_IsArray(top_pubkeys)) {
+        //     int rank = 1;
+        //     cJSON* pubkey_item = NULL;
+        //     cJSON_ArrayForEach(pubkey_item, top_pubkeys) {
+        //         cJSON* pubkey = cJSON_GetObjectItem(pubkey_item, "pubkey");
+        //         cJSON* event_count = cJSON_GetObjectItem(pubkey_item, "event_count");
+        //         cJSON* percentage = cJSON_GetObjectItem(pubkey_item, "percentage");
 
-                if (pubkey && event_count && percentage) {
-                    const char* pubkey_str = cJSON_GetStringValue(pubkey);
-                    char short_pubkey[20] = "...";
-                    if (pubkey_str && strlen(pubkey_str) >= 16) {
-                        snprintf(short_pubkey, sizeof(short_pubkey), "%.16s...", pubkey_str);
-                    }
+        //         if (pubkey && event_count && percentage) {
+        //             const char* pubkey_str = cJSON_GetStringValue(pubkey);
+        //             char short_pubkey[20] = "...";
+        //             if (pubkey_str && strlen(pubkey_str) >= 16) {
+        //                 snprintf(short_pubkey, sizeof(short_pubkey), "%.16s...", pubkey_str);
+        //             }
 
-                    offset += snprintf(stats_text + offset, 16384 - offset,
-                        "%d\t%s\t%lld\t%.1f%%\n",
-                        rank++,
-                        short_pubkey,
-                        (long long)cJSON_GetNumberValue(event_count),
-                        cJSON_GetNumberValue(percentage));
-                }
-            }
-        } else {
-            offset += snprintf(stats_text + offset, 16384 - offset,
-                "No pubkey data available\n");
-        }
+        //             offset += snprintf(stats_text + offset, 16384 - offset,
+        //                 "%d\t%s\t%lld\t%.1f%%\n",
+        //                 rank++,
+        //                 short_pubkey,
+        //                 (long long)cJSON_GetNumberValue(event_count),
+        //                 cJSON_GetNumberValue(percentage));
+        //         }
+        //     }
+        // } else {
+        //     offset += snprintf(stats_text + offset, 16384 - offset,
+        //         "No pubkey data available\n");
+        // }
 
         // Footer
-        offset += snprintf(stats_text + offset, 16384 - offset,
-            "\n✅ Statistics retrieved successfully");
+        offset += snprintf(stats_text + offset, 16384 - offset, "\n");
 
         cJSON_Delete(stats_obj);
     } else {

src/api.h

@@ -64,4 +64,7 @@ void monitoring_on_event_stored(void);
 void monitoring_on_subscription_change(void);
 int get_monitoring_throttle_seconds(void);
 
+// Kind 1 status posts
+int generate_and_post_status_event(void);
+
 #endif // API_H

src/default_config_event.h

@@ -81,7 +81,10 @@ static const struct {
     {"trust_proxy_headers", "true"},
 
     // NIP-59 Gift Wrap Timestamp Configuration
-    {"nip59_timestamp_max_delay_sec", "0"}
+    {"nip59_timestamp_max_delay_sec", "0"},
+
+    // Kind 1 Status Posts
+    {"kind_1_status_posts_hours", "1"}
 };
 
 // Number of default configuration values

src/main.h

@@ -12,7 +12,8 @@
 // Version information (auto-updated by build system)
 #define VERSION_MAJOR 0
 #define VERSION_MINOR 8
-#define VERSION_PATCH 0
+#define VERSION_PATCH 2
+#define VERSION "v0.8.2"
 
 // Relay metadata (authoritative source for NIP-11 information)
 #define RELAY_NAME "C-Relay"

src/sql_schema.h

@@ -1,5 +1,4 @@
 /* Embedded SQL Schema for C Nostr Relay
- * Generated from db/schema.sql - Do not edit manually
  * Schema Version: 8
  */
 #ifndef SQL_SCHEMA_H
@@ -242,7 +241,8 @@ SELECT\n\
     s.filter_json,\n\
     s.events_sent,\n\
     s.created_at,\n\
-    (strftime('%s', 'now') - s.created_at) as duration_seconds\n\
+    (strftime('%s', 'now') - s.created_at) as duration_seconds,\n\
+    s.wsi_pointer\n\
 FROM subscriptions s\n\
 WHERE s.event_type = 'created'\n\
 AND NOT EXISTS (\n\

src/websockets.c

@@ -44,6 +44,9 @@ void send_nip42_auth_challenge(struct lws* wsi, struct per_session_data* pss);
 void handle_nip42_auth_signed_event(struct lws* wsi, struct per_session_data* pss, cJSON* auth_event);
 void handle_nip42_auth_challenge_response(struct lws* wsi, struct per_session_data* pss, const char* challenge);
 
+// Forward declaration for status posts
+int generate_and_post_status_event(void);
+
 // Forward declarations for NIP-11 relay information handling
 int handle_nip11_http_request(struct lws* wsi, const char* accept_header);
 
@@ -282,7 +285,19 @@ static int nostr_relay_callback(struct lws *wsi, enum lws_callback_reasons reaso
 
                 // Check if this is a GET request to the root path
                 if (strcmp(requested_uri, "/") == 0) {
-                    // Get Accept header
+                    // Check if this is a WebSocket upgrade request
+                    char upgrade_header[64] = {0};
+                    int upgrade_len = lws_hdr_copy(wsi, upgrade_header, sizeof(upgrade_header) - 1, WSI_TOKEN_UPGRADE);
+
+                    if (upgrade_len > 0) {
+                        upgrade_header[upgrade_len] = '\0';
+                        if (strstr(upgrade_header, "websocket") != NULL) {
+                            DEBUG_LOG("WebSocket upgrade request - allowing connection");
+                            return 0;
+                        }
+                    }
+
+                    // Not a WebSocket upgrade, check for NIP-11 request
                     char accept_header[256] = {0};
                     int header_len = lws_hdr_copy(wsi, accept_header, sizeof(accept_header) - 1, WSI_TOKEN_HTTP_ACCEPT);
 
@@ -300,7 +315,8 @@ static int nostr_relay_callback(struct lws *wsi, enum lws_callback_reasons reaso
                         }
                     }
 
-                    // Root path without NIP-11 Accept header - return 404
+                    // Root path without NIP-11 Accept header and not WebSocket - return 404
+                    DEBUG_WARN("Rejecting root path request - not WebSocket upgrade and not NIP-11");
                     lws_return_http_status(wsi, HTTP_STATUS_NOT_FOUND, NULL);
                     return -1;
                 }
@@ -1404,6 +1420,9 @@ int start_websocket_relay(int port_override, int strict_port) {
         snprintf(startup_msg, sizeof(startup_msg), "WebSocket relay started on ws://127.0.0.1:%d", actual_port);
     }
 
+    // Static variable for status post timing (initialize to 0 for immediate first post)
+    static time_t last_status_post_time = 0;
+
     // Main event loop with proper signal handling
     while (g_server_running && !g_shutdown_flag) {
         int result = lws_service(ws_context, 1000);
@@ -1412,6 +1431,19 @@ int start_websocket_relay(int port_override, int strict_port) {
             DEBUG_ERROR("libwebsockets service error");
             break;
         }
+
+        // Check if it's time to post status update
+        time_t current_time = time(NULL);
+        int status_post_hours = get_config_int("kind_1_status_posts_hours", 0);
+
+        if (status_post_hours > 0) {
+            int seconds_interval = status_post_hours * 3600; // Convert hours to seconds
+
+            if (current_time - last_status_post_time >= seconds_interval) {
+                last_status_post_time = current_time;
+                generate_and_post_status_event();
+            }
+        }
     }
 
     lws_context_destroy(ws_context);