Skip to main content

Wallet Management

Bitcoin Knots provides extended wallet functionality including legacy wallet support.

Wallet Types

Descriptor Wallet (Default)

Modern wallet using output descriptors:

bitcoin-cli createwallet "mydescriptor"

Legacy Wallet

Traditional wallet with BIP32 HD keys:

bitcoin-cli createwallet "mylegacy" false false "" false false

The last false disables descriptors, creating a legacy wallet.

Basic Operations

Create Wallet

# Descriptor wallet
bitcoin-cli createwallet "wallet1"

# With encryption
bitcoin-cli createwallet "wallet2" false false "passphrase"

Load/Unload

bitcoin-cli loadwallet "wallet1"
bitcoin-cli unloadwallet "wallet1"

List Wallets

bitcoin-cli listwallets

Receiving

Get Address

bitcoin-cli -rpcwallet=wallet1 getnewaddress
bitcoin-cli -rpcwallet=wallet1 getnewaddress "label" "bech32m"

Check Balance

bitcoin-cli -rpcwallet=wallet1 getbalance

Sending

Simple Send

bitcoin-cli -rpcwallet=wallet1 sendtoaddress "bc1q..." 0.001

Advanced Send

bitcoin-cli -rpcwallet=wallet1 send '{
"bc1q...": 0.001
}' null "unset" null '{"fee_rate": 10}'

Knots-Specific Features

Sweep Private Keys

bitcoin-cli sweepprivkeys '["5K..."]' "bc1q..."

Dump Master Key (Legacy)

bitcoin-cli -rpcwallet=legacy dumpmasterprivkey

Import Codex32

bitcoin-cli importcodex32 "ms1..."

Backup

Descriptor Wallet

bitcoin-cli -rpcwallet=wallet1 backupwallet "/path/backup.dat"

Legacy Wallet

bitcoin-cli -rpcwallet=legacy dumpwallet "/path/dump.txt"

Security

Encryption

bitcoin-cli -rpcwallet=wallet1 encryptwallet "passphrase"

Lock/Unlock

bitcoin-cli -rpcwallet=wallet1 walletlock
bitcoin-cli -rpcwallet=wallet1 walletpassphrase "pass" 60

See Also