SilentDragonPaper

SilentDragonPaper is a paper wallet generator that can be run completely offline.

You can run it on an air-gapped computer to generate your shielded z-addresses, which will allow you to keep your keys completely offline.

Example:

Download

Two options for Download, either a pre-built binary or you compile it yourself.

Binary installation

SilentDragonPaper is available as pre-built binaries from our release page. Download the zip file for your platform, extract it and run the ./SilentDragonPaper binary.

Source code installation

If you decide to compile from source, then first use git to get the source code as follows:

git clone https://git.hush.is/hush/SilentDragonPaper

Then choose one of these two source compilation options to build the SilentDragonPaper CLI.

Recommended Option : Compile using "embedded" rust

Here we do not need a system installed Rust to compile. The build.sh script pulls Rust version 1.51.0 down for us and builds with it.

cd SilentDragonPaper
./build.sh

Advanced Option : Compile using system installed rust

SilentDragonPaper is built with Rust. To compile from source, you must install at least Rust 1.51.0. Please report any issues if a particular version of Rust does not compile this, but I have successfully built this with rustc 1.64.0 (a55dd71d5 2022-09-19).

cd SilentDragonPaper/cli
cargo vendor
cargo build --release --offline

After building, the completed binary will be available in the cli/target/release folder.

Usage Instructions

Generating wallets

To generate a Hush paper wallet, simply run one of the following below as the exact command will depend on the method you used to install or compile it.

./SilentDragonPaper
./target/release/SilentDragonPaper
./cli/target/release/SilentDragonPaper

You'll be asked to type some random characters that will add entropy to the random number generator. Run with --help to see all options

Saving as PDFs

To generate a Hush paper wallet and save it as a PDF, run:

./SilentDragonPaper -z 3 --format pdf sdp.pdf

This will generate 3 shielded z-addresses and their corresponding private keys, and save them in a PDF file called sdp.pdf

Vanity Addresses

You can generate a "vanity address" (that is, an address starting with a given prefix) by specifying a --vanity argument with the prefix you want.

Note that generating vanity addresses with a prefix longer than 4-5 characters is computationally expensive. You can run it on multiple CPUs on your computer by specifying the --threads option.

Ensuring Security

When generating paper wallets that will store large amounts of crypto, please take special care to ensure the keys are generated and kept completely offline.

1. SilentDragonPaper supports ARMv8 (Raspberry Pi 3+). You can put one in a Faraday cage along with a printer, and print out the PDFs securely.
2. Please ensure you supply random entropy when you run SilentDragonPaper. Your entropy is mixed in with system-provided entropy to generate keys.
3. If you can, run with unshare, which will disable all network interfaces to a process, providing you with an additional layer of safety. (See next section)
4. After you've generated the keys, you can tear off the Address potion of the wallet and take it to your online computer/phone to send the address funds. Please always keep the private key offline.
5. When you're ready to spend the cold storage keys, import the private key into a full node, then don't re-use the key again.

Run without network

If you are running a newish version of Linux, you can be doubly sure that the process is not contacting the network by running SilentDragonPaper without the network namespace.

sudo unshare -n ./target/release/SilentDragonPaper

unshare -n runs the process without a network interface which means you can be sure that your data is not being sent across the network.

Help options

USAGE:
    SilentDragonPaper [FLAGS] [OPTIONS] [output]

FLAGS:
    -h, --help       Prints help information
    -n, --nohd       Don't reuse HD keys. Normally, SilentDragonPaper will use the same HD key to derive multiple
                     addresses. This flag will use a new seed for each address
    -V, --version    Prints version information

OPTIONS:
    -e, --entropy <entropy>       Provide additional entropy to the random number generator. Any random string,
                                  containing 32-64 characters
    -f, --format <FORMAT>         What format to generate the output in [default: json]  [possible values: pdf, json]
    -t, --taddrs <t_addresses>    Numbe rof T addresses to generate [default: 0]
        --threads <threads>       Number of threads to use for the vanity address generator. Set this to the number of
                                  CPUs you have [default: 1]
        --vanity <vanity>         Generate a vanity address with the given prefix.
                                  Note that ['b', 'i', 'o', '1'] are not allowed in addresses.
    -z, --zaddrs <z_addresses>    Number of Z addresses (Sapling) to generate [default: 1]

ARGS:
    <output>    Name of output file.

Support and Socials

Please feel free to join us on Telegram for official support:

• Main group: https://hush.is/tg
• Support group: https://hush.is/telegram_support
• Mining group: https://hush.is/telegram_mining

If you prefer Matrix, then please join our Matrix chatrooms which are bridged to the above Telegram rooms:

• Main group: #hush_main:matrix.org
• Support group: #hush_support:matrix.org
• Mining group: #hush_mining:matrix.org

Other socials:

• PeerTube: videos.hush.is
• Twitter: @hushisprivacy
• Mastodon: @myhushteam@fosstodon.org
• Reddit: @Myhush

Copyright

Released under the GNU Public License Version 3 or later.

Copyright (c) 2019-2023 The Hush Developers

Copyright (c) 2019 adityapk00

License

GPLv3 or later.

See LICENSE file for details.