NostrBridge Developer Hub

Documentation & Integration Guides

Welcome to NostrBridge docs. Learn how to transform incoming webhooks into cryptographically signed Nostr events and configure edge relays.

Automatically announce new releases, tags, and issue updates directly to Nostr relays.

Publish payment confirmations and subscription milestones to public or private relays.

Bridge blog feeds, Zapier/Make automations, or custom backend services.

Explore complete REST endpoints, authentication standards, and Zap payment specs.

Core Architectural Concepts

1. Webhook Intake Endpoint (`POST /v1/wh/:rule_id`)

Public HTTP endpoint receiving raw JSON POST payloads without requiring authentication, allowing third-party tools to submit events seamlessly.

2. JSONPath & Liquid Template Compilation

Extracts specific field values (e.g. payload.release.tag_name) and compiles note text and tags according to user rules.

3. Cryptographic Event Signing

Creates standard NIP-01 events signed via an Ephemeral Bot Keypair, AES-256 decrypted user nsec, or NIP-46 Remote Bunker socket connection.