🌾 G.R.A.I.N.
Go Relay Architecture for Implementing Nostr
A highly configurable Nostr relay implementation with a powerful Go client library and built-in web frontend for relay status and client features.
🌾 Try it Now: wss://wheat.happytavern.co
My public GRAIN instance is live! Connect your Nostr client and start using it today.
Storage Policy: This relay accepts any event and stores them for a set time before removal.
Want permanent storage? Get a Happy Tavern Membership for whitelist access!
Why GRAIN?
The key to GRAIN is being highly configurable to fit multiple use cases.
GRAIN was created because existing Nostr relay solutions didn't offer the flexibility needed for diverse deployment scenarios. At its core, GRAIN is a powerful, production-ready Nostr relay that you can configure to meet any need—whether you're running a public relay, a private community relay, or a specialized relay with custom rules.
But GRAIN is more than just a relay—it's also a comprehensive Go library for building all sorts of Nostr applications and tools. The client library handles connection pooling, event management, authentication, and more, so you can focus on building your application instead of reinventing the wheel.
🌾 GRAIN is Open Source
GRAIN is completely free and open source. You can run your own relay, customize it however you want, and contribute to the project. That's what GRAIN is all about—giving you the freedom and tools to build on Nostr your way.
Nostr Relay
- ✓ Highly configurable via YAML settings
- ✓ MongoDB-backed event storage
- ✓ Advanced rate limiting & resource controls
- ✓ Whitelist/blacklist filtering
- ✓ Hot configuration reloading
- ✓ Event purging with retention policies
- ✓ NIP support: 1, 2, 9, 11, 40, 42, 65
Go Client Library
- ✓ Connection pooling & relay management
- ✓ Event signing & broadcasting
- ✓ Subscription management with filters
- ✓ Key generation & conversion utilities
- ✓ Session-based authentication
- ✓ Perfect for building Nostr apps in Go
- ✓ Production-grade with error handling
Get Started with GRAIN
GRAIN is open source and built with ❤️ for the Nostr community. Contributions and feedback are always welcome!
🖥️ Built-in Web Frontend
Relay Dashboard
- • Real-time relay status
- • Configuration management
- • Connection monitoring
- • Hot-reload interface
Event & Profile Viewer
- • View user profiles
- • Display event details
- • Search functionality
- • Profile caching
Client Tools
- • Relay ping/latency testing
- • Key generation & conversion
- • Event publishing
- • Multiple auth methods
⚙️ Configuration Examples
GRAIN is designed for simplicity and flexibility. Customize settings to suit your requirements by editing the YAML configuration files.