ScPrime Wallet Commands

You are here:

If you’re comfortable with the command-line, you can interact with ScPrime in powerful ways. This is a list of all the commands that ScPrime understands, and a brief description of what they do.

These can be accessed at any time by using spc help.

All commands start with spc and are followed by a flag or a command.


spc [flags]

spc [command]


You can also use the Terminal in SiaPrime-UI. When doing so, you can type commands without adding spc.


Print the current state of consensus such as current block, block height, and target.


spc consensus [flags]


-h or --help – help for consensus

-v or --verbose – Display full consensus information

Example output

Synced: Yes

Block:      00000000000000009e74c12f68393e108e3d7d2faad15b46c8a76dd42015fb58

Height:     211104

Target:     [0 0 0 0 0 0 0 9 143 142 0 142 95 25 215 124 32 25 172 35 130 182 56 62 38 203 72 1 134 122 250 161]

Difficulty: 1929422247688414200


View and manage the gateway’s connected peers.


spc gateway [flags] or spc gateway [command]


-h or --help – help for gateway

Example output

Address: (this is the address of your ScPrime node)

Active peers: 80


Help about any command.


spc [flags] or spc [command]

Example output

ScPrime Client v1.3.5.2


  spc [flags]

  spc [command]

Available Commands

  consensus   Print the current state of consensus

  gateway     Perform gateway actions

  help        Help about any command

  host        Perform host actions

  hostdb      Interact with the renter's host database.

  miner       Perform miner actions

  renter      Perform renter actions

  stop        Stop the ScPrime daemon

  update      Update ScPrime

  utils       various utilities for working with ScPrime's types

  version     Print version information

  wallet      Perform wallet actions


View or modify host settings.


spc host [flags] or spc host [command]

Available Commands

  announce    Announce yourself as a host

  config      Modify host settings

  contracts   Show host contracts

  folder      Add, remove, or resize a storage folder

  sector      Add or delete a sector (add not supported)


-h or --help – help for host

-v or --verbose – Display detailed host info


View the list of active hosts, the list of all hosts, or query specific hosts. If the ‘-v’ flag is set, a list of recent scans will be provided, with the most recent scan on the right. a ‘0’ indicates that the host was offline, and a ‘1′ indicates that the host was online.


spc hostdb [flags] or spc hostdb [command]

Available Commands

  view        View the full information for a host.


-h or --help – help for host

-v or --verbose – Display detailed host info

-n, or —numhosts int – Number of hosts to display from the hostdb


Perform miner actions and view miner status.


spc miner [flags] or spc miner [command]

Available Commands

  start       Start cpu mining

  stop        Stop mining


-h or --help – help for miner


Perform renter actions – upload, download, rename, delete, load, or share files.


spc renter [flags] or spc renter [command]

Available Commands

  allowance            View the current allowance

  contracts            View the Renter's contracts

  createbackup         Create a backup of the renter's ScPrime files

  delete               Delete a file

  download             Download a file

  downloads            View the download queue

  export               export renter data to various formats

  list                 List the status of all files

  loadbackup           Load a backup of the renter's ScPrime files

  prices               Display the price of storage and bandwidth

  recoveryscanprogress Returns the recovery scan progress.

  rename               Rename a file

  setallowance         Set the allowance

  triggerrecoveryscan  Triggers a recovery scan.

  upload               Upload a file or folder

  uploads              View the upload queue


-h or --help – help for renter

-v or --verbose – Display detailed renter info


Stop the ScPrime daemon.


spc stop [flags]


-h or --help – help for stop


Check for (and/or download) available updates for ScPrime.


spc update [flags] or spc update [command]

Available Commands

  check       Check for available updates


-h or --help – help for update


Various utilities for working with ScPrime’s types. These commands do not require spc.


spc utils [command]

Available Commands

  bash-completion Creates bash completion file.

  checksig        verify a signature of the specified hash

  decoderawtxn    convert a base64-encoded transaction to JSON

  encoderawtxn    convert a JSON-encoded transaction to base64

  hastings        convert a currency amount to Hastings

  man-generation  Creates unix style manpages.

  sighash         calculate the SigHash of a transaction

  verify-seed     verify seed is formatted correctly


-h or --help – help for utils


Print version information.


spc version [flags]


-h or --help – help for version

Example output

ScPrime Client


Git Revision 15b9779

Build Time  Mon Dec 17 20:54:32 CST 2018

ScPrime Daemon


Git Revision 15b9779

Build Time  Mon Dec 17 20:54:32 CST 2018


Perform wallet actions – generate a new address, send coins to another wallet, or view info about the wallet.


spc wallet [flags] or spc wallet [command]

Available Commands

  address         Get a new wallet address

  addresses       List all addresses

  balance         View wallet balance

  broadcast       Broadcast a transaction

  change-password Change the wallet password

  init            Initialize and encrypt a new wallet

  init-seed       Initialize and encrypt a new wallet using a pre-existing seed

  load            Load a wallet seed, v0.3.3.x wallet, or spcg keyset

  lock            Lock the wallet

  seeds           View information about your seeds

  send            Send either ScPrimeCoins or ScPrimeFunds to an address

  sign            Sign a transaction

  sweep           Sweep ScPrimeCoins and ScPrimeFunds from a seed.

  transactions    View transactions

  unlock          Unlock the wallet


-h or --help – help for wallet


The smallest unit of ScPrimeCoins is the hasting. One ScPrimeCoin was 10^24 hastings until our Jan 2020 update where it became 10^27.

Other supported units are:

  pS (pico,  10^-12 SCP)

  nS (nano,  10^-9 SCP)

  uS (micro, 10^-6 SCP)

  mS (milli, 10^-3 SCP)


  KS (kilo, 10^3 SCP)

  MS (mega, 10^6 SCP)

  GS (giga, 10^9 SCP)

  TS (tera, 10^12 SCP)

Global flags

  -a, --addr string            which host/port to communicate with (i.e. the host/port spc is listening on) (default "localhost:9980")

      --apipassword string     the password for the API's http authentication

  -h, --help                   help for spc

  -d, --spc-directory string   location of the ScPrime directory (default "/Users/username/Library/Application Support/SiaPrime")

      --useragent string       the useragent used by spc to connect to the daemon's API (default "SiaPrime-Agent")a