LITECOIN-CLI(1)

📦
version 0.21.4 · 2 versions
, in debian trixie

💅 NAME 💅

litecoin-cli — the manual page for litecoin-cli v0.21.4.0, bestie. It's the little command-line bestie that talks to your Litecoin Core node so you don't have to. No cap.

✨ SYNOPSIS ✨

litecoin-cli [options] <command> [params]  Send command to Litecoin Core
litecoin-cli [options] -named <command> [name=value]...  Send command to
Litecoin Core (with named arguments)
litecoin-cli [options] help                List commands
litecoin-cli [options] help <command>      Get help for a command

So like, four whole ways to pull up: throw a <command> at it with plain <params>, do the same but with -named so you can pass [name=value]... like a civilized person, or just yell help to get the full list of commands, or help <command> to get the 411 on one specific command. Pick your fighter 💜

🌸 DESCRIPTION 🌸

Litecoin Core RPC client version v0.21.4.0-dirty. That's it, that's the vibe. It's the RPC client, it's version v0.21.4.0, and yes it says dirty because that's literally what the version string says and I am NOT editing that. 🫶

🎀 OPTIONS 🎀

  • -? — Print this help message and exit. The classic "help me I'm lost" move, and honestly? Same.
  • -conf=<file> — Specify configuration file. Relative paths will be prefixed by datadir location. (default: litecoin.conf)
  • -datadir=<dir> — Specify data directory. Where all your little files live 🦋
  • -generate — Generate blocks immediately, equivalent to RPC generatenewaddress followed by RPC generatetoaddress. Optional positional integer arguments are number of blocks to generate (default: 1) and maximum iterations to try (default: 1000000), equivalent to RPC generatetoaddress nblocks and maxtries arguments. Example: litecoin-cli -generate 4 1000
okay so this one is doing the MOST. It's literally two RPCs in a trench coat. Also note the default iterations is one million — she's thorough, she's committed, she's iconic ✨
  • -getinfo — Get general information from the remote server. Note that unlike server-side RPC calls, the results of -getinfo is the result of multiple non-atomic requests. Some entries in the result may represent results from different states (e.g. wallet balance may be as of a different block from the chain state reported)
Careful bestie — non-atomic means the numbers you get back might not all be from the exact same moment in time. Wallet balance and chain state could be from different blocks. It's giving "photo taken 0.3 seconds apart" energy. 😭
  • -named — Pass named instead of positional arguments (default: false)
  • -netinfo — Get network peer connection information from the remote server. An optional integer argument from 0 to 4 can be passed for different peers listings (default: 0). Peer gossip time 👑
  • -rpcclienttimeout=<n> — Timeout in seconds during HTTP requests, or 0 for no timeout. (default: 900)
  • -rpcconnect=<ip> — Send commands to node running on <ip> (default: 127.0.0.1)
  • -rpccookiefile=<loc> — Location of the auth cookie. Relative paths will be prefixed by a net-specific datadir location. (default: data dir)
  • -rpcpassword=<pw> — Password for JSON-RPC connections. Guard this with your life fr fr 🙈
  • -rpcport=<port> — Connect to JSON-RPC on <port> (default: 9332, testnet: 19332, signet: 39332, regtest: 19443)
  • -rpcuser=<user> — Username for JSON-RPC connections
  • -rpcwait — Wait for RPC server to start. She's patient, she'll wait at the door like a good friend 🫶
  • -rpcwallet=<walletname> — Send RPC for non-default wallet on RPC server (needs to exactly match corresponding -wallet option passed to litecoind). This changes the RPC endpoint used, e.g. http://127.0.0.1:8332/wallet/<walletname>
EXACTLY match. Not "close enough", not "vibes similar" — exact. Otherwise it's not gonna work and you're gonna be sad. 💀
  • -stdin — Read extra arguments from standard input, one per line until EOF/Ctrl-D (recommended for sensitive information such as passphrases). When combined with -stdinrpcpass, the first line from standard input is used for the RPC password.
  • -stdinrpcpass — Read RPC password from standard input as a single line. When combined with -stdin, the first line from standard input is used for the RPC password. When combined with -stdinwalletpassphrase, -stdinrpcpass consumes the first line, and -stdinwalletpassphrase consumes the second.
Line order matters!! First line = RPC password, second line = wallet passphrase. Do not swap them, I'm begging. 😭
  • -stdinwalletpassphrase — Read wallet passphrase from standard input as a single line. When combined with -stdin, the first line from standard input is used for the wallet passphrase.
  • -version — Print version and exit

🧪 Debugging/Testing options: 🧪

lowkey the testing corner of the house, no shade, very useful 💖

⛓️ Chain selection options: ⛓️

  • -chain=<chain> — Use the chain <chain> (default: main). Allowed values: main, test, signet, regtest
  • -signet — Use the signet chain. Equivalent to -chain=signet. Note that the network is defined by the -signetchallenge parameter
  • -signetchallenge — Blocks must satisfy the given script to be considered valid (only for signet networks; defaults to the global default signet test network challenge)
  • -signetseednode — Specify a seed node for the signet network, in the hostname[:port] format, e.g. sig.net:1234 (may be used multiple times to specify multiple seed nodes; defaults to the global default signet test network seed node(s))
  • -testnet — Use the test chain. Equivalent to -chain=test. Test chain gang where u at 🌈

Copyright (C) 2011-2024 The Litecoin Core developers Copyright (C) 2009-2024 The Bitcoin Core developers

Please contribute if you find Litecoin Core useful. Visit <https://litecoin.org/> for further information about the software. The source code is available from <https://github.com/litecoin-project/litecoin>.

This is experimental software. Distributed under the MIT software license, see the accompanying file COPYING or <https://opensource.org/licenses/MIT>

say it with me: this is experimental software. Respect the warning bestie, she's not being dramatic, she's being honest. 💅

and that's the whole page, no notes, you ate 💅✨

mwah 💖 this was litecoin-cli v0.21.4.0, dated October 2024 — go be the main character of your own node, iykyk 🎀

📦 where this page comes from