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.

Retrieved from "http://wiki.veriblock.org/index.php?title=HowTo_run_SPV&oldid=3603"