Configuration (floonet-rs)

Summary. One config.toml, inherited from nostr-rs-relay and extended with the Floonet sections. The four Floonet features (whitelist, auth, paid access, name authority) are each a small block of keys.

The blocks that matter

`[info]`: neutral metadata

[info]
name = "floonet-rs-relay"
description = "A Floonet relay for the Grin community Nostr network."

Keep it payment-neutral. Operators may customize; the defaults carry zero payment language.

`[limits]`: the whitelist and event size

[limits]
# The keystone: default deny. Only these kinds are accepted.
event_kind_allowlist = [0, 3, 5, 13, 1059, 10002, 10050, 27235]
# Large enough for gift-wrapped slatepacks. Do not shrink.
max_event_bytes = 131072

event_kind_allowlist exists upstream (nostr-rs-relay/src/config.rs:54-79); floonet-rs enforces it in the write path through the admission module.

`[authorization]`: NIP-42 and whitelists

[authorization]
nip42_auth = false          # require AUTH before writes
nip42_dms = false           # require AUTH to read gift wraps addressed to you
# pubkey_whitelist = ["<hex>", "<hex>"]

Upstream parsed pubkey_whitelist but did not gate writes on it; floonet-rs enforces it in admission. See Authentication.

`[pay_to_relay]` + GoblinPay

[pay_to_relay]
enabled = false             # flip on for paid modes
processor = "GoblinPay"

With the environment keys FLOONET_PAY_MODE, FLOONET_NAME_PRICE_GRIN, GOBLINPAY_URL, and GOBLINPAY_TOKEN (same names as floonet-strfry; see the config keys reference). The GoblinPay processor implements the upstream PaymentProcessor trait.

`[name_authority]`

[name_authority]
enabled = true
domain = "relay.yourdomain"

Serves the NIP-05 endpoints in-process. See Name authority.

Environment

Secrets stay out of config.toml: the GoblinPay token and any keys are provided via the systemd environment file (mounted 0400) or container env.

Keyboard shortcuts

Floonet