Dcrctl is a free, open source command-line RPC client for Decred, a cryptocurrency network. It is aimed at developers, node operators and technical users who prefer sending RPC commands to a dcrd or dcrwallet process from a terminal rather than through a graphical tool. The current release is release-v2.1.7, and the code was last updated on July 3, 2026, so the project is recent and under active care.
This page explains what dcrctl does, how to install the Windows build, how to point it at a local or remote node, and how it compares with other developer tools in the catalog. The program is licensed under ISC and written in Go. Because it talks to nodes that can control wallet functions, the safety section also covers how to handle its settings file and credentials sensibly.
What Is a Node RPC Client?
RPC stands for remote procedure call. In blockchain software, an RPC interface lets a program send instructions to a running node and receive back information such as block height, peer status or wallet balances. A client is the tool that makes those requests. It does not validate the network itself; it asks the node to do the work and displays the answer.
A command-line RPC client like dcrctl is useful because it can be scripted, logged and repeated exactly. Instead of clicking through a dashboard, you type one command and read the output in a terminal. This makes it easier to document how you checked a node, to compare results across machines, and to automate small routine checks that would be tedious by hand.
Keep in mind that a client is only as useful as the node behind it. If dcrd or dcrwallet is not running or cannot be reached, dcrctl will report a connection problem. Understanding this division between client and node helps you troubleshoot quickly.
Who Uses dcrctl and for What Tasks?
Developers building applications on Decred are the most natural audience. They may want to check whether a local dcrd instance responds correctly before writing code that depends on it, or confirm that a wallet process accepts the commands their software sends. A terminal client gives them a predictable reference point.
Node operators form a second group. Someone who runs dcrd on a home server or a remote machine can use the -s flag to inspect that node from a laptop without logging in to the server each time. This is handy for routine status checks and for confirming that a machine is reachable after a reboot.
Students and curious users also benefit. Reading the output of familiar commands is one of the best ways to learn how a cryptocurrency node exposes its internal state. Because the program is open source, learners can compare the command-line behavior with the code that implements it.
Key Terms: dcrd, dcrwallet and Testnet
Dcrd is the full node implementation for Decred. It keeps a copy of the blockchain, checks transactions against the network rules, and exposes an RPC interface that tools like dcrctl can call. Dcrwallet is a separate process that manages keys and wallet accounts, and it has its own RPC port. Keeping these roles apart is why dcrctl offers a switch between the two.
Mainnet is the live Decred network where real assets are transferred. Testnet is a parallel network intended for experiments, where the coins have no real market value. Developers often use testnet to rehearse commands before running them on mainnet. Choosing the wrong network is a common mistake, so always check which mode a command targets.
A full node is a machine that stores and verifies the complete chain on its own hardware. Running one gives you direct control, but it also requires storage, bandwidth and regular maintenance. Many people use hosted services instead, which is a different trade-off.
Key features
Local Node Connection by Default
Wallet and Testnet Switches
Remote Server Option
Settings File Support
Open Source Code Under ISC License
Supported coins
Dcrctl is built around the Decred network. Its documentation names Decred as the supported network and describes connections to dcrd and dcrwallet on mainnet and testnet. The tool does not cover other blockchains, so it is best suited to Decred-specific tasks.
How to install Dcrctl on Windows
- 1
Get the Windows build
Open the official GitHub Releases page for the decred/dcrctl project and select release-v2.1.7, the current version. Download the Windows build or installer from the official site or the GitHub Releases page, and pick the file that matches your system architecture.
- 2
Verify the download
Compare the SHA-256 checksum of the file with the value published alongside the release. In PowerShell, run Get-FileHash with the SHA256 algorithm on the downloaded file and check the output against the published value. If the hashes differ, delete the file and download it again before going further.
- 3
Add the program to PATH
Place the dcrctl executable in a dedicated folder, for example a Tools folder on your C drive. Open Environment Variables from System Properties, edit the Path entry in your user variables, and add that folder. Open a new terminal window afterward, then run dcrctl to confirm that Windows can find the program.
-
Ignore the Go build note for ready binaries
The developer documentation suggests adding $GOPATH/bin to PATH. That advice applies when you compile dcrctl from source with Go. A ready-made Windows build runs without Go installed, so you can skip that step unless you plan to build the program yourself.
How to use Dcrctl
Dcrctl works from a terminal, so the basic workflow is to start a Decred node, then send commands with the right connection flags. The steps below assume you have already installed the program and added it to PATH.
- Start dcrd on the same machine, or make sure dcrwallet is running if you plan to use wallet commands.
- Open Command Prompt or PowerShell and run a simple dcrctl command to test the default connection to the mainnet RPC port on localhost.
- Add the --wallet flag when you want to reach the dcrwallet RPC port instead of dcrd.
- Add the --testnet flag when you are working with testnet ports, and keep your commands consistent with the network you intend to use.
- Use --rpcserver or -s followed by a hostname or IP address when the node runs on another machine, remembering that this also overrides the default port.
- If your node requires RPC credentials, store them in the dcrctl.conf file so you do not have to type them into each command.
- Check the output carefully before acting on it, especially when a command concerns wallet functions.
Pros & cons
- Free and open source under the permissive ISC license
- Connects to a local dcrd mainnet node by default, with little setup
- Simple switches for dcrwallet and testnet connections
- Remote server option lets you manage a node from another machine
- Command-line only, which may feel unfamiliar to newcomers
- Useful only when you run or can reach a Decred node
- Best suited to people comfortable with terminal flags and RPC settings
Is Dcrctl safe?
Download dcrctl only from the official GitHub Releases page for the decred/dcrctl project. Before running the file, compare its SHA-256 checksum with the value published with the release, and check the signature if one is provided. Because dcrctl can send commands to dcrd and dcrwallet, treat your dcrctl.conf file as sensitive and keep it out of shared folders. Never enter a seed phrase on a third-party website or into any tool other than your own wallet software. The project was updated recently, but check the latest version on the official website before you install, since releases change over time.
- Official source only. Download from github.com/decred/dcrctl. Ignore ads and lookalike domains.
- Check the SHA-256. Compare the installer hash with the value the developer publishes before running it.
- Never share your seed phrase. No developer, support agent or website — including CryptApps — will ever ask for it.
Alternatives
Dcrctl is narrower than most tools in this catalog, and that is its strength. Remix Desktop and Visual Studio Code with Solidity help you write and compile smart contracts, while Foundry offers forge, cast and anvil for EVM development. Dcrctl does not write contracts. It sends RPC commands to Decred nodes from a terminal. Postman suits testing JSON-RPC endpoints through a graphical interface, and hosted services such as Alchemy, Infura or QuickNode provide RPC access without running your own node. Choose dcrctl when your node is the target and you want commands in a terminal.
Specifications
- Price
- Free
- Type
- Open source
- License
- ISC
- Latest version
- release-v2.1.7
- Last update
- 3 Jul 2026
- Windows support
- Yes (Windows build or installer)
- Source code
- github.com/decred/dcrctl
Frequently asked questions
Yes. Dcrctl is free and released as open source under the ISC license, so you can download, use and read its code without paying for the program itself. Running a Decred node that dcrctl connects to is a separate matter and may require disk space, bandwidth and regular maintenance on your machine.
Yes. The project provides a Windows build or installer. After installation, add the folder containing the executable to your PATH so you can run dcrctl from any Command Prompt or PowerShell window. The same program also runs on macOS and Linux, although the setup details differ slightly by platform.
No, not for a ready-made build. Go is used when you compile dcrctl from source, and the GOPATH/bin tip in the developer notes applies only in that case. If you just want to run the program, download the release, verify its checksum and add the file to your PATH.
By default, dcrctl connects to the mainnet RPC port of dcrd on localhost, which means a node running on the same computer. Add the --wallet flag to reach dcrwallet instead, or the --testnet flag to use testnet ports. You can keep those defaults unless your setup is different.
Yes. Use the --rpcserver flag, or -s for short, followed by a hostname or IP address. This also overrides the default port settings. Connect only to servers you control or trust, because the connection carries commands that your node will execute.
Dcrctl is open source, so its code can be reviewed publicly, but safety depends on where you download it and how you run it. Verify the SHA-256 checksum, keep your RPC settings private and never enter a seed phrase into a third-party website. The safety section above covers these steps in more detail.
Verdict
Dcrctl is a focused tool for people who run or work with Decred nodes and prefer a terminal. It is free, open source under the ISC license, written in Go, and was last updated on July 3, 2026. It suits developers testing node behavior, operators who manage dcrd and dcrwallet remotely, and learners who want to understand how Decred RPC commands work. If you need a graphical interface or do not run a node, the hosted providers and development environments listed in this catalog may be a better fit.