cashtui
v0.0.18
Published
Text UI for Bitcoin Cash nodes
Downloads
1
Maintainers
Readme
CashTUI
Note: this software is experimental, under construction and in a pre-Alpha state. As such, mainnet connections are currently disabled.
CashTUI (pronounced "cash-too-ee") is a text-based user interface for interacting with a Bitcoin Cash node. It may be of benefit to:
- Bitcoin Cash developers
- Operators wanting low level access to their node but something easier to use than entering RPC commands in the Bitcoin QT debug window.
- In cases where the node is installed on a server with no windowing system (ie no GUI support)
Requirements
- A current version of Node.js and NPM.
- A local or accessible Bitcoin Cash node running with the
-server
option. CashTUI is being developed against a Bitcoin Unlimited node but should also work with Bitcoin SV and Bitcoin ABC.
Installing
In a console window or shell, run:
npm install -g cashtui
cashtui
If step two fails, then node global packages aren't in your environment's path variable. In that case, you can run npx cashtui
instead.
Connecting to your node
After selecting the network type, the Connection Settings page will be displayed with defaults that may work out of the box. If not, you may need to check the options that you used to start your node. Particularly important is that the node has been started with the -server
flag.
CashTUI currently supports authenticating via:
- An automatically generated
.cookie
file in your node's data directory, or - A user and password set with the
-rpcuser
and-rpcpassword
node startup flags.
Choose one method (e.g. user/password) and clear the other values (e.g. cookie file) in the CashTUI connection settings.
WARNING Any passwords entered into CashTUI are currently stored in plain text in the application data folder for your operating system. Do not use CashTUI with reused, sensitive production passwords.