Files
dragonx/util/README.md
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

3.1 KiB

DragonX utilities

Scripts in this directory are used by DragonX developers in the process of development or in releasing a new version of DragonX.

Utilities in this directory:

build.sh

Compile DragonX full node code. This is the main build entrypoint.

build-arm.sh

Compile DragonX full node code for ARM architecture. has not worked for some time

build-arm-xcompile.sh

Cross-Compile DragonX full node code for ARM architecture on an x86 build server.

build-debian-package.sh

Builds an x86 Debian package for DragonX.

build-debian-package-ARM.sh

Builds an ARM Debian package for DragonX.

build-mac.sh

Compile DragonX full node code for mac. NOTE: This is likely broken.

build-win.sh

Compile DragonX full node code for windows

bootstrap-dragonx.sh

Download and apply a DRAGONX blockchain bootstrap so a new node can sync quickly. Safely preserves wallet.dat and configuration files, and verifies the archive against checksums and (once configured) a detached signature. See sign-bootstrap.md for the signing procedure.

sign-bootstrap.md

Documentation for maintainers on how to create the signing keypair and sign the DRAGONX.zip bootstrap archive that bootstrap-dragonx.sh verifies.

checkpoints.pl

Generate checkpoint data for chainparams.cpp . This automates the creation of block heights and block hashes by asking dragonxd (via dragonx-cli) for the data and then generating the C++ code needed to embed them in the DragonX source code.

docker-entrypoint.sh

Script to use DragonX with Docker.

docker-hush-cli.sh

Convenience script to run dragonx-cli in a running Docker container.

replace.pl

Replace a string in a set of files by another string. Very useful for updating a variable name or value across many files, or updating copyrights.

security-check.py

Perform basic ELF security checks on a series of executables.

symbol-check.py

A script to check that the (Linux) executables produced by gitian only contain allowed gcc, glibc and libstdc++ version symbols. This makes sure they are still compatible with the minimum supported Linux distribution versions.

Example usage after a gitian build:

find ../gitian-builder/build -type f -executable | xargs python util/symbol-check.py 

If only supported symbols are used the return value will be 0 and the output will be empty.

If there are 'unsupported' symbols, the return value will be 1 a list like this will be printed:

.../64/test_bitcoin: symbol memcpy from unsupported version GLIBC_2.14
.../64/test_bitcoin: symbol __fdelt_chk from unsupported version GLIBC_2.15
.../64/test_bitcoin: symbol std::out_of_range::~out_of_range() from unsupported version GLIBCXX_3.4.15
.../64/test_bitcoin: symbol _ZNSt8__detail15_List_nod from unsupported version GLIBCXX_3.4.15

gen-manpages.sh

A small script to automatically create manpages in ../../doc/man by running the release binaries with the -help option. This requires help2man which can be found at: https://www.gnu.org/software/help2man/

When you type "make manpages" it runs this script.

gen-linux-binary-release.sh

Generate linux release binary.