Node TUI Wallet | Documentation

Overview

The Node TUI Wallet is a text user interface (TUI) wallet that runs alongside your Ghost node. Unlike the light wallet, it connects directly to your local node - no external servers, no trust assumptions, full privacy.

Why Use the Node TUI Wallet?

Maximum privacy - No external servers see your queries
Full validation - Every transaction verified by your node
Node operator features - Manage payouts, view mining rewards
Air-gapped compatible - Works over SSH for cold storage setups
Ghost Pay integration - Send/receive L2 payments

Interface Preview

The TUI wallet provides a keyboard-driven interface accessible via terminal or SSH.

┌─────────────────────────────────────────────────────────────────────┐ │ Ghost Wallet v1.4.0 │ ├─────────────────────────────────────────────────────────────────────┤ │ On-chain Balance: 0.12345678 BTC │ │ Ghost Pay Balance: 0.05000000 BTC │ │ Pending: 0.00100000 BTC (2 conf) │ ├─────────────────────────────────────────────────────────────────────┤ │ Node Status: ● Synced at block 878,234 │ Peers: 12 │ ├─────────────────────────────────────────────────────────────────────┤ │ │ │ end eceive istory ocks ay uit │ │ │ └─────────────────────────────────────────────────────────────────────┘

Installation

The TUI wallet is included with Ghost Node. If you're running a Ghost node, you already have it.

# Launch the TUI wallet (from your node)
ghost-wallet

# Or specify a custom data directory
ghost-wallet --datadir /path/to/ghost

# Access remotely via SSH
ssh user@your-node -t ghost-wallet

Keyboard Navigation

Key	Action
S	Open Send dialog
R	Generate receive address / Ghost Key
H	View transaction history
L	Manage Ghost Locks
P	Ghost Pay menu (send/receive L2)
W	Enter Wraith Protocol
N	Node status and mining info
Tab	Switch between panels
Enter	Confirm selection
Esc	Cancel / Go back
Q	Quit wallet

Sending Bitcoin

┌─────────────────── Send Bitcoin ───────────────────┐ │ │ │ To Address: │ │ ┌────────────────────────────────────────────┐ │ │ │ bc1qxyz... │ │ │ └────────────────────────────────────────────┘ │ │ │ │ Amount (sats): 100000 │ │ Fee rate: 10 sat/vB (Normal) │ │ Total: 100,150 sats │ │ │ │ Confirm Cancel │ │ │ └────────────────────────────────────────────────────┘

The wallet will:

Validate the address format
Check your balance
Select optimal UTXOs (coin control available with C key)
Show fee estimation
Sign and broadcast via your local node

Node Operator Features

As a node operator, the TUI wallet shows additional information about your mining rewards and node status.

┌─────────────────── Node Status ────────────────────┐ │ │ │ Node ID: ghost_a1b2c3d4e5f6... │ │ Status: ● Online (12 peers) │ │ Block: 878,234 (synced) │ │ │ │ Reward Shares (5-4-3-2-1 System) │ │ Archive Mode: +5 ✓ │ │ Ghost Pay: +4 ✓ │ │ Public Mining: +3 ✓ │ │ Policy Node: +2 ✓ │ │ Elder Status: +1 ✗ │ │ ───────────────────────── │ │ Total Shares: 14 / 15 │ │ │ │ Recent Payouts │ │ Block 878,100: +0.00234567 BTC │ │ Block 877,856: +0.00198432 BTC │ │ │ └────────────────────────────────────────────────────┘

Ghost Pay Panel

Press P to access Ghost Pay features for fast L2 payments.

┌─────────────────── Ghost Pay ──────────────────────┐ │ │ │ L2 Balance: 0.05000000 BTC │ │ Pending: 0.00050000 BTC (settling) │ │ │ │ Send Payment (10s confirmation) │ │ Receive / Generate Invoice │ │ Deposit to L2 (from on-chain) │ │ Withdraw to L1 (settle on-chain) │ │ Payment History │ │ │ │ Back to Main Menu │ │ │ └────────────────────────────────────────────────────┘

Security Considerations

Full Node = Full Control

The TUI wallet connects to your local node. This means:

No external servers see your queries - maximum privacy
Wallet keys are stored on the same machine as your node
SSH access to your node = access to your wallet
Consider hardware wallet integration for large amounts
Backup your wallet file: ~/.ghost/wallet.dat

Encryption

The wallet file is encrypted with AES-256. Set a strong passphrase:

ghost-wallet encrypt

Enter new wallet passphrase:
Confirm passphrase:
Wallet encrypted successfully.

Configuration

Wallet settings are stored in your Ghost configuration:

# /etc/ghost/pool.toml

# Wallet settings
wallet_dir=/var/lib/ghost/wallet
wallet_notify=/path/to/script.sh  # Called on new transactions

# Fee settings
fallback_fee=0.00001  # BTC/kB
min_relay_tx_fee=0.00001

# Payout address for mining rewards
payout_address=bc1qYourAddress...