HowTo run SPV

SPV is currently in BETA, and is not part of an official release.

Assume there are bugs.

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.

SPV can run as a separate process, and the NC_CLI can connect to an SPV node.

For convenience, a separate package is created by modifying the NC_CLI package that allows one to directly run the SPV.

How to Install

Download BETA from here:

• https://mirror.veriblock.org/veriblock-nodecore-spv-0.4.9-dev.79.tar.gz
• 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

1. Unzip the package to its own folder
2. Run "veriblock-spv.bat" (Windows) or "veriblock-spv" (Linux/Mac)
3. Wait for the SPV to sync (generally 10 minutes for every 1 million blocks; time will vary)

This means SPV is ready:

SPV is ready. Current blockchain height: 1004200

Run "help" to see available commands (see NodeCore_CommandLine for detail on each command):

Commands:

    disconnect
    importwallet
    importprivatekey
    encryptWallet
    getnewaddress
    exit
    lockWallet
    unlockWallet
    getstateinfo
    getbalance
    backupwallet
    send
    decryptWallet

For example:

send <amount> <destinationAddress>

Sample Output

Copyright 2017-2020 Xenios SEZC
All rights reserved.
Distributed under the MIT software license, see the accompanying
file LICENSE or http://www.opensource.org/licenses/mit-license.php.

===[ VeriBlock NodeCore SPV  v0.4.9-dev.79 ]===
                https://www.veriblock.org/
To see available commands, type: help
To stay up to date on the status of the VeriBlock Network and
ensure you are running the latest software, frequently check:
        Discord: https://discord.gg/wJZEjry
        VeriBlock Explorer: https://explore.veriblock.org

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"
}

File Structure

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.

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.