Floonet
Free & open source

Nostr relays for the Grin community

Floonet is a family of relays for the Grin community that carry names and sealed, end-to-end encrypted messages over nostr, private by default over Tor, and anyone can run one.

Two packages: floonet-strfry · floonet-rs. Self-hostable, hardened, open.

What is Floonet?

Relays are the post offices of nostr. Floonet relays are post offices tuned for the Grin community.

When a wallet like Goblin has something for you, it arrives as a sealed, encrypted envelope. A Floonet relay holds that envelope until your wallet comes online to collect it, and it cannot quietly drop a payment before you have it. The relay never sees what is inside, who sent it, or who it is for. It only passes envelopes, and it drops anything that is not one.

Floonet relays also host names, so friends can reach alice instead of a long key, and they welcome connections arriving over Tor, so nobody watching the wire can see your address or where you are.

There is no company behind Floonet. It is open software, and anyone can run a relay: for their friends, their community, or the whole network.

The stack

Four pieces, each doing one job.

Nostr

The messaging network. Wallets talk by leaving sealed messages on relays: whatever passes between you and a friend moves this way, and your wallet picks it up whenever it is online. No files to swap, no meetups.

Tor

The privacy layer. Wallets reach a Floonet relay over Tor, so the relay never learns your IP or where you are. That is Tor's one job; the relay and its sealed envelopes hide everything else.

Grin

The money. Grin is confidential digital cash on Mimblewimble: every amount is cryptographically hidden and there are no addresses on the chain. Like handing someone cash, what you send stays between the two of you.

Names

The address book. A name authority turns a key into a name like alice, one name per key, yours until you release it. Operators can hand names out free or ask a little Grin for them.

Run your own

A Floonet relay is deliberately boring to operate: one Docker Compose command or a single binary, one config file, and hardening on by default. Names, privacy, and the strict event policy all come in the box.

Everything you need is at docs.floonet.dev.

Read the docs

floonet-strfry

Built on strfry (C++). The whole unit in one Compose stack: relay, bundled name authority, and TLS proxy. The fast path for most operators.

floonet-rs

Built on nostr-rs-relay (Rust). A single binary with an installer and a hardened systemd unit; the name authority is built in.

Use it

The easiest way onto Floonet is Goblin, a private wallet for Grin. Pay a name, and everything on this page, the relays, Tor, the sealed envelopes, is handled for you.

goblin.st