Files

DanS 46693a355a docs: rebrand documentation, packaging, and helper scripts to DragonX

The docs/packaging were largely un-rebranded Hush3 content, with several
docs stating facts that are wrong for DragonX. This rewrites them against
the verified DragonX source state.

Corrections (not just branding):
- PoW: RandomX (CPU), not Equihash/ASIC — README, overview.md, randomx.md
- Privacy: private from genesis (ac_private=1, Sapling@height1), not "as of
  block 340000" — overview.md, payment-api.md
- Removed the false "coinbase must be shielded" consensus claim
  (shield-coinbase.md, payment-api.md); coinbase is directly spendable
- Fixed default fee 0.0001 (was 0.0010000, 10x); stratum port 22769 (was 19031)
- datadir ~/.hush/DRAGONX, DRAGONX.conf, dragonxd/dragonx-cli/dragonx-tx,
  git.dragonx.is throughout; branch model dev->dragonx
- Softened the inherited dPoW reorg claim (no live DragonX notary infra)

Packaging: fix build-debian-package.sh + gen-manpages.sh to use the dragonx
binaries/manpages; rename bash-completions to dragonx*; drop hush-arrakis-chain
from the package. Keep /usr/share/hush (hardcoded in the binary for params).

Also: README links/logo, ObsidianDragon + SilentDragonXAndroid wallets,
networking/init/dev-process/contrib/util rebrand, and leftover helper scripts.
Delete legacy duplicates (hushd.* init/service, HUSH3.conf examples,
OLD_WALLETS.md, hsc.md) and rename hush-uri.bat -> dragonx-uri.bat.

Out of scope (noted, not changed): historical changelog/copyright, the Hush
mainnet airdrop snapshot, seed data files, depends/ source mirrors, and the
in-code strCurrencyUnits="HUSH".

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-07-21 13:59:06 -05:00

4.1 KiB

Raw Blame History

zsweep and consolidation

This is to document zsweep and consolidation for advanced DragonX users.

Warning: If you don't know what Zsweep or Consolidation are, there is a good chance that you will not be using these advanced options. User beware!

Using Zsweep
Using Consolidation
Using Zsweep & Consolidation Together

Pre-Step & Further Details

A user can use these options at the command line, but it is recommended to configure these options within the DRAGONX.conf file.

Consolidation takes many unspent shielded UTXOs (zutxos) into one zutxo, which makes spending them in the future faster and potentially cost less in fees. It also helps prevent certain kinds of metadata leakages and spam attacks. It is not recommended for very large wallets (wallet.dat files with thousands of transactions) for performance reasons. This is why it defaults to OFF for CLI full nodes but ON for GUI wallets that use an embedded dragonxd.

Zsweep is when you sweep numerous zutxos into one z-address that you configure. This z-address can be local to that system or it can be configured to sweep to a remote wallet on a different system with the zsweepexternal=1 option, which is explained below in the Zsweep section.

Zsweep

We add the following to our conf file as per the Pre-Step.
```
zsweep=1
zsweepaddress=zs1...
```
The above zsweepaddress will be the z-address you want to sweep into (zs1... is a placeholder for this documentation) and it must exist within the same local wallet you are configuring this for. If you want to zsweep to an address on another computer, then set zsweepexternal=1 as explained in the options below.

The following are optional zsweep settings with their details:

Zsweep Option Name	Details of what it does
zsweepexternal=1	Will enable the option to zsweep to an "external" z-address which exists in a wallet on a different system.
zsweepinterval=5	By default zsweep runs every 5 blocks, so set and modify this value to change that.
zsweepmaxinputs=8	By default zsweep makes sure to not reduce the anonset in any tx by having a maximum number of inputs of 8. This should be fine for new wallets, but if you have an existing wallet with many zutxos it can be changed with this option. Keep in mind that large values will make sweeping faster at the expense of reducing the AnonSet.
zsweepfee=0	The default zsweep fee is 10000 puposhis or 0.0001 DRAGONX, the default for all transactions. To use fee=0 for zsweep transactions, set this option.
zsweepexclude=zs1...	Exclude a certain address from being swept. Can be used multiple times to exclude multiple addressses

The following DragonX RPC will let you view your zsweep configuration options and run-time stats at the command line: dragonx-cli z_sweepstatus

Consolidation

We add the following to our conf file as per the Pre-Step.
```
consolidation=1
```

The following are optional consolidation settings with their details:

Consolidation Option Name	Details of what it does
consolidationtxfee=0	The default consolidation fee is 10000 puposhis or 0.0001 DRAGONX, the default for all transactions. To use fee=0 for consolidation transactions, set this option.
consolidatesaplingaddress=zs1...	Default of consolidation is set to all, but you can set this option if you have one specific z-address (zs1... is a placeholder for this documentation) that you want to only consolidate to.

The following DragonX RPC will let you view your consolidation configuration options and run-time stats at the command line: dragonx-cli z_sweepstatus

Zsweep & Consolidation Together

We add the following to our conf file as per the Pre-Step.
```
zsweep=1
zsweepaddress=zs1...
consolidation=1
```
Then follow along with the zsweep section above if you want to set specific options for the zsweep behavior.

Copyright

The DragonX Developers, jahway603, and The Hush Developers

License

GPLv3

4.1 KiB Raw Blame History