Files
next.orly.dev/pkg/protocol/directory-client/DEVELOPMENT.md
mleku 8e15ca7e2f Enhance Directory Client Library for NIP-XX Protocol
- Introduced a TypeScript client library for the Distributed Directory Consensus Protocol (NIP-XX), providing a high-level API for managing directory events, identity resolution, and trust calculations.
- Implemented core functionalities including event parsing, trust score aggregation, and replication filtering, mirroring the Go implementation.
- Added comprehensive documentation and development guides for ease of use and integration.
- Updated the `.gitignore` to include additional dependencies and build artifacts for the TypeScript client.
- Enhanced validation mechanisms for group tag names and trust levels, ensuring robust input handling and security.
- Created a new `bun.lock` file to manage package dependencies effectively.
2025-10-25 14:12:09 +01:00

1.1 KiB

Directory Client Library

TypeScript client library for the Nostr Distributed Directory Consensus Protocol (NIP-XX).

Project Structure

src/
├── index.ts              # Main entry point
├── types.ts              # Type definitions
├── validation.ts         # Validation functions
├── parsers.ts            # Event parsers for all kinds
├── identity-resolver.ts  # Identity & delegation management
└── helpers.ts            # Utility functions

Installation

cd pkg/protocol/directory-client
npm install

Building

npm run build

Development

npm run dev  # Watch mode

Testing

npm test

Features Implemented

  • Type definitions for all directory event kinds (39100-39105)
  • Event parsers with validation
  • Identity tag handling and resolution
  • Key delegation management
  • Trust calculation utilities
  • Replication filtering
  • Comprehensive validation matching Go implementation

Usage Example

See the main README.md for detailed usage examples.