Skip to content

README-CLI.md

Latest commit

 

History

History
90 lines (62 loc) · 2.46 KB

README-CLI.md

File metadata and controls

90 lines (62 loc) · 2.46 KB

Command Line Interface

You can access most of Pysatochip functionality through a command line client satochip-cli. This can be used with Satochip, Satodime and Seedkeeper.

There are a wide range of available commands, each with their own relevant options. The best way to find these is with the --help argument:

python3 satochip-cli --help

You can have more info about a specific command by using the --help argument:

python3 satochip-cli satochip-sign-message --help

There are also some general tools, such as those required to decrypt encrypted Seedkeeper JSON backups. (These can be accessed either standalone or via the module)

installation

To install Pysatochip with the command line feature, you can use this command:

python3 -m pip install pysatochip[CLI]

Or, to install from sources:

python3 setup.py install[CLI]

Sign Nostr event

Note: to use this functionality you will need a card with the Satochip applet v0.14-0.2 or higher.

  • Import a private key on slot #0:
python3 satochip_cli.py --verbose satochip-import-privkey --keyslot 0 --privkey aabbccddeeff00112233445566778899aabbccddeeff00112233445566778899
  • Get the corresponding publick key:
python3 satochip_cli.py --verbose satochip-get-pubkey-from-keyslot --keyslot 0
  • Sign Nostr event
python3 satochip_cli.py --verbose satochip-sign-nostr-event --keyslot 0 --message "Hello, world" --kind 1 --broadcast
  • Alternatively, you can import a BIP39 seed and sign with a key derived from a given path:
python3 satochip_cli.py --verbose satochip-import-unencrypted-mnemonic

python3 satochip_cli.py --verbose satochip-sign-nostr-event --path "m/44'/0'/0'/0/0" --message "Hello, world" --kind 1 --broadcast

Satocash operations

  • setup card (once):
python3 satochip_cli.py --verbose common-initial-setup --label "my label"
  • Get status:
python3 satochip_cli.py --verbose satocash-get-status
  • Get balance:
python3 satochip_cli.py --verbose satocash-get-balances --unit "sat"
  • Import token v4:
python3 satochip_cli.py --verbose satocash-import-tokenv4 --tokenv4 "..."
  • Export token v4:
python3 satochip_cli.py --verbose satocash-export-tokenv4 --unit "sat" --amount "10"