ELEMENTS-UTIL(1)

📦
version 23.3.4 · 2 versions
, in nixpkgs unstable

💖 ELEMENTS-UTIL(1) 💖

okay bestie so this is elements-util, from manual page ELEMENTS-UTIL(1) — a manual page for elements-util v23.3.4, and it's giving "tiny utility, big secrets." sit down, grab a strawberry 🍓, and let's go.

✨ SYNOPSIS ✨

bitcoin-util [options] [commands]  Do stuff

yes. "Do stuff." that's the whole pitch. iconic, honestly. 👑

🦋 DESCRIPTION 🦋

Elements Core bitcoin-util utility version v23.3.4 — that's literally what it is. no notes. 💅

🎀 OPTIONS 🎀

the basics, the essentials, the necessities

  • -? — prints this help message and dips. bye! 👋
  • -version — prints the version and dips. same energy.

Debugging/Testing options:

so this heading exists and… it's empty, bestie. nothing under it. no cap. moving on. 🫶

Chain selection options:

  • -chain=<chain> — use the chain <chain>. default is liquidv1. the reserved values are: main, test, signet, regtest, liquidv1, liquidv1test, liquidtestnet. pick your fighter 🌈
  • -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. lowkey so considerate 💖
  • -con_has_parent_chain — whether or not there is a parent chain. that's it. that's the whole thing. do you have a parent chain or not, bestie 😭
  • -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, this is the challenge (scriptPubKey) script. if not, it's 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. heads up fr 🫡
  • -parentgenesisblockhash — the genesis blockhash of the parent chain.
  • -signblockscript — signed blockchain enumberance. only active when -con_signed_blocks set to true. (yes, "enumberance" — we do not fix typos in this house, we preserve them like pressed flowers 🌸)
  • -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 all 🧚
  • -testnet — use the test chain. equivalent to -chain=test.

Elements Options:

  • -acceptunlimitedissuances — allow unblinded issuance amounts to exceed 21 million units. unblinded!! exceeding 21 million!!! bestie be so careful with this one 😭
  • -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. love a dramatic all-caps default ✨
  • -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.
  • -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.
  • -total_valid_epochs — per-chain parameter that sets how long a particular fedpegscript is in effect for.

Commands:

  • grind — perform proof of work on hex header string. go off, king 💀⚡

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

please contribute if you find Elements Core useful, bestie — 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>. experimental, okay?? treat it with respect 🙈

and that's the whole vibe. this page is elements-util v23.3.4, dated September 2026, footer says ELEMENTS-UTIL(1) — slay, stay safe, and read your COPYING file 💜🎀🦋

📦 where this page comes from