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>
This commit is contained in:
@@ -2,37 +2,42 @@
|
||||
|
||||
## Overview
|
||||
|
||||
Backing up your Hush private keys is the best way to be proactive about preventing loss of access to your HUSH.
|
||||
Backing up your DragonX private keys is the best way to be proactive about preventing loss of access to your DRAGONX.
|
||||
|
||||
Problems resulting from bugs in the code, user error, device failure, etc. may lead to losing access to your wallet (and as a result, the private keys of addresses which are required to spend from them).
|
||||
|
||||
No matter what the cause of a corrupted or lost wallet could be, we highly recommend all users backup on a regular basis. Anytime a new address in the wallet is generated, we recommending making a new backup so all private keys for addresses in your wallet are safe.
|
||||
No matter what the cause of a corrupted or lost wallet could be, we highly recommend all users backup on a regular basis. Anytime a new address in the wallet is generated, we recommend making a new backup so all private keys for addresses in your wallet are safe.
|
||||
|
||||
Note that a backup is a duplicate of data needed to spend HUSH so where you keep your backup(s) is another important consideration. You should not store backups where they would be equally or increasingly susceptible to loss or theft.
|
||||
Note that a backup is a duplicate of data needed to spend DRAGONX so where you keep your backup(s) is another important consideration. You should not store backups where they would be equally or increasingly susceptible to loss or theft.
|
||||
|
||||
Because DragonX is a fully private chain (all ordinary funds live on shielded `zs...`
|
||||
addresses), the shielded keys are what you must protect. The only transparent value a
|
||||
normal user ever holds is mining coinbase; see
|
||||
[hd-transparent-keys.md](hd-transparent-keys.md).
|
||||
|
||||
## Instructions for backing up your wallet and/or private keys
|
||||
|
||||
These instructions are specific for the officially supported Hush Linux client. For backing up with third-party wallets, please consult with user guides or support channels provided for those services.
|
||||
These instructions are for the DragonX full-node command-line client. For backing up with third-party wallets, please consult the user guides or support channels provided for those services.
|
||||
|
||||
There are multiple ways to make sure you have at least one other copy of the private keys needed to spend your HUSH and view your shielded HUSH.
|
||||
There are multiple ways to make sure you have at least one other copy of the private keys needed to spend your DRAGONX and view your shielded DRAGONX.
|
||||
|
||||
For all methods, you will need to include an export directory setting in your config file (`HUSH3.conf` located in the data directory which is `~/.hush/HUSH3` or `~/.komodo/HUSH3` (Legacy Location) unless it's been overridden with `datadir=` setting):
|
||||
For all methods, you will need to include an export directory setting in your config file (`DRAGONX.conf` located in the data directory, which is `~/.hush/DRAGONX` unless it's been overridden with the `datadir=` setting):
|
||||
|
||||
`exportdir=path/to/chosen/export/directory`
|
||||
|
||||
You may chose any directory within the home directory as the location for export & backup files. If the directory doesn't exist, it will be created.
|
||||
You may choose any directory within the home directory as the location for export & backup files. If the directory doesn't exist, it will be created.
|
||||
|
||||
Note that hushd will need to be stopped and restarted for edits in the config file to take effect.
|
||||
Note that dragonxd will need to be stopped and restarted for edits in the config file to take effect.
|
||||
|
||||
### Using `backupwallet`
|
||||
|
||||
To create a backup of your wallet, use:
|
||||
|
||||
`hush-cli backupwallet <nameofbackup>`.
|
||||
`dragonx-cli backupwallet <nameofbackup>`.
|
||||
|
||||
The backup will be an exact copy of the current state of your wallet.dat file stored in the export directory you specified in the config file. The file path will also be returned.
|
||||
|
||||
If you generate a new Hush address, it will not be reflected in the backup file.
|
||||
If you generate a new DragonX address, it will not be reflected in the backup file.
|
||||
|
||||
If your original `wallet.dat` file becomes inaccessible for whatever reason, you can use your backup by copying it into your data directory and renaming the copy to `wallet.dat`.
|
||||
|
||||
@@ -40,51 +45,56 @@ If your original `wallet.dat` file becomes inaccessible for whatever reason, you
|
||||
|
||||
If you prefer to have an export of your private keys in human readable format, you can use:
|
||||
|
||||
`hush-cli z_exportwallet <nameofbackup>`
|
||||
`dragonx-cli z_exportwallet <nameofbackup>`
|
||||
|
||||
This will generate a file in the export directory listing all transparent and shielded private keys with their associated public addresses. The file path will be returned in the command line.
|
||||
|
||||
To import keys into a wallet which were previously exported to a file, use:
|
||||
|
||||
`hush-cli z_importwallet <path/to/exportdir/nameofbackup>`
|
||||
`dragonx-cli z_importwallet <path/to/exportdir/nameofbackup>`
|
||||
|
||||
### Using `z_exportkey`, `z_importkey`, `dumpprivkey` & `importprivkey`
|
||||
|
||||
If you prefer to export a single private key for a shielded address, you can use:
|
||||
For normal use, the shielded (`z_exportkey` / `z_importkey`) commands are what you need:
|
||||
they back up and restore the `zs...` addresses that hold your spendable funds. The
|
||||
transparent commands (`dumpprivkey` / `importprivkey`) only matter if you mine, since on
|
||||
DragonX transparent value only exists as mining coinbase.
|
||||
|
||||
`hush-cli z_exportkey <z-address>`
|
||||
To export a single private key for a shielded address, use:
|
||||
|
||||
`dragonx-cli z_exportkey <z-address>`
|
||||
|
||||
This will return the private key and will not create a new file.
|
||||
|
||||
For exporting a single private key for a transparent address, you can use the command inherited from Bitcoin:
|
||||
For exporting a single private key for a transparent (mining coinbase) address, use the command inherited from Bitcoin:
|
||||
|
||||
`hush-cli dumpprivkey <t-address>`
|
||||
`dragonx-cli dumpprivkey <t-address>`
|
||||
|
||||
This will return the private key and will not create a new file.
|
||||
|
||||
To import a private key for a shielded address, use:
|
||||
|
||||
`hush-cli z_importkey <z-priv-key>`
|
||||
`dragonx-cli z_importkey <z-priv-key>`
|
||||
|
||||
This will add the key to your wallet and rescan the wallet for associated transactions if it is not already part of the wallet.
|
||||
|
||||
The rescanning process can take a few minutes for a new private key. To skip it, instead use:
|
||||
|
||||
`hush-cli z_importkey <z-private-key> no`
|
||||
`dragonx-cli z_importkey <z-private-key> no`
|
||||
|
||||
For other instructions on fine-tuning the wallet rescan, see the command's help documentation:
|
||||
|
||||
`hush-cli help z_importkey`
|
||||
`dragonx-cli help z_importkey`
|
||||
|
||||
To import a private key for a transparent address, use:
|
||||
To import a private key for a transparent (mining coinbase) address, use:
|
||||
|
||||
`hush-cli importprivkey <t-priv-key>`
|
||||
`dragonx-cli importprivkey <t-priv-key>`
|
||||
|
||||
This has the same functionality as `z_importkey` but works with transparent addresses.
|
||||
|
||||
See the command's help documentation for instructions on fine-tuning the wallet rescan:
|
||||
|
||||
`hush-cli help importprivkey`
|
||||
`dragonx-cli help importprivkey`
|
||||
|
||||
### Using `dumpwallet`
|
||||
|
||||
|
||||
Reference in New Issue
Block a user