Nostr Static Contact Form
The Nostr Static Contact Form is an embeddable, static contact form that securely sends messages using the decentralized Nostr protocol. Each submission generates an ephemeral Nostr account, encrypts your message using NIP‑04, and publishes the event to a relay network. This form is ideal for any website that needs a simple, modern, mobile‑friendly contact solution without relying on centralized servers.
What is Nostr?
Nostr (Notes and Other Stuff Transmitted by Relays) is an open, decentralized protocol designed to create, sign, and publish content. Nostr is censorship-resistant and relies on a network of relays rather than a single central server. It is used for messaging and data publication while focusing on privacy and resilience.
Features
- Embeddable & Static: A single HTML file that can be hosted on any static site.
- Modern & Mobile-Friendly: Responsive design with a clean, minimal interface.
- Decentralized Messaging: Publishes encrypted messages as Nostr events to multiple relays.
- Ephemeral Security: Generates a new ephemeral key pair for each submission.
- Admin Configurable: The recipient NPUB is set in the code so that all messages go directly to your account.
- Simple Feedback: After submission, users see only a "Success" or "Failed" message.
How It Works
- User Submission: The user fills out the basic contact fields (Name, Email, Message) and submits the form.
- Message Assembly: The form data is compiled into a Markdown‑formatted message.
- Ephemeral Key Generation: A new ephemeral key pair is generated for that submission.
- Encryption: The message is encrypted using NIP‑04 with the admin’s NPUB.
- Event Publishing: The encrypted message is packaged as a Nostr event (kind 4) and published to a set of relays.
- User Feedback: The form displays a success or failure message depending on whether at least one relay accepted the event.
How to Use
1. Configure the Recipient NPUB
Open the HTML file and locate the following line in the JavaScript section:
const recipientNpub = "npubYOURADMINNPUBHERE"; // Replace with your NPUB
Replace "npubYOURADMINNPUBHERE" with your actual Nostr public key (NPUB). This key will be used to receive all messages submitted through the form.
2. Deploy the Form
Since the form is a single HTML file, you can host it on any static hosting provider such as GitHub Pages, Netlify, or Vercel.
3. Embedding as an iFrame
To use the contact form on another website, simply embed it within an <iframe>. For example:
<iframe
src="https://yourdomain.com/path/to/nostr-static-contact-form.html"
style="width:100%; border:none; height:500px;">
</iframe>
Place this code on any page where you want the form to appear. Adjust the height and other styles as needed to fit your design.
4. Test It Out
Visit your deployed page (or the page containing the iframe) and submit a message. A success or failure message will display based on the relay response.
Dependencies
- Nostr Tools v2.10.4:
The form relies on nostr-tools (loaded via CDN) for key generation, encryption, and event publishing.
License
This project is open source and available under the MIT License.