Skip to content

Minimalistic governance & ledger toolkit for cold wallets

License

Notifications You must be signed in to change notification settings

chenyan-dfinity/quill

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

quill

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:

quill --pem-file <path> transfer <account-id> --amount <amount>

To display the signed message in human-readable form:

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

quill could be used on an online computer to send any signed transactions:

quill send <path-to-file>

To get the principal and the account id:

quill --pem-file <path> public-ids

Governance

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

quill --pem-file <path> neuron-stake --amount 2.5 --name 1

Managing the neuron:

quill --pem-file <path> neuron-manage <neuron-id> [OPERATIONS]

Currently supported operations are: --start-dissolving, --stop-dissolving, --disburse, --add-hot-key, --remove-hot-key, --spawn, --split.

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

Download

Use binaries from the latest release.

Build

To compile quill 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/quill.

Contribution

quill is a very critical link in the workflow of the management of valuable assets. quill'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 principals:

  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.
  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

Originally forked from the SDK.

About

Minimalistic governance & ledger toolkit for cold wallets

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Rust 92.5%
  • Shell 6.6%
  • Makefile 0.9%