Skip to content

Module 1: Introduction to Nostr

Module Overview

Duration: 2-3 hours
Level: Beginner
Prerequisites: None
Goal: Understand what Nostr is, why it exists, and how it fundamentally works

πŸ“‹ Learning Objectives

By the end of this module, you will:

  • βœ… Understand what Nostr is and its core philosophy
  • βœ… Know the problems Nostr solves
  • βœ… Comprehend the basic architecture
  • βœ… Set up your first Nostr account
  • βœ… Send your first message on Nostr

1.1 What is Nostr?

The Name

Nostr stands for "Notes and Other Stuff Transmitted by Relays". It's a simple, open protocol that enables a truly decentralized and censorship-resistant global social network.

Core Concept

At its heart, Nostr is:

  • A protocol, not a platform or company
  • Decentralized - no single entity controls it
  • Simple - based on straightforward concepts
  • Flexible - can be used for many applications beyond social media

Key Insight

"Nostr is not an app, it's a protocol - like email or the web. Anyone can build on it, no one can shut it down."

1.2 Why Nostr Exists

Problems with Current Social Media

Traditional social media platforms face several critical issues:

  1. Centralized Control
  2. Single companies control your data
  3. Can ban or censor users arbitrarily
  4. Can disappear, taking your content with them

  5. Data Ownership

  6. Platforms own your content
  7. Cannot easily move between platforms
  8. Your social graph is locked in

  9. Censorship

  10. Content moderation by central authorities
  11. Varying standards across regions
  12. No user choice in moderation policies

  13. Identity Portability

  14. Usernames tied to specific platforms
  15. Must rebuild following on each platform
  16. No universal digital identity

Nostr's Solutions

Problem Nostr Solution
Centralized servers Multiple independent relays
Platform lock-in Portable identity via cryptographic keys
Censorship Choose your own relays and filters
Data ownership You sign and own your content
Identity portability One identity works everywhere

1.3 How Nostr Works

The Three Pillars

graph TD
    A[Users] -->|Create & Sign| B[Events]
    B -->|Broadcast to| C[Relays]
    C -->|Distribute to| A

    style A fill:#9c27b0,stroke:#fff,color:#fff
    style B fill:#7b1fa2,stroke:#fff,color:#fff
    style C fill:#6a1b9a,stroke:#fff,color:#fff
  1. Users (Clients)
  2. Create and consume content
  3. Hold private keys for identity
  4. Connect to multiple relays

  5. Events

  6. All data in Nostr is an "event"
  7. Cryptographically signed messages
  8. Contains content, metadata, and signature

  9. Relays

  10. Simple servers that store and forward events
  11. Anyone can run a relay
  12. Users choose which relays to use

Simple Architecture Example

Imagine Alice wants to send a message:

  1. Alice writes "Hello Nostr!" in her client
  2. Her client creates an event and signs it with her private key
  3. The client sends this event to her chosen relays
  4. Bob's client queries these relays for new events
  5. Bob sees Alice's message and can verify it's really from her

1.4 Key Innovations

1. Cryptographic Identity

Instead of usernames, Nostr uses cryptographic key pairs:

  • Private Key: Your secret password (never share!)
  • Public Key: Your identity that others see

Important

Your private key IS your identity. If you lose it, you lose your account. If someone else gets it, they can impersonate you.

2. Client-Relay Architecture

  • Clients are apps you use (like Damus, Amethyst, Snort)
  • Relays are servers that store messages
  • You can use multiple clients with the same identity
  • You can connect to multiple relays for redundancy

3. Censorship Resistance

  • No single relay can censor you completely
  • If one relay bans you, use others
  • Users choose their own content filters
  • Market-based relay selection

1.5 Hands-On: Your First Nostr Experience

Step 1: Choose a Client

Popular web clients for beginners:

Step 2: Create Your Account

  1. Visit your chosen client
  2. Click "Create Account" or "Get Started"
  3. Save your private key immediately!

Critical: Save Your Keys

Private Key (nsec): nsec1xxxxx... (NEVER SHARE THIS)
Public Key (npub): npub1xxxxx... (This is your public identity)
Store your private key in a password manager or write it down securely!

Step 3: Complete Your Profile

  • Add a display name
  • Write a short bio
  • Add a profile picture (optional)
  • Set up Lightning address for tips (optional)

Step 4: Send Your First Note

  1. Find the compose/post button
  2. Write your first message: "Hello #Nostr! Just joined this decentralized network πŸš€"
  3. Click send/publish

Step 5: Follow Others and Explore

Recommended accounts to follow: - Nostr developers and builders - Content creators in your interests - News and update accounts

1.6 Practical Exercises

Exercise 1: Multi-Client Experience

  1. Log into a second client using your private key
  2. Notice how your profile and posts appear immediately
  3. Post from one client and see it in the other

Exercise 2: Relay Exploration

  1. Check which relays your client is using (usually in settings)
  2. Add a new relay: wss://relay.damus.io
  3. Remove a relay and see if you still see content

Exercise 3: Verify a Message

  1. Find a popular account's message
  2. Look for verification checkmarks or indicators
  3. Understand how the signature proves authenticity

1.7 Common Misconceptions

Misconception Reality
"Nostr is just another social media app" Nostr is a protocol; apps are just clients
"It's only for Bitcoin/crypto people" Nostr is for everyone; Bitcoin integration is optional
"It's too technical for regular users" Modern clients are as easy as traditional social media
"There's no moderation" Users and relays can implement their own moderation
"It can't scale" Nostr's architecture allows horizontal scaling

1.8 Use Cases Beyond Social Media

Nostr isn't limited to social networking:

  • Messaging: Encrypted direct messages
  • Blogging: Long-form content platforms
  • Marketplace: Decentralized commerce
  • Gaming: High scores and achievements
  • Identity: Universal login system
  • IoT: Machine-to-machine communication

πŸ“ Module 1 Quiz

Test your understanding:

  1. What does Nostr stand for?

    Answer Notes and Other Stuff Transmitted by Relays

  2. What are the three main components of Nostr?

    Answer Users (Clients), Events, and Relays

  3. Why is your private key important?

    Answer It's your identity and password combined - losing it means losing your account, and anyone with it can impersonate you

  4. Can one relay completely censor you on Nostr?

    Answer No, because you can use multiple relays. If one blocks you, others can still distribute your content

  5. What makes Nostr different from Twitter or Facebook?

    Answer Nostr is a protocol (not a company), decentralized (no single control point), gives users data ownership, and provides identity portability

🎯 Module 1 Checkpoint

Before moving to Module 2, ensure you have:

  • [ ] Created a Nostr account and saved your keys securely
  • [ ] Successfully posted at least one note
  • [ ] Logged into two different clients with the same key
  • [ ] Followed at least 5 other accounts
  • [ ] Added or removed at least one relay
  • [ ] Understood the difference between public and private keys

πŸ“š Additional Resources

πŸ’¬ Community Discussion

Join our Discord to discuss Module 1: - Share your first Nostr experience - Ask questions about concepts - Help other beginners - Find people to follow


Congratulations!

You've completed Module 1! You now understand what Nostr is, why it matters, and have hands-on experience using it. Ready for Module 2 where we'll dive deep into keys and identity!

Continue to Module 2: Keys & Identity β†’