API & NIP-98 Specification Reference

Complete REST API reference for authentication, rule management, webhook triggers, and NIP-57 Lightning Zap verification.

NIP-98 HTTP Header Authentication

All management endpoints require a NIP-98 signed Authorization header containing a base64 encoded Nostr event of kind: 27235.

Header Format:

Authorization: Nostr <base64-encoded-event-json>

REST API Endpoints

POST /v1/wh/:rule_id Public

Intake endpoint for receiving raw HTTP POST payloads. Validates user credit balance, compiles event content via Liquid template, signs event according to rule preference, and broadcasts to configured relays.

POST /api/v1/auth/login NIP-98 Gated

Exchanges a NIP-98 signed authorization event for a session JWT and upserts user record in Cloudflare D1.

GET / POST / DELETE /api/v1/rules NIP-98 Gated

CRUD endpoints for managing user webhook rules, signing parameters, templates, condition filters, and target relays.

GET /.well-known/lnurlp/:pubkey Public

Standard LNURL-pay endpoint returning Lightning metadata and callback URL for NIP-57 Zaps.

POST /api/v1/zap/verify Public

Verifies incoming NIP-57 Kind 9735 Zap receipt signatures and atomically credits user wallet balance or upgrades subscription tier in Cloudflare D1.