qu

Minimalistic ledger and governance toolkit for cold wallets.

Disclaimer

YOU EXPRESSLY ACKNOWLEDGE AND AGREE THAT USE OF THIS SOFTWARE IS AT YOUR SOLE RISK. AUTHORS OF THIS SOFTWARE SHALL NOT BE LIABLE FOR DAMAGES OF ANY TYPE, WHETHER DIRECT OR INDIRECT.

Usage

This will sign a transfer transaction and print to STDOUT:

qu --seed-file <path> transfer <account-id> --amount <amount>

To display the signed message in human-readable form:

qu send --dry-run <path-to-file>

qu could be used on an online computer to send any signed transaction:

qu send <path-to-file>

To get the principal and the account id:

qu --seed-file <path> public-ids

Governance

This is how you’d stake/topup a neuron:

qu --seed-file <path> neuron-stake --amount 2.5 --name 1

Managing the neuron:

qu --seed-file <path> neuron-manage <neuron-id> [OPERATIONS]

All of the commands above will generate signed messages, which can be sent on the online machine using the send command from above.

Build

To compile qu run:

1. rustup set profile minimal
2. rustup toolchain install stable --component rustfmt --component clippy
3. rustup override set stable
4. make release

After this, find the binary at target/release/qu.

Contribution

qu is a very critical link in the workflow of the management of valuable assets. qu's code must stay clean, simple, readable and leave no room for ambiguities, so that it can be reviewed and audited by anyone. Hence, if you would like to propose a change, please adhere to the following principles:

1. Be concise and only add functional code.
2. Optimize for correctness, then for readability.
3. Avoid adding dependencies at all costs unless it's completely unreasonable to do so.
4. Every new feature (+ a test) is proposed only after it was tested on real wallets.
5. Increment the last digit of the crate version whenever the functionality scope changes.

Credit

Qu was forked from Quill which was started by me as a side project and then was taken over by an official DFINITY team.