← Back to home

Obelisk Guides

Everything about Obelisk: what it is, how it works, and where it's going. Written plain, no jargon walls.

Admission is a ladder, not a switchA self-hosted Nostr relay with three widening tiers of admitted keys around it, added by hand, two hops away, three hops away, each publishing on a smaller share of the rate budget, with a block list cutting across all three.relayyoursTIER 1added by hand6,000/minTIER 2two hops3,000/minTIER 3three hops1,500/minBLOCKEDchecked first, overrides every tiernothingDistance from your reference accountsis how much evidence you have.

Run your own relay: admission is a ladder, not a switch

Obelisk Relay is a NIP-29 relay that decides for itself who may connect: a hand-written allowlist, the accounts your references follow, and the follow graph beyond them, each on a smaller share of the rate budget. Two commands to run one.

#relay#self-host#nip-29
A cell going critical on a Chain Reaction boardA dark grid of cells holding red, lime and cyan orbs. One cell is bursting and sending an orb into each of its four neighbours, the cascade that gives Chain Reaction its name, played over a Nostr relay in Obelisk.One orb over the limitevery neighbour takes one,and may burst in turnkind 2390 {"op":"move","cell":11}the cascade is replayed,never publishedseat 1seat 2seat 3

Chain Reaction, played on a relay

Drop an orb, take a cell, and when a cell holds one orb too many it bursts into its neighbours, and their neighbours. Chain Reaction runs in an Obelisk channel with no game server; every client replays the same event log and reaches the same board.

#games#chain-reaction#nostr
Two Stacker wells trading garbage linesTwo ten-column wells of falling coloured blocks side by side. A completed line in the left well sends grey garbage rows into the right one: the only thing that crosses the Nostr relay in a real-time Obelisk Stacker match.Clear a line……and somebody else digsop: attack lines 3 · hole 6 Every board runs locally at sixty frames a second; only the consequences are published.

Stacker: real-time falling blocks over Nostr

Six players, one shared piece order, and every line you clear buries somebody else. Stacker runs its board locally at sixty frames a second and publishes only the consequences: attacks, top-outs, and checkpoints anyone can replay.

#games#stacker#real-time
A Vesta island with dice derived from the event logA hexagonal island of forest, brick, wool, grain and ore tiles with numbered dice tokens and player settlements, beside the line of the Nostr event log the dice roll is derived from: nobody at the table rolls their own numbers.1058694Nobody rolls their own dicethe numbers come out of the event logentropy = 3f9c…a12 : 14 4 + 3 = 7…and every client derives the sameroll from the same log.

Vesta: settlements, trade, and dice nobody rolls

Vesta is a settlement-building game running inside an Obelisk channel. The rules come from an upstream package we track rather than fork, the dice are derived from the event log instead of rolled by a player, and every client checks every move.

#games#vesta#nostr
A message sealed by two layers of protectionA classic Nostr key exchange wrapped in an outer post-quantum shell, with a locked envelope at the center representing a hybrid-protected direct message.classic key exchangepost-quantum layer

Making your DMs quantum-safe

Encrypted messages you send today can be recorded now and read years from now, once a quantum computer breaks the key exchange Nostr uses. This is the one part of the problem you can fix in advance, and there are two ways to do it.

#security#post-quantum#direct-messages
Obelisk Bots and the zap botA stylish zap bot with black sunglasses listening for Nostr zap receipts and posting signed announcements into NIP-29 Obelisk groups.zap receipt kind 9735reaction kind 7 zapgroupsNIP-29 scanannouncementkind 9 post ZAP BOT9735kind 7NIP-29kind 9own nsecNIP-42PM2

Obelisk Bots: Nostr agents for groups, zaps, and ops

Obelisk-bots is the bot runtime for relay-only Obelisk groups: small Node scripts with their own Nostr keys that listen to NIP-29 group events, announce zaps, run tickers, and automate community operations without a backend.

#bots#nostr#nip-29
Swap anything, trust nothingThe Obelisk ecosystem: one self-hostable relay at the top connected to a chat client, a voice SFU, and a bot runtime, every piece independently replaceable.obelisk-relaySelf-hostable Nostr relay · whitelist · admin UIobelisk-dexWeb chat clientbrowser · NIP-07obelisk-sfuVoice mixing serverWebRTC · large callsobelisk-botsBot runtimemod · games · opsfour projects · one protocol · no central server

Swap anything, trust nothing: the Obelisk four-piece stack

Obelisk is four small projects on one open protocol: chat, voice SFU, bot runtime, and relay. Any piece is replaceable, none is central.

#ecosystem#sovereignty#nostr
Admin tools in the appThe relay operator's server settings and a channel admin's channel settings, side by side. Both publish signed events to a NIP-29 relay, which checks and enforces them.NIP-78NIP-29Server settingsrelay operator onlyServer profileEmoji & stickersChannels & categoriesRoles & ranksMembers & moderationChannel settings#general ACCESSpublicread-onlyprivateTYPEtextvoice & videopublicationsMEMBERSaliceadmindemotebobmemberremove+ add by npubNIP-29 relaychecks and enforcesrelay operator: the whole relaychannel admins: their channelevery click is a signed event

NIP-29 admins, members, and moderation

How admins run a relay community in Obelisk today. Channel admins edit their channel and its members from channel settings; the relay operator manages roles, members, emoji and layout from server settings. Every action is a standard NIP-29 event that any Nostr client can read.

#moderation#nip-29#admins
Bitcoin zaps in chatA chat message with a glowing lightning bolt flowing into it, orbited by sat particles representing a Lightning zap paid from your wallet, through Nostr Wallet Connect or a WebLN extension.Your wallet+21+42+63+84+105+126+147+168Lightning (NIP-57) chat message

Bitcoin zaps in chat

Obelisk lets you send Bitcoin over Lightning directly from a chat message using NIP-57 zaps, paid by a wallet you connect with Nostr Wallet Connect (NIP-47) or by a WebLN browser extension. No custodian, no platform fee, no middleman. Just your wallet, the recipient's wallet, and a signed Nostr event.

#bitcoin#lightning#nwc
Future: Nostr relay-based groupsA mesh of Nostr relays exchanging encrypted group messages, with no central server.relay.arelay.brelay.crelay.drelay.erelay.fNIP-29 group

What shipped, and what's next

Obelisk is a pure Nostr client with no backend. Voice channels, NIP-46 signer-app login, NIP-44 v2 encryption and the installable app have shipped. Still ahead: a static-export build and push notifications while the app is closed.

#roadmap#nostr#nip-46
How Obelisk worksOn a usual chat platform, your account, your data and the rules live on the company's server, between you and your community. In Obelisk you sign each message with your own key and it goes straight to your community's relay, a NIP-29 relay: Obelisk runs a public one, and anyone can run their own. The Obelisk app only signs and shows.A USUAL CHAT PLATFORMYoumessageThe company's serveryour account · your data · its rulesYour communityOBELISKYou, with your keysigned messageYour community's relayObelisk's relayor your ownYour communityUse Obelisk's relay or run your own: your community depends on no one.

How Obelisk works

Obelisk is a web app with no backend of its own. It signs Nostr events with your key and sends them straight to your server, which is a NIP-29 relay, and to the other relays it needs. Here's what happens when you log in, send a message or join a group.

#architecture#how-it-works#nostr
Web of Trust graphA trust graph with your node at the center, connected nodes in lime green for high trust, and red-outlined spam nodes at the periphery.YOU!!!direct followfriend-of-friendfiltered (spam)

Bring your own relay

Obelisk has no central server; instead, you connect to any NIP-29 Nostr relay you trust. Each relay shows up as its own server in the rail. Here's how the multi-relay UX works and why it matters.

#relays#nip-29#sovereignty
What is ObeliskAn obelisk monument surrounded by orbiting Nostr keys and floating chat bubbles.Kn

What is Obelisk?

Obelisk is a Discord-style group chat client with no backend. There's no database, no Obelisk server. Your account is a Nostr keypair, your groups live on Nostr relays, and the app is just a frontend that signs and reads events.

#intro#nostr#identity