Používání příkazů trezorctl

Příkazy trezorctl jsou nástroje napsané v programovacím jazyce Python, které lze použít s Trezor zařízením prostřednictvím příkazového řádku.

Pro kompletního průvodce používáním těchto příkazů navštivte naši speciální stránku na GitHubu zde.

Nainstalujte python-trezor

Upozorňujeme, že tento návod byl testován s python-trezor 0.11.2 na následujících čistých systémech:

• Linux Mint 19
• Ubuntu 19.04.1 LTTS (Bionic Beaver)

Funguje s Trezor Model One (verze bootloaderu 1.6.0 a firmware verze 1.7.0 nebo novější) a Trezor Model T.

1 – Aktualizujte repozitáře a nainstalujte závislosti:

sudo apt update && sudo apt install -y python3-pip python3-dev libusb-1.0-0-dev libudev-dev

Poznámka: Knihovny libusb a libudev nejsou potřeba, pokud máte na pozadí spuštěnou Trezor Suite.

2 – Nainstalujte setuptools a wheel:

pip3 install setuptools wheel

3 – Nainstalujte python-trezor:

pip3 install trezor

4 – Aktualizujte svůj $PATH příkazem:

source .profile

5 – Nastavte na svém systému Udev pravidla:

Nyní můžete používat Python nástroje pro změnu nastavení v zařízení Trezor, podepisování transakcí, získávání informací o účtech a adresách a mnoho dalšího!

aktualizace verze python-trezor

Nejnovější verzi python-trezor si můžete ověřit na této stránce. Pro aktualizaci verze python-trezor spusťte:

pip3 install -U trezor

Příkazy, volby a příklady

Získat adresu

trezorctl get-address

Popis: tento příkaz vrátí adresu pro zadanou BIP32 cestu a typ skriptu.

Povinná volba: -n nebo --address BIP32 cesta, např. "m/49'/0'/0'/0/0"

Další volby:

• -c nebo --coin

Podporované typy mincí: bitcoin, testnet, Bcash, Bgold, Bitcore, Bprivate, Crown, Dash, Decred, Decred testnet, DigiByte, Dogecoin, Feathercoin, Flashcoin, Fujicoin, Groestlcoin, Groestlcoin testnet, Koto, Litecoin, Litecoin testnet, Monacoin, MonetaryUnit, Pesetacoin, SmartCash, Terracoin, Vertcoin, Viacoin, Zcash, Zcash testnet, Zcoin, Zencash

• -t nebo --script-type

Můžete určit, jaký typ skriptu adresy použít pro získání xpub, např. address/segwit/p2shsegwit

• -d nebo --show-display

Tato volba zobrazí konkrétní adresu na displeji Trezoru.

Příklad:

trezorctl get-address -n "m/49'/0'/0'/0/0" -t "p2shsegwit" -d

Vymazání zařízení Trezor

trezorctl wipe-device

Popis: tento příkaz resetuje zařízení Trezor na tovární nastavení a odstraní všechna privátní data. Pokud zařízení není v režimu bootloaderu, smaže uživatelská data. Pokud zařízení není v režimu bootloaderu, ale je použita volba --bootloader, zobrazí se výzva ke vstupu do režimu bootloaderu. Pokud je zařízení v režimu bootloaderu a použije se volba --bootloader, smažou se jak uživatelská data, tak firmware. Pokud je zařízení v režimu bootloaderu a volba --bootloader není použita, zobrazí se upozornění, že zařízení je v režimu bootloaderu.

Nepovinné:

• -nápověda

Zobrazit popis

• -b nebo --bootloader

Vymažte zařízení v režimu bootloaderu. Tím se také smaže firmware.

Příklad:

trezorctl wipe-device

Aktualizace firmwaru

trezorctl firmware-update

Popis: tento příkaz stáhne a nainstaluje vybraný firmware na zařízení Trezor, zařízení musí být v režimu bootloaderu.

Nepovinné:

• --nápověda

Zobrazit popis

• -f nebo --filename

Tato volba umožňuje uživateli zvolit soubor, ze kterého má být firmware nainstalován. Můžete nainstalovat konkrétní verzi firmware (.bin soubor), stáhněte si ji z této stránky Github

Příklad:

trezorctl firmware-update -f trezor-2.1.0.bin

• -u nebo --url

Přímo zadáte URL souboru firmware, který chcete nainstalovat.

Příklad:

trezorctl firmware-update -u https://github.com/trezor/webwallet-data/raw/master/firmware/2/trezor-2.1.0.bin

• -v nebo --version

Můžete zadat verzi firmware, kterou chcete nainstalovat.

Příklad:

trezorctl firmware-update -v 2.1.0

• --podpis

Při aktualizaci firmware můžete zadat otisk nainstalovaného firmware. Zkontroluje, zda se otisk verze shoduje se zadaným otiskem. Pokud není verze definována, otisk se porovná s otiskem nejnovějšího firmware.

Příklad pro firmware 2.1.0:

trezorctl firmware-update 
--fingerprint bb5b0308807b45d41d1e2ab66a468152997ad69a01099789d8a35e464cde999f

Zálohujte své zařízení

trezorctl backup-device

Popis: tento příkaz zobrazí zálohu peněženky (obnovovací frázi) ze zařízení Trezor dvakrát. Zařízení musí být před použitím tohoto příkazu inicializováno. Zobrazení zálohy peněženky (obnovovací fráze) na displeji zařízení umožní uživateli správně zálohovat zařízení.

Změnit PIN

trezorctl change-pin

Popis: tento příkaz umožňuje uživateli změnit nebo odebrat ochranu PIN zařízení Trezor.

Nepovinné:

• -r nebo --remove

Tato volba umožňuje uživateli odstranit ochranu PIN ze zařízení.

Znovu načíst relaci

trezorctl clear-session

Popis: tento příkaz vymaže relaci zařízení (odstraní uložený PIN, passphrase atd.).

Zakázat passphrase

trezorctl disable-passphrase

Popis: tento příkaz zakáže ochranu passphrase. Musí být potvrzeno uživatelem na zařízení.

Povolit passphrase

trezorctl enable-passphrase

Popis: tento příkaz zapne ochranu passphrase. Musí být potvrzeno uživatelem na zařízení.

Inicializovat zařízení

trezorctl reset-device

Popis: tento příkaz inicializuje zařízení a po nainstalování nového firmware vygeneruje nový seed. Jde o stejný postup jako při inicializaci zařízení a vytvoření nové peněženky na trezor.io/start. Pomocí tohoto příkazu může uživatel nastavit délku obnovovací fráze na obou zařízeních, povolit ochranu PIN nebo passphrase, nastavit popisek Trezoru, nastavit vlastní U2F čítač nebo přeskočit proces zálohování.

Možnosti:

• -b nebo --backup_type

Tato možnost umožňuje zvolit mezi tradiční jednorázovou BIP-39 zálohou peněženky (obnovovací fráze) nebo Multi-share / záloha Shamir.

Příklad:

trezorctl reset-device -b shamir -t 128

Tímto se zařízení inicializují s Multi-share / zálohou Shamir s 20slovnými podíly. Změnou hodnoty pro volbu -t na 256 vytvoříte peněženku s 33slovnými podíly.

• -t nebo --strength

Tato možnost umožňuje uživateli zvolit verzi zálohy peněženky (obnovovací fráze). Možnosti jsou 128 bitů (12 slov), 192 bitů (18 slov) a 256 bitů (24 slov). Výchozí nastavení je 256 bitů (24 slov).

Příklad (vytvoření nové peněženky s 18slovnou zálohou peněženky / obnovovací frází):

trezorctl reset-device -t 192

• -r nebo --passphrase-protection

Tato možnost aktivuje ochranu passphrase po vytvoření nové peněženky.

• -p nebo --pin-protection

Tato možnost umožňuje uživateli nastavit PIN před vytvořením nové peněženky.

• -l nebo --label

Tato možnost umožňuje uživateli nastavit popisek zařízení před vytvořením nové peněženky.

Příklad:

trezorctl reset-device -l "MyTrezor"

• -u nebo --u2f-counter

Tato možnost umožňuje uživateli nastavit vlastní U2F čítač.

• -s nebo --skip-backup

Tato možnost umožňuje uživateli přeskočit proces zálohování – dvakrát zobrazí zálohu peněženky (obnovovací fráze) na displeji zařízení. Při použití této možnosti se na displeji Trezoru zobrazí hláška "Vyžaduje zálohu" po vytvoření nové peněženky.

Bezpečnostní kontroly

trezorctl set safety-checks [OPTIONS] [strict|prompt]

Popis: nastavení úrovně bezpečnostních kontrol. Nastavte na "strict" pro plné zabezpečení Trezoru. Nastavte na "prompt" pokud chcete mít možnost povolit potenciálně nebezpečné akce, například nesoulad klíčů mincí nebo extrémní poplatky. Toto je funkce pro pokročilé uživatele. Používejte opatrně.

Příklad:

trezorctl set safety-checks prompt

Získat funkce

trezorctl get-features

Popis: tento příkaz získá vlastnosti a nastavení zařízení.

Ukázka odpovědi příkazu get-features:

device_id: '3B5328CA18BAE5F0553BCD3A',
   flags: 0,
   initialized: True,
   language: 'english',
   major_version: 2,
   minor_version: 1,
   model: 'T',
   needs_backup: False,
   no_backup: False,
   passphrase_cached: False,
   passphrase_protection: True,
   patch_version: 0,
   pin_cached: True,
   pin_protection: True,
   revision: 8 bytes b'3f0e3a33',
   unfinished_backup: False,
   vendor: 'trezor.io',

Získat veřejný uzel

trezorctl get-public-node

Popis: tento příkaz získá rozšířený veřejný klíč, který lze použít pro vytvoření peněženky pouze pro sledování.

Povinná možnost:

• -n nebo --address

Příklad:

trezorctl get-public-node -n "m/44'/0'/0'/0/0"

Možnosti:

• -c nebo --coin

Podporované typy mincí: bitcoin, testnet, Bcash, Bgold, Bitcore, Bprivate, Crown, Dash, Decred, Decred Testnet, DigiByte, Dogecoin, Feathercoin, Flashcoin, Fujicoin, Groestlcoin, Groestlcoin Testnet, Koto, Litecoin, Litecoin Testnet, Monacoin, MonetaryUnit, Pesetacoin, SmartCash, Terracoin, Vertcoin, Viacoin, Zcash, Zcash Testnet, Zcoin, Zencash

• -d nebo --show-display

Tato možnost zobrazí veřejný klíč uzlu na displeji Trezoru.

• -t nebo --script-type

Můžete zadat typ skriptu adresy pro získání xpub, např. address/segwit/p2shsegwit

Seznam

trezorctl list

Popis: tento příkaz vypíše všechna připojená zařízení Trezor.

Ping

trezorctl ping

Popis: tento příkaz odešle zprávu ping na zařízení, aby ověřil komunikaci mezi počítačem a zařízením.

Příklad:

trezorctl ping "ahoy!"

Možnosti:

• -b nebo --button-protection

Tato možnost vyžaduje, aby uživatel potvrdil na zařízení přijetí zprávy ping.

• -p nebo --pin-protection

Tato možnost vyžaduje, aby uživatel před odesláním ping zprávy na zařízení zadal ochranu PIN .

• -r nebo --passphrase-protection

Tato možnost vyžaduje, aby uživatel před odesláním ping zprávy zadal passphrase.

Obnovit zařízení

trezorctl recovery-device

Popis: tento příkaz spustí bezpečné obnovení peněženky pomocí zálohy peněženky (obnovovací fráze).

Možnosti:

• -w nebo --words

Tato možnost umožňuje uživateli zvolit počet slov zálohy peněženky / obnovovací fráze (12, 18 nebo 24).

• -e nebo --expand

Tato možnost umožňuje uživateli zadat pouze první čtyři písmena každého slova (což je dostatečné pro úspěšné obnovení).

• -p nebo --pin-protection

Tato možnost umožňuje uživateli nastavit PIN před zahájením procesu obnovení.

Příklad:

trezorctl recovery-device -p

• -r nebo --passphrase-protection

Tato možnost umožňuje uživateli aktivovat ochranu passphrase před zahájením procesu obnovení.

• -l nebo --label

Tato možnost umožňuje uživateli pojmenovat zařízení Trezor před zahájením procesu obnovení.

• -t nebo --type

Tato možnost umožňuje uživateli vybrat mezi standardním (zamíchaným) a pokročilým (maticovým) procesem obnovení.

Příklad:

trezorctl recovery-device -t matrix

• -d nebo --dry-run

Tato možnost umožňuje uživateli provést testovací obnovení, tj. zkontrolovat, zda zadaná záloha peněženky (obnovovací fráze) odpovídá té uložené na zařízení. Výsledek ukáže, zda je záloha platná či nikoliv. Tuto možnost lze využít jak s inicializovaným, tak s neinitializovaným zařízením.

Viz také: Ověření zálohy peněženky (obnovovací fráze) na Model One, Model T, Safe 3, Safe 5 a Safe 7

Vlastní test

trezorctl self-test

Popis: tento příkaz funguje pouze pro Trezor Model One a v režimu bootloaderu. Provádí testy USB, RNG, CPU a FLASH. Výsledky se zobrazí na displeji zařízení.

Čas automatického uzamčení

trezorctl set auto-lock-delay

Popis: tento příkaz oddálí výchozí automatické uzamčení o nastavený počet sekund.

Příklad:

trezorctl set auto-lock-delay 86400

Domovská obrazovka

trezorctl set-homescreen

Popis: tento příkaz umožňuje uživateli změnit domovskou obrazovku na zařízení Trezor. Možnosti:

• -f nebo --filename

Pro Trezor Model T: Obrázek musí být ve formátu TOIF (Trezor optimized image format) o velikosti 144x144 pixelů.

Pro Trezor One: Obrázek musí být velký 128x64 pixelů.

Další informace o tvorbě domovské obrazovky pro Trezor Model One naleznete v tomto editoru domovské obrazovky. Další informace o formátu obrázku TOIF najdete na této GitHub stránce.

Příklad:

trezorctl set-homescreen -f mynewhs.png

Upravit popisek

trezorctl set-label

Popis: tento příkaz umožňuje uživateli nastavit nový popisek nebo změnit popisek zařízení Trezor.

Povinná možnost:

• -l nebo --label

Příklad pro přejmenování vašeho zařízení Trezor na "Trezor Vault":

trezorctl set-label -l "Trezor Vault"

Otočení displeje

trezorctl set-display-rotation

Popis: tento příkaz umožňuje uživateli otočit orientaci obrazovky preferovaným směrem.

Povinné možnosti: north nebo east nebo south nebo west

Příklad:

trezorctl set-display-rotation west

Podepsat zprávu

trezorctl sign-message

Popis: tento příkaz umožňuje uživateli podepsat zprávu pomocí adresy dané cesty.

Povinná možnost:

• -n nebo --address

Je nutné zadat BIP32 cestu s příkazem sign-message, například „m/44'/0'/0'/0/0".

Příklad:

trezorctl sign-message -n "m/44'/0'/0'/0/0" "ahoy"

Možnosti:

• -c nebo --coin

Je možné zvolit, jakou minci použít pro podepsání zprávy. Výchozí je "bitcoin".

Příklad:

trezorctl sign-message -n "m/44'/0'/0'/0/0" -c "Litecoin" "ahoy"

• -t nebo --script-type

Je možné zvolit typ skriptu adresy, který se použije pro podepsání zprávy, např. address/segwit/p2shsegwit

Ověřit zprávu

trezorctl verify-message

Popis: tento příkaz umožňuje uživateli ověřit podepsanou zprávu pomocí adresy. Po provedení příkazu zařízení požádá uživatele o potvrzení adresy a ověření zprávy.

Možnosti:

• -c nebo --coin

Použití: trezorctl verify-message [MOŽNOSTI] ADRESA PODPIS ZPRÁVA

Příklad:

trezorctl verify-message 
1aWUN65K8ecrc4yi4CnWWB76SaeB8CxHt H2cYhELO9G/NES63uARBidkkgV2ARD8nhCNWHjf+rcTmJreVi+OEfZzL7WvXn02ky62yDQmFF

Nastavit zdroj passphrase

trezorctl set passphrase enabled --force-on-device

Popis: tento příkaz funguje pouze pro Trezor Model T. Vynucuje zadávání passphrase vždy na zařízení. To je užitečné pro použití Trezoru s peněženkami, které neumí určit, kde má být passphrase zadán.

Trezor Safe Family Bootloader Unlock

trezorctl device unlock-bootloader

Popis: odemkne bootloader zařízení Trezor, čímž umožní instalaci nepodepsaného firmware a smaže párovací tajemství Optiga. Tímto se obchází kontrola pravosti Bezpečnostního prvku a funkce je doporučena pouze pokročilým uživatelům.

Trezor Safe Family Tutorial

trezorctl device tutorial

Popis: spustí tutoriál zařízení na zařízeních Trezor Safe Family.