Inspiration

A freelancer agrees on work in one app, requests payment in another, and returns to explain what was paid. NostrChat keeps the private conversation, request and verified receipt in the same context.

What it does

Create a Nostr key with an encrypted backup, or connect a compatible signer. Exchange encrypted one-to-one messages, manage contacts and search conversations. The sender retains an encrypted copy, and saved history can be restored with the same identity.

Connect a restricted NWC wallet, create a fixed-amount Lightning invoice and share it privately. The payer reviews the amount, Bitcoin network and wallet before explicit confirmation. A paid state requires matching wallet proof; the receiver can independently check its own invoice. The verified receipt returns as an encrypted conversation message.

Lock and reopen the account, restore contacts and encrypted history, or export records. An uncertain payment offers a status check against the original wallet and is never automatically paid again.

How we built it

React, TypeScript and Vite power a responsive interface with local Manrope fonts. NIP-17, NIP-44 and NIP-59 protect message text; NIP-49 protects the local backup, and NIP-98 authenticates the account. Convex stores owner-bound encrypted profiles, history, outbox and payment records. NWC/NIP-47 supplies delegated wallet access. The complete local lab uses a private relay, Bitcoin Core and two LND regtest wallets.

Challenges and what we learned

Async signer and wallet operations need identity checks before and after completion. A closed view must not cancel a new view's legitimate authentication. Payment review binds the invoice, amount, owner, network and wallet version; atomic claims and durable unknown states prevent duplicate sends. A relay acknowledgement confirms publication, not delivery or reading.

Verified result

The standalone source passes its build, full TypeScript checks and automated protocol/backend suites. The actual desktop/phone browser exercise completed 7 checks: generated identities and mandatory backups, two-way encrypted delivery, a real 100-sat private LND regtest payment, matching payer and receiver proof, an encrypted receipt, and same-key history recovery at 1440, 390 and 360 pixels. These are builder-controlled engineering checks. Test sats have no monetary value; independent adoption and mainnet settlement are unmeasured.

What's next

Test with independent freelancers on phones and weak connections. Measure first-message completion, invoice-to-payment time and uncertain-payment recovery. Add relay discovery and redundancy, then obtain an independent review of signer and delegated-wallet handling.

Built With

Share this project:

Updates

Submission history