Nostronbtc is a fork of https://github.com/Electron-Cash/Nostron to work in electrum for BTC. It is a prototype minimal nostr implementation, implementing Nostr NIP-01. It uses the monstr_terminal python library for its tooling.
In simple terms, a decentralized social network with a chance of working. It's a simple, open protocol that enables a truly censorship-resistant and global social network.
This plugin is currently available for users running Electron Cash from python source. First install the python dependencies in https://github.com/Electron-Cash/Nostron/blob/main/nostron_plugin/monstr_terminal/requirements.txt. You can do this with pip install -r requirements.txt
Then, install the plugin by downloading the zip file, then upload that zipfile to the wallet as follows: From the top menu, go to Tools--> Installed Plugins. This will open the plugin manager window. Click "Add plugin" , choose the file from your computer. Then, check the disclaimer boxes and click Install.
In the near future, we hope to provide a universal plugin for desktop users, or at least a branch-derived executable.
Nostron performs 2 basic functions (posting to relays and fetching from relays), and manages 3 basic sets of data (Friends, Aliases, and Relays).
-
To start, click Add New Alias and fill in a name (e.g. Alice). Leave the privkey field blank unless you want to import a key from another nostr client.
-
Click Add New Relay and fill in a nostr relay (such as wss://relay.plebstr.com or use one your friends are using)
-
Click Add New Friend and fill in your friend's name (e.g. Bob). Enter their pubkey that they use for nostr. If you want to share your own pubkey, you can click "Copy Alias Pubkey to Clipboard".
-
Make a post by entering text into the text bar at the bottom of the app window and click "Send Message".
-
You can view your own posts and your friends' posts by clicking "Refresh Feed".
-
Nostron does only a reasonable job dealing with bad relays when posting and listening. Hopefully, a bad relay won't cause the whole app to crash, but you may get mixed results in terms of not all posts or queries may happen consistently on all relays -- for example, if the relay is overloaded, it may not respond in time.
-
Nostron should probably use waiting dialogs or other UI interaction to prevent the user from clicking too many times when a network call is being made. Be gentle and wait 10 seconds after posting or refreshing the feed. (When you make a post, the text will intentionally vanish from the input bar when the posting is complete.)
-
Nostron does not gracefully handle having multiple wallet files open at once. Please only use it with a single wallet file open at a time.
-
The plugin currently only works if you're running Electron Cash from source code because not all the dependencies could be packaged easily.
Nostron only implements the minimal features, but the nostr protocol is rich, including support of encrypted direct messages. Future development depends on community input, involvement and interest.