ELEMENTS-WALLET(1)

📦
version 23.3.4 · 2 versions
, in nixpkgs unstable

💖 ELEMENTS-WALLET(1) 💖

okay so bestie, welcome to the elements-wallet glow-up page 💅 this is the manual for elements-wallet, and yes it's a real one, from the User Commands section, no cap.

✨ NAME ✨

elements-wallet — literally the manual page for elements-wallet v23.3.4, she's an icon, she's a legend, and she's right here 🎀

🌸 DESCRIPTION 🌸

This is Elements Core elements-wallet version v23.3.4 💜

So what is she? elements-wallet is an offline tool for creating and interacting with Elements Core wallet files — offline, meaning she's not out here gossiping with the network, she's just handling her business locally 🧚

By default, elements-wallet acts on wallets in the default mainnet wallet directory in the datadir. That's the default vibe. But if you wanna change the target wallet (and honestly, valid), you use the -datadir, -wallet and -regtest/-signet/-testnet arguments ✨

🦋 Usage:

elements-wallet [options] <command>

That's it. Options first, command after. Slay.

👑 OPTIONS 👑

🌈 The main-character options

  • -? — prints this help message and dips. exit stage left 🫶
  • -datadir=<dir> — specify the data directory, aka where she keeps her stuff.
  • -descriptors — creates a descriptors wallet. Only for create, okay?? only for create 💅
  • -dumpfile=<file name> — when you use it with dump, she writes out the records to this file. When you use it with createfromdump, she loads the records into a new wallet. Two moods, one flag 😌
  • -format=<format> — the format of the wallet file to create. Either "bdb" or "sqlite". Only used with createfromdump. pick your fighter ⭐
  • -legacy — creates a legacy wallet. Only for create (yes, another one that's only for create, keep up bestie 🎀)
  • -version — print version and exit. short, sweet, iconic.
  • -wallet=<wallet-name> — specify the wallet name. that's her name, use it 💖

🐛 Debugging/Testing options:

  • -debug=<category> — output debugging information (default: 0).
  • -printtoconsole — send trace/debug info to console (default: 1 when no -debug is true, 0 otherwise). yes, the default is conditional, she's ✨complex✨

⛓️ Chain selection options:

  • -chain=<chain> — use the chain <chain> (default: liquidv1). Reserved values: main, test, signet, regtest, liquidv1, liquidv1test, liquidtestnet. so many options, so little time 🌈
  • -con_blockheightinheader — whether the chain includes the block height directly in the header, for easier validation of block height in low-resource environments. (default: 1) — low-resource friendly, we love accessible validation 💜
  • -con_has_parent_chain — whether or not there is a parent chain. yes/no, she's asking 🦋
  • -con_max_block_sig_size — max allowed witness data for the signed block header.
  • -con_parent_chain_signblockscript — whether the parent chain uses pow or signed blocks. If the parent chain uses signed blocks, the challenge (scriptPubKey) script. If not, an empty string. (default: empty script [ie parent uses pow])
  • -con_parentpowlimit — the proof-of-work limit value for the parent chain.
  • -con_signed_blocks — signed blockchain. Uses input of -signblockscript to define what signatures are necessary to solve it.
  • -fedpegscript — the script for the federated peg enforce from genesis block. This script may stop being enforced once dynamic federations activates. ⚠️ important detail, don't skip it ⚠️
  • -parentgenesisblockhash — the genesis blockhash of the parent chain.
  • -signblockscript — signed blockchain enumberance. Only active when -con_signed_blocks is set to true. (and yes, "enumberance" is what it says, I don't make the rules 💀)
  • -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)). collect them like stickers 🎀
  • -testnet — use the test chain. Equivalent to -chain=test.

💎 Elements Options:

  • -acceptunlimitedissuances — allow unblinded issuance amounts to exceed 21 million units. 21 million who? not her, apparently 🙈
  • -con_blocksubsidy — defines the amount of block subsidy to start with, at genesis block, in satoshis.
  • -con_connect_genesis_outputs — connect outputs in genesis block to utxo database.
  • -con_csv_deploy_start — starting height for CSV deployment. (default: -1, which means ACTIVE from genesis) active from birth, main character energy 👑
  • -con_dyna_deploy_signal — whether to signal for the Dynamic Federations deployment (default: 1).
  • -con_elementsmode — use Elements-like instead of Core-like witness encoding. This is required for CA/CT. (default: 1). required, bestie, not optional, read it again 💅
  • -con_mandatorycoinbase — all non-zero valued coinbase outputs must go to this scriptPubKey, if set.
  • -dynamic_epoch_length — per-chain parameter that sets how many blocks dynamic federation voting and enforcement are in effect for.
  • -enforce_pak — causes standardness checks to enforce Pegout Authorization Key (PAK) validation before dynamic federations, and consensus enforcement after.
  • -multi_data_permitted — allow relay of multiple OP_RETURN outputs. (default: -enforce_pak)
  • -pak — sets the 'first extension space' field to the pak entries ala pre-dynamic federations. Only used for testing in custom chains. testing only, don't be weird about it 🧚
  • -total_valid_epochs — per-chain parameter that sets how long a particular fedpegscript is in effect for.

🎀 Commands: 🎀

  • create — create new wallet file. fresh start, new me ✨
  • createfromdump — create new wallet file from dumped records.
  • dump — print out all of the wallet key-value records.
  • info — get wallet info. she'll tell you everything 💖
  • salvage — attempt to recover private keys from a corrupt wallet. Warning: salvage is experimental. 🚨 like, genuinely, it says experimental, so go in knowing that 🚨

Copyright (C) 2009-2026 The Elements Project developers Copyright (C) 2009-2026 The Bitcoin Core developers

Please contribute if you find Elements Core useful 🫶 Visit <https://elementsproject.org/> for further information about the software. The source code is available from <https://github.com/ElementsProject/elements>.

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

okay that's the whole page, go forth and be iconic 🌈💅 and just so we're official: this was elements-wallet v23.3.4, dated September 2026, and the page itself is ELEMENTS-WALLET(1). mwah 💋 🎀

📦 where this page comes from