How do I get a signed PeerBadge?

The process of getting a signed badge involves the signer exchanging 3 codes between their device and yours. It takes a few minutes and is meant to happen in person, but it can be done over video call if needed.

To start, open the PeerBadge mini app in your Fedi app and tap Get a badge. If you don't have the mini app, you can add it by following the process outlined in What is the PeerBadge app?

Tapping Get a badge prompts you to set up a Nostr identity, which you can do by generating a new key or by importing an existing key you already use, including the key your Fedi chat profile is based on.

To preserve your privacy, the PeerBadge app does not use your Fedi chat identity by default. To use it, you'll need to manually input your secret key – which you can find by going to Settings > Nostr Details.

Keep in mind that however you choose to set up your key, the choice is permanent. Changing it later would mean resetting the PeerBadge app and would result in any badges held on the old key being lost.

If you elect to create a fresh identity, you should back up your key by writing down the 12-word recovery phrase and storing it in a secure, offline location as it is the only way to restore the associated badges.

Once you have set up an identity and backed up the associated key, you're ready to get a signed badge. Tap Get a badge again, and ask the signer to initiate the signing flow on their PeerBadge app. Next:

1. The signer will show you a QR code. Scan it using your device or paste it into the modal.
2. Your device will generate a QR code. Have the signer scan it or paste it into their modal.
3. The signer will show you a second QR. Again, scan it using your device or paste it into the modal.

That's it! You can now view your signed badges in the My Badges section of the mini app. Note that if either device shows an error at any point during the process, both you & the signer should restart the process.

This typically happens when a stale code from an abandoned attempt is left on one party's screen and the other party scans it. This can cause the two devices to fall out of sync.