Command-line client for advanced users
Particl-cli offers all the essential features, but doesn’t include all the advanced bells and whistles of Particl graphical clients.
Controlled via command line interface, Particl-cli is usually used on remote machines and computers without monitors, e.g. servers and less powerful devices like Raspberry Pi (which make great dedicated staking devices!).
Also check out Partyman staking utility which is a great tool to manage your staking node with ease – it’s beginner-friendly and automates many of the tedious tasks related to maintenance of your node!
Browse & compare Particl-cli’s features with other available wallets.
- Download latest release latest release
- Verify the downloaded archive (to make sure you haven’t downloaded bad client, e.g. infected with malware)
- Launch the client – see Usage below
- Backup your wallet – see Backup & Restore wallet guide
Read our dedicated guide on how to properly and securely back-up (and restore) your Particl wallet.
Everything is executed in particl-cli directory
particl/bin/ by default.
Before you can enter any commands, you need Particld (daemon) to run:
$ ./particld -daemon
Next, you can enter commands you need.
Beware as every command starts with
./particl-cli <command>(and NOT
stop– stop the daemon
help– lists all available commands
If you see
Error: couldn't connect to server: unknown (code -1), you probably haven’t started
You cannot run
./particldin parallel with Particl Core wallet.
getinfo– general info about your wallet (version, balance, staking balance, network data etc.)
getwalletinfo– view balances (total, staking, immature), wallet (un)locked status etc.
getbalance– shows your total balance only
listtransactions– lists latest transactions
getnetworkinfo– about your connection to the network
getpeerinfo– info about peer connections
getstakinginfo– staking status & stats
getnewaddress– returns your new address
listaddressgroupings– lists all used addresses (with balances)
listreceivedbyaddress 0 true– returns addresses with zero balance
liststealthaddresses– lists stealth (private) addresses
sendtoaddress <receiver> <amount> <comment> <comment-to> <narration>– sending (public) PART coins
sendparttoblind <stealth address> <amount>– convert public PART to blinded PART coins
sendblindtoblind <stealth address> <amount>– sending blinded PART coins (transactions with hidden TX amount)
sendblindtopart <stealth address> <amount>– converting blind PART coins back to public PART coins
The RPC command-line client gained a new argument,
-stdin to read extra arguments from standard input, one per line until EOF (
Ctrl-D). For example:
$ ./particl-cli -stdin # then press [Enter] walletpassphrase # then press [Enter] "<passphrase>" # then press [Enter] <timeout> # then press [Enter] true # then press [Ctrl-D] here to end input
Unlock wallet (optionally for staking only) for
$ ./particl-cli walletpassphrase <passphrase> <timeout> [stakingonly]
walletpassphrase “<my long pass>” 0 true – unlocks the wallet forever (until locked manually or restarted) for staking only
- long password containing spaces should be “in quotes”
0= unlocked forever; 10 = for 10 seconds and so on
truein the end toggles “for staking only”; if you want your wallet completely unlocked (for sending transactions etc.) you can leave it out