1 files changed, 100 insertions, 0 deletions

diff --git a/example_test.go b/example_test.go
new file mode 100644
index 0000000..90dae0f
--- /dev/null
+++ b/example_test.go
@@ -0,0 +1,100 @@
+package nostr_test
+
+import (
+        "context"
+        "fmt"
+        "time"
+
+        "northwest.io/nostr"
+)
+
+// Example_basic demonstrates basic usage of the nostr library.
+func Example_basic() {
+        // Generate a new key pair
+        key, err := nostr.GenerateKey()
+        if err != nil {
+                fmt.Printf("Failed to generate key: %v\n", err)
+                return
+        }
+
+        fmt.Printf("Public key (hex):  %s...\n", key.Public()[:16])
+        fmt.Printf("Public key (npub): %s...\n", key.Npub()[:20])
+
+        // Create an event
+        event := &nostr.Event{
+                CreatedAt: time.Now().Unix(),
+                Kind:      nostr.KindTextNote,
+                Tags:      nostr.Tags{{"t", "test"}},
+                Content:   "Hello from nostr-go!",
+        }
+
+        // Sign the event
+        if err := key.Sign(event); err != nil {
+                fmt.Printf("Failed to sign event: %v\n", err)
+                return
+        }
+
+        // Verify the signature
+        if event.Verify() {
+                fmt.Println("Event signature verified!")
+        }
+
+        // Create a filter to match our event
+        filter := nostr.Filter{
+                Kinds:   []int{nostr.KindTextNote},
+                Authors: []string{key.Public()[:8]}, // Prefix matching
+        }
+
+        if filter.Matches(event) {
+                fmt.Println("Filter matches the event!")
+        }
+}
+
+// ExampleRelay demonstrates connecting to a relay (requires network).
+// This is a documentation example - run with: go test -v -run ExampleRelay
+func ExampleRelay() {
+        ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
+        defer cancel()
+
+        // Connect to a public relay
+        relay, err := nostr.Connect(ctx, "wss://relay.damus.io")
+        if err != nil {
+                fmt.Printf("Failed to connect: %v\n", err)
+                return
+        }
+        defer relay.Close()
+
+        fmt.Println("Connected to relay!")
+
+        // Subscribe to recent text notes
+        since := time.Now().Add(-1 * time.Hour).Unix()
+        sub, err := relay.Subscribe(ctx, "my-sub", nostr.Filter{
+                Kinds: []int{nostr.KindTextNote},
+                Since: &since,
+                Limit: 5,
+        })
+        if err != nil {
+                fmt.Printf("Failed to subscribe: %v\n", err)
+                return
+        }
+
+        // Listen for events in the background
+        go relay.Listen(ctx)
+
+        // Collect events until EOSE
+        eventCount := 0
+        for {
+                select {
+                case event := <-sub.Events:
+                        eventCount++
+                        fmt.Printf("Received event from %s...\n", event.PubKey[:8])
+                case <-sub.EOSE:
+                        fmt.Printf("Received %d events before EOSE\n", eventCount)
+                        sub.Close(ctx)
+                        return
+                case <-ctx.Done():
+                        fmt.Println("Timeout")
+                        return
+                }
+        }
+}