History

Tomasz Drwięga bb1bbebfd6 Export account RPC (#4967 ) * Export account RPC * Removing GethDirectory and ParityDirectory * Updating ethstore-cli help.		2017-03-23 13:23:03 +01:00
..
res	better word list for secret phrase generation	2016-11-15 19:37:45 +01:00
src	Export account RPC (#4967 )	2017-03-23 13:23:03 +01:00
tests	unique_repr, no default impl	2017-02-16 23:04:39 +03:00
.editorconfig	secret store separated from util (#1304 )	2016-06-20 00:10:34 +02:00
.gitignore	secret store separated from util (#1304 )	2016-06-20 00:10:34 +02:00
.travis.yml	secret store separated from util (#1304 )	2016-06-20 00:10:34 +02:00
Cargo.toml	Serde 0.9 (#4508 )	2017-02-13 18:38:47 +03:00
README.md	Added vaults support to `ethstore-cli` (#4532 )	2017-02-16 17:42:01 +01:00

README.md

ethstore

Ethereum key management.

Documentation

Usage

Ethereum key management.
  Copyright 2016, 2017 Parity Technologies (UK) Ltd

Usage:
    ethstore insert <secret> <password> [--dir DIR] [--vault VAULT] [--vault-pwd VAULTPWD]
    ethstore change-pwd <address> <old-pwd> <new-pwd> [--dir DIR] [--vault VAULT] [--vault-pwd VAULTPWD]
    ethstore list [--dir DIR] [--vault VAULT] [--vault-pwd VAULTPWD]
    ethstore import [--src DIR] [--dir DIR]
    ethstore import-wallet <path> <password> [--dir DIR] [--vault VAULT] [--vault-pwd VAULTPWD]
    ethstore remove <address> <password> [--dir DIR] [--vault VAULT] [--vault-pwd VAULTPWD]
    ethstore sign <address> <password> <message> [--dir DIR] [--vault VAULT] [--vault-pwd VAULTPWD]
    ethstore public <address> <password> [--dir DIR] [--vault VAULT] [--vault-pwd VAULTPWD]
    ethstore list-vaults [--dir DIR]
    ethstore create-vault <vault> <password> [--dir DIR]
    ethstore change-vault-pwd <vault> <old-pwd> <new-pwd> [--dir DIR]
    ethstore move-to-vault <address> <vault> <password> [--dir DIR] [--vault VAULT] [--vault-pwd VAULTPWD]
    ethstore move-from-vault <address> <vault> <password> [--dir DIR]
    ethstore [-h | --help]

Options:
    -h, --help               Display this message and exit.
    --dir DIR                Specify the secret store directory. It may be either
                             parity, parity-test, geth, geth-test
                             or a path [default: parity].
    --vault VAULT            Specify vault to use in this operation.
    --vault-pwd VAULTPWD     Specify vault password to use in this operation. Please note
                             that this option is required when vault option is set.
                             Otherwise it is ignored.
    --src DIR                Specify import source. It may be either
                             parity, parity-test, get, geth-test
                             or a path [default: geth].

Commands:
    insert             Save account with password.
    change-pwd         Change account password.
    list               List accounts.
    import             Import accounts from src.
    import-wallet      Import presale wallet.
    remove             Remove account.
    sign               Sign message.
    public             Displays public key for an address.
    list-vaults        List vaults.
    create-vault       Create new vault.
    change-vault-pwd   Change vault password.
    move-to-vault      Move account to vault from another vault/root directory.
    move-from-vault    Move account to root directory from given vault or root.

Examples

`insert <secret> <password> [--dir DIR] [--vault VAULT] [--vault-pwd VAULTPWD]`

Encrypt secret with a password and save it in secret store.

<secret> - ethereum secret, 32 bytes long
<password> - account password, file path
[--dir DIR] - secret store directory, It may be either parity, parity-test, geth, geth-test or a path. default: parity
[--vault VAULT] - vault to use in this operation
[--vault-pwd VAULTPWD] - vault password to use in this operation, file path

ethstore insert 7d29fab185a33e2cd955812397354c472d2b84615b645aa135ff539f6b0d70d5 password.txt

a8fa5dd30a87bb9e3288d604eb74949c515ab66e

ethstore insert `ethkey generate random -s` "this is sparta"

24edfff680d536a5f6fe862d36df6f8f6f40f115

`change-pwd <address> <old-pwd> <new-pwd> [--dir DIR] [--vault VAULT] [--vault-pwd VAULTPWD]`

Change account password.

<address> - ethereum address, 20 bytes long
<old-pwd> - old account password, file path
<new-pwd> - new account password, file path
[--dir DIR] - secret store directory, It may be either parity, parity-test, geth, geth-test or a path. default: parity
[--vault VAULT] - vault to use in this operation
[--vault-pwd VAULTPWD] - vault password to use in this operation, file path

ethstore change-pwd a8fa5dd30a87bb9e3288d604eb74949c515ab66e old_pwd.txt new_pwd.txt

true

`list [--dir DIR] [--vault VAULT] [--vault-pwd VAULTPWD]`

List secret store accounts.

[--dir DIR] - secret store directory, It may be either parity, parity-test, geth, geth-test or a path. default: parity
[--vault VAULT] - vault to use in this operation
[--vault-pwd VAULTPWD] - vault password to use in this operation, file path

ethstore list

 0: 24edfff680d536a5f6fe862d36df6f8f6f40f115
 1: 6edddfc6349aff20bc6467ccf276c5b52487f7a8
 2: e6a3d25a7cb7cd21cb720df5b5e8afd154af1bbb

`import [--src DIR] [--dir DIR]`

Import accounts from src.

[--src DIR] - secret store directory, It may be either parity, parity-test, geth, geth-test or a path. default: geth
[--dir DIR] - secret store directory, It may be either parity, parity-test, geth, geth-test or a path. default: parity

ethstore import

 0: e6a3d25a7cb7cd21cb720df5b5e8afd154af1bbb
 1: 6edddfc6349aff20bc6467ccf276c5b52487f7a8

`import-wallet <path> <password> [--dir DIR] [--vault VAULT] [--vault-pwd VAULTPWD]`

Import account from presale wallet.

<path> - presale wallet path
<password> - account password, file path
[--dir DIR] - secret store directory, It may be either parity, parity-test, geth, geth-test or a path. default: parity
[--vault VAULT] - vault to use in this operation
[--vault-pwd VAULTPWD] - vault password to use in this operation, file path

ethstore import-wallet ethwallet.json password.txt

e6a3d25a7cb7cd21cb720df5b5e8afd154af1bbb

`remove <address> <password> [--dir DIR] [--vault VAULT] [--vault-pwd VAULTPWD]`

Remove account from secret store.

<address> - ethereum address, 20 bytes long
<password> - account password, file path
[--dir DIR] - secret store directory, It may be either parity, parity-test, geth, geth-test or a path. default: parity
[--vault VAULT] - vault to use in this operation
[--vault-pwd VAULTPWD] - vault password to use in this operation, file path

ethstore remove a8fa5dd30a87bb9e3288d604eb74949c515ab66e password.txt

true

`sign <address> <password> <message> [--dir DIR] [--vault VAULT] [--vault-pwd VAULTPWD]`

Sign message with account's secret.

<address> - ethereum address, 20 bytes long
<password> - account password, file path
<message> - message to sign, 32 bytes long
[--dir DIR] - secret store directory, It may be either parity, parity-test, geth, geth-test or a path. default: parity
[--vault VAULT] - vault to use in this operation
[--vault-pwd VAULTPWD] - vault password to use in this operation, file path

ethstore sign 24edfff680d536a5f6fe862d36df6f8f6f40f115 password.txt 7d29fab185a33e2cd955812397354c472d2b84615b645aa135ff539f6b0d70d5

c6649f9555232d90ff716d7e552a744c5af771574425a74860e12f763479eb1b708c1f3a7dc0a0a7f7a81e0a0ca88c6deacf469222bb3d9c5bf0847f98bae54901

`public <address> <password> [--dir DIR] [--vault VAULT] [--vault-pwd VAULTPWD]`

Displays public key for an address.

<address> - ethereum address, 20 bytes long
<password> - account password, file path
[--dir DIR] - secret store directory, It may be either parity, parity-test, geth, geth-test or a path. default: parity
[--vault VAULT] - vault to use in this operation
[--vault-pwd VAULTPWD] - vault password to use in this operation, file path

ethstore public 00e63fdb87ceb815ec96ae185b8f7381a0b4a5ea account_password.txt --vault vault_name --vault-pwd vault_password.txt

0x84161d8c05a996a534efbec50f24485cfcc07458efaef749a1b22156d7836c903eeb39bf2df74676e702eacc4cfdde069e5fd86692b5ef6ef81ba906e9e77d82

`list-vaults [--dir DIR]`

List vaults.

[--dir DIR] - secret store directory, It may be either parity, parity-test, geth, geth-test or a path. default: parity

ethstore list-vaults

vault1
vault2
vault3

`create-vault <vault> <password> [--dir DIR]`

Create new vault.

<vault> - name of new vault. This can only contain letters, digits, whitespaces, dashes and underscores
<password> - vault password, file path
[--dir DIR] - secret store directory, It may be either parity, parity-test, geth, geth-test or a path. default: parity

ethstore create-vault vault3 vault3_password.txt

OK

`change-vault-pwd <vault> <old-pwd> <new-pwd> [--dir DIR]`

Change vault password.

<vault> - name of existing vault
<old-pwd> - old vault password, file path
<new-pwd> - new vault password, file path
[--dir DIR] - secret store directory, It may be either parity, parity-test, geth, geth-test or a path. default: parity

ethstore change-vault-pwd vault3 vault3_password.txt new_vault3_password.txt

OK

`move-to-vault <address> <vault> <password> [--dir DIR] [--vault VAULT] [--vault-pwd VAULTPWD]`

Move account to vault from another vault/root directory.

<address> - ethereum address, 20 bytes long
<vault> - name of existing vault to move account to
<password> - password of existing <vault> to move account to, file path
[--dir DIR] - secret store directory, It may be either parity, parity-test, geth, geth-test or a path. default: parity
[--vault VAULT] - current vault of the <address> argument, if set
[--vault-pwd VAULTPWD] - password for the current vault of the <address> argument, if any. file path

ethstore move-to-vault 00e63fdb87ceb815ec96ae185b8f7381a0b4a5ea vault3 vault3_password.txt
ethstore move-to-vault 00e63fdb87ceb815ec96ae185b8f7381a0b4a5ea vault1 vault1_password.txt --vault vault3 --vault-pwd vault3_password.txt

OK
OK

`move-from-vault <address> <vault> <password> [--dir DIR]`

Move account to root directory from given vault.

<address> - ethereum address, 20 bytes long
<vault> - name of existing vault to move account to
<password> - password of existing <vault> to move account to, file path
[--dir DIR] - secret store directory, It may be either parity, parity-test, geth, geth-test or a path. default: parity

ethstore move-from-vault 00e63fdb87ceb815ec96ae185b8f7381a0b4a5ea vault1 vault1_password.txt

OK

Ethcore toolchain

this project is a part of the ethcore toolchain

ethkey - Ethereum keys generator and signer.
ethstore - Ethereum key management.
ethabi - Ethereum function calls encoding.