Difference between revisions of "HowTo run SPV"

From Veriblock Wiki
Jump to: navigation, search
 
(13 intermediate revisions by 3 users not shown)
Line 1: Line 1:
  
 
__TOC__
 
__TOC__
 
SPV is currently in BETA, and is not part of an official release.
 
 
Assume there are bugs.
 
  
 
== Overview ==
 
== Overview ==
 +
NodeCore SPV (Simple Payment Verification) is a light wallet that allows a user to see their balance and send VBK without downloading, syncing, and running a full node.
  
NodeCore SPV (Simple Payment Verification) is a light wallet that allows a user to see their balance and send VBK without downloading, syncing, and running a full node.
+
Post vProgPoW, run this beta wallet:
  
SPV can run as a separate process, and the NC_CLI can connect to an SPV node.
+
DOWNLOAD latest: https://explore.veriblock.org/api/stats/download, "nodecore_spv".
  
For convenience, a separate package is created by modifying the NC_CLI package that allows one to directly run the SPV.
+
See other wallets here: https://www.veriblock.org/#wallet
  
== How to Install ==
+
Run veriblock-spv.bat
  
Download BETA from here:
+
Tested on OpenJDK 8, 11, 14, for Windows and Ubuntu Linux
  
* https://mirror.veriblock.org/veriblock-nodecore-spv-0.4.9-dev.79.tar.gz
+
https://openjdk.java.net/projects/jdk/
* https://mirror.veriblock.org/veriblock-nodecore-spv-0.4.9-dev.79.zip
 
  
Tested on OpenJDK 8, 11, 14, for Windows and Ubuntu Linux
 
  
== How to Run SPV ==
+
[[File:Spv download 2.png|800px]]
  
# Unzip the package to its own folder
+
== Source Code ==
# Run "veriblock-spv.bat" (Windows) or "veriblock-spv" (Linux/Mac)
 
# Wait for the SPV to sync (generally 10 minutes for every 1 million blocks; time will vary)
 
  
This means SPV is ready:
+
Github: https://github.com/VeriBlock/nodecore/tree/master/nodecore-spv
  
<pre>
+
== Commands ==
SPV is ready. Current blockchain height: 1004200
 
</pre>
 
  
Run "help" to see available commands (see [[NodeCore_CommandLine]] for detail on each command):
+
SPV has a subset of commands: https://wiki.veriblock.org/index.php/NodeCore_CommandLine
  
 
<pre>
 
<pre>
 +
help
 
Commands:
 
Commands:
 
+
    clear
     disconnect
+
    quit|leave|close|exit
 +
    help|?|/?|h|/h|h?|showcommands
 +
    getbalance|getbal|bal
 +
    getstateinfo|stateinfo|state|getstate
 +
    send|sendtoaddress|sendtoaddr
 +
    lockwallet
 +
    unlockwallet
 +
    decryptwallet
 +
     encryptwallet
 
     importwallet
 
     importwallet
     importprivatekey
+
     backupwallet
    encryptWallet
 
 
     getnewaddress
 
     getnewaddress
    exit
 
    lockWallet
 
    unlockWallet
 
    getstateinfo
 
    getbalance
 
    backupwallet
 
    send
 
    decryptWallet
 
 
</pre>
 
</pre>
  
For example:
+
=== Configuration ===
  
<pre>
+
File: application.conf
send <amount> <destinationAddress>
 
</pre>
 
 
 
== Sample Output ==
 
  
 
<pre>
 
<pre>
Copyright 2017-2020 Xenios SEZC
+
# Default Configuration of VeriBlock SPV
All rights reserved.
+
spv {
Distributed under the MIT software license, see the accompanying
+
  # Blockchain network to connect to (mainnet | testnet | alphanet)
file LICENSE or http://www.opensource.org/licenses/mit-license.php.
+
  network: mainnet
 
+
  # Data directory
===[ VeriBlock NodeCore SPV v0.4.9-dev.79 ]===
+
  dataDir: "."
                https://www.veriblock.org/
+
  # Uncomment if you want SPV to connect to a local node
To see available commands, type: help
+
  #connectDirectlyTo: [localhost]
To stay up to date on the status of the VeriBlock Network and
+
  # Uncomment if you want SPV to connect to 3 arbitrary nodes/ports
ensure you are running the latest software, frequently check:
+
   #connectDirectlyTo: [host1:1111,host1:2222,host1:3333]
        Discord: https://discord.gg/wJZEjry
+
   # Trust the block hashes from the peers (fast sync) or compute them locally (slow sync)
        VeriBlock Explorer: https://explore.veriblock.org
+
   trustPeerHashes: false
 
 
Waiting for peers response.
 
Waiting for peers response.
 
...
 
Waiting for peers response.
 
Blockchain is downloading. 5899 / 1004234
 
Blockchain is downloading. 15699 / 1004234
 
...
 
Blockchain is downloading. 987859 / 1004254
 
Blockchain is downloading. 995699 / 1004254
 
Blockchain is downloading. 1002559 / 1004254
 
Blockchain is ready. Current height 1004256
 
 
 
Connected to node on 127.0.0.1:10500
 
 
 
(VBK_CLI rpc (127.0.0.1:10500)) > getbalance
 
getbalance
 
{
 
   "confirmed": [
 
    {
 
      "address": "V3t6uFPjRLv9zB5inXdwJqh59fmvad",
 
      "totalAmount": "0.00000000",
 
      "unlockedAmount": "0.00000000",
 
      "lockedAmount": "0.00000000"
 
    }
 
  ],
 
   "total_confirmed": "0.00000000",
 
  "unconfirmed": [],
 
   "total_unconfirmed": "0.00000000"
 
 
}
 
}
 
</pre>
 
</pre>
  
== File Structure ==
+
== Appendix ==
 
 
Running the SPV will create a "data" folder, as well as log and wallet files.
 
 
 
== Known Issues ==
 
 
 
This is a BETA, and there are several known issues.
 
  
Ensure that a NodeCore full node is not already running, as it will interfere with NC_CLI connecting to SPV.
+
=== Known Issues ===
  
 
SPV does not show locked coins (from MainNet launch). If you have a locked-coin balance, SPV will still show as zero.
 
SPV does not show locked coins (from MainNet launch). If you have a locked-coin balance, SPV will still show as zero.
  
 
Running importwallet may take a few minutes to sync the new wallet.
 
Running importwallet may take a few minutes to sync the new wallet.

Latest revision as of 18:16, 6 December 2021

Overview

NodeCore SPV (Simple Payment Verification) is a light wallet that allows a user to see their balance and send VBK without downloading, syncing, and running a full node.

Post vProgPoW, run this beta wallet:

DOWNLOAD latest: https://explore.veriblock.org/api/stats/download, "nodecore_spv".

See other wallets here: https://www.veriblock.org/#wallet

Run veriblock-spv.bat

Tested on OpenJDK 8, 11, 14, for Windows and Ubuntu Linux

https://openjdk.java.net/projects/jdk/


Spv download 2.png

Source Code

Github: https://github.com/VeriBlock/nodecore/tree/master/nodecore-spv

Commands

SPV has a subset of commands: https://wiki.veriblock.org/index.php/NodeCore_CommandLine

help
Commands:
    clear
    quit|leave|close|exit
    help|?|/?|h|/h|h?|showcommands
    getbalance|getbal|bal
    getstateinfo|stateinfo|state|getstate
    send|sendtoaddress|sendtoaddr
    lockwallet
    unlockwallet
    decryptwallet
    encryptwallet
    importwallet
    backupwallet
    getnewaddress

Configuration

File: application.conf

# Default Configuration of VeriBlock SPV
spv {
  # Blockchain network to connect to (mainnet | testnet | alphanet)
  network: mainnet
  # Data directory
  dataDir: "."
  # Uncomment if you want SPV to connect to a local node
  #connectDirectlyTo: [localhost]
  # Uncomment if you want SPV to connect to 3 arbitrary nodes/ports
  #connectDirectlyTo: [host1:1111,host1:2222,host1:3333]
  # Trust the block hashes from the peers (fast sync) or compute them locally (slow sync)
  trustPeerHashes: false
}

Appendix

Known Issues

SPV does not show locked coins (from MainNet launch). If you have a locked-coin balance, SPV will still show as zero.

Running importwallet may take a few minutes to sync the new wallet.