From a911cf04914f6565e36960a923b3a1c021cb9516 Mon Sep 17 00:00:00 2001 From: BitcoinMechanic Date: Fri, 26 May 2023 11:59:30 -0700 Subject: [PATCH] start work on specter-desktop, david's suggestons --- .../service-guides/specter/index.rst | 10 +++++++++- .../service-guides/specter/specter-desktop.rst | 17 +++++++++++++++++ .../service-guides/specter/specter-service.rst | 11 ++++++++--- 3 files changed, 34 insertions(+), 4 deletions(-) create mode 100644 site/source/user-manual/service-guides/specter/specter-desktop.rst diff --git a/site/source/user-manual/service-guides/specter/index.rst b/site/source/user-manual/service-guides/specter/index.rst index 28dfa63..5af4b3c 100644 --- a/site/source/user-manual/service-guides/specter/index.rst +++ b/site/source/user-manual/service-guides/specter/index.rst @@ -8,4 +8,12 @@ There are two ways to use Specter with your Start9 server. You can :ref:`run it as a service` in which case it will automatically connect to Bitcoin Core and can be optionally configured to connect via Electrs. -Alternatively you can `connect Specter Desktop via Tor `_. \ No newline at end of file +If you wish to do this in conjuction with a USB connecting hardware wallet/signing device like the Trezor One, then you will also have to install Specter Desktop on your local device. However the instructions for doing so are in the guide mentioned above. There is no need to follow the Specter Desktop guide below - that is just for people not wishing to use Specter as a service. + +If you wish to use Specter Desktop and have it connect to your server's bitcoin node or Electrs service please :ref:`see here `. + +.. toctree:: + :maxdepth: 1 + + specter-service + specter-desktop \ No newline at end of file diff --git a/site/source/user-manual/service-guides/specter/specter-desktop.rst b/site/source/user-manual/service-guides/specter/specter-desktop.rst new file mode 100644 index 0000000..3dec520 --- /dev/null +++ b/site/source/user-manual/service-guides/specter/specter-desktop.rst @@ -0,0 +1,17 @@ +.. _specter-desktop: + +=============== +Specter Desktop +=============== + +Please follow this guide if you would like to connect `Specter Desktop `_ running on your laptop/desktop (**not** your Start9 server!) to your bitcoin node or Electrs service on your Start9 server. + +.. note:: This is not the same as running :ref:`Specter as a service ` on your server. However, if you want to use Specter as a service and wish to use a USB connected hardware wallet/signing device with it, you will need to install Specter Desktop but you can ignore this guide. Please see :ref:`here instead`. + +#. Start by ensuring that Tor is running on your system as Specter will connect to Bitcoin or Electrs via the Tor network. For instructions on how to do this see :ref:`here` and slecet the approriate operating system. + +#. Once Tor is up and running go ahead and install `Specter Desktop `_. + +#. + +#. \ No newline at end of file diff --git a/site/source/user-manual/service-guides/specter/specter-service.rst b/site/source/user-manual/service-guides/specter/specter-service.rst index c1c9a62..4dbd39b 100644 --- a/site/source/user-manual/service-guides/specter/specter-service.rst +++ b/site/source/user-manual/service-guides/specter/specter-service.rst @@ -1,7 +1,8 @@ .. _specter-service: -Specter Service ---------------- +==================== +Specter as a Service +==================== To run Specter as a service on your Start9 server, simply `install it from the marketplace `_. @@ -9,6 +10,8 @@ You can then configure it to connect to the bitcoin network via connecting to Bi Electrs will be more performant but will use more system resources. +The advantage of using Specter as a service on your Start9 server is that you can have a wallet accessible from anywhere from all your devices that runs on the same system as your bitcoin node. This offers a faster and more smooth experience than connecting Specter Desktop (or other wallets) from other individual devices which would each need to have their own wallet. + Once up and running you can follow these instructions to setup a signing device with Specter. There are two ways to do this. @@ -17,6 +20,8 @@ Some signing devices permit you to **airgap** which means transferring the xpub .. note:: Using an airgapped signing device like a Coldcard is far easier to setup as unsigned transactions can be simply downloaded to your local machine from the Specter webUI where they can be saved to an SD card and transferred to a signing device for signing, then uploaded back to the Specter UI once signed just like uploading any file to a website or adding an attachment to an email. Signing devices that connect via USB require a more complicated setup. +.. tip:: If you would like to run Specter Desktop (an application that will run on client devices like laptops) and connect it to your Start9 node please see `here `_. + .. tabs:: .. group-tab:: Air Gapped Signing Devices @@ -103,7 +108,7 @@ Some signing devices permit you to **airgap** which means transferring the xpub .. group-tab:: USB Connected Signing Devices: - For devices like the Trezor One on which air gapping is not possible xpubs must be imported via USB - Specter permits this via the HWI which requires running a second instance of Specter on your *local* machine (i.e *not* your server). + For devices that do not support air-gap features, such as the Trezor One, xpubs must be imported via USB - Specter permits this via the HWI which requires running a second instance of Specter on your *local* machine (i.e *not* your server). .. note:: This means you will be running Specter as a service on your Start9 server, which you will be accessing through a webUI and *in addition* you will be running **Specter Desktop** as an application on your local device (laptop/desktop).