Nostr — Connect it to MokonyxSocial

This guide walks you through connecting Nostr so MokonyxSocial can publish your Joomla content as a signed kind:1 text note (a short post) to the relay you choose. Keep in mind Nostr notes are plain text with no rich formatting, so a long article gets trimmed to text plus a link.

What you need

• A Nostr key pair (your public and private keys). Your private key is what signs and authorizes every post.
• At least one relay URL to publish to. A relay is a WebSocket server that stores and rebroadcasts your notes — without one, your post has nowhere to go.

Get your credentials

Private key private_key (required)

This is your Nostr secret key, and it signs every note you send — so treat it exactly like a password and never post it publicly. You can give MokonyxSocial either the nsec1... form or the 64-character hex form.

Here's where to find it:

1. Install a Nostr client that lets you export your secret key — for example the Alby browser extension (https://getalby.com), nos2x, Damus on iOS (https://damus.io), or Amethyst on Android.
2. Create a new identity, or open the one you already use.
3. Open the key/settings screen (in Alby or nos2x: extension options → "Private Key"; in Damus: Settings → Keys) and copy the secret key — the value that starts with nsec1.... Don't copy the npub1... value; that's your public key and can't sign posts.
4. Paste the nsec1... (or hex) value into the private_key field.

No client yet? You can generate a fresh key pair at a trusted tool like https://nostrtool.com ("generate new keys") and save both your nsec and npub somewhere safe.

Relay relay (required)

This is the WebSocket address of the relay you want MokonyxSocial to publish to. It needs to start with wss:// (secure) or ws://.

Here's how to pick one:

1. Choose a public relay that accepts writes. Popular ones include wss://relay.damus.io, wss://nos.lol, wss://relay.nostr.band, and wss://relay.primal.net.
2. Copy the full wss://... address.
3. Paste it into the relay field.

Note that some relays are read-only or need payment or whitelisting before they'll accept your posts. If one rejects your note, just switch to a public-write relay like wss://nos.lol.

Set it up in MokonyxSocial

1. In your Joomla admin, go to Components → MokonyxSocial → Services → New.
2. Choose Nostr.
3. Enter your private_key and relay from above.
4. Click Send Test to verify, then Save & Close and make sure the service is Published.

Verify

Open any Nostr client or web viewer (like https://nostr.band or https://primal.net), search for your npub public key, and check that your test note showed up. Since relays rebroadcast to one another, you should see it within a few seconds.

Troubleshooting

• Your note never shows up (relay replies "OK: false") — the relay is read-only or wants payment/whitelisting. Switch to a public-write relay such as wss://nos.lol.
• "Invalid key" or a signature error — you probably pasted your npub (public key) instead of your nsec/hex secret key. Grab the secret key instead.
• The connection times out — the relay URL is wrong or the relay is offline. Confirm it starts with wss:// and try another.
• Your post shows up but looks cut off — that's expected. Nostr notes are short text, so long content gets trimmed and a link is added.

Notes & limits

• Each Nostr service posts to one relay. Want to reach more? Add a separate Nostr service for each relay URL.
• Your notes are public and effectively permanent once relays have them — there's no reliable global delete.
• There's no native rich text, scheduling, or threading; every publish is a single standalone note.
• Anyone with your private_key can post as you, so keep it secret and generate a new key pair if it ever leaks.