Nostr MCP Server

# Nostr MCP Server Test Suite This directory contains tests for the Nostr MCP server functionality. ## Overview The test suite uses Jest to test both the core functionality and protocol integration of the Nostr MCP server. It includes: 1. Unit Tests - Testing isolated business logic 2. Integration Tests - Testing with a real (but in-memory) Nostr relay ## Test Files ### Unit Tests - `basic.test.ts`: Simple tests for profile formatting and zap receipt processing - `profile-notes-simple.test.ts`: Tests for profile and note data structures - `zap-tools-simple.test.ts`: Tests for zap processing and anonymous zap preparation - `mocks.ts`: Contains mock data for unit tests ### Integration Tests - `integration.test.ts`: Tests direct interaction with an ephemeral Nostr relay - `websocket-integration.test.ts`: Tests WebSocket communication with a Nostr relay ## Running Tests To run all tests: ```bash npm test ``` To run a specific test file: ```bash npm test -- __tests__/basic.test.ts npm test -- __tests__/integration.test.ts ``` ## Test Design The tests use two approaches: ### Unit Tests Unit tests use mocks to simulate the Nostr network and focus on testing business logic without actual network communication. This approach allows for: - Fast test execution - Deterministic behavior - Testing error handling and edge cases ### Integration Tests Integration tests use an in-memory ephemeral relay that implements the Nostr protocol, allowing: - Testing with real cryptographically signed events - Full event publication and retrieval workflows - Testing WebSocket protocol communication - Validating event verification works properly ## Test Coverage The test suite provides coverage for: - Profile retrieval and formatting - Note retrieval and formatting - Zap receipt processing and validation - Anonymous zap preparation - Full Nostr protocol event cycles - WebSocket communication - Event filtering - Subscription management ## Adding Tests When adding new features, consider adding: 1. Unit tests that: - Test the business logic in isolation - Verify error handling - Test edge cases 2. Integration tests that: - Verify the feature works with real Nostr events - Test the WebSocket protocol behavior if applicable - Verify end-to-end workflows