nostrstack-api

What problem does it solve?

Centralizes guidance and operational rules for developing and maintaining the Nostrstack API so engineers avoid broken tenancy, payment, or data migrations and keep Nostr endpoint behavior consistent across environments.

Core Features & Use Cases

• Provides architecture context and data flow for Fastify + Prisma APIs, including LightningProvider payment flow and webhook handling.
• Documents routing patterns, service vs route responsibilities, tenancy resolution rules, and Nostr identifier handling to reduce integration errors.
• Includes testing guidance and triggers for updating Prisma migrations, seeds, and OpenAPI documentation when response shapes or routes change.
• Use case: add a new payment-related route while preserving LNbits webhook retry semantics, tenant lookup, and OpenAPI accuracy.

Quick Start

Review the references/architecture.md and references/api-structure.md, implement or modify the route or service in apps/api, run the API tests, and update openapi.json and Prisma migrations as required.