Skip to content

Latest commit

 

History

History
133 lines (84 loc) · 5.92 KB

setup.md

File metadata and controls

133 lines (84 loc) · 5.92 KB
Raw

Setup

Connections

Hardware Wallet Connection

Note: ⚠️ make sure to have the latest firmware installed on your hardware device.
Also make sure to close all applications that might interfere with the device's USB dongle (such as Ledger Chrome Wallet or Ledger Live App)

Select the hardware wallet model from the dropdown menu. Connect the hardware device to the USB, unlock it (and, for Ledger, open the PIVX app on it).
Click the button Connect next to 'Hardware Device:' drop down menu:


Once successfully connected, it gives a confirmation message and the light turns purple.




RPC Server Connection

Public Servers

In order to interact with the PIVX blockchain, SPMT has a number of preloaded remote RPC servers.
To change the server used by the application, select it from the drop-down menu. The tool automatically tries to connect to it and displays latest block number and server's response time.




Local Wallet

Alternatively SPMT can connect to a local PIVX wallet running alongside it (any empty pivx-cli wallet will do) using it as JSON-RPC server.

Install the local wallet and edit its pivx.conf inserting rpcuser, rpcpassword, rpcallowip and, if preferred, change the RPC port setting rpcport=N replacing N with the desired port number (if not set, the wallet will use default RPC port number: 51473)
Example:

server=1
rpcuser=myUsername
rpcpassword=myPassword
rpcallowip=127.0.0.1


Then, inside the SPMT, open the menu Setup -> RPC Servers config... to access the configuration dialog.


Click on the 'edit' icon next to "Local Wallet":


You can leave ip "127.0.0.1" if the wallet is on the same machine as the SPMT.

Insert the RPC user/password credentials and hit 'Save' to go back.



Now select Local Wallet from the drop-down menu, it should connect with SPMT instantly.
Otherwise use the Connect/Update button.




Custom Private Servers

The user has also the option to run his own instance of a remote RPC server.
In order to setup the remote server, the following solution can be used:

https://github.com/random-zebra/PIVX-NGINX_proxy


Once setup, to add the remote server inside SPMT, go to Setup -> RPC Servers config... and click Add RPC Server:


Insert the server URL, selecting "http" or "https", the username and password, and hit save.
Close the configuration dialog and select the new server from the drop-down menu to attempt a connection to it.


Masternodes configurations

Setting up a masternode configuration

Click New Masternode (big button below the list) and fill all the informations of the remote node:

  • Name : an alias for the masternode entry
  • IP Address / IP Port : Public IP address and port of the remote masternode
  • MN Priv Key : masternode private key. If you have already setup the remote node, copy here the masternodeprivkey from the pivx.conf file.
    If you don't have one yet, you can generate a new one clicking on Generate (then copy it to the config file of the remote node).


Insert the PIVX Address holding the collateral and relative account number.
If you have only one account in your wallet, leave account number to "0".
After inserting Account number and PIVX Address, click >> to look for path and public key.


Note: If you are unsure about the account number, you can check the account details:
° (LEDGER) from Ledger live app (advanced logs --> your account number is next to "index"):


* (TREZOR) from Trezor web wallet, select the account, go to the 'receive' tab and click on 'show full address'. Next to the QR code there's the full path of the address, e.g.: BIP32 Path: m/44'/119'/1'/2/3. --> Your account number is the third one (i.e. 1 in the example).

The tool looks for the public key and path of the given address (in batches of 10 paths per scan, asking confirmation to continue if needed).
When found, a notification message is displayed.


Note: If the user knows already the correct spath_id (address number) he can, instead, insert it and click << to do the reverse search (look for the corresponding address and public key).

Click Lookup to find the collateral TxHash, select it and press OK.



Alternatively click Edit to fill it manually, and then OK.



Click Save to save the configuration and go back to main view.



Import external masternode file

Starting from version v0.3.1 it is possible to "import" external masternodes (with collateral traditionally held on PIVX core wallets, instead of hardware devices), loading the data from an external file formatted as the common masternode.conf of the controller wallets.

To access the feature simply click on Import "masternode.conf" file from the Setup menu and select the file.


These "external masternodes" will appear in orange in the list inside the SPMT.
They can't be started and the spending of rewards is disabled for them. But their status can be checked and they can be used for voting in the governace Tab.