¶ Overview
Electrs is an Electrum Rust Server that connects to your bitcoin full node. This server indexes and queries your node to verify transactions without ever having to trust any other third parties. It also provides the framework for you to connect any number of other hardware or mobile wallets to your RoninDojo.
Electrs is considered your RoninDojo's indexer, and thusly you cannot have it at the same time as Samourai Indexer. Feel free to use the Application Management menu swap between the two at any time.
For more information, see the Electrs repository.
¶ Why use it?
Electrs is particularly useful if you have a hardware wallet such as: Trezor, Cold Card, or Ledger. You can connect your hardware wallet to Electrum desktop which is backed by the Electrum Server you chose to install. This allows you to safely and privately interact with your various Bitcoin wallets, trusting only your own node.
There's also the added benefit of enhancing your ability to restore existing Samourai Wallets in Dojo and allows more detailed searches when using your BTC-RPC-Explorer. This is an optional feature and Electrs is not officially a part of the Samourai stack. Feel free to skip this if you do not want to use it!
¶ Install Electrs
To install the Electrum Rust Server on your RoninDojo device, you can select it during the initial installation or by using the Application Management menu.
¶ Install Electrum Desktop Wallet
On you main computer, download and install Electrum desktop wallet client.
¶ Connecting
After activation, Electrs will take around 10 hours to fully index the blockchain. Do not attempt to carry out the following steps until this time has passed. To confirm that Electrs has completed indexing you can view indexer logs on your Ronin UI. If they are updating every 30 seconds and moving down the screen then you are good to go. If not, give it some more time before continuing.
- Obtain the Tor hidden service address for Electrs from the settings page of your Ronin UI. This address can also be found in the
Credentialspage of the RoninDojo command line menus.
- By default, Electrum desktop connects to multiple external servers and shares your wallet information with people you dont know. To stop this, we need to set your Electrum Server to 'single server' mode. Only allowing it to connect to the Electrum server on your RoninDojo by using the step below that's relevant to your chosen operating system.
-
Windows & Mac users follow the this Electrum Documentation.
-
Linux users can adapt the following command.
./electrum -1 -s <yourRoninelectrstoraddress>.onion:50001:t -p socks5:127.0.0.1:9150
- If you installed via AppImage you can edit this by:
cd .electrum
nano config
Change: "oneserver": true,
Change: "proxy": "socks5:127.0.0.1:9150::" (or 9050 for daemon)
Change: "server": "<yourRoninelectrstoraddress>.onion:50001:t",
DO NOT append http:// on onion address
- Ensure your Tor browser is running and then start Electrum. If the above steps were successful you should see a blue light in the bottom right of the window. This indicates you are successfully connected via Tor.
- Verify you are on your own RoninServer by going to the
consoletab in Electrum wallet and look for the welcome message that displays theelectrsversion.
For more information on how to utlize your hardware wallets with the Electrum desktop wallet client, follow the information on the Electrum Hardware Wallet Documentation.
Now give the Bitcoin Explorer a try. It is not required, but it's certainly a useful tool for studying Bitcoin related stats!
Check out the Troubleshooting page if you have any questions.
Need help? Join the RoninDojo Chatroom.
Return to Wiki Homepage.