nip 17, and 59

.gitignore

@@ -8,7 +8,7 @@ node_modules/
 nostr-tools/
 tiny-AES-c/
 blossom/
-
+ndk/
 
 Trash/debug_tests/
 node_modules/

AUTOMATIC_VERSIONING.md

@@ -1,223 +0,0 @@
-# NOSTR Core Library - Automatic Versioning System
-
-## Overview
-
-The NOSTR Core Library now features an automatic version increment system that automatically increments the patch version (e.g., v0.2.0 → v0.2.1) with each build. This ensures consistent versioning and traceability across builds.
-
-## How It Works
-
-### Version Format
-The library uses semantic versioning with the format: `vMAJOR.MINOR.PATCH`
-
-- **MAJOR**: Incremented for breaking changes (manual)
-- **MINOR**: Incremented for new features (manual)  
-- **PATCH**: Incremented automatically with each build
-
-### Automatic Increment Process
-
-1. **Version Detection**: The build system scans all git tags matching `v*.*.*` pattern
-2. **Highest Version**: Uses `sort -V` to find the numerically highest version (not chronologically latest)
-3. **Patch Increment**: Increments the patch number by 1
-4. **Git Tag Creation**: Creates a new git tag for the incremented version
-5. **File Generation**: Generates `nostr_core/version.h` and `nostr_core/version.c` with build metadata
-
-### Generated Files
-
-The system automatically generates two files during each build:
-
-#### `nostr_core/version.h`
-```c
-#define VERSION_MAJOR 0
-#define VERSION_MINOR 2  
-#define VERSION_PATCH 1
-#define VERSION_STRING "0.2.1"
-#define VERSION_TAG "v0.2.1"
-
-#define BUILD_DATE "2025-08-09"
-#define BUILD_TIME "10:42:45"
-#define BUILD_TIMESTAMP "2025-08-09 10:42:45"
-
-#define GIT_HASH "ca6b475"
-#define GIT_BRANCH "master"
-
-// API functions
-const char* nostr_core_get_version(void);
-const char* nostr_core_get_version_full(void);
-const char* nostr_core_get_build_info(void);
-```
-
-#### `nostr_core/version.c`
-Contains the implementation of the version API functions.
-
-## Usage
-
-### Building with Auto-Versioning
-
-All major build targets automatically increment the version:
-
-```bash
-# Build static library (increments version)
-./build.sh lib
-
-# Build shared library (increments version)
-./build.sh shared
-
-# Build all libraries (increments version)
-./build.sh all
-
-# Build examples (increments version)
-./build.sh examples
-
-# Install to system (increments version)
-./build.sh install
-```
-
-### Non-Versioned Builds
-
-Some targets do not increment versions:
-
-```bash
-# Clean build artifacts (no version increment)
-./build.sh clean
-
-# Run tests (no version increment)
-./build.sh test
-```
-
-### Using Version Information in Code
-
-```c
-#include "version.h"
-
-// Get version string
-printf("Version: %s\n", nostr_core_get_version());
-
-// Get full version with timestamp and commit
-printf("Full: %s\n", nostr_core_get_version_full());
-
-// Get detailed build information  
-printf("Build: %s\n", nostr_core_get_build_info());
-
-// Use version macros
-#if VERSION_MAJOR >= 1
-    // Use new API
-#else
-    // Use legacy API
-#endif
-```
-
-### Testing Version System
-
-A version test example is provided:
-
-```bash
-# Build and run version test
-gcc -I. -Inostr_core examples/version_test.c -o examples/version_test ./libnostr_core.a ./secp256k1/.libs/libsecp256k1.a -lm
-./examples/version_test
-```
-
-## Version History Tracking
-
-### View All Versions
-```bash
-# List all version tags
-git tag --list
-
-# View version history
-git log --oneline --decorate --graph
-```
-
-### Current Version
-```bash
-# Check current version
-cat VERSION
-
-# Or check the latest git tag
-git describe --tags --abbrev=0
-```
-
-## Manual Version Management
-
-### Major/Minor Version Bumps
-
-For major or minor version changes, manually create the appropriate tag:
-
-```bash
-# For a minor version bump (new features)
-git tag v0.3.0
-
-# For a major version bump (breaking changes)  
-git tag v1.0.0
-```
-
-The next build will automatically increment from the new base version.
-
-### Resetting Version
-
-To reset or fix version numbering:
-
-```bash
-# Delete incorrect tags (if needed)
-git tag -d v0.2.1
-git push origin --delete v0.2.1
-
-# Create correct base version
-git tag v0.2.0
-
-# Next build will create v0.2.1
-```
-
-## Integration Notes
-
-### Makefile Integration
-- The `version.c` file is automatically included in `LIB_SOURCES`
-- Version files are compiled and linked with the library
-- Clean targets remove generated version object files
-
-### Git Integration
-- Version files (`version.h`, `version.c`) are excluded from git via `.gitignore`
-- Only version tags and the `VERSION` file are tracked
-- Build system works in any git repository with version tags
-
-### Build System Integration
-- Version increment is integrated directly into `build.sh`
-- No separate scripts or external dependencies required
-- Self-contained and portable across systems
-
-## Example Output
-
-When building, you'll see output like:
-
-```
-[INFO] Incrementing version...
-[INFO] Current version: v0.2.0
-[INFO] New version: v0.2.1
-[SUCCESS] Created new version tag: v0.2.1
-[SUCCESS] Generated version.h and version.c
-[SUCCESS] Updated VERSION file to 0.2.1
-```
-
-## Troubleshooting
-
-### Version Not Incrementing
-- Ensure you're in a git repository
-- Check that git tags exist with `git tag --list`
-- Verify tag format matches `v*.*.*` pattern
-
-### Tag Already Exists
-If a tag already exists, the build will continue with the existing version:
-
-```
-[WARNING] Tag v0.2.1 already exists - using existing version
-```
-
-### Missing Git Information
-If git is not available, version files will show "unknown" for git hash and branch.
-
-## Benefits
-
-1. **Automatic Traceability**: Every build has a unique version
-2. **Build Metadata**: Includes timestamp, git commit, and branch information  
-3. **API Integration**: Version information accessible via C API
-4. **Zero Maintenance**: No manual version file editing required
-5. **Git Integration**: Automatic git tag creation for version history

POOL_API.md

@@ -0,0 +1,755 @@
+# Relay Pool API Reference
+
+This document describes the public API for the Nostr Relay Pool implementation in [`core_relay_pool.c`](nostr_core/core_relay_pool.c).
+
+## Function Summary
+
+| Function | Description |
+|----------|-------------|
+| [`nostr_relay_pool_create()`](nostr_core/core_relay_pool.c:219) | Create and initialize a new relay pool |
+| [`nostr_relay_pool_destroy()`](nostr_core/core_relay_pool.c:304) | Destroy pool and cleanup all resources |
+| [`nostr_relay_pool_add_relay()`](nostr_core/core_relay_pool.c:229) | Add a relay URL to the pool |
+| [`nostr_relay_pool_remove_relay()`](nostr_core/core_relay_pool.c:273) | Remove a relay URL from the pool |
+| [`nostr_relay_pool_subscribe()`](nostr_core/core_relay_pool.c:399) | Create async subscription with callbacks |
+| [`nostr_pool_subscription_close()`](nostr_core/core_relay_pool.c:491) | Close subscription and free resources |
+| [`nostr_relay_pool_run()`](nostr_core/core_relay_pool.c:1192) | Run event loop for specified timeout |
+| [`nostr_relay_pool_poll()`](nostr_core/core_relay_pool.c:1232) | Single iteration poll and dispatch |
+| [`nostr_relay_pool_query_sync()`](nostr_core/core_relay_pool.c:695) | Synchronous query returning event array |
+| [`nostr_relay_pool_get_event()`](nostr_core/core_relay_pool.c:825) | Get single most recent event |
+| [`nostr_relay_pool_publish()`](nostr_core/core_relay_pool.c:866) | Publish event and wait for OK responses |
+| [`nostr_relay_pool_get_relay_status()`](nostr_core/core_relay_pool.c:944) | Get connection status for a relay |
+| [`nostr_relay_pool_list_relays()`](nostr_core/core_relay_pool.c:960) | List all relays and their statuses |
+| [`nostr_relay_pool_get_relay_stats()`](nostr_core/core_relay_pool.c:992) | Get detailed statistics for a relay |
+| [`nostr_relay_pool_reset_relay_stats()`](nostr_core/core_relay_pool.c:1008) | Reset statistics for a relay |
+| [`nostr_relay_pool_get_relay_query_latency()`](nostr_core/core_relay_pool.c:1045) | Get average query latency for a relay |
+
+## Pool Lifecycle
+
+### Create Pool
+**Function:** [`nostr_relay_pool_create()`](nostr_core/core_relay_pool.c:219)
+```c
+nostr_relay_pool_t* nostr_relay_pool_create(void);
+```
+
+**Example:**
+```c
+#include "nostr_core.h"
+
+int main() {
+    // Create a new relay pool
+    nostr_relay_pool_t* pool = nostr_relay_pool_create();
+    if (!pool) {
+        fprintf(stderr, "Failed to create relay pool\n");
+        return -1;
+    }
+    
+    // Use the pool...
+    
+    // Clean up
+    nostr_relay_pool_destroy(pool);
+    return 0;
+}
+```
+
+### Destroy Pool
+**Function:** [`nostr_relay_pool_destroy()`](nostr_core/core_relay_pool.c:304)
+```c
+void nostr_relay_pool_destroy(nostr_relay_pool_t* pool);
+```
+
+**Example:**
+```c
+// Properly cleanup a relay pool
+void cleanup_pool(nostr_relay_pool_t* pool) {
+    if (pool) {
+        // This will close all active subscriptions and relay connections
+        nostr_relay_pool_destroy(pool);
+        pool = NULL;
+    }
+}
+```
+
+## Relay Management
+
+### Add Relay
+**Function:** [`nostr_relay_pool_add_relay()`](nostr_core/core_relay_pool.c:229)
+```c
+int nostr_relay_pool_add_relay(nostr_relay_pool_t* pool, const char* relay_url);
+```
+
+**Example:**
+```c
+int setup_relays(nostr_relay_pool_t* pool) {
+    const char* relays[] = {
+        "wss://relay.damus.io",
+        "wss://nos.lol",
+        "wss://relay.nostr.band"
+    };
+    
+    for (int i = 0; i < 3; i++) {
+        int result = nostr_relay_pool_add_relay(pool, relays[i]);
+        if (result != NOSTR_SUCCESS) {
+            fprintf(stderr, "Failed to add relay %s: %d\n", relays[i], result);
+            return -1;
+        }
+        printf("Added relay: %s\n", relays[i]);
+    }
+    
+    return 0;
+}
+```
+
+### Remove Relay
+**Function:** [`nostr_relay_pool_remove_relay()`](nostr_core/core_relay_pool.c:273)
+```c
+int nostr_relay_pool_remove_relay(nostr_relay_pool_t* pool, const char* relay_url);
+```
+
+**Example:**
+```c
+int remove_slow_relay(nostr_relay_pool_t* pool) {
+    const char* slow_relay = "wss://slow-relay.example.com";
+    
+    int result = nostr_relay_pool_remove_relay(pool, slow_relay);
+    if (result == NOSTR_SUCCESS) {
+        printf("Successfully removed relay: %s\n", slow_relay);
+    } else {
+        printf("Failed to remove relay %s (may not exist)\n", slow_relay);
+    }
+    
+    return result;
+}
+```
+
+## Subscriptions (Asynchronous)
+
+### Subscribe to Events
+**Function:** [`nostr_relay_pool_subscribe()`](nostr_core/core_relay_pool.c:399)
+```c
+nostr_pool_subscription_t* nostr_relay_pool_subscribe(
+    nostr_relay_pool_t* pool,
+    const char** relay_urls, 
+    int relay_count,
+    cJSON* filter,
+    void (*on_event)(cJSON* event, const char* relay_url, void* user_data),
+    void (*on_eose)(void* user_data),
+    void* user_data);
+```
+
+**Example:**
+```c
+#include "cjson/cJSON.h"
+
+// Event callback - called for each received event
+void handle_event(cJSON* event, const char* relay_url, void* user_data) {
+    cJSON* content = cJSON_GetObjectItem(event, "content");
+    cJSON* pubkey = cJSON_GetObjectItem(event, "pubkey");
+    
+    if (content && pubkey) {
+        printf("Event from %s: %s (by %s)\n", 
+               relay_url, 
+               cJSON_GetStringValue(content),
+               cJSON_GetStringValue(pubkey));
+    }
+}
+
+// EOSE callback - called when all relays finish sending stored events
+void handle_eose(void* user_data) {
+    printf("All relays finished sending stored events\n");
+}
+
+int subscribe_to_notes(nostr_relay_pool_t* pool) {
+    // Create filter for kind 1 (text notes) from last hour
+    cJSON* filter = cJSON_CreateObject();
+    cJSON* kinds = cJSON_CreateArray();
+    cJSON_AddItemToArray(kinds, cJSON_CreateNumber(1));
+    cJSON_AddItemToObject(filter, "kinds", kinds);
+    
+    time_t since = time(NULL) - 3600; // Last hour
+    cJSON_AddItemToObject(filter, "since", cJSON_CreateNumber(since));
+    cJSON_AddItemToObject(filter, "limit", cJSON_CreateNumber(50));
+    
+    // Subscribe to specific relays
+    const char* relay_urls[] = {
+        "wss://relay.damus.io",
+        "wss://nos.lol"
+    };
+    
+    nostr_pool_subscription_t* sub = nostr_relay_pool_subscribe(
+        pool,
+        relay_urls,
+        2,
+        filter,
+        handle_event,
+        handle_eose,
+        NULL  // user_data
+    );
+    
+    cJSON_Delete(filter); // Pool makes its own copy
+    
+    if (!sub) {
+        fprintf(stderr, "Failed to create subscription\n");
+        return -1;
+    }
+    
+    // Drive the event loop to receive events
+    printf("Listening for events for 30 seconds...\n");
+    nostr_relay_pool_run(pool, 30000); // 30 seconds
+    
+    // Close subscription
+    nostr_pool_subscription_close(sub);
+    return 0;
+}
+```
+
+### Close Subscription
+**Function:** [`nostr_pool_subscription_close()`](nostr_core/core_relay_pool.c:491)
+```c
+int nostr_pool_subscription_close(nostr_pool_subscription_t* subscription);
+```
+
+**Example:**
+```c
+// Subscription management with cleanup
+typedef struct {
+    nostr_pool_subscription_t* subscription;
+    int event_count;
+    int should_stop;
+} subscription_context_t;
+
+void event_counter(cJSON* event, const char* relay_url, void* user_data) {
+    subscription_context_t* ctx = (subscription_context_t*)user_data;
+    ctx->event_count++;
+    
+    printf("Received event #%d from %s\n", ctx->event_count, relay_url);
+    
+    // Stop after 10 events
+    if (ctx->event_count >= 10) {
+        ctx->should_stop = 1;
+    }
+}
+
+int limited_subscription(nostr_relay_pool_t* pool) {
+    subscription_context_t ctx = {0};
+    
+    // Create filter
+    cJSON* filter = cJSON_CreateObject();
+    cJSON* kinds = cJSON_CreateArray();
+    cJSON_AddItemToArray(kinds, cJSON_CreateNumber(1));
+    cJSON_AddItemToObject(filter, "kinds", kinds);
+    
+    const char* relay_urls[] = {"wss://relay.damus.io"};
+    
+    ctx.subscription = nostr_relay_pool_subscribe(
+        pool, relay_urls, 1, filter, event_counter, NULL, &ctx);
+    
+    cJSON_Delete(filter);
+    
+    if (!ctx.subscription) {
+        return -1;
+    }
+    
+    // Poll until we should stop
+    while (!ctx.should_stop) {
+        int events = nostr_relay_pool_poll(pool, 100);
+        if (events < 0) break;
+    }
+    
+    // Clean up
+    int result = nostr_pool_subscription_close(ctx.subscription);
+    printf("Subscription closed with result: %d\n", result);
+    
+    return 0;
+}
+```
+
+## Event Loop
+
+### Run Timed Loop
+**Function:** [`nostr_relay_pool_run()`](nostr_core/core_relay_pool.c:1192)
+```c
+int nostr_relay_pool_run(nostr_relay_pool_t* pool, int timeout_ms);
+```
+
+**Example:**
+```c
+int run_event_loop(nostr_relay_pool_t* pool) {
+    printf("Starting event loop for 60 seconds...\n");
+    
+    // Run for 60 seconds, processing all incoming events
+    int total_events = nostr_relay_pool_run(pool, 60000);
+    
+    if (total_events < 0) {
+        fprintf(stderr, "Event loop error\n");
+        return -1;
+    }
+    
+    printf("Processed %d events total\n", total_events);
+    return 0;
+}
+```
+
+### Single Poll Iteration
+**Function:** [`nostr_relay_pool_poll()`](nostr_core/core_relay_pool.c:1232)
+```c
+int nostr_relay_pool_poll(nostr_relay_pool_t* pool, int timeout_ms);
+```
+
+**Example:**
+```c
+// Integration with custom main loop
+int custom_main_loop(nostr_relay_pool_t* pool) {
+    int running = 1;
+    int total_events = 0;
+    
+    while (running) {
+        // Poll for Nostr events (non-blocking with 50ms timeout)
+        int events = nostr_relay_pool_poll(pool, 50);
+        if (events > 0) {
+            total_events += events;
+            printf("Processed %d events this iteration\n", events);
+        }
+        
+        // Do other work in your application
+        // handle_ui_events();
+        // process_background_tasks();
+        
+        // Check exit condition
+        // running = !should_exit();
+        
+        // Simple exit after 100 events for demo
+        if (total_events >= 100) {
+            running = 0;
+        }
+    }
+    
+    printf("Main loop finished, processed %d total events\n", total_events);
+    return 0;
+}
+```
+
+## Synchronous Operations
+
+### Query Multiple Events
+**Function:** [`nostr_relay_pool_query_sync()`](nostr_core/core_relay_pool.c:695)
+```c
+cJSON** nostr_relay_pool_query_sync(
+    nostr_relay_pool_t* pool,
+    const char** relay_urls,
+    int relay_count, 
+    cJSON* filter,
+    int* event_count,
+    int timeout_ms);
+```
+
+**Example:**
+```c
+int query_recent_notes(nostr_relay_pool_t* pool) {
+    // Create filter for recent text notes
+    cJSON* filter = cJSON_CreateObject();
+    cJSON* kinds = cJSON_CreateArray();
+    cJSON_AddItemToArray(kinds, cJSON_CreateNumber(1));
+    cJSON_AddItemToObject(filter, "kinds", kinds);
+    cJSON_AddItemToObject(filter, "limit", cJSON_CreateNumber(20));
+    
+    const char* relay_urls[] = {
+        "wss://relay.damus.io",
+        "wss://nos.lol"
+    };
+    
+    int event_count = 0;
+    cJSON** events = nostr_relay_pool_query_sync(
+        pool, relay_urls, 2, filter, &event_count, 10000); // 10 second timeout
+    
+    cJSON_Delete(filter);
+    
+    if (!events) {
+        printf("No events received or query failed\n");
+        return -1;
+    }
+    
+    printf("Received %d events:\n", event_count);
+    for (int i = 0; i < event_count; i++) {
+        cJSON* content = cJSON_GetObjectItem(events[i], "content");
+        if (content) {
+            printf("  %d: %s\n", i + 1, cJSON_GetStringValue(content));
+        }
+        
+        // Free each event
+        cJSON_Delete(events[i]);
+    }
+    
+    // Free the events array
+    free(events);
+    return event_count;
+}
+```
+
+### Get Single Most Recent Event
+**Function:** [`nostr_relay_pool_get_event()`](nostr_core/core_relay_pool.c:825)
+```c
+cJSON* nostr_relay_pool_get_event(
+    nostr_relay_pool_t* pool,
+    const char** relay_urls,
+    int relay_count,
+    cJSON* filter,
+    int timeout_ms);
+```
+
+**Example:**
+```c
+int get_latest_note_from_pubkey(nostr_relay_pool_t* pool, const char* pubkey_hex) {
+    // Create filter for specific author's notes
+    cJSON* filter = cJSON_CreateObject();
+    cJSON* kinds = cJSON_CreateArray();
+    cJSON_AddItemToArray(kinds, cJSON_CreateNumber(1));
+    cJSON_AddItemToObject(filter, "kinds", kinds);
+    
+    cJSON* authors = cJSON_CreateArray();
+    cJSON_AddItemToArray(authors, cJSON_CreateString(pubkey_hex));
+    cJSON_AddItemToObject(filter, "authors", authors);
+    
+    cJSON_AddItemToObject(filter, "limit", cJSON_CreateNumber(1));
+    
+    const char* relay_urls[] = {"wss://relay.damus.io"};
+    
+    cJSON* event = nostr_relay_pool_get_event(
+        pool, relay_urls, 1, filter, 5000); // 5 second timeout
+    
+    cJSON_Delete(filter);
+    
+    if (!event) {
+        printf("No recent event found for pubkey %s\n", pubkey_hex);
+        return -1;
+    }
+    
+    cJSON* content = cJSON_GetObjectItem(event, "content");
+    cJSON* created_at = cJSON_GetObjectItem(event, "created_at");
+    
+    if (content && created_at) {
+        printf("Latest note: %s (created at %ld)\n", 
+               cJSON_GetStringValue(content),
+               (long)cJSON_GetNumberValue(created_at));
+    }
+    
+    cJSON_Delete(event);
+    return 0;
+}
+```
+
+### Publish Event
+**Function:** [`nostr_relay_pool_publish()`](nostr_core/core_relay_pool.c:866)
+```c
+int nostr_relay_pool_publish(
+    nostr_relay_pool_t* pool,
+    const char** relay_urls,
+    int relay_count,
+    cJSON* event);
+```
+
+**Example:**
+```c
+int publish_text_note(nostr_relay_pool_t* pool, const char* content) {
+    // Create a basic text note event (this is simplified - real implementation
+    // would need proper signing with private key)
+    cJSON* event = cJSON_CreateObject();
+    cJSON_AddItemToObject(event, "kind", cJSON_CreateNumber(1));
+    cJSON_AddItemToObject(event, "content", cJSON_CreateString(content));
+    cJSON_AddItemToObject(event, "created_at", cJSON_CreateNumber(time(NULL)));
+    
+    // In real usage, you'd add pubkey, id, sig fields here
+    cJSON_AddItemToObject(event, "pubkey", cJSON_CreateString("your_pubkey_hex"));
+    cJSON_AddItemToObject(event, "id", cJSON_CreateString("event_id_hash"));
+    cJSON_AddItemToObject(event, "sig", cJSON_CreateString("event_signature"));
+    cJSON_AddItemToObject(event, "tags", cJSON_CreateArray());
+    
+    const char* relay_urls[] = {
+        "wss://relay.damus.io",
+        "wss://nos.lol",
+        "wss://relay.nostr.band"
+    };
+    
+    printf("Publishing note: %s\n", content);
+    
+    int success_count = nostr_relay_pool_publish(
+        pool, relay_urls, 3, event);
+    
+    cJSON_Delete(event);
+    
+    printf("Successfully published to %d out of 3 relays\n", success_count);
+    
+    if (success_count == 0) {
+        fprintf(stderr, "Failed to publish to any relay\n");
+        return -1;
+    }
+    
+    return success_count;
+}
+```
+
+## Status and Statistics
+
+### Get Relay Status
+**Function:** [`nostr_relay_pool_get_relay_status()`](nostr_core/core_relay_pool.c:944)
+```c
+nostr_pool_relay_status_t nostr_relay_pool_get_relay_status(
+    nostr_relay_pool_t* pool, 
+    const char* relay_url);
+```
+
+**Example:**
+```c
+void check_relay_status(nostr_relay_pool_t* pool, const char* relay_url) {
+    nostr_pool_relay_status_t status = nostr_relay_pool_get_relay_status(pool, relay_url);
+    
+    const char* status_str;
+    switch (status) {
+        case NOSTR_POOL_RELAY_DISCONNECTED:
+            status_str = "DISCONNECTED";
+            break;
+        case NOSTR_POOL_RELAY_CONNECTING:
+            status_str = "CONNECTING";
+            break;
+        case NOSTR_POOL_RELAY_CONNECTED:
+            status_str = "CONNECTED";
+            break;
+        case NOSTR_POOL_RELAY_ERROR:
+            status_str = "ERROR";
+            break;
+        default:
+            status_str = "UNKNOWN";
+            break;
+    }
+    
+    printf("Relay %s status: %s\n", relay_url, status_str);
+}
+```
+
+### List All Relays
+**Function:** [`nostr_relay_pool_list_relays()`](nostr_core/core_relay_pool.c:960)
+```c
+int nostr_relay_pool_list_relays(
+    nostr_relay_pool_t* pool,
+    char*** relay_urls,
+    nostr_pool_relay_status_t** statuses);
+```
+
+**Example:**
+```c
+void print_all_relays(nostr_relay_pool_t* pool) {
+    char** relay_urls = NULL;
+    nostr_pool_relay_status_t* statuses = NULL;
+    
+    int count = nostr_relay_pool_list_relays(pool, &relay_urls, &statuses);
+    
+    if (count < 0) {
+        printf("Failed to list relays\n");
+        return;
+    }
+    
+    if (count == 0) {
+        printf("No relays configured\n");
+        return;
+    }
+    
+    printf("Configured relays (%d):\n", count);
+    for (int i = 0; i < count; i++) {
+        const char* status_str = (statuses[i] == NOSTR_POOL_RELAY_CONNECTED) ? 
+                                 "CONNECTED" : "DISCONNECTED";
+        printf("  %s - %s\n", relay_urls[i], status_str);
+        
+        // Free the duplicated URL string
+        free(relay_urls[i]);
+    }
+    
+    // Free the arrays
+    free(relay_urls);
+    free(statuses);
+}
+```
+
+### Get Relay Statistics
+**Function:** [`nostr_relay_pool_get_relay_stats()`](nostr_core/core_relay_pool.c:992)
+```c
+const nostr_relay_stats_t* nostr_relay_pool_get_relay_stats(
+    nostr_relay_pool_t* pool, 
+    const char* relay_url);
+```
+
+**Example:**
+```c
+void print_relay_stats(nostr_relay_pool_t* pool, const char* relay_url) {
+    const nostr_relay_stats_t* stats = nostr_relay_pool_get_relay_stats(pool, relay_url);
+    
+    if (!stats) {
+        printf("No stats available for relay %s\n", relay_url);
+        return;
+    }
+    
+    printf("Statistics for %s:\n", relay_url);
+    printf("  Connection attempts: %d\n", stats->connection_attempts);
+    printf("  Connection failures: %d\n", stats->connection_failures);
+    printf("  Events received: %d\n", stats->events_received);
+    printf("  Events published: %d\n", stats->events_published);
+    printf("  Events published OK: %d\n", stats->events_published_ok);
+    printf("  Events published failed: %d\n", stats->events_published_failed);
+    printf("  Query latency avg: %.2f ms\n", stats->query_latency_avg);
+    printf("  Query samples: %d\n", stats->query_samples);
+    printf("  Publish latency avg: %.2f ms\n", stats->publish_latency_avg);
+    printf("  Publish samples: %d\n", stats->publish_samples);
+    
+    if (stats->last_event_time > 0) {
+        printf("  Last event: %ld seconds ago\n", 
+               time(NULL) - stats->last_event_time);
+    }
+}
+```
+
+### Reset Relay Statistics
+**Function:** [`nostr_relay_pool_reset_relay_stats()`](nostr_core/core_relay_pool.c:1008)
+```c
+int nostr_relay_pool_reset_relay_stats(
+    nostr_relay_pool_t* pool, 
+    const char* relay_url);
+```
+
+**Example:**
+```c
+void reset_stats_for_relay(nostr_relay_pool_t* pool, const char* relay_url) {
+    int result = nostr_relay_pool_reset_relay_stats(pool, relay_url);
+    
+    if (result == NOSTR_SUCCESS) {
+        printf("Successfully reset statistics for %s\n", relay_url);
+    } else {
+        printf("Failed to reset statistics for %s\n", relay_url);
+    }
+}
+```
+
+### Get Query Latency
+**Function:** [`nostr_relay_pool_get_relay_query_latency()`](nostr_core/core_relay_pool.c:1045)
+```c
+double nostr_relay_pool_get_relay_query_latency(
+    nostr_relay_pool_t* pool, 
+    const char* relay_url);
+```
+
+**Example:**
+```c
+void check_relay_performance(nostr_relay_pool_t* pool) {
+    const char* relays[] = {
+        "wss://relay.damus.io",
+        "wss://nos.lol",
+        "wss://relay.nostr.band"
+    };
+    
+    printf("Relay performance comparison:\n");
+    for (int i = 0; i < 3; i++) {
+        double latency = nostr_relay_pool_get_relay_query_latency(pool, relays[i]);
+        
+        if (latency >= 0) {
+            printf("  %s: %.2f ms average query latency\n", relays[i], latency);
+        } else {
+            printf("  %s: No latency data available\n", relays[i]);
+        }
+    }
+}
+```
+
+## Complete Example Application
+
+```c
+#include "nostr_core.h"
+#include "cjson/cJSON.h"
+#include <stdio.h>
+#include <stdlib.h>
+#include <unistd.h>
+
+// Global context for the example
+typedef struct {
+    int event_count;
+    int max_events;
+} app_context_t;
+
+void on_text_note(cJSON* event, const char* relay_url, void* user_data) {
+    app_context_t* ctx = (app_context_t*)user_data;
+    
+    cJSON* content = cJSON_GetObjectItem(event, "content");
+    if (content && cJSON_IsString(content)) {
+        printf("[%s] Note #%d: %s\n", 
+               relay_url, ++ctx->event_count, cJSON_GetStringValue(content));
+    }
+}
+
+void on_subscription_complete(void* user_data) {
+    printf("All relays finished sending stored events\n");
+}
+
+int main() {
+    // Initialize pool
+    nostr_relay_pool_t* pool = nostr_relay_pool_create();
+    if (!pool) {
+        fprintf(stderr, "Failed to create relay pool\n");
+        return 1;
+    }
+    
+    // Add relays
+    const char* relays[] = {
+        "wss://relay.damus.io",
+        "wss://nos.lol"
+    };
+    
+    for (int i = 0; i < 2; i++) {
+        if (nostr_relay_pool_add_relay(pool, relays[i]) != NOSTR_SUCCESS) {
+            fprintf(stderr, "Failed to add relay: %s\n", relays[i]);
+        }
+    }
+    
+    // Create filter for recent text notes
+    cJSON* filter = cJSON_CreateObject();
+    cJSON* kinds = cJSON_CreateArray();
+    cJSON_AddItemToArray(kinds, cJSON_CreateNumber(1));
+    cJSON_AddItemToObject(filter, "kinds", kinds);
+    cJSON_AddItemToObject(filter, "limit", cJSON_CreateNumber(10));
+    
+    // Set up context
+    app_context_t ctx = {0, 10};
+    
+    // Subscribe
+    nostr_pool_subscription_t* sub = nostr_relay_pool_subscribe(
+        pool, relays, 2, filter, on_text_note, on_subscription_complete, &ctx);
+    
+    cJSON_Delete(filter);
+    
+    if (!sub) {
+        fprintf(stderr, "Failed to create subscription\n");
+        nostr_relay_pool_destroy(pool);
+        return 1;
+    }
+    
+    // Run event loop for 30 seconds
+    printf("Listening for events...\n");
+    nostr_relay_pool_run(pool, 30000);
+    
+    // Print final stats
+    for (int i = 0; i < 2; i++) {
+        print_relay_stats(pool, relays[i]);
+    }
+    
+    // Cleanup
+    nostr_pool_subscription_close(sub);
+    nostr_relay_pool_destroy(pool);
+    
+    printf("Application finished. Received %d events total.\n", ctx.event_count);
+    return 0;
+}
+```
+
+## Notes
+
+- All functions are **not thread-safe**. Use from a single thread or add external synchronization.
+- **Memory ownership**: The pool duplicates filters and URLs internally. Caller owns returned events and must free them.
+- **Event deduplication** is applied pool-wide using a circular buffer of 1000 event IDs.
+- **Ping functionality** is currently disabled in this build.
+- **Reconnection** happens on-demand when sending, but active subscriptions are not automatically re-sent after reconnect.
+- **Polling model**: You must drive the event loop via [`nostr_relay_pool_run()`](nostr_core/core_relay_pool.c:1192) or [`nostr_relay_pool_poll()`](nostr_core/core_relay_pool.c:1232) to receive events.

README.md

@@ -302,20 +302,32 @@ publish_result_t* synchronous_publish_event_with_progress(const char** relay_url
 
 ### Relay Pools (Asynchronous)
 ```c
-// Create and manage relay pool
-nostr_relay_pool_t* nostr_relay_pool_create(void);
+// Create and manage relay pool with reconnection
+nostr_pool_reconnect_config_t* config = nostr_pool_reconnect_config_default();
+nostr_relay_pool_t* nostr_relay_pool_create(nostr_pool_reconnect_config_t* config);
 int nostr_relay_pool_add_relay(nostr_relay_pool_t* pool, const char* relay_url);
 void nostr_relay_pool_destroy(nostr_relay_pool_t* pool);
 
-// Subscribe to events
+// Subscribe to events (with auto-reconnection)
 nostr_pool_subscription_t* nostr_relay_pool_subscribe(
     nostr_relay_pool_t* pool, const char** relay_urls, int relay_count, cJSON* filter,
     void (*on_event)(cJSON* event, const char* relay_url, void* user_data),
-    void (*on_eose)(void* user_data), void* user_data);
+    void (*on_eose)(void* user_data), void* user_data, int close_on_eose);
 
-// Run event loop
+// Run event loop (handles reconnection automatically)
 int nostr_relay_pool_run(nostr_relay_pool_t* pool, int timeout_ms);
 int nostr_relay_pool_poll(nostr_relay_pool_t* pool, int timeout_ms);
+
+// Reconnection configuration
+typedef struct {
+    int enable_auto_reconnect;        // Enable automatic reconnection
+    int max_reconnect_attempts;       // Maximum retry attempts
+    int initial_reconnect_delay_ms;   // Initial delay between attempts
+    int max_reconnect_delay_ms;       // Maximum delay cap
+    int reconnect_backoff_multiplier; // Exponential backoff factor
+    int ping_interval_seconds;        // Health check ping interval
+    int pong_timeout_seconds;         // Pong response timeout
+} nostr_pool_reconnect_config_t;
 ```
 
 ### NIP-05 Identifier Verification
@@ -370,6 +382,9 @@ The library includes extensive tests:
 
 # Individual test categories
 cd tests && make test
+
+# Interactive relay pool testing
+cd tests && ./pool_test
 ```
 
 **Test Categories:**
@@ -383,6 +398,7 @@ cd tests && make test
 - **Relay Communication**: `relay_pool_test`, `sync_test`
 - **HTTP/WebSocket**: `http_test`, `wss_test`
 - **Proof of Work**: `test_pow_loop`
+- **Interactive Pool Testing**: `pool_test` (menu-driven interface with reconnection testing)
 
 ## 🏗️ Integration
 

VERSION

@@ -1 +1 @@
-0.2.1
+0.4.4

build.sh

@@ -58,6 +58,7 @@ FORCE_NIPS=""
 VERBOSE=false
 HELP=false
 BUILD_TESTS=false
+BUILD_EXAMPLES=false
 NO_COLOR_FLAG=false
 
 # Parse command line arguments
@@ -83,6 +84,10 @@ while [[ $# -gt 0 ]]; do
             BUILD_TESTS=true
             shift
             ;;
+        --examples|-e)
+            BUILD_EXAMPLES=true
+            shift
+            ;;
         --no-color)
             NO_COLOR_FLAG=true
             shift
@@ -119,6 +124,7 @@ if [ "$HELP" = true ]; then
     echo "  --nips=1,5,6,19       Force specific NIPs (comma-separated)"
     echo "  --nips=all            Include all available NIPs"
     echo "  --tests, -t           Build all test programs in tests/ directory"
+    echo "  --examples, -e        Build all example programs in examples/ directory"
     echo "  --verbose, -v         Verbose output"
     echo "  --no-color            Disable colored output"
     echo "  --help, -h            Show this help"
@@ -134,9 +140,11 @@ if [ "$HELP" = true ]; then
     echo "  006 - Key derivation from mnemonic"
     echo "  011 - Relay information document"
     echo "  013 - Proof of Work"
+    echo "  017 - Private Direct Messages"
     echo "  019 - Bech32 encoding (nsec/npub)"
     echo "  042 - Authentication of clients to relays"
     echo "  044 - Encryption (modern)"
+    echo "  059 - Gift Wrap"
     echo ""
     echo "Examples:"
     echo "  $0                    # Auto-detect NIPs, build for current arch"
@@ -185,7 +193,7 @@ print_info "Auto-detecting needed NIPs from your source code..."
 NEEDED_NIPS=""
 if [ -n "$FORCE_NIPS" ]; then
     if [ "$FORCE_NIPS" = "all" ]; then
-        NEEDED_NIPS="001 004 005 006 011 013 019 042 044"
+        NEEDED_NIPS="001 004 005 006 011 013 017 019 042 044 059"
         print_info "Forced: Building all available NIPs"
     else
         # Convert comma-separated list to space-separated with 3-digit format
@@ -220,10 +228,10 @@ else
     fi
 fi
 
-# If building tests, include all NIPs to ensure test compatibility
-if [ "$BUILD_TESTS" = true ] && [ -z "$FORCE_NIPS" ]; then
-    NEEDED_NIPS="001 004 005 006 011 013 019 042 044"
-    print_info "Building tests - including all available NIPs for test compatibility"
+# If building tests or examples, include all NIPs to ensure compatibility
+if ([ "$BUILD_TESTS" = true ] || [ "$BUILD_EXAMPLES" = true ]) && [ -z "$FORCE_NIPS" ]; then
+    NEEDED_NIPS="001 004 005 006 011 013 017 019 042 044 059"
+    print_info "Building tests/examples - including all available NIPs for compatibility"
 fi
 
 # Ensure NIP-001 is always included (required for core functionality)
@@ -491,6 +499,7 @@ SOURCES="$SOURCES cjson/cJSON.c"
 SOURCES="$SOURCES nostr_core/utils.c"
 SOURCES="$SOURCES nostr_core/nostr_common.c"
 SOURCES="$SOURCES nostr_core/core_relays.c"
+SOURCES="$SOURCES nostr_core/core_relay_pool.c"
 SOURCES="$SOURCES nostr_websocket/nostr_websocket_openssl.c"
 SOURCES="$SOURCES nostr_core/request_validator.c"
 
@@ -507,9 +516,11 @@ for nip in $NEEDED_NIPS; do
             006) NIP_DESCRIPTIONS="$NIP_DESCRIPTIONS NIP-006(Keys)" ;;
             011) NIP_DESCRIPTIONS="$NIP_DESCRIPTIONS NIP-011(Relay-Info)" ;;
             013) NIP_DESCRIPTIONS="$NIP_DESCRIPTIONS NIP-013(PoW)" ;;
+            017) NIP_DESCRIPTIONS="$NIP_DESCRIPTIONS NIP-017(DMs)" ;;
             019) NIP_DESCRIPTIONS="$NIP_DESCRIPTIONS NIP-019(Bech32)" ;;
             042) NIP_DESCRIPTIONS="$NIP_DESCRIPTIONS NIP-042(Auth)" ;;
             044) NIP_DESCRIPTIONS="$NIP_DESCRIPTIONS NIP-044(Encrypt)" ;;
+            059) NIP_DESCRIPTIONS="$NIP_DESCRIPTIONS NIP-059(Gift-Wrap)" ;;
         esac
     else
         print_warning "NIP file not found: $NIP_FILE - skipping"
@@ -666,7 +677,53 @@ if [ $AR_RESULT -eq 0 ]; then
         fi
         echo ""
     fi
-    
+
+    # Build examples if requested
+    if [ "$BUILD_EXAMPLES" = true ]; then
+        print_info "Scanning examples/ directory for example programs..."
+
+        if [ ! -d "examples" ]; then
+            print_warning "examples/ directory not found - skipping example builds"
+        else
+            EXAMPLE_COUNT=0
+            SUCCESS_COUNT=0
+
+            # Find all .c files in examples/ directory (not subdirectories)
+            while IFS= read -r -d '' example_file; do
+                EXAMPLE_COUNT=$((EXAMPLE_COUNT + 1))
+                example_name=$(basename "$example_file" .c)
+                example_exe="examples/$example_name"
+
+                print_info "Building example: $example_name"
+
+                # Example compilation with system libraries
+                LINK_FLAGS="-lz -ldl -lpthread -lm $SYSTEM_LIBS"
+
+                if [ "$VERBOSE" = true ]; then
+                    print_info "  Command: $CC $CFLAGS $INCLUDES \"$example_file\" -o \"$example_exe\" ./$OUTPUT $LINK_FLAGS"
+                fi
+
+                if $CC $CFLAGS $INCLUDES "$example_file" -o "$example_exe" "./$OUTPUT" $LINK_FLAGS; then
+                    SUCCESS_COUNT=$((SUCCESS_COUNT + 1))
+                    print_success "Built $example_name"
+                    if [ "$VERBOSE" = true ]; then
+                        print_info "  Executable: $example_exe"
+                    fi
+                else
+                    print_error "  Failed to build: $example_name"
+                fi
+
+            done < <(find examples/ -maxdepth 1 -name "*.c" -type f -print0)
+
+            if [ $EXAMPLE_COUNT -eq 0 ]; then
+                print_warning "No .c files found in examples/ directory"
+            else
+                print_success "Built $SUCCESS_COUNT/$EXAMPLE_COUNT example programs"
+            fi
+        fi
+        echo ""
+    fi
+
     echo "Usage in your project:"
     echo "  gcc your_app.c $OUTPUT -lz -ldl -lpthread -lm $SYSTEM_LIBS -o your_app"
     echo ""

dev_build.sh

@@ -1,394 +0,0 @@
-#!/bin/bash
-
-# NOSTR Core Library Build Script
-# Provides convenient build targets for the standalone library
-# Automatically increments patch version with each build
-
-set -e  # Exit on any error
-
-# Colors for output
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-NC='\033[0m' # No Color
-
-# Function to print colored output
-print_status() {
-    echo -e "${BLUE}[INFO]${NC} $1"
-}
-
-print_success() {
-    echo -e "${GREEN}[SUCCESS]${NC} $1"
-}
-
-print_warning() {
-    echo -e "${YELLOW}[WARNING]${NC} $1"
-}
-
-print_error() {
-    echo -e "${RED}[ERROR]${NC} $1"
-}
-
-# Function to automatically increment version
-increment_version() {
-    print_status "Incrementing version..."
-    
-    # Check if we're in a git repository
-    if ! git rev-parse --git-dir > /dev/null 2>&1; then
-        print_warning "Not in a git repository - skipping version increment"
-        return 0
-    fi
-    
-    # Get the highest version tag (not necessarily the most recent chronologically)
-    LATEST_TAG=$(git tag -l 'v*.*.*' | sort -V | tail -n 1 || echo "v0.1.0")
-    if [[ -z "$LATEST_TAG" ]]; then
-        LATEST_TAG="v0.1.0"
-    fi
-    
-    # Extract version components (remove 'v' prefix if present)
-    VERSION=${LATEST_TAG#v}
-    
-    # Parse major.minor.patch
-    if [[ $VERSION =~ ^([0-9]+)\.([0-9]+)\.([0-9]+)$ ]]; then
-        MAJOR=${BASH_REMATCH[1]}
-        MINOR=${BASH_REMATCH[2]}
-        PATCH=${BASH_REMATCH[3]}
-    else
-        print_error "Invalid version format in tag: $LATEST_TAG"
-        print_error "Expected format: v0.1.0"
-        return 1
-    fi
-    
-    # Increment patch version
-    NEW_PATCH=$((PATCH + 1))
-    NEW_VERSION="v${MAJOR}.${MINOR}.${NEW_PATCH}"
-    
-    print_status "Current version: $LATEST_TAG"
-    print_status "New version: $NEW_VERSION"
-    
-    # Create new git tag
-    if git tag "$NEW_VERSION" 2>/dev/null; then
-        print_success "Created new version tag: $NEW_VERSION"
-    else
-        print_warning "Tag $NEW_VERSION already exists - using existing version"
-        NEW_VERSION=$LATEST_TAG
-    fi
-    
-    # Update VERSION file for compatibility
-    echo "${NEW_VERSION#v}" > VERSION
-    print_success "Updated VERSION file to ${NEW_VERSION#v}"
-}
-
-# Function to perform git operations after successful build
-perform_git_operations() {
-    local commit_message="$1"
-    
-    if [[ -z "$commit_message" ]]; then
-        return 0  # No commit message provided, skip git operations
-    fi
-    
-    print_status "Performing git operations..."
-    
-    # Check if we're in a git repository
-    if ! git rev-parse --git-dir > /dev/null 2>&1; then
-        print_warning "Not in a git repository - skipping git operations"
-        return 0
-    fi
-    
-    # Check if there are changes to commit
-    if git diff --quiet && git diff --cached --quiet; then
-        print_warning "No changes to commit"
-        return 0
-    fi
-    
-    # Add all changes
-    print_status "Adding changes to git..."
-    if ! git add .; then
-        print_error "Failed to add changes to git"
-        return 1
-    fi
-    
-    # Commit changes
-    print_status "Committing changes with message: '$commit_message'"
-    if ! git commit -m "$commit_message"; then
-        print_error "Failed to commit changes"
-        return 1
-    fi
-    
-    # Push changes
-    print_status "Pushing changes to remote repository..."
-    if ! git push; then
-        print_error "Failed to push changes to remote repository"
-        print_warning "Changes have been committed locally but not pushed"
-        return 1
-    fi
-    
-    print_success "Git operations completed successfully!"
-    return 0
-}
-
-# Function to show usage
-show_usage() {
-    echo "NOSTR Core Library Build Script"
-    echo "==============================="
-    echo ""
-    echo "Usage: $0 [target] [-m \"commit message\"]"
-    echo ""
-    echo "Available targets:"
-    echo "  clean       - Clean all build artifacts"
-    echo "  lib         - Build static libraries for both x64 and ARM64 (default)"
-    echo "  x64         - Build x64 static library only"
-    echo "  arm64       - Build ARM64 static library only"
-    echo "  all         - Build both architectures and examples"
-    echo "  examples    - Build example programs"
-    echo "  test        - Run tests"
-    echo "  install     - Install library to system"
-    echo "  uninstall   - Remove library from system"
-    echo "  help        - Show this help message"
-    echo ""
-    echo "Options:"
-    echo "  -m \"message\"  - Git commit message (triggers automatic git add, commit, push after successful build)"
-    echo ""
-    echo "Examples:"
-    echo "  $0 lib -m \"Add new proof-of-work parameters\""
-    echo "  $0 x64 -m \"Fix OpenSSL minimal build configuration\""
-    echo "  $0 lib                                        # Build without git operations"
-    echo ""
-    echo "Library outputs (both self-contained with secp256k1):"
-    echo "  libnostr_core.a       - x86_64 static library"
-    echo "  libnostr_core_arm64.a - ARM64 static library"
-    echo "  examples/*            - Example programs"
-    echo ""
-    echo "Both libraries include secp256k1 objects internally."
-    echo "Users only need to link with the library + -lm."
-}
-
-# Parse command line arguments
-TARGET=""
-COMMIT_MESSAGE=""
-
-# Parse arguments
-while [[ $# -gt 0 ]]; do
-    case $1 in
-        -m)
-            COMMIT_MESSAGE="$2"
-            shift 2
-            ;;
-        -*)
-            print_error "Unknown option: $1"
-            show_usage
-            exit 1
-            ;;
-        *)
-            if [[ -z "$TARGET" ]]; then
-                TARGET="$1"
-            else
-                print_error "Multiple targets specified: $TARGET and $1"
-                show_usage
-                exit 1
-            fi
-            shift
-            ;;
-    esac
-done
-
-# Set default target if none specified
-TARGET=${TARGET:-lib}
-
-case "$TARGET" in
-    clean)
-        print_status "Cleaning build artifacts..."
-        make clean
-        print_success "Clean completed"
-        ;;
-        
-    lib|library)
-        increment_version
-        print_status "Building both x64 and ARM64 static libraries..."
-        make clean
-        make
-        
-        # Check both libraries were built
-        SUCCESS=0
-        if [ -f "libnostr_core.a" ]; then
-            SIZE_X64=$(stat -c%s "libnostr_core.a")
-            print_success "x64 static library built successfully (${SIZE_X64} bytes)"
-            SUCCESS=$((SUCCESS + 1))
-        else
-            print_error "Failed to build x64 static library"
-        fi
-        
-        if [ -f "libnostr_core_arm64.a" ]; then
-            SIZE_ARM64=$(stat -c%s "libnostr_core_arm64.a")
-            print_success "ARM64 static library built successfully (${SIZE_ARM64} bytes)"
-            SUCCESS=$((SUCCESS + 1))
-        else
-            print_error "Failed to build ARM64 static library"
-        fi
-        
-        if [ $SUCCESS -eq 2 ]; then
-            print_success "Both architectures built successfully!"
-            ls -la libnostr_core*.a
-            perform_git_operations "$COMMIT_MESSAGE"
-        else
-            print_error "Failed to build all libraries"
-            exit 1
-        fi
-        ;;
-        
-    x64|x64-only)
-        increment_version
-        print_status "Building x64 static library only..."
-        make clean
-        make x64
-        if [ -f "libnostr_core.a" ]; then
-            SIZE=$(stat -c%s "libnostr_core.a")
-            print_success "x64 static library built successfully (${SIZE} bytes)"
-            ls -la libnostr_core.a
-            perform_git_operations "$COMMIT_MESSAGE"
-        else
-            print_error "Failed to build x64 static library"
-            exit 1
-        fi
-        ;;
-        
-    arm64|arm64-only)
-        increment_version
-        print_status "Building ARM64 static library only..."
-        make clean
-        make arm64
-        if [ -f "libnostr_core_arm64.a" ]; then
-            SIZE=$(stat -c%s "libnostr_core_arm64.a")
-            print_success "ARM64 static library built successfully (${SIZE} bytes)"
-            ls -la libnostr_core_arm64.a
-            perform_git_operations "$COMMIT_MESSAGE"
-        else
-            print_error "Failed to build ARM64 static library"
-            exit 1
-        fi
-        ;;
-        
-    shared)
-        increment_version
-        print_status "Building shared library..."
-        make clean
-        make libnostr_core.so
-        if [ -f "libnostr_core.so" ]; then
-            SIZE=$(stat -c%s "libnostr_core.so")
-            print_success "Shared library built successfully (${SIZE} bytes)"
-            ls -la libnostr_core.so
-            perform_git_operations "$COMMIT_MESSAGE"
-        else
-            print_error "Failed to build shared library"
-            exit 1
-        fi
-        ;;
-        
-    all)
-        increment_version
-        print_status "Building all libraries and examples..."
-        make clean
-        make all
-        
-        # Check both libraries and examples were built
-        SUCCESS=0
-        if [ -f "libnostr_core.a" ]; then
-            SIZE_X64=$(stat -c%s "libnostr_core.a")
-            print_success "x64 static library built successfully (${SIZE_X64} bytes)"
-            SUCCESS=$((SUCCESS + 1))
-        else
-            print_error "Failed to build x64 static library"
-        fi
-        
-        if [ -f "libnostr_core_arm64.a" ]; then
-            SIZE_ARM64=$(stat -c%s "libnostr_core_arm64.a")
-            print_success "ARM64 static library built successfully (${SIZE_ARM64} bytes)"
-            SUCCESS=$((SUCCESS + 1))
-        else
-            print_error "Failed to build ARM64 static library"
-        fi
-        
-        if [ $SUCCESS -eq 2 ]; then
-            print_success "All libraries and examples built successfully!"
-            ls -la libnostr_core*.a
-            ls -la examples/
-            perform_git_operations "$COMMIT_MESSAGE"
-        else
-            print_error "Failed to build all components"
-            exit 1
-        fi
-        ;;
-        
-    examples)
-        increment_version
-        print_status "Building both libraries and examples..."
-        make clean
-        make
-        make examples
-        
-        # Verify libraries were built
-        if [ -f "libnostr_core.a" ] && [ -f "libnostr_core_arm64.a" ]; then
-            print_success "Both libraries and examples built successfully"
-            ls -la libnostr_core*.a
-            ls -la examples/
-            perform_git_operations "$COMMIT_MESSAGE"
-        else
-            print_error "Failed to build libraries for examples"
-            exit 1
-        fi
-        ;;
-        
-    test)
-        print_status "Running tests..."
-        make clean
-        make
-        if make test-crypto 2>/dev/null; then
-            print_success "All tests passed"
-        else
-            print_warning "Running simple test instead..."
-            make test
-            print_success "Basic test completed"
-        fi
-        ;;
-        
-    tests)
-        print_status "Running tests..."
-        make clean
-        make
-        if make test-crypto 2>/dev/null; then
-            print_success "All tests passed"
-        else
-            print_warning "Running simple test instead..."
-            make test
-            print_success "Basic test completed"
-        fi
-        ;;
-
-    install)
-        increment_version
-        print_status "Installing library to system..."
-        make clean
-        make all
-        sudo make install
-        print_success "Library installed to /usr/local"
-        perform_git_operations "$COMMIT_MESSAGE"
-        ;;
-        
-    uninstall)
-        print_status "Uninstalling library from system..."
-        sudo make uninstall
-        print_success "Library uninstalled"
-        ;;
-        
-    help|--help|-h)
-        show_usage
-        ;;
-        
-    *)
-        print_error "Unknown target: $TARGET"
-        echo ""
-        show_usage
-        exit 1
-        ;;
-esac

examples/integration_example/CMakeLists.txt

@@ -1,39 +0,0 @@
-# Example CMakeLists.txt for a project using nostr_core library
-cmake_minimum_required(VERSION 3.12)
-project(my_nostr_app VERSION 1.0.0 LANGUAGES C)
-
-set(CMAKE_C_STANDARD 99)
-
-# Method 1: Find installed package
-# Uncomment if nostr_core is installed system-wide
-# find_package(nostr_core REQUIRED)
-
-# Method 2: Use as subdirectory
-# Uncomment if nostr_core is a subdirectory
-# add_subdirectory(nostr_core)
-
-# Method 3: Use pkg-config
-# Uncomment if using pkg-config
-# find_package(PkgConfig REQUIRED)
-# pkg_check_modules(NOSTR_CORE REQUIRED nostr_core)
-
-# Create executable
-add_executable(my_nostr_app main.c)
-
-# Link with nostr_core
-# Choose one of the following based on your integration method:
-
-# Method 1: Installed package
-# target_link_libraries(my_nostr_app nostr_core::static)
-
-# Method 2: Subdirectory
-# target_link_libraries(my_nostr_app nostr_core_static)
-
-# Method 3: pkg-config
-# target_include_directories(my_nostr_app PRIVATE ${NOSTR_CORE_INCLUDE_DIRS})
-# target_link_libraries(my_nostr_app ${NOSTR_CORE_LIBRARIES})
-
-# For this example, we'll assume Method 2 (subdirectory)
-# Add the parent nostr_core directory
-add_subdirectory(../.. nostr_core)
-target_link_libraries(my_nostr_app nostr_core_static)

examples/integration_example/README.md

@@ -1,186 +0,0 @@
-# NOSTR Core Integration Example
-
-This directory contains a complete example showing how to integrate the NOSTR Core library into your own projects.
-
-## What This Example Demonstrates
-
-- **Library Initialization**: Proper setup and cleanup of the NOSTR library
-- **Identity Management**: Key generation, bech32 encoding, and format detection
-- **Event Creation**: Creating and signing different types of NOSTR events
-- **Input Handling**: Processing various input formats (mnemonic, hex, bech32)
-- **Utility Functions**: Using helper functions for hex conversion and error handling
-- **CMake Integration**: How to integrate the library in your CMake-based project
-
-## Building and Running
-
-### Method 1: Using CMake
-
-```bash
-# Create build directory
-mkdir build && cd build
-
-# Configure with CMake
-cmake ..
-
-# Build
-make
-
-# Run the example
-./my_nostr_app
-```
-
-### Method 2: Manual Compilation
-
-```bash
-# Compile directly (assuming you're in the c_nostr root directory)
-gcc -I. examples/integration_example/main.c nostr_core.c nostr_crypto.c cjson/cJSON.c -lm -o integration_example
-
-# Run
-./integration_example
-```
-
-## Expected Output
-
-The example will demonstrate:
-
-1. **Identity Management Demo**
-   - Generate a new keypair
-   - Display keys in hex and bech32 format
-
-2. **Event Creation Demo**
-   - Create a text note event
-   - Create a profile event
-   - Display the JSON for both events
-
-3. **Input Handling Demo**
-   - Process different input formats
-   - Show format detection and decoding
-
-4. **Utility Functions Demo**
-   - Hex conversion round-trip
-   - Error message display
-
-## Integration Patterns
-
-### Pattern 1: CMake Find Package
-
-If NOSTR Core is installed system-wide:
-
-```cmake
-find_package(nostr_core REQUIRED)
-target_link_libraries(your_app nostr_core::static)
-```
-
-### Pattern 2: CMake Subdirectory
-
-If NOSTR Core is a subdirectory of your project:
-
-```cmake
-add_subdirectory(nostr_core)
-target_link_libraries(your_app nostr_core_static)
-```
-
-### Pattern 3: pkg-config
-
-If using pkg-config:
-
-```cmake
-find_package(PkgConfig REQUIRED)
-pkg_check_modules(NOSTR_CORE REQUIRED nostr_core)
-target_include_directories(your_app PRIVATE ${NOSTR_CORE_INCLUDE_DIRS})
-target_link_libraries(your_app ${NOSTR_CORE_LIBRARIES})
-```
-
-### Pattern 4: Direct Source Integration
-
-Copy the essential files to your project:
-
-```bash
-cp nostr_core.{c,h} nostr_crypto.{c,h} your_project/src/
-cp -r cjson/ your_project/src/
-```
-
-Then compile them with your project sources.
-
-## Code Structure
-
-### main.c Structure
-
-The example is organized into clear demonstration functions:
-
-- `demo_identity_management()` - Key generation and encoding
-- `demo_event_creation()` - Creating different event types
-- `demo_input_handling()` - Processing various input formats
-- `demo_utilities()` - Using utility functions
-
-Each function demonstrates specific aspects of the library while maintaining proper error handling and resource cleanup.
-
-### Key Integration Points
-
-1. **Initialization**
-   ```c
-   int ret = nostr_init();
-   if (ret != NOSTR_SUCCESS) {
-       // Handle error
-   }
-   ```
-
-2. **Resource Cleanup**
-   ```c
-   // Always clean up JSON objects
-   cJSON_Delete(event);
-   
-   // Clean up library on exit
-   nostr_cleanup();
-   ```
-
-3. **Error Handling**
-   ```c
-   if (ret != NOSTR_SUCCESS) {
-       printf("Error: %s\n", nostr_strerror(ret));
-       return ret;
-   }
-   ```
-
-## Customization
-
-You can modify this example for your specific needs:
-
-- Change the `app_config_t` structure to match your application's configuration
-- Add additional event types or custom event creation logic
-- Integrate with your existing error handling and logging systems
-- Add networking functionality using the WebSocket layer
-
-## Dependencies
-
-This example requires:
-- C99 compiler (gcc, clang)
-- CMake 3.12+ (for CMake build)
-- NOSTR Core library and its dependencies
-
-## Testing
-
-You can test different input formats by passing them as command line arguments:
-
-```bash
-# Test with mnemonic
-./my_nostr_app "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about"
-
-# Test with hex private key
-./my_nostr_app "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"
-
-# Test with bech32 nsec
-./my_nostr_app "nsec1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
-```
-
-## Next Steps
-
-After studying this example, you can:
-
-1. Integrate the patterns into your own application
-2. Explore the WebSocket functionality for relay communication
-3. Add support for additional NOSTR event types
-4. Implement your own identity persistence layer
-5. Add networking and relay management features
-
-For more examples, see the other files in the `examples/` directory.

examples/integration_example/main.c

@@ -1,271 +0,0 @@
-/*
- * Example application demonstrating how to integrate nostr_core into other projects
- * This shows a complete workflow from key generation to event publishing
- */
-
-#include <stdio.h>
-#include <stdlib.h>
-#include <string.h>
-#include "nostr_core.h"
-
-// Example application configuration
-typedef struct {
-    char* app_name;
-    char* version;
-    int debug_mode;
-} app_config_t;
-
-static app_config_t g_config = {
-    .app_name = "My NOSTR App",
-    .version = "1.0.0",
-    .debug_mode = 1
-};
-
-// Helper function to print hex data
-static void print_hex(const char* label, const unsigned char* data, size_t len) {
-    if (g_config.debug_mode) {
-        printf("%s: ", label);
-        for (size_t i = 0; i < len; i++) {
-            printf("%02x", data[i]);
-        }
-        printf("\n");
-    }
-}
-
-// Helper function to print JSON nicely
-static void print_event(const char* label, cJSON* event) {
-    if (!event) {
-        printf("%s: NULL\n", label);
-        return;
-    }
-    
-    char* json_string = cJSON_Print(event);
-    if (json_string) {
-        printf("%s:\n%s\n", label, json_string);
-        free(json_string);
-    }
-}
-
-// Example: Generate and manage identity
-static int demo_identity_management(void) {
-    printf("\n=== Identity Management Demo ===\n");
-    
-    unsigned char private_key[32], public_key[32];
-    char nsec[100], npub[100];
-    
-    // Generate a new keypair
-    printf("Generating new keypair...\n");
-    int ret = nostr_generate_keypair(private_key, public_key);
-    if (ret != NOSTR_SUCCESS) {
-        printf("Error generating keypair: %s\n", nostr_strerror(ret));
-        return ret;
-    }
-    
-    print_hex("Private Key", private_key, 32);
-    print_hex("Public Key", public_key, 32);
-    
-    // Convert to bech32 format
-    ret = nostr_key_to_bech32(private_key, "nsec", nsec);
-    if (ret != NOSTR_SUCCESS) {
-        printf("Error encoding nsec: %s\n", nostr_strerror(ret));
-        return ret;
-    }
-    
-    ret = nostr_key_to_bech32(public_key, "npub", npub);
-    if (ret != NOSTR_SUCCESS) {
-        printf("Error encoding npub: %s\n", nostr_strerror(ret));
-        return ret;
-    }
-    
-    printf("nsec: %s\n", nsec);
-    printf("npub: %s\n", npub);
-    
-    return NOSTR_SUCCESS;
-}
-
-// Example: Create different types of events
-static int demo_event_creation(const unsigned char* private_key) {
-    printf("\n=== Event Creation Demo ===\n");
-    
-    // Create a text note
-    printf("Creating text note...\n");
-    cJSON* text_event = nostr_create_text_event("Hello from my NOSTR app!", private_key);
-    if (!text_event) {
-        printf("Error creating text event\n");
-        return NOSTR_ERROR_JSON_PARSE;
-    }
-    print_event("Text Event", text_event);
-    
-    // Create a profile event
-    printf("\nCreating profile event...\n");
-    cJSON* profile_event = nostr_create_profile_event(
-        g_config.app_name, 
-        "A sample application demonstrating NOSTR integration",
-        private_key
-    );
-    if (!profile_event) {
-        printf("Error creating profile event\n");
-        cJSON_Delete(text_event);
-        return NOSTR_ERROR_JSON_PARSE;
-    }
-    print_event("Profile Event", profile_event);
-    
-    // Cleanup
-    cJSON_Delete(text_event);
-    cJSON_Delete(profile_event);
-    
-    return NOSTR_SUCCESS;
-}
-
-// Example: Handle different input formats
-static int demo_input_handling(const char* user_input) {
-    printf("\n=== Input Handling Demo ===\n");
-    printf("Processing input: %s\n", user_input);
-    
-    // Detect input type
-    int input_type = nostr_detect_input_type(user_input);
-    switch (input_type) {
-        case NOSTR_INPUT_MNEMONIC:
-            printf("Detected: BIP39 Mnemonic\n");
-            {
-                unsigned char priv[32], pub[32];
-                int ret = nostr_derive_keys_from_mnemonic(user_input, 0, priv, pub);
-                if (ret == NOSTR_SUCCESS) {
-                    print_hex("Derived Private Key", priv, 32);
-                    print_hex("Derived Public Key", pub, 32);
-                }
-            }
-            break;
-            
-        case NOSTR_INPUT_NSEC_HEX:
-            printf("Detected: Hex-encoded private key\n");
-            {
-                unsigned char decoded[32];
-                int ret = nostr_decode_nsec(user_input, decoded);
-                if (ret == NOSTR_SUCCESS) {
-                    print_hex("Decoded Private Key", decoded, 32);
-                }
-            }
-            break;
-            
-        case NOSTR_INPUT_NSEC_BECH32:
-            printf("Detected: Bech32-encoded private key (nsec)\n");
-            {
-                unsigned char decoded[32];
-                int ret = nostr_decode_nsec(user_input, decoded);
-                if (ret == NOSTR_SUCCESS) {
-                    print_hex("Decoded Private Key", decoded, 32);
-                }
-            }
-            break;
-            
-        default:
-            printf("Unknown input format\n");
-            return NOSTR_ERROR_INVALID_INPUT;
-    }
-    
-    return NOSTR_SUCCESS;
-}
-
-// Example: Demonstrate utility functions
-static int demo_utilities(void) {
-    printf("\n=== Utility Functions Demo ===\n");
-    
-    // Hex conversion
-    const char* test_hex = "deadbeef";
-    unsigned char bytes[4];
-    char hex_result[9];
-    
-    printf("Testing hex conversion with: %s\n", test_hex);
-    
-    int ret = nostr_hex_to_bytes(test_hex, bytes, 4);
-    if (ret != NOSTR_SUCCESS) {
-        printf("Error in hex_to_bytes: %s\n", nostr_strerror(ret));
-        return ret;
-    }
-    
-    nostr_bytes_to_hex(bytes, 4, hex_result);
-    printf("Round-trip result: %s\n", hex_result);
-    
-    // Error message testing
-    printf("\nTesting error messages:\n");
-    for (int i = 0; i >= -10; i--) {
-        const char* msg = nostr_strerror(i);
-        if (msg && strlen(msg) > 0) {
-            printf("  %d: %s\n", i, msg);
-        }
-    }
-    
-    return NOSTR_SUCCESS;
-}
-
-int main(int argc, char* argv[]) {
-    printf("%s v%s\n", g_config.app_name, g_config.version);
-    printf("NOSTR Core Integration Example\n");
-    printf("=====================================\n");
-    
-    // Initialize the NOSTR library
-    printf("Initializing NOSTR core library...\n");
-    int ret = nostr_init();
-    if (ret != NOSTR_SUCCESS) {
-        printf("Failed to initialize NOSTR library: %s\n", nostr_strerror(ret));
-        return 1;
-    }
-    
-    // Run demonstrations
-    unsigned char demo_private_key[32];
-    
-    // 1. Identity management
-    ret = demo_identity_management();
-    if (ret != NOSTR_SUCCESS) {
-        goto cleanup;
-    }
-    
-    // Generate a key for other demos
-    nostr_generate_keypair(demo_private_key, NULL);
-    
-    // 2. Event creation
-    ret = demo_event_creation(demo_private_key);
-    if (ret != NOSTR_SUCCESS) {
-        goto cleanup;
-    }
-    
-    // 3. Input handling (use command line argument if provided)
-    const char* test_input = (argc > 1) ? argv[1] : 
-        "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about";
-    ret = demo_input_handling(test_input);
-    if (ret != NOSTR_SUCCESS && ret != NOSTR_ERROR_INVALID_INPUT) {
-        goto cleanup;
-    }
-    
-    // 4. Utility functions
-    ret = demo_utilities();
-    if (ret != NOSTR_SUCCESS) {
-        goto cleanup;
-    }
-    
-    printf("\n=====================================\n");
-    printf("All demonstrations completed successfully!\n");
-    printf("\nThis example shows how to:\n");
-    printf("  • Initialize the NOSTR library\n");
-    printf("  • Generate and manage keypairs\n");
-    printf("  • Create and sign different event types\n");
-    printf("  • Handle various input formats\n");
-    printf("  • Use utility functions\n");
-    printf("  • Clean up resources properly\n");
-    
-    ret = NOSTR_SUCCESS;
-
-cleanup:
-    // Clean up the NOSTR library
-    printf("\nCleaning up NOSTR library...\n");
-    nostr_cleanup();
-    
-    if (ret == NOSTR_SUCCESS) {
-        printf("Example completed successfully.\n");
-        return 0;
-    } else {
-        printf("Example failed with error: %s\n", nostr_strerror(ret));
-        return 1;
-    }
-}

examples/relay_pool.c

@@ -0,0 +1,692 @@
+/*
+ * Interactive Relay Pool Test Program
+ *
+ * Interactive command-line interface for testing nostr_relay_pool functionality.
+ * All output is logged to pool.log while the menu runs in the terminal.
+ *
+ * Usage: ./pool_test
+ */
+
+#define _POSIX_C_SOURCE 200809L
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <signal.h>
+#include <time.h>
+#include <unistd.h>
+#include <pthread.h>
+#include <fcntl.h>
+#include <sys/stat.h>
+#include "../nostr_core/nostr_core.h"
+#include "../cjson/cJSON.h"
+
+// Global variables
+volatile sig_atomic_t running = 1;
+nostr_relay_pool_t* pool = NULL;
+nostr_pool_subscription_t** subscriptions = NULL;
+int subscription_count = 0;
+int subscription_capacity = 0;
+pthread_t poll_thread;
+int log_fd = -1;
+
+// Signal handler for clean shutdown
+void signal_handler(int signum) {
+    (void)signum;
+    running = 0;
+}
+
+// Event callback - called when an event is received
+void on_event(cJSON* event, const char* relay_url, void* user_data) {
+    (void)user_data;
+
+    // Extract basic event information
+    cJSON* id = cJSON_GetObjectItem(event, "id");
+    cJSON* pubkey = cJSON_GetObjectItem(event, "pubkey");
+    cJSON* created_at = cJSON_GetObjectItem(event, "created_at");
+    cJSON* kind = cJSON_GetObjectItem(event, "kind");
+    cJSON* content = cJSON_GetObjectItem(event, "content");
+
+    time_t now = time(NULL);
+    char timestamp[26];
+    ctime_r(&now, timestamp);
+    timestamp[24] = '\0'; // Remove newline
+
+    dprintf(log_fd, "[%s] 📨 EVENT from %s\n", timestamp, relay_url);
+    dprintf(log_fd, "├── ID: %.12s...\n", id && cJSON_IsString(id) ? cJSON_GetStringValue(id) : "unknown");
+    dprintf(log_fd, "├── Pubkey: %.12s...\n", pubkey && cJSON_IsString(pubkey) ? cJSON_GetStringValue(pubkey) : "unknown");
+    dprintf(log_fd, "├── Kind: %d\n", kind && cJSON_IsNumber(kind) ? (int)cJSON_GetNumberValue(kind) : -1);
+    dprintf(log_fd, "├── Created: %lld\n", created_at && cJSON_IsNumber(created_at) ? (long long)cJSON_GetNumberValue(created_at) : 0);
+
+    // Truncate content if too long
+    if (content && cJSON_IsString(content)) {
+        const char* content_str = cJSON_GetStringValue(content);
+        size_t content_len = strlen(content_str);
+        if (content_len > 100) {
+            dprintf(log_fd, "└── Content: %.97s...\n", content_str);
+        } else {
+            dprintf(log_fd, "└── Content: %s\n", content_str);
+        }
+    } else {
+        dprintf(log_fd, "└── Content: (empty)\n");
+    }
+    dprintf(log_fd, "\n");
+}
+
+// EOSE callback - called when End of Stored Events is received
+void on_eose(cJSON** events, int event_count, void* user_data) {
+    (void)user_data;
+    time_t now = time(NULL);
+    char timestamp[26];
+    ctime_r(&now, timestamp);
+    timestamp[24] = '\0';
+    dprintf(log_fd, "[%s] 📋 EOSE received - %d events collected\n", timestamp, event_count);
+
+    // Log collected events if any
+    for (int i = 0; i < event_count; i++) {
+        cJSON* id = cJSON_GetObjectItem(events[i], "id");
+        if (id && cJSON_IsString(id)) {
+            dprintf(log_fd, "  Event %d: %.12s...\n", i + 1, cJSON_GetStringValue(id));
+        }
+    }
+    dprintf(log_fd, "\n");
+}
+
+// Background polling thread
+void* poll_thread_func(void* arg) {
+    (void)arg;
+
+    while (running) {
+        if (pool) {
+            nostr_relay_pool_poll(pool, 100);
+        }
+        struct timespec ts = {0, 10000000}; // 10ms
+        nanosleep(&ts, NULL);
+    }
+
+    return NULL;
+}
+
+// Print menu
+void print_menu() {
+    printf("\n=== NOSTR Relay Pool Test Menu ===\n");
+    printf("1. Start Pool (wss://relay.laantungir.net)\n");
+    printf("2. Stop Pool\n");
+    printf("3. Add relay to pool\n");
+    printf("4. Remove relay from pool\n");
+    printf("5. Add subscription\n");
+    printf("6. Remove subscription\n");
+    printf("7. Show pool status\n");
+    printf("8. Test reconnection (simulate disconnect)\n");
+    printf("9. Exit\n");
+    printf("Choice: ");
+}
+
+// Get user input with default
+char* get_input(const char* prompt, const char* default_value) {
+    static char buffer[1024];
+    printf("%s", prompt);
+    if (default_value) {
+        printf(" [%s]", default_value);
+    }
+    printf(": ");
+
+    if (!fgets(buffer, sizeof(buffer), stdin)) {
+        return NULL;
+    }
+
+    // Remove newline
+    size_t len = strlen(buffer);
+    if (len > 0 && buffer[len-1] == '\n') {
+        buffer[len-1] = '\0';
+    }
+
+    // Return default if empty
+    if (strlen(buffer) == 0 && default_value) {
+        return strdup(default_value);
+    }
+
+    return strdup(buffer);
+}
+
+// Parse comma-separated list into cJSON array
+cJSON* parse_comma_list(const char* input, int is_number) {
+    if (!input || strlen(input) == 0) {
+        return NULL;
+    }
+
+    cJSON* array = cJSON_CreateArray();
+    if (!array) return NULL;
+
+    char* input_copy = strdup(input);
+    char* token = strtok(input_copy, ",");
+
+    while (token) {
+        // Trim whitespace
+        while (*token == ' ') token++;
+        char* end = token + strlen(token) - 1;
+        while (end > token && *end == ' ') *end-- = '\0';
+
+        if (is_number) {
+            int num = atoi(token);
+            cJSON_AddItemToArray(array, cJSON_CreateNumber(num));
+        } else {
+            cJSON_AddItemToArray(array, cJSON_CreateString(token));
+        }
+
+        token = strtok(NULL, ",");
+    }
+
+    free(input_copy);
+    return array;
+}
+
+// Add subscription interactively
+void add_subscription() {
+    if (!pool) {
+        printf("❌ Pool not started\n");
+        return;
+    }
+
+    printf("\n--- Add Subscription ---\n");
+    printf("Enter filter values (press Enter for no value):\n");
+
+    cJSON* filter = cJSON_CreateObject();
+
+    // ids
+    char* ids_input = get_input("ids (comma-separated event ids)", NULL);
+    if (ids_input && strlen(ids_input) > 0) {
+        cJSON* ids = parse_comma_list(ids_input, 0);
+        if (ids) cJSON_AddItemToObject(filter, "ids", ids);
+    }
+    free(ids_input);
+
+    // authors
+    char* authors_input = get_input("authors (comma-separated pubkeys)", NULL);
+    if (authors_input && strlen(authors_input) > 0) {
+        cJSON* authors = parse_comma_list(authors_input, 0);
+        if (authors) cJSON_AddItemToObject(filter, "authors", authors);
+    }
+    free(authors_input);
+
+    // kinds
+    char* kinds_input = get_input("kinds (comma-separated numbers)", NULL);
+    if (kinds_input && strlen(kinds_input) > 0) {
+        cJSON* kinds = parse_comma_list(kinds_input, 1);
+        if (kinds) cJSON_AddItemToObject(filter, "kinds", kinds);
+    }
+    free(kinds_input);
+
+    // #e tag
+    char* e_input = get_input("#e (comma-separated event ids)", NULL);
+    if (e_input && strlen(e_input) > 0) {
+        cJSON* e_array = parse_comma_list(e_input, 0);
+        if (e_array) cJSON_AddItemToObject(filter, "#e", e_array);
+    }
+    free(e_input);
+
+    // #p tag
+    char* p_input = get_input("#p (comma-separated pubkeys)", NULL);
+    if (p_input && strlen(p_input) > 0) {
+        cJSON* p_array = parse_comma_list(p_input, 0);
+        if (p_array) cJSON_AddItemToObject(filter, "#p", p_array);
+    }
+    free(p_input);
+
+    // since
+    char* since_input = get_input("since (unix timestamp or 'n' for now)", NULL);
+    if (since_input && strlen(since_input) > 0) {
+        if (strcmp(since_input, "n") == 0) {
+            // Use current timestamp
+            time_t now = time(NULL);
+            cJSON_AddItemToObject(filter, "since", cJSON_CreateNumber((int)now));
+            printf("Using current timestamp: %ld\n", now);
+        } else {
+            int since = atoi(since_input);
+            if (since > 0) cJSON_AddItemToObject(filter, "since", cJSON_CreateNumber(since));
+        }
+    }
+    free(since_input);
+
+    // until
+    char* until_input = get_input("until (unix timestamp)", NULL);
+    if (until_input && strlen(until_input) > 0) {
+        int until = atoi(until_input);
+        if (until > 0) cJSON_AddItemToObject(filter, "until", cJSON_CreateNumber(until));
+    }
+    free(until_input);
+
+    // limit
+    char* limit_input = get_input("limit (max events)", "10");
+    if (limit_input && strlen(limit_input) > 0) {
+        int limit = atoi(limit_input);
+        if (limit > 0) cJSON_AddItemToObject(filter, "limit", cJSON_CreateNumber(limit));
+    }
+    free(limit_input);
+
+    // Get relay URLs from pool
+    char** relay_urls = NULL;
+    nostr_pool_relay_status_t* statuses = NULL;
+    int relay_count = nostr_relay_pool_list_relays(pool, &relay_urls, &statuses);
+
+    if (relay_count <= 0) {
+        printf("❌ No relays in pool\n");
+        cJSON_Delete(filter);
+        return;
+    }
+
+    // Ask about close_on_eose behavior
+    char* close_input = get_input("Close subscription on EOSE? (y/n)", "n");
+    int close_on_eose = (close_input && strcmp(close_input, "y") == 0) ? 1 : 0;
+    free(close_input);
+
+    // Create subscription with new parameters
+    nostr_pool_subscription_t* sub = nostr_relay_pool_subscribe(
+        pool,
+        (const char**)relay_urls,
+        relay_count,
+        filter,
+        on_event,
+        on_eose,
+        NULL,
+        close_on_eose,
+        1,  // enable_deduplication
+        NOSTR_POOL_EOSE_FULL_SET,  // result_mode
+        30,  // relay_timeout_seconds
+        60   // eose_timeout_seconds
+    );
+
+    // Free relay URLs
+    for (int i = 0; i < relay_count; i++) {
+        free(relay_urls[i]);
+    }
+    free(relay_urls);
+    free(statuses);
+
+    if (!sub) {
+        printf("❌ Failed to create subscription\n");
+        cJSON_Delete(filter);
+        return;
+    }
+
+    // Store subscription
+    if (subscription_count >= subscription_capacity) {
+        subscription_capacity = subscription_capacity == 0 ? 10 : subscription_capacity * 2;
+        subscriptions = realloc(subscriptions, subscription_capacity * sizeof(nostr_pool_subscription_t*));
+    }
+    subscriptions[subscription_count++] = sub;
+
+    printf("✅ Subscription created (ID: %d)\n", subscription_count);
+
+    // Log the filter
+    char* filter_json = cJSON_Print(filter);
+    time_t now = time(NULL);
+    char timestamp[26];
+    ctime_r(&now, timestamp);
+    timestamp[24] = '\0';
+    dprintf(log_fd, "[%s] 🔍 New subscription created (ID: %d)\n", timestamp, subscription_count);
+    dprintf(log_fd, "Filter: %s\n\n", filter_json);
+    free(filter_json);
+}
+
+// Remove subscription
+void remove_subscription() {
+    if (subscription_count == 0) {
+        printf("❌ No subscriptions to remove\n");
+        return;
+    }
+
+    printf("\n--- Remove Subscription ---\n");
+    printf("Available subscriptions:\n");
+    for (int i = 0; i < subscription_count; i++) {
+        printf("%d. Subscription %d\n", i + 1, i + 1);
+    }
+
+    char* choice_input = get_input("Enter subscription number to remove", NULL);
+    if (!choice_input || strlen(choice_input) == 0) {
+        free(choice_input);
+        return;
+    }
+
+    int choice = atoi(choice_input) - 1;
+    free(choice_input);
+
+    if (choice < 0 || choice >= subscription_count) {
+        printf("❌ Invalid subscription number\n");
+        return;
+    }
+
+    nostr_pool_subscription_close(subscriptions[choice]);
+
+    // Shift remaining subscriptions
+    for (int i = choice; i < subscription_count - 1; i++) {
+        subscriptions[i] = subscriptions[i + 1];
+    }
+    subscription_count--;
+
+    printf("✅ Subscription removed\n");
+
+    time_t now = time(NULL);
+    char timestamp[26];
+    ctime_r(&now, timestamp);
+    timestamp[24] = '\0';
+    dprintf(log_fd, "[%s] 🗑️ Subscription removed (was ID: %d)\n\n", timestamp, choice + 1);
+}
+
+// Show pool status
+void show_pool_status() {
+    if (!pool) {
+        printf("❌ Pool not started\n");
+        return;
+    }
+
+    // Give polling thread time to establish connections
+    printf("⏳ Waiting for connections to establish...\n");
+    sleep(3);
+
+    char** relay_urls = NULL;
+    nostr_pool_relay_status_t* statuses = NULL;
+    int relay_count = nostr_relay_pool_list_relays(pool, &relay_urls, &statuses);
+
+    printf("\n📊 POOL STATUS\n");
+    printf("Relays: %d\n", relay_count);
+    printf("Subscriptions: %d\n", subscription_count);
+
+    if (relay_count > 0) {
+        printf("\nRelay Details:\n");
+        for (int i = 0; i < relay_count; i++) {
+            const char* status_str;
+            switch (statuses[i]) {
+                case NOSTR_POOL_RELAY_CONNECTED: status_str = "🟢 CONNECTED"; break;
+                case NOSTR_POOL_RELAY_CONNECTING: status_str = "🟡 CONNECTING"; break;
+                case NOSTR_POOL_RELAY_DISCONNECTED: status_str = "⚪ DISCONNECTED"; break;
+                case NOSTR_POOL_RELAY_ERROR: status_str = "🔴 ERROR"; break;
+                default: status_str = "❓ UNKNOWN"; break;
+            }
+
+            printf("├── %s: %s\n", relay_urls[i], status_str);
+
+            const nostr_relay_stats_t* stats = nostr_relay_pool_get_relay_stats(pool, relay_urls[i]);
+            if (stats) {
+                printf("│   ├── Events received: %d\n", stats->events_received);
+                printf("│   ├── Connection attempts: %d\n", stats->connection_attempts);
+                printf("│   ├── Connection failures: %d\n", stats->connection_failures);
+                printf("│   ├── Ping latency: %.2f ms\n", stats->ping_latency_current);
+                printf("│   └── Query latency: %.2f ms\n", stats->query_latency_avg);
+            }
+
+            free(relay_urls[i]);
+        }
+        free(relay_urls);
+        free(statuses);
+    }
+    printf("\n");
+}
+
+int main() {
+    // Setup logging to file
+    log_fd = open("pool.log", O_WRONLY | O_CREAT | O_TRUNC, 0644);
+    if (log_fd == -1) {
+        fprintf(stderr, "❌ Failed to open pool.log for writing\n");
+        return 1;
+    }
+
+    // Initialize NOSTR library
+    if (nostr_init() != NOSTR_SUCCESS) {
+        fprintf(stderr, "❌ Failed to initialize NOSTR library\n");
+        close(log_fd);
+        return 1;
+    }
+
+    // Setup signal handler
+    signal(SIGINT, signal_handler);
+    signal(SIGTERM, signal_handler);
+
+    // Start polling thread
+    if (pthread_create(&poll_thread, NULL, poll_thread_func, NULL) != 0) {
+        fprintf(stderr, "❌ Failed to create polling thread\n");
+        nostr_cleanup();
+        close(log_fd);
+        return 1;
+    }
+
+    printf("🔗 NOSTR Relay Pool Interactive Test\n");
+    printf("=====================================\n");
+    printf("All event output is logged to pool.log\n");
+    printf("Press Ctrl+C to exit\n\n");
+
+    time_t now = time(NULL);
+    char timestamp[26];
+    ctime_r(&now, timestamp);
+    timestamp[24] = '\0';
+    dprintf(log_fd, "[%s] 🚀 Pool test started\n\n", timestamp);
+
+    // Main menu loop
+    while (running) {
+        print_menu();
+
+        char choice;
+        if (scanf("%c", &choice) != 1) {
+            break;
+        }
+
+        // Consume newline
+        int c;
+        while ((c = getchar()) != '\n' && c != EOF);
+
+        switch (choice) {
+            case '1': { // Start Pool
+                if (pool) {
+                    printf("❌ Pool already started\n");
+                    break;
+                }
+
+                // Create pool with custom reconnection configuration for faster testing
+                nostr_pool_reconnect_config_t config = *nostr_pool_reconnect_config_default();
+                config.ping_interval_seconds = 5; // Ping every 5 seconds for testing
+                pool = nostr_relay_pool_create(&config);
+                if (!pool) {
+                    printf("❌ Failed to create pool\n");
+                    break;
+                }
+
+                if (nostr_relay_pool_add_relay(pool, "wss://relay.laantungir.net") != NOSTR_SUCCESS) {
+                    printf("❌ Failed to add default relay\n");
+                    nostr_relay_pool_destroy(pool);
+                    pool = NULL;
+                    break;
+                }
+
+                printf("✅ Pool started with wss://relay.laantungir.net\n");
+
+                now = time(NULL);
+                ctime_r(&now, timestamp);
+                timestamp[24] = '\0';
+                dprintf(log_fd, "[%s] 🏊 Pool started with default relay\n\n", timestamp);
+                break;
+            }
+
+            case '2': { // Stop Pool
+                if (!pool) {
+                    printf("❌ Pool not started\n");
+                    break;
+                }
+
+                // Close all subscriptions
+                for (int i = 0; i < subscription_count; i++) {
+                    if (subscriptions[i]) {
+                        nostr_pool_subscription_close(subscriptions[i]);
+                    }
+                }
+                free(subscriptions);
+                subscriptions = NULL;
+                subscription_count = 0;
+                subscription_capacity = 0;
+
+                nostr_relay_pool_destroy(pool);
+                pool = NULL;
+
+                printf("✅ Pool stopped\n");
+
+                now = time(NULL);
+                ctime_r(&now, timestamp);
+                timestamp[24] = '\0';
+                dprintf(log_fd, "[%s] 🛑 Pool stopped\n\n", timestamp);
+                break;
+            }
+
+            case '3': { // Add relay
+                if (!pool) {
+                    printf("❌ Pool not started\n");
+                    break;
+                }
+
+                char* url = get_input("Enter relay URL", "wss://relay.example.com");
+                if (url && strlen(url) > 0) {
+                    if (nostr_relay_pool_add_relay(pool, url) == NOSTR_SUCCESS) {
+                        printf("✅ Relay added: %s\n", url);
+
+                        now = time(NULL);
+                        ctime_r(&now, timestamp);
+                        timestamp[24] = '\0';
+                        dprintf(log_fd, "[%s] ➕ Relay added: %s\n\n", timestamp, url);
+                    } else {
+                        printf("❌ Failed to add relay\n");
+                    }
+                }
+                free(url);
+                break;
+            }
+
+            case '4': { // Remove relay
+                if (!pool) {
+                    printf("❌ Pool not started\n");
+                    break;
+                }
+
+                char* url = get_input("Enter relay URL to remove", NULL);
+                if (url && strlen(url) > 0) {
+                    if (nostr_relay_pool_remove_relay(pool, url) == NOSTR_SUCCESS) {
+                        printf("✅ Relay removed: %s\n", url);
+
+                        now = time(NULL);
+                        ctime_r(&now, timestamp);
+                        timestamp[24] = '\0';
+                        dprintf(log_fd, "[%s] ➖ Relay removed: %s\n\n", timestamp, url);
+                    } else {
+                        printf("❌ Failed to remove relay\n");
+                    }
+                }
+                free(url);
+                break;
+            }
+
+            case '5': // Add subscription
+                add_subscription();
+                break;
+
+            case '6': // Remove subscription
+                remove_subscription();
+                break;
+
+            case '7': // Show status
+                show_pool_status();
+                break;
+
+            case '8': { // Test reconnection
+                if (!pool) {
+                    printf("❌ Pool not started\n");
+                    break;
+                }
+
+                char** relay_urls = NULL;
+                nostr_pool_relay_status_t* statuses = NULL;
+                int relay_count = nostr_relay_pool_list_relays(pool, &relay_urls, &statuses);
+
+                if (relay_count <= 0) {
+                    printf("❌ No relays in pool\n");
+                    break;
+                }
+
+                printf("\n--- Test Reconnection ---\n");
+                printf("Available relays:\n");
+                for (int i = 0; i < relay_count; i++) {
+                    printf("%d. %s (%s)\n", i + 1, relay_urls[i],
+                           statuses[i] == NOSTR_POOL_RELAY_CONNECTED ? "CONNECTED" : "NOT CONNECTED");
+                }
+
+                char* choice_input = get_input("Enter relay number to test reconnection with", NULL);
+                if (!choice_input || strlen(choice_input) == 0) {
+                    for (int i = 0; i < relay_count; i++) free(relay_urls[i]);
+                    free(relay_urls);
+                    free(statuses);
+                    free(choice_input);
+                    break;
+                }
+
+                int choice = atoi(choice_input) - 1;
+                free(choice_input);
+
+                if (choice < 0 || choice >= relay_count) {
+                    printf("❌ Invalid relay number\n");
+                    for (int i = 0; i < relay_count; i++) free(relay_urls[i]);
+                    free(relay_urls);
+                    free(statuses);
+                    break;
+                }
+
+                printf("🔄 Testing reconnection with %s...\n", relay_urls[choice]);
+                printf("   The pool is configured with automatic reconnection enabled.\n");
+                printf("   If the connection drops, it will automatically attempt to reconnect\n");
+                printf("   with exponential backoff (1s → 2s → 4s → 8s → 16s → 30s max).\n");
+                printf("   Connection health is monitored with ping/pong every 30 seconds.\n");
+
+                time_t now = time(NULL);
+                char timestamp[26];
+                ctime_r(&now, timestamp);
+                timestamp[24] = '\0';
+                dprintf(log_fd, "[%s] 🔄 TEST: Testing reconnection behavior with %s\n", timestamp, relay_urls[choice]);
+                dprintf(log_fd, "   Pool configured with: auto-reconnect=ON, max_attempts=10, ping_interval=30s\n\n");
+
+                printf("✅ Reconnection test initiated. Monitor the status and logs for reconnection activity.\n");
+
+                for (int i = 0; i < relay_count; i++) free(relay_urls[i]);
+                free(relay_urls);
+                free(statuses);
+                break;
+            }
+
+            case '9': // Exit
+                running = 0;
+                break;
+
+            default:
+                printf("❌ Invalid choice\n");
+                break;
+        }
+    }
+
+    printf("\n🧹 Cleaning up...\n");
+
+    // Stop polling thread
+    running = 0;
+    pthread_join(poll_thread, NULL);
+
+    // Clean up pool and subscriptions
+    if (pool) {
+        for (int i = 0; i < subscription_count; i++) {
+            if (subscriptions[i]) {
+                nostr_pool_subscription_close(subscriptions[i]);
+            }
+        }
+        free(subscriptions);
+        nostr_relay_pool_destroy(pool);
+        printf("✅ Pool destroyed\n");
+    }
+
+    // Cleanup
+    nostr_cleanup();
+    close(log_fd);
+
+    printf("👋 Test completed\n");
+    return 0;
+}

examples/send_nip17_dm.c

@@ -0,0 +1,242 @@
+/*
+ * NIP-17 Private Direct Messages - Command Line Application
+ *
+ * This example demonstrates how to send NIP-17 private direct messages
+ * using the Nostr Core Library.
+ *
+ * Usage:
+ *   ./send_nip17_dm <recipient_pubkey> <message> [sender_nsec]
+ *
+ * Arguments:
+ *   recipient_pubkey: The npub or hex public key of the recipient
+ *   message: The message to send
+ *   sender_nsec: (optional) The nsec private key to use for sending.
+ *                If not provided, uses a default test key.
+ *
+ * Example:
+ *   ./send_nip17_dm npub1example... "Hello from NIP-17!" nsec1test...
+ */
+
+#define _GNU_SOURCE
+#define _POSIX_C_SOURCE 200809L
+
+#include "../nostr_core/nostr_core.h"
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <unistd.h>
+
+// Default test private key (for demonstration - DO NOT USE IN PRODUCTION)
+#define DEFAULT_SENDER_NSEC "nsec12kgt0dv2k2safv6s32w8f89z9uw27e68hjaa0d66c5xvk70ezpwqncd045"
+
+// Default relay for sending DMs
+#define DEFAULT_RELAY "wss://relay.laantungir.net"
+
+// Progress callback for publishing
+void publish_progress_callback(const char* relay_url, const char* status,
+                              const char* message, int success_count,
+                              int total_relays, int completed_relays, void* user_data) {
+    (void)user_data;
+
+    if (relay_url) {
+        printf("📡 [%s]: %s", relay_url, status);
+        if (message) {
+            printf(" - %s", message);
+        }
+        printf(" (%d/%d completed, %d successful)\n", completed_relays, total_relays, success_count);
+    } else {
+        printf("📡 PUBLISH COMPLETE: %d/%d successful\n", success_count, total_relays);
+    }
+}
+
+/**
+ * Convert npub to hex if needed
+ */
+int convert_pubkey_to_hex(const char* input_pubkey, char* output_hex) {
+    // Check if it's already hex (64 characters)
+    if (strlen(input_pubkey) == 64) {
+        // Assume it's already hex
+        strcpy(output_hex, input_pubkey);
+        return 0;
+    }
+
+    // Check if it's an npub (starts with "npub1")
+    if (strncmp(input_pubkey, "npub1", 5) == 0) {
+        // Convert npub to hex
+        unsigned char pubkey_bytes[32];
+        if (nostr_decode_npub(input_pubkey, pubkey_bytes) != 0) {
+            fprintf(stderr, "Error: Invalid npub format\n");
+            return -1;
+        }
+        nostr_bytes_to_hex(pubkey_bytes, 32, output_hex);
+        return 0;
+    }
+
+    fprintf(stderr, "Error: Public key must be 64-character hex or valid npub\n");
+    return -1;
+}
+
+/**
+ * Convert nsec to private key bytes if needed
+ */
+int convert_nsec_to_private_key(const char* input_nsec, unsigned char* private_key) {
+    // Check if it's already hex (64 characters)
+    if (strlen(input_nsec) == 64) {
+        // Convert hex to bytes
+        if (nostr_hex_to_bytes(input_nsec, private_key, 32) != 0) {
+            fprintf(stderr, "Error: Invalid hex private key\n");
+            return -1;
+        }
+        return 0;
+    }
+
+    // Check if it's an nsec (starts with "nsec1")
+    if (strncmp(input_nsec, "nsec1", 5) == 0) {
+        // Convert nsec directly to private key bytes
+        if (nostr_decode_nsec(input_nsec, private_key) != 0) {
+            fprintf(stderr, "Error: Invalid nsec format\n");
+            return -1;
+        }
+        return 0;
+    }
+
+    fprintf(stderr, "Error: Private key must be 64-character hex or valid nsec\n");
+    return -1;
+}
+
+/**
+ * Main function
+ */
+int main(int argc, char* argv[]) {
+    if (argc < 3 || argc > 4) {
+        fprintf(stderr, "Usage: %s <recipient_pubkey> <message> [sender_nsec]\n\n", argv[0]);
+        fprintf(stderr, "Arguments:\n");
+        fprintf(stderr, "  recipient_pubkey: npub or hex public key of recipient\n");
+        fprintf(stderr, "  message: The message to send\n");
+        fprintf(stderr, "  sender_nsec: (optional) nsec private key. Uses test key if not provided.\n\n");
+        fprintf(stderr, "Example:\n");
+        fprintf(stderr, "  %s npub1example... \"Hello!\" nsec1test...\n", argv[0]);
+        return 1;
+    }
+
+    const char* recipient_pubkey_input = argv[1];
+    const char* message = argv[2];
+    const char* sender_nsec_input = (argc >= 4) ? argv[3] : DEFAULT_SENDER_NSEC;
+
+    printf("🧪 NIP-17 Private Direct Message Sender\n");
+    printf("======================================\n\n");
+
+    // Initialize crypto
+    if (nostr_init() != NOSTR_SUCCESS) {
+        fprintf(stderr, "Failed to initialize crypto\n");
+        return 1;
+    }
+
+    // Convert recipient pubkey
+    char recipient_pubkey_hex[65];
+    if (convert_pubkey_to_hex(recipient_pubkey_input, recipient_pubkey_hex) != 0) {
+        return 1;
+    }
+
+    // Convert sender private key
+    unsigned char sender_privkey[32];
+    if (convert_nsec_to_private_key(sender_nsec_input, sender_privkey) != 0) {
+        return 1;
+    }
+
+    // Derive sender public key for display
+    unsigned char sender_pubkey_bytes[32];
+    char sender_pubkey_hex[65];
+    if (nostr_ec_public_key_from_private_key(sender_privkey, sender_pubkey_bytes) != 0) {
+        fprintf(stderr, "Failed to derive sender public key\n");
+        return 1;
+    }
+    nostr_bytes_to_hex(sender_pubkey_bytes, 32, sender_pubkey_hex);
+
+    printf("📤 Sender: %s\n", sender_pubkey_hex);
+    printf("📥 Recipient: %s\n", recipient_pubkey_hex);
+    printf("💬 Message: %s\n", message);
+    printf("🌐 Relay: %s\n\n", DEFAULT_RELAY);
+
+    // Create DM event
+    printf("💬 Creating DM event...\n");
+    const char* recipient_pubkeys[] = {recipient_pubkey_hex};
+    cJSON* dm_event = nostr_nip17_create_chat_event(
+        message,
+        recipient_pubkeys,
+        1,
+        "NIP-17 CLI",  // subject
+        NULL,          // no reply
+        DEFAULT_RELAY, // relay hint
+        sender_pubkey_hex
+    );
+
+    if (!dm_event) {
+        fprintf(stderr, "Failed to create DM event\n");
+        return 1;
+    }
+
+    printf("✅ Created DM event (kind 14)\n");
+
+    // Send DM (create gift wraps)
+    printf("🎁 Creating gift wraps...\n");
+    cJSON* gift_wraps[10];  // Max 10 gift wraps
+    int gift_wrap_count = nostr_nip17_send_dm(
+        dm_event,
+        recipient_pubkeys,
+        1,
+        sender_privkey,
+        gift_wraps,
+        10
+    );
+
+    cJSON_Delete(dm_event);  // Original DM event no longer needed
+
+    if (gift_wrap_count <= 0) {
+        fprintf(stderr, "Failed to create gift wraps\n");
+        return 1;
+    }
+
+    printf("✅ Created %d gift wrap(s)\n", gift_wrap_count);
+
+    // Publish the gift wrap to relay
+    printf("\n📤 Publishing gift wrap to relay...\n");
+
+    const char* relay_urls[] = {DEFAULT_RELAY};
+    int success_count = 0;
+    publish_result_t* publish_results = synchronous_publish_event_with_progress(
+        relay_urls,
+        1,  // single relay
+        gift_wraps[0],  // Send the first gift wrap
+        &success_count,
+        10,  // 10 second timeout
+        publish_progress_callback,
+        NULL,  // no user data
+        0,     // NIP-42 disabled
+        NULL   // no private key for auth
+    );
+
+    if (!publish_results || success_count != 1) {
+        fprintf(stderr, "\n❌ Failed to publish gift wrap (success_count: %d)\n", success_count);
+        // Clean up gift wraps
+        for (int i = 0; i < gift_wrap_count; i++) {
+            cJSON_Delete(gift_wraps[i]);
+        }
+        if (publish_results) free(publish_results);
+        return 1;
+    }
+
+    printf("\n✅ Successfully published NIP-17 DM!\n");
+
+    // Clean up
+    free(publish_results);
+    for (int i = 0; i < gift_wrap_count; i++) {
+        cJSON_Delete(gift_wraps[i]);
+    }
+
+    nostr_cleanup();
+
+    printf("\n🎉 DM sent successfully! The recipient can now decrypt it using their private key.\n");
+
+    return 0;
+}

increment_and_push.sh

@@ -0,0 +1,151 @@
+#!/bin/bash
+
+# increment_and_push.sh - Version increment and git automation script
+# Usage: ./increment_and_push.sh "meaningful git comment"
+
+set -e  # Exit on error
+
+# Color constants
+RED='\033[31m'
+GREEN='\033[32m'
+YELLOW='\033[33m'
+BLUE='\033[34m'
+BOLD='\033[1m'
+RESET='\033[0m'
+
+# Function to print output with colors
+print_info() {
+    if [ "$USE_COLORS" = true ]; then
+        echo -e "${BLUE}[INFO]${RESET} $1"
+    else
+        echo "[INFO] $1"
+    fi
+}
+
+print_success() {
+    if [ "$USE_COLORS" = true ]; then
+        echo -e "${GREEN}${BOLD}[SUCCESS]${RESET} $1"
+    else
+        echo "[SUCCESS] $1"
+    fi
+}
+
+print_warning() {
+    if [ "$USE_COLORS" = true ]; then
+        echo -e "${YELLOW}[WARNING]${RESET} $1"
+    else
+        echo "[WARNING] $1"
+    fi
+}
+
+print_error() {
+    if [ "$USE_COLORS" = true ]; then
+        echo -e "${RED}${BOLD}[ERROR]${RESET} $1"
+    else
+        echo "[ERROR] $1"
+    fi
+}
+
+# Check if we're in the correct directory
+CURRENT_DIR=$(basename "$(pwd)")
+if [ "$CURRENT_DIR" != "nostr_core_lib" ]; then
+    print_error "Script must be run from the nostr_core_lib directory"
+    echo ""
+    echo "Current directory: $CURRENT_DIR"
+    echo "Expected directory: nostr_core_lib"
+    echo ""
+    echo "Please change to the nostr_core_lib directory first."
+    echo ""
+    exit 1
+fi
+
+# Check if git repository exists
+if ! git rev-parse --git-dir > /dev/null 2>&1; then
+    print_error "Not a git repository. Please initialize git first."
+    exit 1
+fi
+
+# Check if we have a commit message
+if [ $# -eq 0 ]; then
+    print_error "Usage: $0 \"meaningful git comment\""
+    echo ""
+    echo "Example: $0 \"Add enhanced subscription functionality\""
+    echo ""
+    exit 1
+fi
+
+COMMIT_MESSAGE="$1"
+
+# Check if nostr_core.h exists
+if [ ! -f "nostr_core/nostr_core.h" ]; then
+    print_error "nostr_core/nostr_core.h not found"
+    exit 1
+fi
+
+print_info "Starting version increment and push process..."
+
+# Extract current version from nostr_core.h
+CURRENT_VERSION=$(grep '#define VERSION ' nostr_core/nostr_core.h | cut -d'"' -f2)
+if [ -z "$CURRENT_VERSION" ]; then
+    print_error "Could not find VERSION define in nostr_core.h"
+    exit 1
+fi
+
+# Extract version components
+VERSION_MAJOR=$(grep '#define VERSION_MAJOR ' nostr_core/nostr_core.h | awk '{print $3}')
+VERSION_MINOR=$(grep '#define VERSION_MINOR ' nostr_core/nostr_core.h | awk '{print $3}')
+VERSION_PATCH=$(grep '#define VERSION_PATCH ' nostr_core/nostr_core.h | awk '{print $3}')
+
+if [ -z "$VERSION_MAJOR" ] || [ -z "$VERSION_MINOR" ] || [ -z "$VERSION_PATCH" ]; then
+    print_error "Could not extract version components from nostr_core.h"
+    exit 1
+fi
+
+print_info "Current version: $CURRENT_VERSION (Major: $VERSION_MAJOR, Minor: $VERSION_MINOR, Patch: $VERSION_PATCH)"
+
+# Increment patch version
+NEW_PATCH=$((VERSION_PATCH + 1))
+NEW_VERSION="v$VERSION_MAJOR.$VERSION_MINOR.$NEW_PATCH"
+
+print_info "New version will be: $NEW_VERSION"
+
+# Update version in nostr_core.h
+sed -i "s/#define VERSION .*/#define VERSION \"$NEW_VERSION\"/" nostr_core/nostr_core.h
+sed -i "s/#define VERSION_PATCH .*/#define VERSION_PATCH $NEW_PATCH/" nostr_core/nostr_core.h
+
+print_success "Updated version in nostr_core.h"
+
+# Check if VERSION file exists and update it
+if [ -f "VERSION" ]; then
+    echo "$VERSION_MAJOR.$VERSION_MINOR.$NEW_PATCH" > VERSION
+    print_success "Updated VERSION file"
+fi
+
+# Check git status
+if ! git diff --quiet; then
+    print_info "Adding changes to git..."
+    git add .
+
+    print_info "Committing changes..."
+    git commit -m "$COMMIT_MESSAGE"
+
+    print_success "Changes committed"
+else
+    print_warning "No changes to commit"
+fi
+
+# Create and push git tag
+print_info "Creating git tag: $NEW_VERSION"
+git tag "$NEW_VERSION"
+
+print_info "Pushing commits and tags..."
+CURRENT_BRANCH=$(git branch --show-current)
+git push origin "$CURRENT_BRANCH"
+git push origin "$NEW_VERSION"
+
+print_success "Version $NEW_VERSION successfully released!"
+print_info "Git commit: $COMMIT_MESSAGE"
+print_info "Tag: $NEW_VERSION"
+
+echo ""
+echo "🎉 Release complete! Version $NEW_VERSION is now live."

nostr_core/core_relays.c

@@ -13,7 +13,7 @@
 #define _GNU_SOURCE
 #define _POSIX_C_SOURCE 200809L
 
-#include "nostr_common.h"
+#include "nostr_core.h"
 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>
@@ -26,6 +26,9 @@
 // cJSON for JSON handling
 #include "../cjson/cJSON.h"
 
+// NIP-42 Authentication
+#include "nip042.h"
+
 // =============================================================================
 // TYPE DEFINITIONS FOR SYNCHRONOUS RELAY QUERIES
 // =============================================================================
@@ -51,6 +54,12 @@ typedef struct {
     cJSON** events;              // Array of events from this relay
     int events_capacity;         // Allocated capacity
     char subscription_id[32];    // Unique subscription ID
+
+    // NIP-42 Authentication fields
+    nostr_auth_state_t auth_state;           // Current authentication state
+    char auth_challenge[NOSTR_NIP42_MAX_CHALLENGE_LENGTH]; // Stored challenge
+    time_t auth_challenge_time;              // When challenge was received
+    int nip42_enabled;                       // Whether NIP-42 is enabled for this relay
 } relay_connection_t;
 
 
@@ -65,7 +74,9 @@ cJSON** synchronous_query_relays_with_progress(
     int* result_count,
     int relay_timeout_seconds,
     relay_progress_callback_t callback,
-    void* user_data) {
+    void* user_data,
+    int nip42_enabled,
+    const unsigned char* private_key) {
     
     if (!relay_urls || relay_count <= 0 || !filter || !result_count) {
         if (result_count) *result_count = 0;
@@ -95,11 +106,17 @@ cJSON** synchronous_query_relays_with_progress(
         relays[i].last_activity = start_time;
         relays[i].events_capacity = 10;
         relays[i].events = malloc(relays[i].events_capacity * sizeof(cJSON*));
-        
+
+        // Initialize NIP-42 authentication fields
+        relays[i].auth_state = NOSTR_AUTH_STATE_NONE;
+        memset(relays[i].auth_challenge, 0, sizeof(relays[i].auth_challenge));
+        relays[i].auth_challenge_time = 0;
+        relays[i].nip42_enabled = nip42_enabled;
+
         // Generate unique subscription ID
-        snprintf(relays[i].subscription_id, sizeof(relays[i].subscription_id), 
+        snprintf(relays[i].subscription_id, sizeof(relays[i].subscription_id),
                  "sync_%d_%ld", i, start_time);
-        
+
         if (callback) {
             callback(relays[i].url, "connecting", NULL, 0, relay_count, 0, user_data);
         }
@@ -191,19 +208,50 @@ cJSON** synchronous_query_relays_with_progress(
                 cJSON* parsed = NULL;
                 if (nostr_parse_relay_message(buffer, &msg_type, &parsed) == 0) {
                     
-                    if (msg_type && strcmp(msg_type, "EVENT") == 0) {
+                    if (msg_type && strcmp(msg_type, "AUTH") == 0) {
+                        // Handle AUTH challenge message: ["AUTH", <challenge-string>]
+                        if (relay->nip42_enabled && private_key && cJSON_IsArray(parsed) && cJSON_GetArraySize(parsed) >= 2) {
+                            cJSON* challenge_json = cJSON_GetArrayItem(parsed, 1);
+                            if (cJSON_IsString(challenge_json)) {
+                                const char* challenge = cJSON_GetStringValue(challenge_json);
+
+                                // Store challenge and attempt authentication
+                                strncpy(relay->auth_challenge, challenge, sizeof(relay->auth_challenge) - 1);
+                                relay->auth_challenge[sizeof(relay->auth_challenge) - 1] = '\0';
+                                relay->auth_challenge_time = time(NULL);
+                                relay->auth_state = NOSTR_AUTH_STATE_CHALLENGE_RECEIVED;
+
+                                // Create and send authentication event
+                                cJSON* auth_event = nostr_nip42_create_auth_event(challenge, relay->url, private_key, 0);
+                                if (auth_event) {
+                                    char* auth_message = nostr_nip42_create_auth_message(auth_event);
+                                    if (auth_message) {
+                                        if (nostr_ws_send_text(relay->client, auth_message) >= 0) {
+                                            relay->auth_state = NOSTR_AUTH_STATE_AUTHENTICATING;
+                                            if (callback) {
+                                                callback(relay->url, "authenticating", NULL, 0, relay_count, completed_relays, user_data);
+                                            }
+                                        }
+                                        free(auth_message);
+                                    }
+                                    cJSON_Delete(auth_event);
+                                }
+                            }
+                        }
+
+                    } else if (msg_type && strcmp(msg_type, "EVENT") == 0) {
                         // Handle EVENT message
                         if (cJSON_IsArray(parsed) && cJSON_GetArraySize(parsed) >= 3) {
                             cJSON* sub_id_json = cJSON_GetArrayItem(parsed, 1);
                             cJSON* event = cJSON_GetArrayItem(parsed, 2);
-                            
+
                             if (cJSON_IsString(sub_id_json) && event &&
                                 strcmp(cJSON_GetStringValue(sub_id_json), relay->subscription_id) == 0) {
-                                
+
                                 cJSON* event_id_json = cJSON_GetObjectItem(event, "id");
                                 if (event_id_json && cJSON_IsString(event_id_json)) {
                                     const char* event_id = cJSON_GetStringValue(event_id_json);
-                                    
+
                                     // Check for duplicate
                                     int is_duplicate = 0;
                                     for (int j = 0; j < seen_count; j++) {
@@ -212,31 +260,31 @@ cJSON** synchronous_query_relays_with_progress(
                                             break;
                                         }
                                     }
-                                    
+
                                     if (!is_duplicate && seen_count < 1000) {
                                         // New event - add to seen list
                                         strncpy(seen_event_ids[seen_count], event_id, 64);
                                         seen_event_ids[seen_count][64] = '\0';
                                         seen_count++;
                                         total_unique_events++;
-                                        
+
                                         // Store event in relay's array
                                         if (relay->events_received >= relay->events_capacity) {
                                             relay->events_capacity *= 2;
-                                            relay->events = realloc(relay->events, 
+                                            relay->events = realloc(relay->events,
                                                 relay->events_capacity * sizeof(cJSON*));
                                         }
-                                        
+
                                         relay->events[relay->events_received] = cJSON_Duplicate(event, 1);
                                         relay->events_received++;
                                         relay->state = RELAY_STATE_ACTIVE;
-                                        
+
                                         if (callback) {
-                                            callback(relay->url, "event_found", event_id, 
-                                                    relay->events_received, relay_count, 
+                                            callback(relay->url, "event_found", event_id,
+                                                    relay->events_received, relay_count,
                                                     completed_relays, user_data);
                                         }
-                                        
+
                                         // For FIRST_RESULT mode, return immediately
                                         if (mode == RELAY_QUERY_FIRST_RESULT) {
                                             result_array = malloc(sizeof(cJSON*));
@@ -244,7 +292,7 @@ cJSON** synchronous_query_relays_with_progress(
                                                 result_array[0] = cJSON_Duplicate(event, 1);
                                                 *result_count = 1;
                                                 if (callback) {
-                                                    callback(NULL, "first_result", event_id, 
+                                                    callback(NULL, "first_result", event_id,
                                                             1, relay_count, completed_relays, user_data);
                                                 }
                                             }
@@ -254,7 +302,7 @@ cJSON** synchronous_query_relays_with_progress(
                                 }
                             }
                         }
-                        
+
                     } else if (msg_type && strcmp(msg_type, "EOSE") == 0) {
                         // Handle End of Stored Events
                         cJSON* sub_id_json = cJSON_GetArrayItem(parsed, 1);
@@ -400,7 +448,9 @@ publish_result_t* synchronous_publish_event_with_progress(
     int* success_count,
     int relay_timeout_seconds,
     publish_progress_callback_t callback,
-    void* user_data) {
+    void* user_data,
+    int nip42_enabled,
+    const unsigned char* private_key) {
     
     if (!relay_urls || relay_count <= 0 || !event || !success_count) {
         if (success_count) *success_count = 0;
@@ -443,7 +493,13 @@ publish_result_t* synchronous_publish_event_with_progress(
         relays[i].state = RELAY_STATE_CONNECTING;
         relays[i].last_activity = start_time;
         results[i] = PUBLISH_ERROR; // Default to error
-        
+
+        // Initialize NIP-42 authentication fields
+        relays[i].auth_state = NOSTR_AUTH_STATE_NONE;
+        memset(relays[i].auth_challenge, 0, sizeof(relays[i].auth_challenge));
+        relays[i].auth_challenge_time = 0;
+        relays[i].nip42_enabled = nip42_enabled;
+
         if (callback) {
             callback(relays[i].url, "connecting", NULL, 0, relay_count, 0, user_data);
         }
@@ -535,34 +591,65 @@ publish_result_t* synchronous_publish_event_with_progress(
                 char* msg_type = NULL;
                 cJSON* parsed = NULL;
                 if (nostr_parse_relay_message(buffer, &msg_type, &parsed) == 0) {
-                    
-                    if (msg_type && strcmp(msg_type, "OK") == 0) {
+
+                    if (msg_type && strcmp(msg_type, "AUTH") == 0) {
+                        // Handle AUTH challenge message: ["AUTH", <challenge-string>]
+                        if (relay->nip42_enabled && private_key && cJSON_IsArray(parsed) && cJSON_GetArraySize(parsed) >= 2) {
+                            cJSON* challenge_json = cJSON_GetArrayItem(parsed, 1);
+                            if (cJSON_IsString(challenge_json)) {
+                                const char* challenge = cJSON_GetStringValue(challenge_json);
+
+                                // Store challenge and attempt authentication
+                                strncpy(relay->auth_challenge, challenge, sizeof(relay->auth_challenge) - 1);
+                                relay->auth_challenge[sizeof(relay->auth_challenge) - 1] = '\0';
+                                relay->auth_challenge_time = time(NULL);
+                                relay->auth_state = NOSTR_AUTH_STATE_CHALLENGE_RECEIVED;
+
+                                // Create and send authentication event
+                                cJSON* auth_event = nostr_nip42_create_auth_event(challenge, relay->url, private_key, 0);
+                                if (auth_event) {
+                                    char* auth_message = nostr_nip42_create_auth_message(auth_event);
+                                    if (auth_message) {
+                                        if (nostr_ws_send_text(relay->client, auth_message) >= 0) {
+                                            relay->auth_state = NOSTR_AUTH_STATE_AUTHENTICATING;
+                                            if (callback) {
+                                                callback(relay->url, "authenticating", NULL, 0, relay_count, completed_relays, user_data);
+                                            }
+                                        }
+                                        free(auth_message);
+                                    }
+                                    cJSON_Delete(auth_event);
+                                }
+                            }
+                        }
+
+                    } else if (msg_type && strcmp(msg_type, "OK") == 0) {
                         // Handle OK message: ["OK", <event_id>, <true|false>, <message>]
                         if (cJSON_IsArray(parsed) && cJSON_GetArraySize(parsed) >= 3) {
                             cJSON* ok_event_id = cJSON_GetArrayItem(parsed, 1);
                             cJSON* accepted = cJSON_GetArrayItem(parsed, 2);
                             cJSON* message = cJSON_GetArrayItem(parsed, 3);
-                            
+
                             // Verify this OK is for our event
                             if (ok_event_id && cJSON_IsString(ok_event_id) && event_id &&
                                 strcmp(cJSON_GetStringValue(ok_event_id), event_id) == 0) {
-                                
+
                                 relay->state = RELAY_STATE_EOSE_RECEIVED; // Reuse for "completed"
                                 active_relays--;
                                 completed_relays++;
-                                
+
                                 const char* ok_message = "";
                                 if (message && cJSON_IsString(message)) {
                                     ok_message = cJSON_GetStringValue(message);
                                 }
-                                
+
                                 if (accepted && cJSON_IsBool(accepted) && cJSON_IsTrue(accepted)) {
                                     // Event accepted
                                     results[i] = PUBLISH_SUCCESS;
                                     (*success_count)++;
                                     
                                     if (callback) {
-                                        callback(relay->url, "accepted", ok_message, 
+                                        callback(relay->url, "accepted", ok_message,
                                                 *success_count, relay_count, completed_relays, user_data);
                                     }
                                 } else {
@@ -570,11 +657,11 @@ publish_result_t* synchronous_publish_event_with_progress(
                                     results[i] = PUBLISH_REJECTED;
                                     
                                     if (callback) {
-                                        callback(relay->url, "rejected", ok_message, 
+                                        callback(relay->url, "rejected", ok_message,
                                                 *success_count, relay_count, completed_relays, user_data);
                                     }
                                 }
-                                
+
                                 // Close connection
                                 nostr_ws_close(relay->client);
                                 relay->client = NULL;

nostr_core/nip017.c

@@ -0,0 +1,406 @@
+/*
+ * NIP-17: Private Direct Messages Implementation
+ * https://github.com/nostr-protocol/nips/blob/master/17.md
+ */
+
+#define _GNU_SOURCE
+#include "nip017.h"
+#include "nip059.h"
+#include "nip001.h"
+#include "utils.h"
+#include "nostr_common.h"
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <time.h>
+
+// Forward declarations for crypto functions
+int nostr_ec_public_key_from_private_key(const unsigned char* private_key, unsigned char* public_key);
+
+/**
+ * Create tags array for DM events
+ */
+static cJSON* create_dm_tags(const char** recipient_pubkeys,
+                           int num_recipients,
+                           const char* subject,
+                           const char* reply_to_event_id,
+                           const char* reply_relay_url) {
+    cJSON* tags = cJSON_CreateArray();
+    if (!tags) return NULL;
+
+    // Add "p" tags for each recipient
+    for (int i = 0; i < num_recipients; i++) {
+        cJSON* p_tag = cJSON_CreateArray();
+        if (!p_tag) {
+            cJSON_Delete(tags);
+            return NULL;
+        }
+        cJSON_AddItemToArray(p_tag, cJSON_CreateString("p"));
+        cJSON_AddItemToArray(p_tag, cJSON_CreateString(recipient_pubkeys[i]));
+        // Add relay URL if provided (recommended)
+        if (reply_relay_url) {
+            cJSON_AddItemToArray(p_tag, cJSON_CreateString(reply_relay_url));
+        }
+        cJSON_AddItemToArray(tags, p_tag);
+    }
+
+    // Add subject tag if provided
+    if (subject && strlen(subject) > 0) {
+        cJSON* subject_tag = cJSON_CreateArray();
+        if (!subject_tag) {
+            cJSON_Delete(tags);
+            return NULL;
+        }
+        cJSON_AddItemToArray(subject_tag, cJSON_CreateString("subject"));
+        cJSON_AddItemToArray(subject_tag, cJSON_CreateString(subject));
+        cJSON_AddItemToArray(tags, subject_tag);
+    }
+
+    // Add reply reference if provided
+    if (reply_to_event_id && strlen(reply_to_event_id) > 0) {
+        cJSON* e_tag = cJSON_CreateArray();
+        if (!e_tag) {
+            cJSON_Delete(tags);
+            return NULL;
+        }
+        cJSON_AddItemToArray(e_tag, cJSON_CreateString("e"));
+        cJSON_AddItemToArray(e_tag, cJSON_CreateString(reply_to_event_id));
+        if (reply_relay_url) {
+            cJSON_AddItemToArray(e_tag, cJSON_CreateString(reply_relay_url));
+        }
+        // For replies, add "reply" marker as per NIP-17
+        cJSON_AddItemToArray(e_tag, cJSON_CreateString("reply"));
+        cJSON_AddItemToArray(tags, e_tag);
+    }
+
+    return tags;
+}
+
+/**
+ * NIP-17: Create a chat message event (kind 14)
+ */
+cJSON* nostr_nip17_create_chat_event(const char* message,
+                                    const char** recipient_pubkeys,
+                                    int num_recipients,
+                                    const char* subject,
+                                    const char* reply_to_event_id,
+                                    const char* reply_relay_url,
+                                    const char* sender_pubkey_hex) {
+    if (!message || !recipient_pubkeys || num_recipients <= 0 || !sender_pubkey_hex) {
+        return NULL;
+    }
+
+    // Create tags
+    cJSON* tags = create_dm_tags(recipient_pubkeys, num_recipients, subject,
+                               reply_to_event_id, reply_relay_url);
+    if (!tags) {
+        return NULL;
+    }
+
+    // Create the chat rumor (kind 14, unsigned)
+    cJSON* chat_event = nostr_nip59_create_rumor(14, message, tags, sender_pubkey_hex, 0);
+
+    cJSON_Delete(tags); // Tags are duplicated in create_rumor
+
+    return chat_event;
+}
+
+/**
+ * NIP-17: Create a file message event (kind 15)
+ */
+cJSON* nostr_nip17_create_file_event(const char* file_url,
+                                   const char* file_type,
+                                   const char* encryption_algorithm,
+                                   const char* decryption_key,
+                                   const char* decryption_nonce,
+                                   const char* file_hash,
+                                   const char* original_file_hash,
+                                   size_t file_size,
+                                   const char* dimensions,
+                                   const char* blurhash,
+                                   const char* thumbnail_url,
+                                   const char** recipient_pubkeys,
+                                   int num_recipients,
+                                   const char* subject,
+                                   const char* reply_to_event_id,
+                                   const char* reply_relay_url,
+                                   const char* sender_pubkey_hex) {
+    if (!file_url || !file_type || !encryption_algorithm || !decryption_key ||
+        !decryption_nonce || !file_hash || !recipient_pubkeys ||
+        num_recipients <= 0 || !sender_pubkey_hex) {
+        return NULL;
+    }
+
+    // Create base tags
+    cJSON* tags = create_dm_tags(recipient_pubkeys, num_recipients, subject,
+                               reply_to_event_id, reply_relay_url);
+    if (!tags) {
+        return NULL;
+    }
+
+    // Add file-specific tags
+    cJSON* file_type_tag = cJSON_CreateArray();
+    cJSON_AddItemToArray(file_type_tag, cJSON_CreateString("file-type"));
+    cJSON_AddItemToArray(file_type_tag, cJSON_CreateString(file_type));
+    cJSON_AddItemToArray(tags, file_type_tag);
+
+    cJSON* encryption_tag = cJSON_CreateArray();
+    cJSON_AddItemToArray(encryption_tag, cJSON_CreateString("encryption-algorithm"));
+    cJSON_AddItemToArray(encryption_tag, cJSON_CreateString(encryption_algorithm));
+    cJSON_AddItemToArray(tags, encryption_tag);
+
+    cJSON* key_tag = cJSON_CreateArray();
+    cJSON_AddItemToArray(key_tag, cJSON_CreateString("decryption-key"));
+    cJSON_AddItemToArray(key_tag, cJSON_CreateString(decryption_key));
+    cJSON_AddItemToArray(tags, key_tag);
+
+    cJSON* nonce_tag = cJSON_CreateArray();
+    cJSON_AddItemToArray(nonce_tag, cJSON_CreateString("decryption-nonce"));
+    cJSON_AddItemToArray(nonce_tag, cJSON_CreateString(decryption_nonce));
+    cJSON_AddItemToArray(tags, nonce_tag);
+
+    cJSON* x_tag = cJSON_CreateArray();
+    cJSON_AddItemToArray(x_tag, cJSON_CreateString("x"));
+    cJSON_AddItemToArray(x_tag, cJSON_CreateString(file_hash));
+    cJSON_AddItemToArray(tags, x_tag);
+
+    // Optional tags
+    if (original_file_hash && strlen(original_file_hash) > 0) {
+        cJSON* ox_tag = cJSON_CreateArray();
+        cJSON_AddItemToArray(ox_tag, cJSON_CreateString("ox"));
+        cJSON_AddItemToArray(ox_tag, cJSON_CreateString(original_file_hash));
+        cJSON_AddItemToArray(tags, ox_tag);
+    }
+
+    if (file_size > 0) {
+        char size_str[32];
+        snprintf(size_str, sizeof(size_str), "%zu", file_size);
+        cJSON* size_tag = cJSON_CreateArray();
+        cJSON_AddItemToArray(size_tag, cJSON_CreateString("size"));
+        cJSON_AddItemToArray(size_tag, cJSON_CreateString(size_str));
+        cJSON_AddItemToArray(tags, size_tag);
+    }
+
+    if (dimensions && strlen(dimensions) > 0) {
+        cJSON* dim_tag = cJSON_CreateArray();
+        cJSON_AddItemToArray(dim_tag, cJSON_CreateString("dim"));
+        cJSON_AddItemToArray(dim_tag, cJSON_CreateString(dimensions));
+        cJSON_AddItemToArray(tags, dim_tag);
+    }
+
+    if (blurhash && strlen(blurhash) > 0) {
+        cJSON* blurhash_tag = cJSON_CreateArray();
+        cJSON_AddItemToArray(blurhash_tag, cJSON_CreateString("blurhash"));
+        cJSON_AddItemToArray(blurhash_tag, cJSON_CreateString(blurhash));
+        cJSON_AddItemToArray(tags, blurhash_tag);
+    }
+
+    if (thumbnail_url && strlen(thumbnail_url) > 0) {
+        cJSON* thumb_tag = cJSON_CreateArray();
+        cJSON_AddItemToArray(thumb_tag, cJSON_CreateString("thumb"));
+        cJSON_AddItemToArray(thumb_tag, cJSON_CreateString(thumbnail_url));
+        cJSON_AddItemToArray(tags, thumb_tag);
+    }
+
+    // Create the file rumor (kind 15, unsigned)
+    cJSON* file_event = nostr_nip59_create_rumor(15, file_url, tags, sender_pubkey_hex, 0);
+
+    cJSON_Delete(tags); // Tags are duplicated in create_rumor
+
+    return file_event;
+}
+
+/**
+ * NIP-17: Create a relay list event (kind 10050)
+ */
+cJSON* nostr_nip17_create_relay_list_event(const char** relay_urls,
+                                         int num_relays,
+                                         const unsigned char* private_key) {
+    if (!relay_urls || num_relays <= 0 || !private_key) {
+        return NULL;
+    }
+
+    // Get public key
+    unsigned char public_key[32];
+    if (nostr_ec_public_key_from_private_key(private_key, public_key) != 0) {
+        return NULL;
+    }
+
+    char pubkey_hex[65];
+    nostr_bytes_to_hex(public_key, 32, pubkey_hex);
+
+    // Create tags with relay URLs
+    cJSON* tags = cJSON_CreateArray();
+    if (!tags) {
+        return NULL;
+    }
+
+    for (int i = 0; i < num_relays; i++) {
+        cJSON* relay_tag = cJSON_CreateArray();
+        if (!relay_tag) {
+            cJSON_Delete(tags);
+            return NULL;
+        }
+        cJSON_AddItemToArray(relay_tag, cJSON_CreateString("relay"));
+        cJSON_AddItemToArray(relay_tag, cJSON_CreateString(relay_urls[i]));
+        cJSON_AddItemToArray(tags, relay_tag);
+    }
+
+    // Create and sign the event
+    cJSON* relay_event = nostr_create_and_sign_event(10050, "", tags, private_key, time(NULL));
+
+    cJSON_Delete(tags); // Tags are duplicated in create_and_sign_event
+
+    return relay_event;
+}
+
+/**
+ * NIP-17: Send a direct message to recipients
+ */
+int nostr_nip17_send_dm(cJSON* dm_event,
+                       const char** recipient_pubkeys,
+                       int num_recipients,
+                       const unsigned char* sender_private_key,
+                       cJSON** gift_wraps_out,
+                       int max_gift_wraps) {
+    if (!dm_event || !recipient_pubkeys || num_recipients <= 0 ||
+        !sender_private_key || !gift_wraps_out || max_gift_wraps <= 0) {
+        return -1;
+    }
+
+    int created_wraps = 0;
+
+    for (int i = 0; i < num_recipients && created_wraps < max_gift_wraps; i++) {
+        // Convert recipient pubkey hex to bytes
+        unsigned char recipient_public_key[32];
+        if (nostr_hex_to_bytes(recipient_pubkeys[i], recipient_public_key, 32) != 0) {
+            continue; // Skip invalid pubkeys
+        }
+
+        // Create seal for this recipient
+        cJSON* seal = nostr_nip59_create_seal(dm_event, sender_private_key, recipient_public_key);
+        if (!seal) {
+            continue; // Skip if sealing fails
+        }
+
+        // Create gift wrap for this recipient
+        cJSON* gift_wrap = nostr_nip59_create_gift_wrap(seal, recipient_pubkeys[i]);
+        cJSON_Delete(seal); // Seal is now wrapped
+
+        if (!gift_wrap) {
+            continue; // Skip if wrapping fails
+        }
+
+        gift_wraps_out[created_wraps++] = gift_wrap;
+    }
+
+    // Also create a gift wrap for the sender (so they can see their own messages)
+    if (created_wraps < max_gift_wraps) {
+        // Get sender's public key
+        unsigned char sender_public_key[32];
+        if (nostr_ec_public_key_from_private_key(sender_private_key, sender_public_key) == 0) {
+            char sender_pubkey_hex[65];
+            nostr_bytes_to_hex(sender_public_key, 32, sender_pubkey_hex);
+
+            // Create seal for sender
+            cJSON* sender_seal = nostr_nip59_create_seal(dm_event, sender_private_key, sender_public_key);
+            if (sender_seal) {
+                // Create gift wrap for sender
+                cJSON* sender_gift_wrap = nostr_nip59_create_gift_wrap(sender_seal, sender_pubkey_hex);
+                cJSON_Delete(sender_seal);
+
+                if (sender_gift_wrap) {
+                    gift_wraps_out[created_wraps++] = sender_gift_wrap;
+                }
+            }
+        }
+    }
+
+    return created_wraps;
+}
+
+/**
+ * NIP-17: Receive and decrypt a direct message
+ */
+cJSON* nostr_nip17_receive_dm(cJSON* gift_wrap,
+                            const unsigned char* recipient_private_key) {
+    if (!gift_wrap || !recipient_private_key) {
+        return NULL;
+    }
+
+    // Unwrap the gift wrap to get the seal
+    cJSON* seal = nostr_nip59_unwrap_gift(gift_wrap, recipient_private_key);
+    if (!seal) {
+        return NULL;
+    }
+
+    // Get sender's public key from the seal
+    cJSON* seal_pubkey_item = cJSON_GetObjectItem(seal, "pubkey");
+    if (!seal_pubkey_item || !cJSON_IsString(seal_pubkey_item)) {
+        cJSON_Delete(seal);
+        return NULL;
+    }
+
+    const char* sender_pubkey_hex = cJSON_GetStringValue(seal_pubkey_item);
+
+    // Convert sender pubkey hex to bytes
+    unsigned char sender_public_key[32];
+    if (nostr_hex_to_bytes(sender_pubkey_hex, sender_public_key, 32) != 0) {
+        cJSON_Delete(seal);
+        return NULL;
+    }
+
+    // Unseal the rumor
+    cJSON* rumor = nostr_nip59_unseal_rumor(seal, sender_public_key, recipient_private_key);
+    cJSON_Delete(seal); // Seal is no longer needed
+
+    return rumor;
+}
+
+/**
+ * NIP-17: Extract DM relay URLs from a user's kind 10050 event
+ */
+int nostr_nip17_extract_dm_relays(cJSON* relay_list_event,
+                                char** relay_urls_out,
+                                int max_relays) {
+    if (!relay_list_event || !relay_urls_out || max_relays <= 0) {
+        return -1;
+    }
+
+    // Check if this is a kind 10050 event
+    cJSON* kind_item = cJSON_GetObjectItem(relay_list_event, "kind");
+    if (!kind_item || !cJSON_IsNumber(kind_item) || cJSON_GetNumberValue(kind_item) != 10050) {
+        return -1;
+    }
+
+    // Get tags array
+    cJSON* tags_item = cJSON_GetObjectItem(relay_list_event, "tags");
+    if (!tags_item || !cJSON_IsArray(tags_item)) {
+        return -1;
+    }
+
+    int extracted = 0;
+    cJSON* tag_item;
+    cJSON_ArrayForEach(tag_item, tags_item) {
+        if (!cJSON_IsArray(tag_item) || cJSON_GetArraySize(tag_item) < 2) {
+            continue;
+        }
+
+        // Check if this is a "relay" tag
+        cJSON* tag_name = cJSON_GetArrayItem(tag_item, 0);
+        cJSON* relay_url = cJSON_GetArrayItem(tag_item, 1);
+
+        if (cJSON_IsString(tag_name) && cJSON_IsString(relay_url) &&
+            strcmp(cJSON_GetStringValue(tag_name), "relay") == 0) {
+
+            if (extracted < max_relays) {
+                relay_urls_out[extracted] = strdup(cJSON_GetStringValue(relay_url));
+                if (relay_urls_out[extracted]) {
+                    extracted++;
+                }
+            }
+        }
+    }
+
+    return extracted;
+}

nostr_core/nip017.h

@@ -0,0 +1,137 @@
+/*
+ * NIP-17: Private Direct Messages
+ * https://github.com/nostr-protocol/nips/blob/master/17.md
+ */
+
+#ifndef NOSTR_NIP017_H
+#define NOSTR_NIP017_H
+
+#include <stddef.h>
+#include "../cjson/cJSON.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * NIP-17: Create a chat message event (kind 14)
+ *
+ * @param message Plain text message content
+ * @param recipient_pubkeys Array of recipient public keys (hex strings)
+ * @param num_recipients Number of recipients
+ * @param subject Optional conversation subject/title (can be NULL)
+ * @param reply_to_event_id Optional event ID this message replies to (can be NULL)
+ * @param reply_relay_url Optional relay URL for reply reference (can be NULL)
+ * @param sender_pubkey_hex Sender's public key in hex format
+ * @return cJSON object representing the unsigned chat event, or NULL on error
+ */
+cJSON* nostr_nip17_create_chat_event(const char* message,
+                                    const char** recipient_pubkeys,
+                                    int num_recipients,
+                                    const char* subject,
+                                    const char* reply_to_event_id,
+                                    const char* reply_relay_url,
+                                    const char* sender_pubkey_hex);
+
+/**
+ * NIP-17: Create a file message event (kind 15)
+ *
+ * @param file_url URL of the encrypted file
+ * @param file_type MIME type of the original file (e.g., "image/jpeg")
+ * @param encryption_algorithm Encryption algorithm used ("aes-gcm")
+ * @param decryption_key Base64-encoded decryption key
+ * @param decryption_nonce Base64-encoded decryption nonce
+ * @param file_hash SHA-256 hash of the encrypted file (hex)
+ * @param original_file_hash SHA-256 hash of the original file before encryption (hex, optional)
+ * @param file_size Size of encrypted file in bytes (optional, 0 to skip)
+ * @param dimensions Image dimensions in "WxH" format (optional, NULL to skip)
+ * @param blurhash Blurhash for preview (optional, NULL to skip)
+ * @param thumbnail_url URL of encrypted thumbnail (optional, NULL to skip)
+ * @param recipient_pubkeys Array of recipient public keys (hex strings)
+ * @param num_recipients Number of recipients
+ * @param subject Optional conversation subject/title (can be NULL)
+ * @param reply_to_event_id Optional event ID this message replies to (can be NULL)
+ * @param reply_relay_url Optional relay URL for reply reference (can be NULL)
+ * @param sender_pubkey_hex Sender's public key in hex format
+ * @return cJSON object representing the unsigned file event, or NULL on error
+ */
+cJSON* nostr_nip17_create_file_event(const char* file_url,
+                                   const char* file_type,
+                                   const char* encryption_algorithm,
+                                   const char* decryption_key,
+                                   const char* decryption_nonce,
+                                   const char* file_hash,
+                                   const char* original_file_hash,
+                                   size_t file_size,
+                                   const char* dimensions,
+                                   const char* blurhash,
+                                   const char* thumbnail_url,
+                                   const char** recipient_pubkeys,
+                                   int num_recipients,
+                                   const char* subject,
+                                   const char* reply_to_event_id,
+                                   const char* reply_relay_url,
+                                   const char* sender_pubkey_hex);
+
+/**
+ * NIP-17: Create a relay list event (kind 10050)
+ *
+ * @param relay_urls Array of relay URLs for DM delivery
+ * @param num_relays Number of relay URLs
+ * @param private_key Sender's private key for signing
+ * @return cJSON object representing the signed relay list event, or NULL on error
+ */
+cJSON* nostr_nip17_create_relay_list_event(const char** relay_urls,
+                                         int num_relays,
+                                         const unsigned char* private_key);
+
+/**
+ * NIP-17: Send a direct message to recipients
+ *
+ * This function creates the appropriate rumor, seals it, gift wraps it,
+ * and returns the final gift wrap events ready for publishing.
+ *
+ * @param dm_event The unsigned DM event (kind 14 or 15)
+ * @param recipient_pubkeys Array of recipient public keys (hex strings)
+ * @param num_recipients Number of recipients
+ * @param sender_private_key 32-byte sender private key
+ * @param gift_wraps_out Array to store resulting gift wrap events (caller must free)
+ * @param max_gift_wraps Maximum number of gift wraps to create
+ * @return Number of gift wrap events created, or -1 on error
+ */
+int nostr_nip17_send_dm(cJSON* dm_event,
+                       const char** recipient_pubkeys,
+                       int num_recipients,
+                       const unsigned char* sender_private_key,
+                       cJSON** gift_wraps_out,
+                       int max_gift_wraps);
+
+/**
+ * NIP-17: Receive and decrypt a direct message
+ *
+ * This function unwraps a gift wrap, unseals the rumor, and returns the original DM event.
+ *
+ * @param gift_wrap The received gift wrap event (kind 1059)
+ * @param recipient_private_key 32-byte recipient private key
+ * @return cJSON object representing the decrypted DM event, or NULL on error
+ */
+cJSON* nostr_nip17_receive_dm(cJSON* gift_wrap,
+                            const unsigned char* recipient_private_key);
+
+/**
+ * NIP-17: Extract DM relay URLs from a user's kind 10050 event
+ *
+ * @param relay_list_event The kind 10050 event
+ * @param relay_urls_out Array to store extracted relay URLs (caller must free)
+ * @param max_relays Maximum number of relays to extract
+ * @return Number of relay URLs extracted, or -1 on error
+ */
+int nostr_nip17_extract_dm_relays(cJSON* relay_list_event,
+                                char** relay_urls_out,
+                                int max_relays);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // NOSTR_NIP017_H

nostr_core/nip059.c

@@ -0,0 +1,406 @@
+/*
+ * NIP-59: Gift Wrap Implementation
+ * https://github.com/nostr-protocol/nips/blob/master/59.md
+ */
+
+#include "nip059.h"
+#include "nip044.h"
+#include "nip001.h"
+#include "utils.h"
+#include "nostr_common.h"
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <time.h>
+
+// Forward declarations for crypto functions
+int nostr_secp256k1_get_random_bytes(unsigned char* buf, size_t len);
+int nostr_ec_public_key_from_private_key(const unsigned char* private_key, unsigned char* public_key);
+int nostr_ec_sign(const unsigned char* private_key, const unsigned char* hash, unsigned char* signature);
+
+// Memory clearing utility
+static void memory_clear(const void *p, size_t len) {
+    if (p && len) {
+        memset((void *)p, 0, len);
+    }
+}
+
+/**
+ * Create a random timestamp within 2 days in the past (as per NIP-59 spec)
+ */
+static time_t random_past_timestamp(void) {
+    time_t now = time(NULL);
+    // Random time up to 2 days (172800 seconds) in the past
+    long random_offset = (long)(rand() % 172800);
+    return now - random_offset;
+}
+
+/**
+ * Generate a random private key for gift wrap
+ */
+static int generate_random_private_key(unsigned char* private_key) {
+    return nostr_secp256k1_get_random_bytes(private_key, 32);
+}
+
+/**
+ * Create event ID from event data (without signature)
+ */
+static int create_event_id(cJSON* event, char* event_id_hex) {
+    if (!event || !event_id_hex) {
+        return -1;
+    }
+
+    // Get event fields for serialization
+    cJSON* pubkey_item = cJSON_GetObjectItem(event, "pubkey");
+    cJSON* created_at_item = cJSON_GetObjectItem(event, "created_at");
+    cJSON* kind_item = cJSON_GetObjectItem(event, "kind");
+    cJSON* tags_item = cJSON_GetObjectItem(event, "tags");
+    cJSON* content_item = cJSON_GetObjectItem(event, "content");
+
+    if (!pubkey_item || !created_at_item || !kind_item || !tags_item || !content_item) {
+        return -1;
+    }
+
+    // Create serialization array: [0, pubkey, created_at, kind, tags, content]
+    cJSON* serialize_array = cJSON_CreateArray();
+    if (!serialize_array) {
+        return -1;
+    }
+
+    cJSON_AddItemToArray(serialize_array, cJSON_CreateNumber(0));
+    cJSON_AddItemToArray(serialize_array, cJSON_Duplicate(pubkey_item, 1));
+    cJSON_AddItemToArray(serialize_array, cJSON_Duplicate(created_at_item, 1));
+    cJSON_AddItemToArray(serialize_array, cJSON_Duplicate(kind_item, 1));
+    cJSON_AddItemToArray(serialize_array, cJSON_Duplicate(tags_item, 1));
+    cJSON_AddItemToArray(serialize_array, cJSON_Duplicate(content_item, 1));
+
+    char* serialize_string = cJSON_PrintUnformatted(serialize_array);
+    cJSON_Delete(serialize_array);
+
+    if (!serialize_string) {
+        return -1;
+    }
+
+    // Hash the serialized event
+    unsigned char event_hash[32];
+    if (nostr_sha256((const unsigned char*)serialize_string, strlen(serialize_string), event_hash) != 0) {
+        free(serialize_string);
+        return -1;
+    }
+
+    // Convert hash to hex
+    nostr_bytes_to_hex(event_hash, 32, event_id_hex);
+
+    free(serialize_string);
+    return 0;
+}
+
+/**
+ * NIP-59: Create a rumor (unsigned event)
+ */
+cJSON* nostr_nip59_create_rumor(int kind, const char* content, cJSON* tags,
+                               const char* pubkey_hex, time_t created_at) {
+    if (!pubkey_hex || !content) {
+        return NULL;
+    }
+
+    // Use provided timestamp or random past timestamp
+    time_t event_time = (created_at == 0) ? random_past_timestamp() : created_at;
+
+    // Create event structure (without id and sig - that's what makes it a rumor)
+    cJSON* rumor = cJSON_CreateObject();
+    if (!rumor) {
+        return NULL;
+    }
+
+    cJSON_AddStringToObject(rumor, "pubkey", pubkey_hex);
+    cJSON_AddNumberToObject(rumor, "created_at", (double)event_time);
+    cJSON_AddNumberToObject(rumor, "kind", kind);
+
+    // Add tags (copy provided tags or create empty array)
+    if (tags) {
+        cJSON_AddItemToObject(rumor, "tags", cJSON_Duplicate(tags, 1));
+    } else {
+        cJSON_AddItemToObject(rumor, "tags", cJSON_CreateArray());
+    }
+
+    cJSON_AddStringToObject(rumor, "content", content);
+
+    // Calculate and add event ID
+    char event_id[65];
+    if (create_event_id(rumor, event_id) != 0) {
+        cJSON_Delete(rumor);
+        return NULL;
+    }
+
+    cJSON_AddStringToObject(rumor, "id", event_id);
+
+    return rumor;
+}
+
+/**
+ * NIP-59: Create a seal (kind 13) wrapping a rumor
+ */
+cJSON* nostr_nip59_create_seal(cJSON* rumor, const unsigned char* sender_private_key,
+                              const unsigned char* recipient_public_key) {
+    if (!rumor || !sender_private_key || !recipient_public_key) {
+        return NULL;
+    }
+
+    // Serialize the rumor to JSON
+    char* rumor_json = cJSON_PrintUnformatted(rumor);
+    if (!rumor_json) {
+        return NULL;
+    }
+
+    // Encrypt the rumor using NIP-44
+    char encrypted_content[4096]; // Should be large enough for most events
+    int encrypt_result = nostr_nip44_encrypt(sender_private_key, recipient_public_key,
+                                           rumor_json, encrypted_content, sizeof(encrypted_content));
+    free(rumor_json);
+
+    if (encrypt_result != NOSTR_SUCCESS) {
+        return NULL;
+    }
+
+    // Get sender's public key
+    unsigned char sender_public_key[32];
+    if (nostr_ec_public_key_from_private_key(sender_private_key, sender_public_key) != 0) {
+        return NULL;
+    }
+
+    char sender_pubkey_hex[65];
+    nostr_bytes_to_hex(sender_public_key, 32, sender_pubkey_hex);
+
+    // Create seal event (kind 13)
+    cJSON* seal = cJSON_CreateObject();
+    if (!seal) {
+        return NULL;
+    }
+
+    time_t seal_time = random_past_timestamp();
+
+    cJSON_AddStringToObject(seal, "pubkey", sender_pubkey_hex);
+    cJSON_AddNumberToObject(seal, "created_at", (double)seal_time);
+    cJSON_AddNumberToObject(seal, "kind", 13);
+    cJSON_AddItemToObject(seal, "tags", cJSON_CreateArray()); // Empty tags array
+    cJSON_AddStringToObject(seal, "content", encrypted_content);
+
+    // Calculate event ID
+    char event_id[65];
+    if (create_event_id(seal, event_id) != 0) {
+        cJSON_Delete(seal);
+        return NULL;
+    }
+    cJSON_AddStringToObject(seal, "id", event_id);
+
+    // Sign the seal
+    unsigned char event_hash[32];
+    if (nostr_hex_to_bytes(event_id, event_hash, 32) != 0) {
+        cJSON_Delete(seal);
+        return NULL;
+    }
+
+    unsigned char signature[64];
+    if (nostr_ec_sign(sender_private_key, event_hash, signature) != 0) {
+        cJSON_Delete(seal);
+        return NULL;
+    }
+
+    char sig_hex[129];
+    nostr_bytes_to_hex(signature, 64, sig_hex);
+    cJSON_AddStringToObject(seal, "sig", sig_hex);
+
+    return seal;
+}
+
+/**
+ * NIP-59: Create a gift wrap (kind 1059) wrapping a seal
+ */
+cJSON* nostr_nip59_create_gift_wrap(cJSON* seal, const char* recipient_public_key_hex) {
+    if (!seal || !recipient_public_key_hex) {
+        return NULL;
+    }
+
+    // Serialize the seal to JSON
+    char* seal_json = cJSON_PrintUnformatted(seal);
+    if (!seal_json) {
+        return NULL;
+    }
+
+    // Generate random private key for gift wrap
+    unsigned char random_private_key[32];
+    if (generate_random_private_key(random_private_key) != 1) {
+        free(seal_json);
+        return NULL;
+    }
+
+    // Get random public key
+    unsigned char random_public_key[32];
+    if (nostr_ec_public_key_from_private_key(random_private_key, random_public_key) != 0) {
+        memory_clear(random_private_key, 32);
+        free(seal_json);
+        return NULL;
+    }
+
+    char random_pubkey_hex[65];
+    nostr_bytes_to_hex(random_public_key, 32, random_pubkey_hex);
+
+    // Convert recipient pubkey hex to bytes
+    unsigned char recipient_public_key[32];
+    if (nostr_hex_to_bytes(recipient_public_key_hex, recipient_public_key, 32) != 0) {
+        memory_clear(random_private_key, 32);
+        free(seal_json);
+        return NULL;
+    }
+
+    // Encrypt the seal using NIP-44
+    char encrypted_content[8192]; // Larger buffer for nested encryption
+    int encrypt_result = nostr_nip44_encrypt(random_private_key, recipient_public_key,
+                                           seal_json, encrypted_content, sizeof(encrypted_content));
+    free(seal_json);
+
+    if (encrypt_result != NOSTR_SUCCESS) {
+        memory_clear(random_private_key, 32);
+        return NULL;
+    }
+
+    // Create gift wrap event (kind 1059)
+    cJSON* gift_wrap = cJSON_CreateObject();
+    if (!gift_wrap) {
+        memory_clear(random_private_key, 32);
+        return NULL;
+    }
+
+    time_t wrap_time = random_past_timestamp();
+
+    cJSON_AddStringToObject(gift_wrap, "pubkey", random_pubkey_hex);
+    cJSON_AddNumberToObject(gift_wrap, "created_at", (double)wrap_time);
+    cJSON_AddNumberToObject(gift_wrap, "kind", 1059);
+
+    // Add p tag for recipient
+    cJSON* tags = cJSON_CreateArray();
+    cJSON* p_tag = cJSON_CreateArray();
+    cJSON_AddItemToArray(p_tag, cJSON_CreateString("p"));
+    cJSON_AddItemToArray(p_tag, cJSON_CreateString(recipient_public_key_hex));
+    cJSON_AddItemToArray(tags, p_tag);
+    cJSON_AddItemToObject(gift_wrap, "tags", tags);
+
+    cJSON_AddStringToObject(gift_wrap, "content", encrypted_content);
+
+    // Calculate event ID
+    char event_id[65];
+    if (create_event_id(gift_wrap, event_id) != 0) {
+        memory_clear(random_private_key, 32);
+        cJSON_Delete(gift_wrap);
+        return NULL;
+    }
+    cJSON_AddStringToObject(gift_wrap, "id", event_id);
+
+    // Sign the gift wrap
+    unsigned char event_hash[32];
+    if (nostr_hex_to_bytes(event_id, event_hash, 32) != 0) {
+        memory_clear(random_private_key, 32);
+        cJSON_Delete(gift_wrap);
+        return NULL;
+    }
+
+    unsigned char signature[64];
+    if (nostr_ec_sign(random_private_key, event_hash, signature) != 0) {
+        memory_clear(random_private_key, 32);
+        cJSON_Delete(gift_wrap);
+        return NULL;
+    }
+
+    char sig_hex[129];
+    nostr_bytes_to_hex(signature, 64, sig_hex);
+    cJSON_AddStringToObject(gift_wrap, "sig", sig_hex);
+
+    // Clear the random private key from memory
+    memory_clear(random_private_key, 32);
+
+    return gift_wrap;
+}
+
+/**
+ * NIP-59: Unwrap a gift wrap to get the seal
+ */
+cJSON* nostr_nip59_unwrap_gift(cJSON* gift_wrap, const unsigned char* recipient_private_key) {
+    if (!gift_wrap || !recipient_private_key) {
+        return NULL;
+    }
+
+    // Get the encrypted content
+    cJSON* content_item = cJSON_GetObjectItem(gift_wrap, "content");
+    if (!content_item || !cJSON_IsString(content_item)) {
+        return NULL;
+    }
+
+    const char* encrypted_content = cJSON_GetStringValue(content_item);
+
+    // Get the sender's public key (gift wrap pubkey)
+    cJSON* pubkey_item = cJSON_GetObjectItem(gift_wrap, "pubkey");
+    if (!pubkey_item || !cJSON_IsString(pubkey_item)) {
+        return NULL;
+    }
+
+    const char* sender_pubkey_hex = cJSON_GetStringValue(pubkey_item);
+
+    // Convert sender pubkey hex to bytes
+    unsigned char sender_public_key[32];
+    if (nostr_hex_to_bytes(sender_pubkey_hex, sender_public_key, 32) != 0) {
+        return NULL;
+    }
+
+    // Decrypt the content using NIP-44
+    char decrypted_json[8192];
+    int decrypt_result = nostr_nip44_decrypt(recipient_private_key, sender_public_key,
+                                           encrypted_content, decrypted_json, sizeof(decrypted_json));
+
+    if (decrypt_result != NOSTR_SUCCESS) {
+        return NULL;
+    }
+
+    // Parse the decrypted JSON as the seal event
+    cJSON* seal = cJSON_Parse(decrypted_json);
+    if (!seal) {
+        return NULL;
+    }
+
+    return seal;
+}
+
+/**
+ * NIP-59: Unseal a seal to get the rumor
+ */
+cJSON* nostr_nip59_unseal_rumor(cJSON* seal, const unsigned char* sender_public_key,
+                               const unsigned char* recipient_private_key) {
+    if (!seal || !sender_public_key || !recipient_private_key) {
+        return NULL;
+    }
+
+    // Get the encrypted content
+    cJSON* content_item = cJSON_GetObjectItem(seal, "content");
+    if (!content_item || !cJSON_IsString(content_item)) {
+        return NULL;
+    }
+
+    const char* encrypted_content = cJSON_GetStringValue(content_item);
+
+    // Decrypt the content using NIP-44
+    char decrypted_json[4096];
+    int decrypt_result = nostr_nip44_decrypt(recipient_private_key, sender_public_key,
+                                           encrypted_content, decrypted_json, sizeof(decrypted_json));
+
+    if (decrypt_result != NOSTR_SUCCESS) {
+        return NULL;
+    }
+
+    // Parse the decrypted JSON as the rumor event
+    cJSON* rumor = cJSON_Parse(decrypted_json);
+    if (!rumor) {
+        return NULL;
+    }
+
+    return rumor;
+}

nostr_core/nip059.h

@@ -0,0 +1,74 @@
+/*
+ * NIP-59: Gift Wrap
+ * https://github.com/nostr-protocol/nips/blob/master/59.md
+ */
+
+#ifndef NOSTR_NIP059_H
+#define NOSTR_NIP059_H
+
+#include <stddef.h>
+#include <time.h>
+#include "../cjson/cJSON.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * NIP-59: Create a rumor (unsigned event)
+ *
+ * @param kind Event kind
+ * @param content Event content
+ * @param tags Event tags (cJSON array, can be NULL)
+ * @param pubkey_hex Sender's public key in hex format
+ * @param created_at Event timestamp (0 for current time)
+ * @return cJSON object representing the rumor, or NULL on error
+ */
+cJSON* nostr_nip59_create_rumor(int kind, const char* content, cJSON* tags,
+                               const char* pubkey_hex, time_t created_at);
+
+/**
+ * NIP-59: Create a seal (kind 13) wrapping a rumor
+ *
+ * @param rumor The rumor event to seal (cJSON object)
+ * @param sender_private_key 32-byte sender private key
+ * @param recipient_public_key 32-byte recipient public key (x-only)
+ * @return cJSON object representing the seal event, or NULL on error
+ */
+cJSON* nostr_nip59_create_seal(cJSON* rumor, const unsigned char* sender_private_key,
+                              const unsigned char* recipient_public_key);
+
+/**
+ * NIP-59: Create a gift wrap (kind 1059) wrapping a seal
+ *
+ * @param seal The seal event to wrap (cJSON object)
+ * @param recipient_public_key_hex Recipient's public key in hex format
+ * @return cJSON object representing the gift wrap event, or NULL on error
+ */
+cJSON* nostr_nip59_create_gift_wrap(cJSON* seal, const char* recipient_public_key_hex);
+
+/**
+ * NIP-59: Unwrap a gift wrap to get the seal
+ *
+ * @param gift_wrap The gift wrap event (cJSON object)
+ * @param recipient_private_key 32-byte recipient private key
+ * @return cJSON object representing the seal event, or NULL on error
+ */
+cJSON* nostr_nip59_unwrap_gift(cJSON* gift_wrap, const unsigned char* recipient_private_key);
+
+/**
+ * NIP-59: Unseal a seal to get the rumor
+ *
+ * @param seal The seal event (cJSON object)
+ * @param sender_public_key 32-byte sender public key (x-only)
+ * @param recipient_private_key 32-byte recipient private key
+ * @return cJSON object representing the rumor event, or NULL on error
+ */
+cJSON* nostr_nip59_unseal_rumor(cJSON* seal, const unsigned char* sender_public_key,
+                               const unsigned char* recipient_private_key);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // NOSTR_NIP059_H

nostr_core/nostr_common.h

@@ -81,66 +81,11 @@
 // Forward declaration for cJSON (to avoid requiring cJSON.h in header)
 struct cJSON;
 
-// Relay query modes
-typedef enum {
-    RELAY_QUERY_FIRST_RESULT,   // Return as soon as first event is received
-    RELAY_QUERY_MOST_RECENT,    // Return the most recent event from all relays
-    RELAY_QUERY_ALL_RESULTS     // Return all unique events from all relays
-} relay_query_mode_t;
-
-// Publish result types
-typedef enum {
-    PUBLISH_SUCCESS,    // Event was accepted by relay
-    PUBLISH_REJECTED,   // Event was rejected by relay  
-    PUBLISH_TIMEOUT,    // No response within timeout
-    PUBLISH_ERROR       // Connection or other error
-} publish_result_t;
-
-// Progress callback function types
-typedef void (*relay_progress_callback_t)(
-    const char* relay_url,
-    const char* status,
-    const char* event_id,
-    int events_received,
-    int total_relays,
-    int completed_relays,
-    void* user_data);
-
-typedef void (*publish_progress_callback_t)(
-    const char* relay_url,
-    const char* status,
-    const char* message,
-    int success_count,
-    int total_relays,
-    int completed_relays,
-    void* user_data);
-
 // Function declarations
 const char* nostr_strerror(int error_code);
 
-// Library initialization functions  
+// Library initialization functions
 int nostr_init(void);
 void nostr_cleanup(void);
 
-// Relay query functions
-struct cJSON** synchronous_query_relays_with_progress(
-    const char** relay_urls,
-    int relay_count,
-    struct cJSON* filter,
-    relay_query_mode_t mode,
-    int* result_count,
-    int relay_timeout_seconds,
-    relay_progress_callback_t callback,
-    void* user_data);
-
-// Relay publish functions  
-publish_result_t* synchronous_publish_event_with_progress(
-    const char** relay_urls,
-    int relay_count,
-    struct cJSON* event,
-    int* success_count,
-    int relay_timeout_seconds,
-    publish_progress_callback_t callback,
-    void* user_data);
-
 #endif // NOSTR_COMMON_H

nostr_core/nostr_core.h

@@ -1,6 +1,12 @@
 #ifndef NOSTR_CORE_H
 #define NOSTR_CORE_H
 
+// Version information (auto-updated by increment_and_push.sh)
+#define VERSION "v0.4.4"
+#define VERSION_MAJOR 0
+#define VERSION_MINOR 4
+#define VERSION_PATCH 4
+
 /*
  * NOSTR Core Library - Complete API Reference
  * 
@@ -43,6 +49,21 @@
  *   - nostr_nip44_encrypt_with_nonce()  -> Encrypt with specific nonce (testing)
  *   - nostr_nip44_decrypt()             -> Decrypt ChaCha20 + HMAC messages
  *
+ * NIP-59 GIFT WRAP:
+ *   - nostr_nip59_create_rumor()        -> Create unsigned event (rumor)
+ *   - nostr_nip59_create_seal()         -> Seal rumor with sender's key (kind 13)
+ *   - nostr_nip59_create_gift_wrap()    -> Wrap seal with random key (kind 1059)
+ *   - nostr_nip59_unwrap_gift()         -> Unwrap gift wrap to get seal
+ *   - nostr_nip59_unseal_rumor()        -> Unseal to get original rumor
+ *
+ * NIP-17 PRIVATE DIRECT MESSAGES:
+ *   - nostr_nip17_create_chat_event()   -> Create chat message (kind 14)
+ *   - nostr_nip17_create_file_event()   -> Create file message (kind 15)
+ *   - nostr_nip17_create_relay_list_event() -> Create DM relay list (kind 10050)
+ *   - nostr_nip17_send_dm()             -> Send DM to multiple recipients
+ *   - nostr_nip17_receive_dm()          -> Receive and decrypt DM
+ *   - nostr_nip17_extract_dm_relays()   -> Extract relay URLs from kind 10050
+ *
  * NIP-42 AUTHENTICATION:
  *   - nostr_nip42_create_auth_event()   -> Create authentication event (kind 22242)
  *   - nostr_nip42_verify_auth_event()   -> Verify authentication event (relay-side)
@@ -82,6 +103,15 @@
  *   - nostr_auth_rule_add()             -> Add authentication rule
  *   - nostr_auth_rule_remove()          -> Remove authentication rule
  *
+ * RELAY OPERATIONS:
+ *   - synchronous_query_relays_with_progress() -> One-off query from multiple relays
+ *   - synchronous_publish_event_with_progress() -> One-off publish to multiple relays
+ * *
+ * RELAY POOL OPERATIONS:
+ *   - nostr_relay_pool_create()         -> Create relay pool for persistent connections
+ *   - nostr_relay_pool_subscribe()      -> Subscribe to events with callbacks
+ *   - nostr_relay_pool_run()            -> Run event loop for receiving events
+
  * SYSTEM FUNCTIONS:
  *   - nostr_crypto_init()               -> Initialize crypto subsystem
  *   - nostr_crypto_cleanup()            -> Cleanup crypto subsystem
@@ -117,6 +147,16 @@
  *   cJSON* auth_event = nostr_nip42_create_auth_event(challenge, relay_url, private_key, 0);
  *   nostr_ws_authenticate(client, private_key, 600); // Auto-authenticate WebSocket
  *
+ * Private Direct Messages (NIP-17):
+ *   // Create and send a DM
+ *   cJSON* dm_event = nostr_nip17_create_chat_event("Hello!", &recipient_pubkey, 1, NULL, NULL, NULL, sender_pubkey);
+ *   cJSON* gift_wraps[10];
+ *   int count = nostr_nip17_send_dm(dm_event, &recipient_pubkey, 1, sender_privkey, gift_wraps, 10);
+ *   // Publish gift_wraps[0] to recipient's relays
+ *
+ *   // Receive a DM
+ *   cJSON* decrypted_dm = nostr_nip17_receive_dm(received_gift_wrap, recipient_privkey);
+ *
  * ============================================================================
  */
 
@@ -135,13 +175,208 @@ extern "C" {
 #include "nip006.h"  // Key derivation from mnemonic
 #include "nip011.h"  // Relay information document
 #include "nip013.h"  // Proof of Work
+#include "nip017.h"  // Private Direct Messages
 #include "nip019.h"  // Bech32 encoding (nsec/npub)
 #include "nip042.h"  // Authentication of clients to relays
 #include "nip044.h"  // Encryption (modern)
+#include "nip059.h"  // Gift Wrap
 
 // Authentication and request validation system
 #include "request_validator.h"  // Request validation and authentication rules
 
+// Relay pool types and functions
+typedef enum {
+    NOSTR_POOL_RELAY_DISCONNECTED = 0,
+    NOSTR_POOL_RELAY_CONNECTING = 1,
+    NOSTR_POOL_RELAY_CONNECTED = 2,
+    NOSTR_POOL_RELAY_ERROR = -1
+} nostr_pool_relay_status_t;
+
+// EOSE result mode for subscriptions
+typedef enum {
+    NOSTR_POOL_EOSE_FULL_SET,      // Wait for all relays, return all events
+    NOSTR_POOL_EOSE_MOST_RECENT,   // Wait for all relays, return most recent event
+    NOSTR_POOL_EOSE_FIRST          // Return results on first EOSE (fastest response)
+} nostr_pool_eose_result_mode_t;
+
+typedef struct {
+    int connection_attempts;
+    int connection_failures;
+    int events_received;
+    int events_published;
+    int events_published_ok;
+    int events_published_failed;
+    time_t last_event_time;
+    time_t connection_uptime_start;
+    double ping_latency_avg;
+    double ping_latency_min;
+    double ping_latency_max;
+    double ping_latency_current;
+    int ping_samples;
+    double query_latency_avg;
+    double query_latency_min;
+    double query_latency_max;
+    int query_samples;
+    double publish_latency_avg;
+    int publish_samples;
+} nostr_relay_stats_t;
+
+typedef struct nostr_relay_pool nostr_relay_pool_t;
+typedef struct nostr_pool_subscription nostr_pool_subscription_t;
+
+// Reconnection configuration
+typedef struct {
+    int enable_auto_reconnect;        // 1 = enable, 0 = disable
+    int max_reconnect_attempts;       // Max attempts per relay
+    int initial_reconnect_delay_ms;   // Initial delay between attempts
+    int max_reconnect_delay_ms;       // Max delay (cap exponential backoff)
+    int reconnect_backoff_multiplier; // Delay multiplier
+    int ping_interval_seconds;        // How often to ping (0 = disable)
+    int pong_timeout_seconds;         // How long to wait for pong before reconnecting
+} nostr_pool_reconnect_config_t;
+
+// Relay pool management functions
+nostr_relay_pool_t* nostr_relay_pool_create(nostr_pool_reconnect_config_t* config);
+nostr_pool_reconnect_config_t* nostr_pool_reconnect_config_default(void);
+int nostr_relay_pool_add_relay(nostr_relay_pool_t* pool, const char* relay_url);
+int nostr_relay_pool_remove_relay(nostr_relay_pool_t* pool, const char* relay_url);
+void nostr_relay_pool_destroy(nostr_relay_pool_t* pool);
+
+// Subscription management
+nostr_pool_subscription_t* nostr_relay_pool_subscribe(
+    nostr_relay_pool_t* pool,
+    const char** relay_urls,
+    int relay_count,
+    cJSON* filter,
+    void (*on_event)(cJSON* event, const char* relay_url, void* user_data),
+    void (*on_eose)(cJSON** events, int event_count, void* user_data),
+    void* user_data,
+    int close_on_eose,
+    int enable_deduplication,
+    nostr_pool_eose_result_mode_t result_mode,
+    int relay_timeout_seconds,
+    int eose_timeout_seconds);
+int nostr_pool_subscription_close(nostr_pool_subscription_t* subscription);
+
+// Backward compatibility wrapper
+nostr_pool_subscription_t* nostr_relay_pool_subscribe_compat(
+    nostr_relay_pool_t* pool,
+    const char** relay_urls,
+    int relay_count,
+    cJSON* filter,
+    void (*on_event)(cJSON* event, const char* relay_url, void* user_data),
+    void (*on_eose)(void* user_data),
+    void* user_data,
+    int close_on_eose);
+
+// Event loop functions
+int nostr_relay_pool_run(nostr_relay_pool_t* pool, int timeout_ms);
+int nostr_relay_pool_poll(nostr_relay_pool_t* pool, int timeout_ms);
+
+// Synchronous query/publish functions
+cJSON** nostr_relay_pool_query_sync(
+    nostr_relay_pool_t* pool,
+    const char** relay_urls,
+    int relay_count,
+    cJSON* filter,
+    int* event_count,
+    int timeout_ms);
+cJSON* nostr_relay_pool_get_event(
+    nostr_relay_pool_t* pool,
+    const char** relay_urls,
+    int relay_count,
+    cJSON* filter,
+    int timeout_ms);
+int nostr_relay_pool_publish(
+    nostr_relay_pool_t* pool,
+    const char** relay_urls,
+    int relay_count,
+    cJSON* event);
+
+// Status and statistics functions
+nostr_pool_relay_status_t nostr_relay_pool_get_relay_status(
+    nostr_relay_pool_t* pool,
+    const char* relay_url);
+int nostr_relay_pool_list_relays(
+    nostr_relay_pool_t* pool,
+    char*** relay_urls,
+    nostr_pool_relay_status_t** statuses);
+const nostr_relay_stats_t* nostr_relay_pool_get_relay_stats(
+    nostr_relay_pool_t* pool,
+    const char* relay_url);
+int nostr_relay_pool_reset_relay_stats(
+    nostr_relay_pool_t* pool,
+    const char* relay_url);
+double nostr_relay_pool_get_relay_query_latency(
+    nostr_relay_pool_t* pool,
+    const char* relay_url);
+const char* nostr_relay_pool_get_relay_last_publish_error(
+    nostr_relay_pool_t* pool,
+    const char* relay_url);
+const char* nostr_relay_pool_get_relay_last_connection_error(
+    nostr_relay_pool_t* pool,
+    const char* relay_url);
+double nostr_relay_pool_get_relay_ping_latency(
+    nostr_relay_pool_t* pool,
+    const char* relay_url);
+
+// Synchronous relay operations (one-off queries/publishes)
+typedef enum {
+    RELAY_QUERY_FIRST_RESULT,   // Return as soon as first event is received
+    RELAY_QUERY_MOST_RECENT,    // Return the most recent event from all relays
+    RELAY_QUERY_ALL_RESULTS     // Return all unique events from all relays
+} relay_query_mode_t;
+
+typedef enum {
+    PUBLISH_SUCCESS,    // Event was accepted by relay
+    PUBLISH_REJECTED,   // Event was rejected by relay
+    PUBLISH_TIMEOUT,    // No response within timeout
+    PUBLISH_ERROR       // Connection or other error
+} publish_result_t;
+
+typedef void (*relay_progress_callback_t)(
+    const char* relay_url,
+    const char* status,
+    const char* event_id,
+    int events_received,
+    int total_relays,
+    int completed_relays,
+    void* user_data);
+
+typedef void (*publish_progress_callback_t)(
+    const char* relay_url,
+    const char* status,
+    const char* message,
+    int success_count,
+    int total_relays,
+    int completed_relays,
+    void* user_data);
+
+// Synchronous relay query functions
+struct cJSON** synchronous_query_relays_with_progress(
+    const char** relay_urls,
+    int relay_count,
+    struct cJSON* filter,
+    relay_query_mode_t mode,
+    int* result_count,
+    int relay_timeout_seconds,
+    relay_progress_callback_t callback,
+    void* user_data,
+    int nip42_enabled,
+    const unsigned char* private_key);
+
+// Synchronous relay publish functions
+publish_result_t* synchronous_publish_event_with_progress(
+    const char** relay_urls,
+    int relay_count,
+    struct cJSON* event,
+    int* success_count,
+    int relay_timeout_seconds,
+    publish_progress_callback_t callback,
+    void* user_data,
+    int nip42_enabled,
+    const unsigned char* private_key);
+
 // Relay communication functions are defined in nostr_common.h
 // WebSocket functions are defined in nostr_common.h
 

nostr_core/request_validator.c

@@ -13,6 +13,7 @@
 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>
+#include <strings.h>
 #include <sqlite3.h>
 #include <time.h>
 
@@ -241,8 +242,10 @@ void nostr_request_validator_cleanup(void) {
 // CONVENIENCE FUNCTIONS
 //=============================================================================
 
-int nostr_auth_check_upload(const char* pubkey, const char* auth_header, 
+int nostr_auth_check_upload(const char* pubkey, const char* auth_header,
                            const char* hash, const char* mime_type, long file_size) {
+    (void)pubkey; // Parameter not used in this convenience function
+
     nostr_request_t request = {
         .operation = "upload",
         .auth_header = auth_header,
@@ -265,6 +268,8 @@ int nostr_auth_check_upload(const char* pubkey, const char* auth_header,
 }
 
 int nostr_auth_check_delete(const char* pubkey, const char* auth_header, const char* hash) {
+    (void)pubkey; // Parameter not used in this convenience function
+
     nostr_request_t request = {
         .operation = "delete",
         .auth_header = auth_header,
@@ -287,6 +292,8 @@ int nostr_auth_check_delete(const char* pubkey, const char* auth_header, const c
 }
 
 int nostr_auth_check_publish(const char* pubkey, struct cJSON* event) {
+    (void)pubkey; // Parameter not used in this convenience function
+
     if (!event) {
         return NOSTR_ERROR_INVALID_INPUT;
     }
@@ -459,6 +466,8 @@ static int validate_nostr_event(struct cJSON* event, const char* expected_hash,
 //=============================================================================
 
 static int sqlite_auth_init(const char* db_path, const char* app_name) {
+    (void)app_name; // Parameter not used in this implementation
+
     if (g_auth_db) {
         return NOSTR_SUCCESS; // Already initialized
     }
@@ -765,13 +774,15 @@ static int sqlite_auth_rule_update(const nostr_auth_rule_t* rule) {
 }
 
 static int sqlite_auth_rule_list(const char* operation, nostr_auth_rule_t** rules, int* count) {
+    (void)operation; // Parameter not used in this implementation
+
     if (!g_auth_db || !rules || !count) {
         return NOSTR_ERROR_INVALID_INPUT;
     }
-    
+
     *rules = NULL;
     *count = 0;
-    
+
     // For now, return empty list - would implement full rule listing
     return NOSTR_SUCCESS;
 }
@@ -1130,19 +1141,21 @@ static int evaluate_auth_rules(const char* pubkey, const char* operation, const
 static void generate_auth_cache_key(const char* pubkey, const char* operation, const char* hash,
                             const char* mime_type, long file_size, char* cache_key, size_t key_size) {
     char temp_buffer[1024];
-    snprintf(temp_buffer, sizeof(temp_buffer), "%s|%s|%s|%s|%ld",
-             pubkey ? pubkey : "", operation ? operation : "",
-             hash ? hash : "", mime_type ? mime_type : "", file_size);
-    
+    int written = snprintf(temp_buffer, sizeof(temp_buffer), "%s|%s|%s|%s|%ld",
+                          pubkey ? pubkey : "", operation ? operation : "",
+                          hash ? hash : "", mime_type ? mime_type : "", file_size);
+
     // Generate SHA-256 hash of the key components for consistent cache keys
     unsigned char hash_bytes[32];
-    if (nostr_sha256((unsigned char*)temp_buffer, strlen(temp_buffer), hash_bytes) == NOSTR_SUCCESS) {
+    size_t hash_len = (written >= 0 && (size_t)written < sizeof(temp_buffer)) ? (size_t)written : sizeof(temp_buffer) - 1;
+    if (nostr_sha256((unsigned char*)temp_buffer, hash_len, hash_bytes) == NOSTR_SUCCESS) {
         nostr_bytes_to_hex(hash_bytes, 32, cache_key);
         cache_key[64] = '\0';  // Ensure null termination
     } else {
-        // Fallback if hashing fails
-        strncpy(cache_key, temp_buffer, key_size - 1);
-        cache_key[key_size - 1] = '\0';
+        // Fallback if hashing fails - safely copy up to key_size - 1 characters
+        size_t copy_len = (written >= 0 && (size_t)written < key_size - 1) ? (size_t)written : key_size - 1;
+        memcpy(cache_key, temp_buffer, copy_len);
+        cache_key[copy_len] = '\0';
     }
 }
 
@@ -1179,6 +1192,8 @@ int nostr_auth_rule_list(const char* operation, nostr_auth_rule_t** rules, int*
 }
 
 void nostr_auth_rules_free(nostr_auth_rule_t* rules, int count) {
+    (void)count; // Parameter not used in this implementation
+
     if (rules) {
         free(rules);
     }
@@ -1200,6 +1215,8 @@ int nostr_auth_cache_stats(int* hit_count, int* miss_count, int* entries) {
 }
 
 int nostr_auth_register_db_backend(const nostr_auth_db_interface_t* backend) {
+    (void)backend; // Parameter not used in this implementation
+
     // For now, only SQLite backend is supported
     return NOSTR_ERROR_AUTH_RULES_BACKEND_NOT_FOUND;
 }

nostr_core_lib.code-workspace

@@ -0,0 +1,10 @@
+{
+	"folders": [
+		{
+			"path": "."
+		}
+	],
+	"settings": {
+		"git.ignoreLimitWarning": true
+	}
+}

nostr_websocket/nostr_websocket_openssl.c

@@ -131,7 +131,7 @@ static void init_openssl(void) {
 
 nostr_ws_client_t* nostr_ws_connect(const char* url) {
     if (!url) return NULL;
-    
+
     // Initialize OpenSSL
     init_openssl();
     
@@ -781,32 +781,35 @@ static int ws_perform_handshake(nostr_ws_client_t* client, const char* key) {
     // Read response
     char response[MAX_HEADER_SIZE];
     int total_received = 0;
-    
+
     while ((size_t)total_received < sizeof(response) - 1) {
-        int received = client->transport->recv(&client->transport_ctx, 
-                                             response + total_received, 
-                                             sizeof(response) - total_received - 1, 
-                                             client->timeout_ms);
+        int received = client->transport->recv(&client->transport_ctx,
+                                              response + total_received,
+                                              sizeof(response) - total_received - 1,
+                                              client->timeout_ms);
         if (received <= 0) {
             return -1;
         }
-        
+
         total_received += received;
         response[total_received] = '\0';
-        
+
         // Check if we have complete headers
-        if (strstr(response, "\r\n\r\n")) break;
+        if (strstr(response, "\r\n\r\n")) {
+            break;
+        }
     }
     
     // Check if response starts with the correct HTTP status line
     if (strncmp(response, "HTTP/1.1 101 Switching Protocols\r\n", 34) != 0) {
         return -1;
     }
-    
-    if (!strstr(response, "Upgrade: websocket") && !strstr(response, "upgrade: websocket")) {
+
+    if (!strstr(response, "Upgrade: websocket") && !strstr(response, "upgrade: websocket") &&
+        !strstr(response, "Upgrade: WebSocket") && !strstr(response, "upgrade: WebSocket")) {
         return -1;
     }
-    
+
     return 0;
 }
 

pool.log

@@ -0,0 +1,74 @@
+[Thu Oct  2 19:30:49 2025] 🚀 Pool test started
+
+[Thu Oct  2 19:30:52 2025] 🏊 Pool started with default relay
+
+[Thu Oct  2 19:31:05 2025] ➕ Relay added: ws://127.0.0.1:7777
+
+[Thu Oct  2 19:31:24 2025] 🔍 New subscription created (ID: 1)
+Filter: {
+	"kinds":	[15555],
+	"limit":	10
+}
+
+[Thu Oct  2 19:31:24 2025] 📨 EVENT from ws://127.0.0.1:7777
+├── ID: 9af94cf163a2...
+├── Pubkey: e568a76a4f88...
+├── Kind: 15555
+├── Created: 1759447876
+└── Content: 📊 Bitcoin Mempool Status
+
+Pending Transactions: 3,255
+Total Size: 1.82 MB
+Memory Usage: 3.4%
+A...
+
+[Thu Oct  2 19:31:24 2025] 📨 EVENT from wss://relay.laantungir.net
+├── ID: 93472348ded1...
+├── Pubkey: b3f282fe77f4...
+├── Kind: 15555
+├── Created: 1753542367
+└── Content: 📊 Bitcoin Mempool Status
+
+Pending Transactions: 9,882
+Total Size: 2.85 MB
+Memory Usage: 6.0%
+A...
+
+[Thu Oct  2 19:31:24 2025] 📋 EOSE received - 0 events collected
+
+[Thu Oct  2 19:31:26 2025] 📨 EVENT from ws://127.0.0.1:7777
+├── ID: 90336970f3cf...
+├── Pubkey: e568a76a4f88...
+├── Kind: 15555
+├── Created: 1759447886
+└── Content: 📊 Bitcoin Mempool Status
+
+Pending Transactions: 3,295
+Total Size: 1.83 MB
+Memory Usage: 3.4%
+A...
+
+[Thu Oct  2 19:32:06 2025] 📨 EVENT from ws://127.0.0.1:7777
+├── ID: 56e8e931f211...
+├── Pubkey: e568a76a4f88...
+├── Kind: 15555
+├── Created: 1759447926
+└── Content: 📊 Bitcoin Mempool Status
+
+Pending Transactions: 3,357
+Total Size: 1.91 MB
+Memory Usage: 3.5%
+A...
+
+[Thu Oct  2 19:32:16 2025] 📨 EVENT from ws://127.0.0.1:7777
+├── ID: 76682921a11b...
+├── Pubkey: e568a76a4f88...
+├── Kind: 15555
+├── Created: 1759447936
+└── Content: 📊 Bitcoin Mempool Status
+
+Pending Transactions: 3,363
+Total Size: 1.91 MB
+Memory Usage: 3.5%
+A...
+

tests/nip17_test.c

@@ -0,0 +1,341 @@
+/*
+ * NIP-17 Private Direct Messages Test Program
+ *
+ * Tests the complete NIP-17 DM flow using synchronous relay operations:
+ * 1. Generate sender and recipient keypairs
+ * 2. Create a DM from sender to recipient
+ * 3. Publish the gift-wrapped DM to relay
+ * 4. Subscribe to receive the DM back
+ * 5. Decrypt and verify the received DM
+ */
+
+#define _GNU_SOURCE
+#define _POSIX_C_SOURCE 200809L
+
+// Enable debug output to see all relay messages
+#define NOSTR_DEBUG_ENABLED
+
+#include "../nostr_core/nostr_core.h"
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <unistd.h>
+#include <time.h>
+
+// Forward declarations for crypto functions
+int nostr_secp256k1_get_random_bytes(unsigned char* buf, size_t len);
+
+// Test configuration
+#define RELAY_URL "wss://relay.laantungir.net"
+#define TEST_TIMEOUT_MS 5000
+
+// Progress callback for publishing
+void publish_progress_callback(const char* relay_url, const char* status,
+                              const char* message, int success_count,
+                              int total_relays, int completed_relays, void* user_data) {
+    (void)user_data;
+
+    if (relay_url) {
+        printf("📡 PUBLISH [%s]: %s", relay_url, status);
+        if (message) {
+            printf(" - %s", message);
+        }
+        printf(" (%d/%d completed, %d successful)\n", completed_relays, total_relays, success_count);
+    } else {
+        printf("📡 PUBLISH COMPLETE: %d/%d successful\n", success_count, total_relays);
+    }
+}
+
+// Progress callback for querying/subscribing
+void query_progress_callback(const char* relay_url, const char* status,
+                            const char* event_id, int event_count,
+                            int total_relays, int completed_relays, void* user_data) {
+    (void)user_data;
+
+    if (relay_url) {
+        printf("🔍 QUERY [%s]: %s", relay_url, status);
+        if (event_id) {
+            printf(" - Event: %.12s...", event_id);
+        }
+        if (event_count > 0) {
+            printf(" (%d events)", event_count);
+        }
+        printf(" (%d/%d completed)\n", completed_relays, total_relays);
+    } else {
+        printf("🔍 QUERY COMPLETE: %d events found\n", event_count);
+    }
+}
+
+/**
+ * Generate a random keypair for testing
+ */
+void generate_test_keypair(unsigned char* private_key, char* pubkey_hex) {
+    // Generate random private key
+    if (nostr_secp256k1_get_random_bytes(private_key, 32) != 1) {
+        fprintf(stderr, "Failed to generate random private key\n");
+        exit(1);
+    }
+
+    // Derive public key
+    unsigned char public_key[32];
+    if (nostr_ec_public_key_from_private_key(private_key, public_key) != 0) {
+        fprintf(stderr, "Failed to derive public key\n");
+        exit(1);
+    }
+
+    // Convert to hex
+    nostr_bytes_to_hex(public_key, 32, pubkey_hex);
+}
+
+/**
+ * Main test function
+ */
+int main(int argc, char* argv[]) {
+    (void)argc; // Suppress unused parameter warning
+    (void)argv; // Suppress unused parameter warning
+
+    printf("🧪 NIP-17 Private Direct Messages Test (Synchronous)\n");
+    printf("=================================================\n\n");
+
+    // Initialize crypto
+    if (nostr_init() != NOSTR_SUCCESS) {
+        fprintf(stderr, "Failed to initialize crypto\n");
+        return 1;
+    }
+
+    // Generate keypairs
+    unsigned char sender_privkey[32];
+    unsigned char recipient_privkey[32];
+    char sender_pubkey_hex[65];
+    char recipient_pubkey_hex[65];
+
+    printf("🔑 Generating keypairs...\n");
+    generate_test_keypair(sender_privkey, sender_pubkey_hex);
+    generate_test_keypair(recipient_privkey, recipient_pubkey_hex);
+
+    printf("📤 Sender pubkey: %s\n", sender_pubkey_hex);
+    printf("📥 Recipient pubkey: %s\n", recipient_pubkey_hex);
+    printf("\n");
+
+    // Create DM event with timestamp
+    printf("💬 Creating DM event...\n");
+    time_t now = time(NULL);
+    char test_message[256];
+    snprintf(test_message, sizeof(test_message),
+             "Hello from NIP-17! This is a private direct message sent at %ld", now);
+
+    const char* recipient_pubkeys[] = {recipient_pubkey_hex};
+    cJSON* dm_event = nostr_nip17_create_chat_event(
+        test_message,
+        recipient_pubkeys,
+        1,
+        "NIP-17 Test",
+        NULL,  // no reply
+        RELAY_URL,
+        sender_pubkey_hex
+    );
+
+    if (!dm_event) {
+        fprintf(stderr, "Failed to create DM event\n");
+        return 1;
+    }
+
+    printf("📝 Created DM event (kind 14)\n");
+
+    // Send DM (create gift wraps)
+    printf("🎁 Creating gift wraps...\n");
+    cJSON* gift_wraps[10];  // Max 10 gift wraps
+    int gift_wrap_count = nostr_nip17_send_dm(
+        dm_event,
+        recipient_pubkeys,
+        1,
+        sender_privkey,
+        gift_wraps,
+        10
+    );
+
+    cJSON_Delete(dm_event);  // Original DM event no longer needed
+
+    if (gift_wrap_count <= 0) {
+        fprintf(stderr, "Failed to create gift wraps\n");
+        return 1;
+    }
+
+    printf("✅ Created %d gift wrap(s)\n", gift_wrap_count);
+
+    // Print the gift wrap JSON
+    printf("\n📄 Gift wrap event JSON:\n");
+    printf("========================\n");
+    char* gift_wrap_json = cJSON_Print(gift_wraps[0]);
+    printf("%s\n", gift_wrap_json);
+    free(gift_wrap_json);
+
+    // PHASE 1: Publish the gift wrap to relay
+    printf("\n📤 PHASE 1: Publishing gift wrap to relay\n");
+    printf("==========================================\n");
+
+    const char* relay_urls[] = {RELAY_URL};
+    int success_count = 0;
+    publish_result_t* publish_results = synchronous_publish_event_with_progress(
+        relay_urls,
+        1,  // single relay
+        gift_wraps[0],  // Send the first gift wrap
+        &success_count,
+        10,  // 10 second timeout
+        publish_progress_callback,
+        NULL,  // no user data
+        0,     // NIP-42 disabled
+        NULL   // no private key for auth
+    );
+
+    if (!publish_results || success_count != 1) {
+        fprintf(stderr, "❌ Failed to publish gift wrap (success_count: %d)\n", success_count);
+        // Clean up gift wraps
+        for (int i = 0; i < gift_wrap_count; i++) {
+            cJSON_Delete(gift_wraps[i]);
+        }
+        if (publish_results) free(publish_results);
+        return 1;
+    }
+
+    printf("✅ Successfully published gift wrap!\n");
+
+    // Clean up publish results and gift wraps
+    free(publish_results);
+    for (int i = 0; i < gift_wrap_count; i++) {
+        cJSON_Delete(gift_wraps[i]);
+    }
+
+    // Small delay to let the relay process the event
+    printf("⏳ Waiting 2 seconds for relay to process...\n");
+    sleep(2);
+
+    // PHASE 2: Subscribe to receive the DM back
+    printf("\n📥 PHASE 2: Subscribing to receive DM back\n");
+    printf("===========================================\n");
+
+    // Create filter for gift wraps addressed to recipient
+    cJSON* filter = cJSON_CreateObject();
+    cJSON* kinds = cJSON_CreateArray();
+    cJSON_AddItemToArray(kinds, cJSON_CreateNumber(1059));  // Gift wrap kind
+    cJSON_AddItemToObject(filter, "kinds", kinds);
+
+    // Filter for gift wraps with p tag matching recipient
+    cJSON* p_tags = cJSON_CreateArray();
+    cJSON_AddItemToArray(p_tags, cJSON_CreateString(recipient_pubkey_hex));
+    cJSON_AddItemToObject(filter, "#p", p_tags);
+
+    // Print the subscription filter JSON
+    printf("📄 Subscription filter JSON:\n");
+    printf("============================\n");
+    char* filter_json = cJSON_Print(filter);
+    printf("%s\n", filter_json);
+    free(filter_json);
+
+    int query_result_count = 0;
+    cJSON** query_results = synchronous_query_relays_with_progress(
+        relay_urls,
+        1,  // single relay
+        filter,
+        RELAY_QUERY_ALL_RESULTS,  // Get all matching events
+        &query_result_count,
+        10,  // 10 second timeout per relay
+        query_progress_callback,
+        NULL,  // no user data
+        0,     // NIP-42 disabled
+        NULL   // no private key for auth
+    );
+
+    cJSON_Delete(filter);  // Clean up filter
+
+    if (!query_results || query_result_count == 0) {
+        fprintf(stderr, "❌ No DM events received back from relay\n");
+        if (query_results) free(query_results);
+        return 1;
+    }
+
+    printf("✅ Received %d event(s) from relay!\n", query_result_count);
+
+    // Process the received events
+    printf("\n🔍 PHASE 3: Processing received events\n");
+    printf("=====================================\n");
+
+    int dm_found = 0;
+    cJSON* received_dm = NULL;
+
+    for (int i = 0; i < query_result_count; i++) {
+        cJSON* event = query_results[i];
+        cJSON* kind_item = cJSON_GetObjectItem(event, "kind");
+        cJSON* id_item = cJSON_GetObjectItem(event, "id");
+
+        if (kind_item && cJSON_IsNumber(kind_item) && cJSON_GetNumberValue(kind_item) == 1059) {
+            printf("🎁 Found gift wrap event: %.12s...\n",
+                   id_item && cJSON_IsString(id_item) ? cJSON_GetStringValue(id_item) : "unknown");
+
+            // Try to decrypt this gift wrap
+            cJSON* decrypted_dm = nostr_nip17_receive_dm(event, recipient_privkey);
+            if (decrypted_dm) {
+                printf("✅ Successfully decrypted gift wrap!\n");
+
+                // Verify the decrypted DM
+                cJSON* content_item = cJSON_GetObjectItem(decrypted_dm, "content");
+                cJSON* dm_kind_item = cJSON_GetObjectItem(decrypted_dm, "kind");
+                cJSON* pubkey_item = cJSON_GetObjectItem(decrypted_dm, "pubkey");
+
+                if (content_item && dm_kind_item && pubkey_item) {
+                    const char* decrypted_content = cJSON_GetStringValue(content_item);
+                    int decrypted_kind = (int)cJSON_GetNumberValue(dm_kind_item);
+                    const char* decrypted_pubkey = cJSON_GetStringValue(pubkey_item);
+
+                    printf("📧 Decrypted DM:\n");
+                    printf("   Kind: %d\n", decrypted_kind);
+                    printf("   From: %s\n", decrypted_pubkey);
+                    printf("   Content: %s\n", decrypted_content);
+
+                    // Verify the DM content (check that it contains our message with timestamp)
+                    int content_ok = strstr(decrypted_content, "Hello from NIP-17! This is a private direct message sent at ") != NULL;
+
+                    if (decrypted_kind == 14 &&
+                        content_ok &&
+                        strlen(decrypted_content) >= 64 && // Should be at least as long as the prefix
+                        strcmp(decrypted_pubkey, sender_pubkey_hex) == 0) {
+
+                        printf("✅ DM verification successful!\n");
+                        dm_found = 1;
+                        received_dm = decrypted_dm;  // Keep reference for cleanup
+                        break;  // Found our DM, no need to check more
+                    } else {
+                        printf("❌ DM verification failed\n");
+                        cJSON_Delete(decrypted_dm);
+                    }
+                } else {
+                    printf("❌ Invalid decrypted DM structure\n");
+                    cJSON_Delete(decrypted_dm);
+                }
+            } else {
+                printf("❌ Failed to decrypt gift wrap\n");
+            }
+        }
+    }
+
+    // Clean up query results
+    for (int i = 0; i < query_result_count; i++) {
+        cJSON_Delete(query_results[i]);
+    }
+    free(query_results);
+
+    if (!dm_found) {
+        fprintf(stderr, "❌ Could not find or decrypt the expected DM\n");
+        return 1;
+    }
+
+    printf("\n🎉 NIP-17 synchronous test completed successfully!\n");
+
+    // Cleanup
+    if (received_dm) {
+        cJSON_Delete(received_dm);
+    }
+    nostr_cleanup();
+
+    return 0;
+}

tests/relay_synchronous_test.c

@@ -0,0 +1,254 @@
+/*
+ * Relay Pool Test Program
+ *
+ * Tests the nostr_relay_pool functionality with persistent connections
+ * and subscriptions. Prints events as they arrive and shows connection status.
+ *
+ * Usage: ./pool_test
+ * Press Ctrl+C to exit
+ */
+
+#define _POSIX_C_SOURCE 200809L
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <signal.h>
+#include <time.h>
+#include <unistd.h>
+#include "../nostr_core/nostr_core.h"
+#include "../cjson/cJSON.h"
+
+// Global variables for signal handling
+volatile sig_atomic_t running = 1;
+time_t last_status_time = 0;
+
+// Signal handler for clean shutdown
+void signal_handler(int signum) {
+    (void)signum; // Suppress unused parameter warning
+    printf("\n🛑 Received signal, shutting down...\n");
+    running = 0;
+}
+
+// Event callback - called when an event is received
+void on_event(cJSON* event, const char* relay_url, void* user_data) {
+    (void)user_data; // Suppress unused parameter warning
+
+    // Extract basic event information
+    cJSON* id = cJSON_GetObjectItem(event, "id");
+    cJSON* pubkey = cJSON_GetObjectItem(event, "pubkey");
+    cJSON* created_at = cJSON_GetObjectItem(event, "created_at");
+    cJSON* kind = cJSON_GetObjectItem(event, "kind");
+    cJSON* content = cJSON_GetObjectItem(event, "content");
+
+    printf("\n📨 EVENT from %s\n", relay_url);
+    printf("├── ID: %.12s...\n", id && cJSON_IsString(id) ? cJSON_GetStringValue(id) : "unknown");
+    printf("├── Pubkey: %.12s...\n", pubkey && cJSON_IsString(pubkey) ? cJSON_GetStringValue(pubkey) : "unknown");
+    printf("├── Kind: %d\n", kind && cJSON_IsNumber(kind) ? (int)cJSON_GetNumberValue(kind) : -1);
+    printf("├── Created: %lld\n", created_at && cJSON_IsNumber(created_at) ? (long long)cJSON_GetNumberValue(created_at) : 0);
+
+    // Truncate content if too long
+    if (content && cJSON_IsString(content)) {
+        const char* content_str = cJSON_GetStringValue(content);
+        size_t content_len = strlen(content_str);
+        if (content_len > 100) {
+            printf("└── Content: %.97s...\n", content_str);
+        } else {
+            printf("└── Content: %s\n", content_str);
+        }
+    } else {
+        printf("└── Content: (empty)\n");
+    }
+    fflush(stdout);
+}
+
+// EOSE callback - called when End of Stored Events is received
+void on_eose(cJSON** events, int event_count, void* user_data) {
+    (void)user_data; // Suppress unused parameter warning
+    printf("📋 EOSE received - %d events collected\n", event_count);
+
+    // Log collected events if any
+    for (int i = 0; i < event_count; i++) {
+        cJSON* id = cJSON_GetObjectItem(events[i], "id");
+        if (id && cJSON_IsString(id)) {
+            printf("  Event %d: %.12s...\n", i + 1, cJSON_GetStringValue(id));
+        }
+    }
+    fflush(stdout);
+}
+
+// Print connection status for all relays
+void print_relay_status(nostr_relay_pool_t* pool) {
+    char** relay_urls = NULL;
+    nostr_pool_relay_status_t* statuses = NULL;
+    int relay_count = nostr_relay_pool_list_relays(pool, &relay_urls, &statuses);
+
+    if (relay_count <= 0) {
+        printf("❌ No relays in pool\n");
+        return;
+    }
+
+    printf("\n📊 RELAY STATUS (%d relays):\n", relay_count);
+    for (int i = 0; i < relay_count; i++) {
+        const char* status_str;
+        switch (statuses[i]) {
+            case NOSTR_POOL_RELAY_CONNECTED:
+                status_str = "🟢 CONNECTED";
+                break;
+            case NOSTR_POOL_RELAY_CONNECTING:
+                status_str = "🟡 CONNECTING";
+                break;
+            case NOSTR_POOL_RELAY_DISCONNECTED:
+                status_str = "⚪ DISCONNECTED";
+                break;
+            case NOSTR_POOL_RELAY_ERROR:
+                status_str = "🔴 ERROR";
+                break;
+            default:
+                status_str = "❓ UNKNOWN";
+                break;
+        }
+
+        printf("├── %s: %s\n", relay_urls[i], status_str);
+
+        // Show additional stats if available
+        const nostr_relay_stats_t* stats = nostr_relay_pool_get_relay_stats(pool, relay_urls[i]);
+        if (stats) {
+            printf("│   ├── Events received: %d\n", stats->events_received);
+            printf("│   ├── Connection attempts: %d\n", stats->connection_attempts);
+            printf("│   └── Connection failures: %d\n", stats->connection_failures);
+        }
+
+        free(relay_urls[i]);
+    }
+    printf("\n");
+    free(relay_urls);
+    free(statuses);
+    fflush(stdout);
+}
+
+int main() {
+    printf("🔗 NOSTR Relay Pool Test\n");
+    printf("========================\n");
+    printf("Testing persistent relay connections with subscriptions.\n");
+    printf("Press Ctrl+C to exit.\n\n");
+
+    // Initialize NOSTR library
+    if (nostr_init() != NOSTR_SUCCESS) {
+        fprintf(stderr, "❌ Failed to initialize NOSTR library\n");
+        return 1;
+    }
+
+    // Setup signal handler for clean shutdown
+    signal(SIGINT, signal_handler);
+    signal(SIGTERM, signal_handler);
+
+    // Create relay pool with default configuration
+    nostr_pool_reconnect_config_t* config = nostr_pool_reconnect_config_default();
+    nostr_relay_pool_t* pool = nostr_relay_pool_create(config);
+    if (!pool) {
+        fprintf(stderr, "❌ Failed to create relay pool\n");
+        nostr_cleanup();
+        return 1;
+    }
+
+    // Add relays to the pool
+    const char* relay_urls[] = {
+        "wss://nostr.mom",
+        "wss://relay.laantungir.net",
+        "wss://nos.lol"
+    };
+    int relay_count = 3;
+
+    printf("📡 Adding %d relays to pool:\n", relay_count);
+    for (int i = 0; i < relay_count; i++) {
+        printf("├── %s\n", relay_urls[i]);
+        if (nostr_relay_pool_add_relay(pool, relay_urls[i]) != NOSTR_SUCCESS) {
+            printf("│   ❌ Failed to add relay\n");
+        } else {
+            printf("│   ✅ Added successfully\n");
+        }
+    }
+    printf("\n");
+
+    // Create filter for subscription (kind 1 events - text notes)
+    cJSON* filter = cJSON_CreateObject();
+    cJSON* kinds = cJSON_CreateArray();
+    cJSON_AddItemToArray(kinds, cJSON_CreateNumber(1));
+    cJSON_AddItemToObject(filter, "kinds", kinds);
+    cJSON_AddItemToObject(filter, "limit", cJSON_CreateNumber(10)); // Limit to 10 events per relay
+
+    printf("🔍 Creating subscription with filter:\n");
+    char* filter_json = cJSON_Print(filter);
+    printf("%s\n\n", filter_json);
+    free(filter_json);
+
+    // Create subscription with new parameters
+    nostr_pool_subscription_t* subscription = nostr_relay_pool_subscribe(
+        pool,
+        relay_urls,
+        relay_count,
+        filter,
+        on_event,      // Event callback
+        on_eose,       // EOSE callback
+        NULL,          // User data (not used)
+        0,             // close_on_eose (false - keep subscription open)
+        1,             // enable_deduplication
+        NOSTR_POOL_EOSE_FULL_SET,  // result_mode
+        30,            // relay_timeout_seconds
+        60             // eose_timeout_seconds
+    );
+
+    if (!subscription) {
+        fprintf(stderr, "❌ Failed to create subscription\n");
+        cJSON_Delete(filter);
+        nostr_relay_pool_destroy(pool);
+        nostr_cleanup();
+        return 1;
+    }
+
+    printf("✅ Subscription created successfully\n");
+    printf("🎯 Listening for events... (Ctrl+C to exit)\n\n");
+
+    // Record start time for status updates
+    last_status_time = time(NULL);
+
+    // Main event loop
+    while (running) {
+        // Poll for events (100ms timeout)
+        int events_processed = nostr_relay_pool_poll(pool, 100);
+
+        // Check if we should print status (every 30 seconds)
+        time_t current_time = time(NULL);
+        if (current_time - last_status_time >= 30) {
+            print_relay_status(pool);
+            last_status_time = current_time;
+        }
+
+        // Small delay to prevent busy waiting
+        if (events_processed == 0) {
+            struct timespec ts = {0, 10000000}; // 10ms
+            nanosleep(&ts, NULL);
+        }
+    }
+
+    printf("\n🧹 Cleaning up...\n");
+
+    // Close subscription
+    if (subscription) {
+        nostr_pool_subscription_close(subscription);
+        printf("✅ Subscription closed\n");
+    }
+
+    // Destroy pool
+    nostr_relay_pool_destroy(pool);
+    printf("✅ Relay pool destroyed\n");
+
+    // Cleanup JSON
+    cJSON_Delete(filter);
+
+    // Cleanup library
+    nostr_cleanup();
+
+    printf("👋 Test completed successfully\n");
+    return 0;
+}

tests/sync_relay_test.c

@@ -10,7 +10,7 @@
 #include <stdio.h>
 #include <stdlib.h>
 #include <time.h>
-#include "../nostr_core/nostr_common.h"
+#include "../nostr_core/nostr_core.h"
 #include "../cjson/cJSON.h"
 
 
@@ -80,7 +80,7 @@ int main() {
     const char* filter_json = 
         "{"
         "  \"kinds\": [1],"
-        "  \"limit\": 1"
+        "  \"limit\": 4"
         "}";
     
     // Alternative filter examples (comment out the one above, uncomment one below):
@@ -133,7 +133,8 @@ int main() {
     
     cJSON** results = synchronous_query_relays_with_progress(
         test_relays, relay_count, filter, test_mode,
-        &result_count, 5, progress_callback, NULL
+        &result_count, 5, progress_callback, NULL,
+        1, NULL  // nip42_enabled = true, private_key = NULL (no auth)
     );
     
     time_t end_time = time(NULL);

tests/websocket_debug.c

@@ -0,0 +1,188 @@
+/*
+ * Simple WebSocket Debug Tool for NIP-17 Testing
+ *
+ * Connects to a relay and sends a subscription request to see what responses we get.
+ */
+
+#define _GNU_SOURCE
+#define _POSIX_C_SOURCE 200809L
+
+#include "../nostr_core/nostr_core.h"
+#include "../nostr_websocket/nostr_websocket_tls.h"
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <unistd.h>
+#include <time.h>
+
+int main(int argc, char* argv[]) {
+    if (argc < 2) {
+        fprintf(stderr, "Usage: %s <relay_url> [event_id]\n", argv[0]);
+        fprintf(stderr, "Example: %s wss://relay.laantungir.net 06cdf2cdd095ddb1ebe15d5b3c736b27a34de2683e847b871fe37d86ac998772\n");
+        return 1;
+    }
+
+    const char* relay_url = argv[1];
+    const char* event_id = (argc >= 3) ? argv[2] : NULL;
+
+    printf("🔍 WebSocket Debug Tool\n");
+    printf("=======================\n");
+    printf("Relay: %s\n", relay_url);
+    if (event_id) {
+        printf("Looking for event: %s\n", event_id);
+    }
+    printf("\n");
+
+    // Initialize crypto
+    if (nostr_init() != NOSTR_SUCCESS) {
+        fprintf(stderr, "Failed to initialize crypto\n");
+        return 1;
+    }
+
+    // Connect to relay
+    printf("🔌 Connecting to relay...\n");
+    nostr_ws_client_t* client = nostr_ws_connect(relay_url);
+    if (!client) {
+        fprintf(stderr, "Failed to connect to relay - nostr_ws_connect returned NULL\n");
+        return 1;
+    }
+
+    // Check initial state
+    nostr_ws_state_t initial_state = nostr_ws_get_state(client);
+    printf("Initial connection state: %d\n", (int)initial_state);
+
+    // Wait for connection
+    time_t start_time = time(NULL);
+    while (time(NULL) - start_time < 10) {  // 10 second timeout
+        nostr_ws_state_t state = nostr_ws_get_state(client);
+        if (state == NOSTR_WS_CONNECTED) {
+            printf("✅ Connected!\n");
+            break;
+        } else if (state == NOSTR_WS_ERROR) {
+            fprintf(stderr, "❌ Connection failed\n");
+            nostr_ws_close(client);
+            return 1;
+        }
+        usleep(100000); // 100ms
+    }
+
+    if (nostr_ws_get_state(client) != NOSTR_WS_CONNECTED) {
+        fprintf(stderr, "❌ Connection timeout\n");
+        nostr_ws_close(client);
+        return 1;
+    }
+
+    // Send subscription request
+    printf("📡 Sending subscription request...\n");
+
+    // Create filter for kind 1059 events
+    cJSON* filter = cJSON_CreateObject();
+    cJSON* kinds = cJSON_CreateArray();
+    cJSON_AddItemToArray(kinds, cJSON_CreateNumber(1059));
+    cJSON_AddItemToObject(filter, "kinds", kinds);
+
+    // If we have a specific event ID, add it to the filter
+    if (event_id) {
+        cJSON* ids = cJSON_CreateArray();
+        cJSON_AddItemToArray(ids, cJSON_CreateString(event_id));
+        cJSON_AddItemToObject(filter, "ids", ids);
+    }
+
+    char* filter_json = cJSON_PrintUnformatted(filter);
+    printf("Filter: %s\n", filter_json);
+
+    // Send REQ message
+    char subscription_id[32];
+    snprintf(subscription_id, sizeof(subscription_id), "debug_%ld", time(NULL));
+
+    if (nostr_relay_send_req(client, subscription_id, filter) < 0) {
+        fprintf(stderr, "Failed to send subscription request\n");
+        cJSON_Delete(filter);
+        free(filter_json);
+        nostr_ws_close(client);
+        return 1;
+    }
+
+    cJSON_Delete(filter);
+    free(filter_json);
+
+    printf("✅ Subscription sent (ID: %s)\n", subscription_id);
+    printf("⏳ Listening for responses (30 seconds)...\n");
+    printf("Press Ctrl+C to stop\n\n");
+
+    // Listen for responses
+    start_time = time(NULL);
+    int message_count = 0;
+
+    while (time(NULL) - start_time < 30) {  // 30 second timeout
+        char buffer[16384];
+        int len = nostr_ws_receive(client, buffer, sizeof(buffer) - 1, 1000); // 1 second timeout
+
+        if (len > 0) {
+            buffer[len] = '\0';
+            message_count++;
+
+            printf("📨 Message %d:\n", message_count);
+            printf("%s\n", buffer);
+
+            // Parse the message
+            char* msg_type = NULL;
+            cJSON* parsed = NULL;
+
+            if (nostr_parse_relay_message(buffer, &msg_type, &parsed) == 0) {
+                if (msg_type && strcmp(msg_type, "EVENT") == 0) {
+                    printf("   → EVENT received\n");
+                    if (cJSON_IsArray(parsed) && cJSON_GetArraySize(parsed) >= 3) {
+                        cJSON* event = cJSON_GetArrayItem(parsed, 2);
+                        if (event) {
+                            cJSON* kind_item = cJSON_GetObjectItem(event, "kind");
+                            cJSON* id_item = cJSON_GetObjectItem(event, "id");
+                            if (kind_item && cJSON_IsNumber(kind_item)) {
+                                printf("   → Kind: %d\n", (int)cJSON_GetNumberValue(kind_item));
+                            }
+                            if (id_item && cJSON_IsString(id_item)) {
+                                printf("   → ID: %.12s...\n", cJSON_GetStringValue(id_item));
+                            }
+                        }
+                    }
+                } else if (msg_type && strcmp(msg_type, "EOSE") == 0) {
+                    printf("   → EOSE (End of Stored Events)\n");
+                } else if (msg_type && strcmp(msg_type, "NOTICE") == 0) {
+                    printf("   → NOTICE from relay\n");
+                    if (cJSON_IsArray(parsed) && cJSON_GetArraySize(parsed) >= 2) {
+                        cJSON* notice_msg = cJSON_GetArrayItem(parsed, 1);
+                        if (notice_msg && cJSON_IsString(notice_msg)) {
+                            printf("   → Message: %s\n", cJSON_GetStringValue(notice_msg));
+                        }
+                    }
+                } else if (msg_type) {
+                    printf("   → %s\n", msg_type);
+                }
+
+                if (msg_type) free(msg_type);
+                if (parsed) cJSON_Delete(parsed);
+            }
+
+            printf("\n");
+        } else if (len < 0) {
+            printf("❌ Receive error\n");
+            break;
+        }
+
+        // Small delay to prevent busy waiting
+        usleep(10000); // 10ms
+    }
+
+    printf("📊 Total messages received: %d\n", message_count);
+
+    // Send CLOSE message
+    printf("🔌 Closing subscription...\n");
+    nostr_relay_send_close(client, subscription_id);
+
+    // Close connection
+    nostr_ws_close(client);
+    nostr_cleanup();
+
+    printf("✅ Done\n");
+    return 0;
+}

tests/wss_test.c

@@ -1,103 +0,0 @@
-/*
- * WebSocket SSL Test - Test OpenSSL WebSocket implementation
- * Connect to a NOSTR relay and fetch one type 1 event
- */
-
-#include <stdio.h>
-#include <stdlib.h>
-
-#include "../cjson/cJSON.h"
-#include "../nostr_core/nostr_common.h"
-
-// Progress callback to show connection status
-static void progress_callback(
-    const char* relay_url,
-    const char* status,
-    const char* event_id,
-    int events_received,
-    int total_relays,
-    int completed_relays,
-    void* user_data) 
-{
-    printf("Progress: %s - %s", relay_url ? relay_url : "Summary", status);
-    if (event_id) {
-        printf(" (Event: %.12s...)", event_id);
-    }
-    printf(" [%d/%d events, %d/%d relays]\n", 
-           events_received, *(int*)user_data, completed_relays, total_relays);
-}
-
-int main() {
-    printf("WebSocket SSL Test - Testing OpenSSL WebSocket with NOSTR relay\n");
-    printf("================================================================\n");
-    
-    // Initialize NOSTR library
-    if (nostr_init() != NOSTR_SUCCESS) {
-        printf("❌ Failed to initialize NOSTR library\n");
-        return 1;
-    }
-    
-    printf("✅ NOSTR library initialized\n");
-    
-    // Setup relay and filter
-    const char* relay_urls[] = {"wss://nostr.mom"};
-    int relay_count = 1;
-    
-    // Create filter for type 1 events (text notes), limit to 1 event
-    cJSON* filter = cJSON_CreateObject();
-    cJSON* kinds = cJSON_CreateArray();
-    cJSON_AddItemToArray(kinds, cJSON_CreateNumber(1));
-    cJSON_AddItemToObject(filter, "kinds", kinds);
-    cJSON_AddItemToObject(filter, "limit", cJSON_CreateNumber(1));
-    
-    printf("📡 Connecting to %s...\n", relay_urls[0]);
-    printf("🔍 Requesting 1 type 1 event (text note)...\n\n");
-    
-    // Query the relay
-    int result_count = 0;
-    int expected_events = 1;
-    cJSON** events = synchronous_query_relays_with_progress(
-        relay_urls,
-        relay_count,
-        filter,
-        RELAY_QUERY_FIRST_RESULT,  // Return as soon as we get the first event
-        &result_count,
-        10,  // 10 second timeout
-        progress_callback,
-        &expected_events
-    );
-    
-    // Process results
-    if (events && result_count > 0) {
-        printf("\n✅ Successfully received %d event(s)!\n", result_count);
-        printf("📄 Raw JSON event data:\n");
-        printf("========================\n");
-        
-        for (int i = 0; i < result_count; i++) {
-            char* json_string = cJSON_Print(events[i]);
-            if (json_string) {
-                printf("%s\n\n", json_string);
-                free(json_string);
-            }
-            cJSON_Delete(events[i]);
-        }
-        free(events);
-        
-        printf("🎉 WebSocket SSL Test PASSED - OpenSSL WebSocket working correctly!\n");
-    } else {
-        printf("\n❌ No events received or query failed\n");
-        printf("❌ WebSocket SSL Test FAILED\n");
-        
-        // Cleanup and return error
-        cJSON_Delete(filter);
-        nostr_cleanup();
-        return 1;
-    }
-    
-    // Cleanup
-    cJSON_Delete(filter);
-    nostr_cleanup();
-    
-    printf("✅ WebSocket connection and TLS working with OpenSSL\n");
-    return 0;
-}