git / moonbite-core / doc/man/litecoind.1 · raw

.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.1..TH LITECOIND "1" "May 2026" "litecoind v0.21.5.5" "User Commands".SH NAMElitecoind \- manual page for litecoind v0.21.5.5.SH SYNOPSIS.B litecoind[\fI\,options\/\fR]                     \fI\,Start Litecoin Core\/\fR.SH DESCRIPTIONLitecoin Core version v0.21.5.5\-dirty.SH OPTIONS.HP\-?.IPPrint this help message and exit.HP\fB\-alertnotify=\fR<cmd>.IPExecute command when a relevant alert is received or we see a reallylong fork (%s in cmd is replaced by message).HP\fB\-assumevalid=\fR<hex>.IPIf this block is in the chain assume that it and its ancestors are validand potentially skip their script verification (0 to verify all,default:80cdb35c080484df5bf384b311fde3c4694d3405765bc0f596e9eb369ff286e5,testnet:4a280c0e150e3b74ebe19618e6394548c8a39d5549fd9941b9c431c73822fbd5,signet:4a280c0e150e3b74ebe19618e6394548c8a39d5549fd9941b9c431c73822fbd5).HP\fB\-blockfilterindex=\fR<type>.IPMaintain an index of compact filters by block (default: 1, values:basic). If <type> is not supplied or if <type> = 1, indexes forall known types are enabled..HP\fB\-blocknotify=\fR<cmd>.IPExecute command when the best block changes (%s in cmd is replaced byblock hash).HP\fB\-blockreconstructionextratxn=\fR<n>.IPExtra transactions to keep in memory for compact block reconstructions(default: 100).HP\fB\-blocksdir=\fR<dir>.IPSpecify directory to hold blocks subdirectory for *.dat files (default:<datadir>).HP\fB\-blocksonly\fR.IPWhether to reject transactions from network peers. Automatic broadcastand rebroadcast of any transactions from inbound peers isdisabled, unless the peer has the 'forcerelay' permission. RPCtransactions are not affected. (default: 0).HP\fB\-conf=\fR<file>.IPSpecify path to read\-only configuration file. Relative paths will beprefixed by datadir location. (default: litecoin.conf).HP\fB\-daemon\fR.IPRun in the background as a daemon and accept commands.HP\fB\-datadir=\fR<dir>.IPSpecify data directory.HP\fB\-dbcache=\fR<n>.IPMaximum database cache size <n> MiB (4 to 16384, default: 450). Inaddition, unused mempool memory is shared for this cache (see\fB\-maxmempool\fR)..HP\fB\-debuglogfile=\fR<file>.IPSpecify location of debug log file. Relative paths will be prefixed by anet\-specific datadir location. (\fB\-nodebuglogfile\fR to disable;default: debug.log).HP\fB\-includeconf=\fR<file>.IPSpecify additional configuration file, relative to the \fB\-datadir\fR path(only useable from configuration file, not command line).HP\fB\-loadblock=\fR<file>.IPImports blocks from external file on startup.HP\fB\-maxmempool=\fR<n>.IPKeep the transaction memory pool below <n> megabytes (default: 300).HP\fB\-maxorphantx=\fR<n>.IPKeep at most <n> unconnectable transactions in memory (default: 100).HP\fB\-mempoolexpiry=\fR<n>.IPDo not keep transactions in the mempool longer than <n> hours (default:336).HP\fB\-par=\fR<n>.IPSet the number of script verification threads (\fB\-64\fR to 15, 0 = auto, <0 =leave that many cores free, default: 0).HP\fB\-persistmempool\fR.IPWhether to save the mempool on shutdown and load on restart (default: 1).HP\fB\-pid=\fR<file>.IPSpecify pid file. Relative paths will be prefixed by a net\-specificdatadir location. (default: litecoind.pid).HP\fB\-prune=\fR<n>.IPReduce storage requirements by enabling pruning (deleting) of oldblocks. This allows the pruneblockchain RPC to be called todelete specific blocks, and enables automatic pruning of oldblocks if a target size in MiB is provided. This mode isincompatible with \fB\-txindex\fR and \fB\-rescan\fR. Warning: Reverting thissetting requires re\-downloading the entire blockchain. (default:0 = disable pruning blocks, 1 = allow manual pruning via RPC,>=550 = automatically prune block files to stay under thespecified target size in MiB).HP\fB\-reindex\fR.IPRebuild chain state and block index from the blk*.dat files on disk.HP\fB\-reindex\-chainstate\fR.IPRebuild chain state from the currently indexed blocks. When in pruningmode or if blocks on disk might be corrupted, use full \fB\-reindex\fRinstead..HP\fB\-settings=\fR<file>.IPSpecify path to dynamic settings data file. Can be disabled with\fB\-nosettings\fR. File is written at runtime and not meant to beedited by users (use litecoin.conf instead for custom settings).Relative paths will be prefixed by datadir location. (default:settings.json).HP\fB\-startupnotify=\fR<cmd>.IPExecute command on startup..HP\fB\-sysperms\fR.IPCreate new files with system default permissions, instead of umask 077(only effective with disabled wallet functionality).HP\fB\-txindex\fR.IPMaintain a full transaction index, used by the getrawtransaction rpccall (default: 0).HP\fB\-version\fR.IPPrint version and exit.PPConnection options:.HP\fB\-addnode=\fR<ip>.IPAdd a node to connect to and attempt to keep the connection open (seethe `addnode` RPC command help for more info). This option can bespecified multiple times to add multiple nodes..HP\fB\-asmap=\fR<file>.IPSpecify asn mapping used for bucketing of the peers (default:ip_asn.map). Relative paths will be prefixed by the net\-specificdatadir location..HP\fB\-bantime=\fR<n>.IPDefault duration (in seconds) of manually configured bans (default:86400).HP\fB\-bind=\fR<addr>[:<port>][=onion].IPBind to given address and always listen on it (default: 0.0.0.0). Use[host]:port notation for IPv6. Append =onion to tag any incomingconnections to that address and port as incoming Tor connections(default: 127.0.0.1:9333=onion, testnet: 127.0.0.1:19335=onion,signet: 127.0.0.1:39335=onion, regtest: 127.0.0.1:19444=onion).HP\fB\-connect=\fR<ip>.IPConnect only to the specified node; \fB\-noconnect\fR disables automaticconnections (the rules for this peer are the same as for\fB\-addnode\fR). This option can be specified multiple times to connectto multiple nodes..HP\fB\-discover\fR.IPDiscover own IP addresses (default: 1 when listening and no \fB\-externalip\fRor \fB\-proxy\fR).HP\fB\-dns\fR.IPAllow DNS lookups for \fB\-addnode\fR, \fB\-seednode\fR and \fB\-connect\fR (default: 1).HP\fB\-dnsseed\fR.IPQuery for peer addresses via DNS lookup, if low on addresses (default: 1unless \fB\-connect\fR used).HP\fB\-externalip=\fR<ip>.IPSpecify your own public address.HP\fB\-forcednsseed\fR.IPAlways query for peer addresses via DNS lookup (default: 0).HP\fB\-listen\fR.IPAccept connections from outside (default: 1 if no \fB\-proxy\fR or \fB\-connect\fR).HP\fB\-listenonion\fR.IPAutomatically create Tor onion service (default: 1).HP\fB\-maxconnections=\fR<n>.IPMaintain at most <n> connections to peers (default: 125).HP\fB\-maxreceivebuffer=\fR<n>.IPMaximum per\-connection receive buffer, <n>*1000 bytes (default: 5000).HP\fB\-maxsendbuffer=\fR<n>.IPMaximum per\-connection send buffer, <n>*1000 bytes (default: 1000).HP\fB\-maxtimeadjustment\fR.IPMaximum allowed median peer time offset adjustment. Local perspective oftime may be influenced by peers forward or backward by thisamount. (default: 2100 seconds).HP\fB\-maxuploadtarget=\fR<n>.IPTries to keep outbound traffic under the given target (in MiB per 24h).Limit does not apply to peers with 'download' permission. 0 = nolimit (default: 0).HP\fB\-networkactive\fR.IPEnable all P2P network activity (default: 1). Can be changed by thesetnetworkactive RPC command.HP\fB\-onion=\fR<ip:port>.IPUse separate SOCKS5 proxy to reach peers via Tor onion services, set\fB\-noonion\fR to disable (default: \fB\-proxy\fR).HP\fB\-onlynet=\fR<net>.IPMake outgoing connections only through network <net> (ipv4, ipv6 oronion). Incoming connections are not affected by this option.This option can be specified multiple times to allow multiplenetworks..HP\fB\-peerblockfilters\fR.IPServe compact block filters to peers per BIP 157 (default: 1).HP\fB\-peerbloomfilters\fR.IPSupport filtering of blocks and transaction with bloom filters (default:0).HP\fB\-permitbaremultisig\fR.IPRelay non\-P2SH multisig (default: 1).HP\fB\-port=\fR<port>.IPListen for connections on <port>. Nodes not using the default ports(default: 9333, testnet: 19335, signet: 19335, regtest: 19444)are unlikely to get incoming connections..HP\fB\-proxy=\fR<ip:port>.IPConnect through SOCKS5 proxy, set \fB\-noproxy\fR to disable (default:disabled).HP\fB\-proxyrandomize\fR.IPRandomize credentials for every proxy connection. This enables Torstream isolation (default: 1).HP\fB\-seednode=\fR<ip>.IPConnect to a node to retrieve peer addresses, and disconnect. Thisoption can be specified multiple times to connect to multiplenodes..HP\fB\-timeout=\fR<n>.IPSpecify connection timeout in milliseconds (minimum: 1, default: 5000).HP\fB\-torcontrol=\fR<ip>:<port>.IPTor control port to use if onion listening enabled (default:127.0.0.1:9051).HP\fB\-torpassword=\fR<pass>.IPTor control port password (default: empty).HP\fB\-upnp\fR.IPUse UPnP to map the listening port (default: 0).HP\fB\-whitebind=\fR<[permissions@]addr>.IPBind to the given address and add permission flags to the peersconnecting to it. Use [host]:port notation for IPv6. Allowedpermissions: bloomfilter (allow requesting BIP37 filtered blocksand transactions), noban (do not ban for misbehavior; impliesdownload), forcerelay (relay transactions that are already in themempool; implies relay), relay (relay even in \fB\-blocksonly\fR mode,and unlimited transaction announcements), mempool (allowrequesting BIP35 mempool contents), download (allow getheadersduring IBD, no disconnect after maxuploadtarget limit), addr(responses to GETADDR avoid hitting the cache and contain randomrecords with the most up\-to\-date info). Specify multiplepermissions separated by commas (default:download,noban,mempool,relay). Can be specified multiple times..HP\fB\-whitelist=\fR<[permissions@]IP address or network>.IPAdd permission flags to the peers connecting from the given IP address(e.g. 1.2.3.4) or CIDR\-notated network (e.g. 1.2.3.0/24). Usesthe same permissions as \fB\-whitebind\fR. Can be specified multipletimes..PPWallet options:.HP\fB\-addresstype\fR.IPWhat type of addresses to use ("legacy", "p2sh\-segwit", or "bech32",default: "bech32").HP\fB\-avoidpartialspends\fR.IPGroup outputs by address, selecting all or none, instead of selecting ona per\-output basis. Privacy is improved as an address is onlyused once (unless someone sends to it after spending from it),but may result in slightly higher fees as suboptimal coinselection may result due to the added limitation (default: 0(always enabled for wallets with "avoid_reuse" enabled)).HP\fB\-changetype\fR.IPWhat type of change to use ("legacy", "p2sh\-segwit", or "bech32").Default is same as \fB\-addresstype\fR, except when\fB\-addresstype\fR=\fI\,p2sh\-segwit\/\fR a native segwit output is used whensending to a native segwit address).HP\fB\-disablewallet\fR.IPDo not load the wallet and disable wallet RPC calls.HP\fB\-discardfee=\fR<amt>.IPThe fee rate (in LTC/kB) that indicates your tolerance for discardingchange by adding it to the fee (default: 0.0001). Note: An outputis discarded if it is dust at this rate, but we will alwaysdiscard up to the dust relay fee and a discard fee above that islimited by the fee estimate for the longest target.HP\fB\-fallbackfee=\fR<amt>.IPA fee rate (in LTC/kB) that will be used when fee estimation hasinsufficient data. 0 to entirely disable the fallbackfee feature.(default: 0.002).HP\fB\-keypool=\fR<n>.IPSet key pool size to <n> (default: 1000). Warning: Smaller sizes mayincrease the risk of losing funds when restoring from an oldbackup, if none of the addresses in the original keypool havebeen used..HP\fB\-maxapsfee=\fR<n>.IPSpend up to this amount in additional (absolute) fees (in LTC) if itallows the use of partial spend avoidance (default: 0.00).HP\fB\-mintxfee=\fR<amt>.IPFees (in LTC/kB) smaller than this are considered zero fee fortransaction creation (default: 0.0001).HP\fB\-paytxfee=\fR<amt>.IPFee (in LTC/kB) to add to transactions you send (default: 0.00).HP\fB\-rescan\fR.IPRescan the block chain for missing wallet transactions on startup.HP\fB\-spendzeroconfchange\fR.IPSpend unconfirmed change when sending transactions (default: 1).HP\fB\-txconfirmtarget=\fR<n>.IPIf paytxfee is not set, include enough fee so transactions beginconfirmation on average within n blocks (default: 6).HP\fB\-wallet=\fR<path>.IPSpecify wallet path to load at startup. Can be used multiple times toload multiple wallets. Path is to a directory containing walletdata and log files. If the path is not absolute, it isinterpreted relative to <walletdir>. This only loads existingwallets and does not create new ones. For backwards compatibilitythis also accepts names of existing top\-level data files in<walletdir>..HP\fB\-walletbroadcast\fR.IPMake the wallet broadcast transactions (default: 1).HP\fB\-walletdir=\fR<dir>.IPSpecify directory to hold wallets (default: <datadir>/wallets if itexists, otherwise <datadir>).HP\fB\-walletnotify=\fR<cmd>.IPExecute command when a wallet transaction changes. %s in cmd is replacedby TxID and %w is replaced by wallet name. %w is not currentlyimplemented on windows. On systems where %w is supported, itshould NOT be quoted because this would break shell escaping usedto invoke the command..HP\fB\-walletrbf\fR.IPSend transactions with full\-RBF opt\-in enabled (RPC only, default: 0).PPZeroMQ notification options:.HP\fB\-zmqpubhashblock=\fR<address>.IPEnable publish hash block in <address>.HP\fB\-zmqpubhashblockhwm=\fR<n>.IPSet publish hash block outbound message high water mark (default: 1000).HP\fB\-zmqpubhashtx=\fR<address>.IPEnable publish hash transaction in <address>.HP\fB\-zmqpubhashtxhwm=\fR<n>.IPSet publish hash transaction outbound message high water mark (default:1000).HP\fB\-zmqpubrawblock=\fR<address>.IPEnable publish raw block in <address>.HP\fB\-zmqpubrawblockhwm=\fR<n>.IPSet publish raw block outbound message high water mark (default: 1000).HP\fB\-zmqpubrawtx=\fR<address>.IPEnable publish raw transaction in <address>.HP\fB\-zmqpubrawtxhwm=\fR<n>.IPSet publish raw transaction outbound message high water mark (default:1000).HP\fB\-zmqpubsequence=\fR<address>.IPEnable publish hash block and tx sequence in <address>.HP\fB\-zmqpubsequencehwm=\fR<n>.IPSet publish hash sequence message high water mark (default: 1000).PPDebugging/Testing options:.HP\fB\-debug=\fR<category>.IPOutput debugging information (default: \fB\-nodebug\fR, supplying <category> isoptional). If <category> is not supplied or if <category> = 1,output all debugging information. <category> can be: net, tor,mempool, http, bench, zmq, walletdb, rpc, estimatefee, addrman,selectcoins, reindex, cmpctblock, rand, prune, proxy, mempoolrej,libevent, coindb, qt, leveldb, validation..HP\fB\-debugexclude=\fR<category>.IPExclude debugging information for a category. Can be used in conjunctionwith \fB\-debug\fR=\fI\,1\/\fR to output debug logs for all categories except oneor more specified categories..HP\fB\-help\-debug\fR.IPPrint help message with debugging options and exit.HP\fB\-logips\fR.IPInclude IP addresses in debug output (default: 0).HP\fB\-logthreadnames\fR.IPPrepend debug output with name of the originating thread (only availableon platforms supporting thread_local) (default: 0).HP\fB\-logtimestamps\fR.IPPrepend debug output with timestamp (default: 1).HP\fB\-maxtxfee=\fR<amt>.IPMaximum total fees (in LTC) to use in a single wallet transaction;setting this too low may abort large transactions (default: 0.10).HP\fB\-printtoconsole\fR.IPSend trace/debug info to console (default: 1 when no \fB\-daemon\fR. To disablelogging to file, set \fB\-nodebuglogfile\fR).HP\fB\-shrinkdebugfile\fR.IPShrink debug.log file on client startup (default: 1 when no \fB\-debug\fR).HP\fB\-uacomment=\fR<cmt>.IPAppend comment to the user agent string.PPChain selection options:.HP\fB\-chain=\fR<chain>.IPUse the chain <chain> (default: main). Allowed values: main, test,signet, regtest.HP\fB\-signet\fR.IPUse the signet chain. Equivalent to \fB\-chain\fR=\fI\,signet\/\fR. Note that the networkis defined by the \fB\-signetchallenge\fR parameter.HP\fB\-signetchallenge\fR.IPBlocks must satisfy the given script to be considered valid (only forsignet networks; defaults to the global default signet testnetwork challenge).HP\fB\-signetseednode\fR.IPSpecify a seed node for the signet network, in the hostname[:port]format, e.g. sig.net:1234 (may be used multiple times to specifymultiple seed nodes; defaults to the global default signet testnetwork seed node(s)).HP\fB\-testnet\fR.IPUse the test chain. Equivalent to \fB\-chain\fR=\fI\,test\/\fR..PPNode relay options:.HP\fB\-bytespersigop\fR.IPEquivalent bytes per sigop in transactions for relay and mining(default: 20).HP\fB\-datacarrier\fR.IPRelay and mine data carrier transactions (default: 1).HP\fB\-datacarriersize\fR.IPMaximum size of data in data carrier transactions we relay and mine(default: 83).HP\fB\-mempoolreplacement\fR.IPEnable transaction replacement in the memory pool (default: 0).HP\fB\-minrelaytxfee=\fR<amt>.IPFees (in LTC/kB) smaller than this are considered zero fee for relaying,mining and transaction creation (default: 0.00001).HP\fB\-whitelistforcerelay\fR.IPAdd 'forcerelay' permission to whitelisted inbound peers with defaultpermissions. This will relay transactions even if thetransactions were already in the mempool. (default: 0).HP\fB\-whitelistrelay\fR.IPAdd 'relay' permission to whitelisted inbound peers with defaultpermissions. This will accept relayed transactions even when notrelaying transactions (default: 1).PPBlock creation options:.HP\fB\-blockmaxweight=\fR<n>.IPSet maximum BIP141 block weight (default: 3996000).HP\fB\-blockmintxfee=\fR<amt>.IPSet lowest fee rate (in LTC/kB) for transactions to be included in blockcreation. (default: 0.00001).PPRPC server options:.HP\fB\-rest\fR.IPAccept public REST requests (default: 0).HP\fB\-rpcallowip=\fR<ip>.IPAllow JSON\-RPC connections from specified source. Valid for <ip> are asingle IP (e.g. 1.2.3.4), a network/netmask (e.g.1.2.3.4/255.255.255.0) or a network/CIDR (e.g. 1.2.3.4/24). Thisoption can be specified multiple times.HP\fB\-rpcauth=\fR<userpw>.IPUsername and HMAC\-SHA\-256 hashed password for JSON\-RPC connections. Thefield <userpw> comes in the format: <USERNAME>:<SALT>$<HASH>. Acanonical python script is included in share/rpcauth. The clientthen connects normally using therpcuser=<USERNAME>/rpcpassword=<PASSWORD> pair of arguments. Thisoption can be specified multiple times.HP\fB\-rpcbind=\fR<addr>[:port].IPBind to given address to listen for JSON\-RPC connections. Do not exposethe RPC server to untrusted networks such as the public internet!This option is ignored unless \fB\-rpcallowip\fR is also passed. Port isoptional and overrides \fB\-rpcport\fR. Use [host]:port notation forIPv6. This option can be specified multiple times (default:127.0.0.1 and ::1 i.e., localhost).HP\fB\-rpccookiefile=\fR<loc>.IPLocation of the auth cookie. Relative paths will be prefixed by anet\-specific datadir location. (default: data dir).HP\fB\-rpcpassword=\fR<pw>.IPPassword for JSON\-RPC connections.HP\fB\-rpcport=\fR<port>.IPListen for JSON\-RPC connections on <port> (default: 9332, testnet:19332, signet: 39332, regtest: 19443).HP\fB\-rpcserialversion\fR.IPSets the serialization of raw transaction or block hex returned innon\-verbose mode, non\-segwit(0) or segwit(1) (default: 2).HP\fB\-rpcthreads=\fR<n>.IPSet the number of threads to service RPC calls (default: 4).HP\fB\-rpcuser=\fR<user>.IPUsername for JSON\-RPC connections.HP\fB\-rpcwhitelist=\fR<whitelist>.IPSet a whitelist to filter incoming RPC calls for a specific user. Thefield <whitelist> comes in the format: <USERNAME>:<rpc 1>,<rpc2>,...,<rpc n>. If multiple whitelists are set for a given user,they are set\-intersected. See \fB\-rpcwhitelistdefault\fR documentationfor information on default whitelist behavior..HP\fB\-rpcwhitelistdefault\fR.IPSets default behavior for rpc whitelisting. Unless rpcwhitelistdefaultis set to 0, if any \fB\-rpcwhitelist\fR is set, the rpc server acts asif all rpc users are subject to empty\-unless\-otherwise\-specifiedwhitelists. If rpcwhitelistdefault is set to 1 and no\fB\-rpcwhitelist\fR is set, rpc server acts as if all rpc users aresubject to empty whitelists..HP\fB\-server\fR.IPAccept command line and JSON\-RPC commands.SH COPYRIGHTCopyright (C) 2011-2026 The Litecoin Core developersCopyright (C) 2009-2026 The Bitcoin Core developersPlease 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 COPYINGor <https://opensource.org/licenses/MIT>