Security is paramount for NostrBridge, as the system handles private keys (NSECs), NIP-98 authentication signatures, webhook execution rules, and payment integrations.
If you discover a potential security vulnerability in NostrBridge, please DO NOT open a public GitHub issue.
Instead, please report vulnerabilities via:
- GitHub Private Vulnerability Reporting: Submit a disclosure report directly through the repository's Security tab under Advisories.
- Security Email: Contact the security team privately at
security@nostrbridge.com(or project maintainers).
- Detailed description of the vulnerability and potential impact.
- Steps to reproduce or a Proof of Concept (PoC).
- Affected endpoints or components (e.g., API router, signer module, NIP-98 validation).
- Any suggested remediations or mitigations.
- We will acknowledge receipt of your report within 48 hours.
- We will keep you updated on progress towards resolving the issue.
- Once fixed, we will publicly release a security advisory giving credit to the reporter (if desired).
When self-hosting NostrBridge on your own Cloudflare account:
- NSEC Cryptographic Protection:
- Never commit raw private keys (
nsec...) or secrets into git repositories or.envfiles. - Use Cloudflare Secret environment variables (
wrangler secret put) or AES-256 encrypted D1 fields.
- Never commit raw private keys (
- NIP-98 Gating:
- Ensure all non-webhook API endpoints are protected by NIP-98 HTTP header authentication (
Authorization: Nostr ...).
- Ensure all non-webhook API endpoints are protected by NIP-98 HTTP header authentication (
- Environment Isolation:
- Keep development secrets (
.dev.vars) separate from production Cloudflare environment variables.
- Keep development secrets (
- Dependency Auditing:
- Regularly run
pnpm auditto check for downstream package vulnerabilities.
- Regularly run