Command Line Interface

This document is a prettier output of the documentation produced by the command line client’s man command. You can obtain similar pages using the following shell commands.

tezos-client -protocol ProtoALphaALph man -verbosity 3
tezos-admin-client man -verbosity 3

Client manual

Usage

  • tezos-client [global options] command [command options]
  • tezos-client --help (for global options)
  • tezos-client [global options] command --help (for command options)

To browse the documentation

  • tezos-client [global options] man (for a list of commands)
  • tezos-client [global options] man -v 3 (for the full manual)

Global options (must come before the command)

-d --base-dir <path>: client data directory The directory where the Tezos client will store all its data. By default: '$HOME/.tezos-client'. -c --config-file <path>: configuration file -t --timings: show RPC request times -b --block <hash|tag>: block on which to apply contextual commands Defaults to `head`. -w --wait <none|<int>>: how many confirmation blocks before to consider an operation as included -p --protocol <hash>: use commands of a specific protocol -l --log-requests: log all requests to the node -A --addr <IP addr|host>: IP address of the node -P --port <number>: RPC port of the node -S --tls: use TLS to connect to node. -R --remote-signer <uri>: URI of the remote signer

Access the documentation

  • man [keyword...] [-v --verbosity <0|1|2|3>] [--format <plain|colors|html>]
    Print documentation of commands. Add search keywords to narrow list. Will display only the commands by default, unless [-verbosity <2|3>] is passed or the list of matching commands if less than 3. keyword: keyword to search for If several are given they must all appear in the command. -v --verbosity <0|1|2|3>: level of details 0. Only shows command mnemonics, without documentation. 1. Shows command mnemonics with short descriptions. 2. Show commands and arguments with short descriptions 3. Show everything --format <plain|colors|html>: the manual's output format Defaults to `plain`.

Binary Description

  • describe unsigned block header
    Describe unsigned block header
  • describe unsigned operation
    Describe unsigned block header

Block contextual commands (see option -block)

  • get timestamp [-s --seconds]
    Access the timestamp of the block. -s --seconds: output time in seconds
  • list contracts
    Lists all non empty contracts of the block.
  • get balance for src
    Get the balance of a contract. src: source contract Can be an alias, a key, or a literal (autodetected in order). Use 'text:literal', 'alias:name', 'key:name' to force.
  • get script storage for src
    Get the storage of a contract. src: source contract Can be an alias, a key, or a literal (autodetected in order). Use 'text:literal', 'alias:name', 'key:name' to force.
  • get big map value for key of type type in src
    Get the value associated to a key in the big map storage of a contract. key: the key to look for type: type of the key src: source contract Can be an alias, a key, or a literal (autodetected in order). Use 'text:literal', 'alias:name', 'key:name' to force.
  • get script code for src
    Get the storage of a contract. src: source contract Can be an alias, a key, or a literal (autodetected in order). Use 'text:literal', 'alias:name', 'key:name' to force.
  • get manager for src
    Get the manager of a contract. src: source contract Can be an alias, a key, or a literal (autodetected in order). Use 'text:literal', 'alias:name', 'key:name' to force.
  • get delegate for src
    Get the delegate of a contract. src: source contract Can be an alias, a key, or a literal (autodetected in order). Use 'text:literal', 'alias:name', 'key:name' to force.
  • set delegate for src to mgr [--fee <amount>] [-D --dry-run] [--minimal-fees <amount>] [--minimal-nanotez-per-byte <amount>] [--minimal-nanotez-per-gas-unit <amount>] [--force-low-fee] [--fee-cap <amount>] [--burn-cap <amount>]
    Set the delegate of a contract. src: source contract Can be an alias, a key, or a literal (autodetected in order). Use 'text:literal', 'alias:name', 'key:name' to force. mgr: new delegate of the contract --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --minimal-fees <amount>: exclude operations with fees lower than this threshold (in tez) Defaults to `0.0001`. --minimal-nanotez-per-byte <amount>: exclude operations with fees per byte lower than this threshold (in tez) Defaults to `1000`. --minimal-nanotez-per-gas-unit <amount>: exclude operations with fees per gas lower than this threshold (in nanotez) Defaults to `100`. --force-low-fee: Don't check that the fee is lower than the estimated default value --fee-cap <amount>: Set the fee cap Defaults to `1.0`. --burn-cap <amount>: Set the burn cap Defaults to `0`.
  • withdraw delegate from src [--fee <amount>] [-D --dry-run] [--minimal-fees <amount>] [--minimal-nanotez-per-byte <amount>] [--minimal-nanotez-per-gas-unit <amount>] [--force-low-fee] [--fee-cap <amount>] [--burn-cap <amount>]
    Withdraw the delegate from a contract. src: source contract Can be an alias, a key, or a literal (autodetected in order). Use 'text:literal', 'alias:name', 'key:name' to force. --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --minimal-fees <amount>: exclude operations with fees lower than this threshold (in tez) Defaults to `0.0001`. --minimal-nanotez-per-byte <amount>: exclude operations with fees per byte lower than this threshold (in tez) Defaults to `1000`. --minimal-nanotez-per-gas-unit <amount>: exclude operations with fees per gas lower than this threshold (in nanotez) Defaults to `100`. --force-low-fee: Don't check that the fee is lower than the estimated default value --fee-cap <amount>: Set the fee cap Defaults to `1.0`. --burn-cap <amount>: Set the burn cap Defaults to `0`.
  • originate account new for mgr transferring qty from src [--fee <amount>] [-D --dry-run] [--delegate <address>] [--delegatable] [-f --force] [--minimal-fees <amount>] [--minimal-nanotez-per-byte <amount>] [--minimal-nanotez-per-gas-unit <amount>] [--force-low-fee] [--fee-cap <amount>] [--burn-cap <amount>]
    Open a new account. new: name of the new contract mgr: manager of the new contract Can be a public key hash name, a file or a raw public key hash literal. If the parameter is not the name of an existing public key hash, the client will look for a file containing a public key hash, and if it does not exist, the argument will be read as a raw public key hash. Use 'alias:name', 'file:path' or 'text:literal' to disable autodetect. qty: amount taken from source in ꜩ Text format: `DDDDDDD.DDDDDD`. Tez and mutez and separated by a period sign. Trailing and pending zeroes are allowed. src: name of the source contract Can be an alias, a key, or a literal (autodetected in order). Use 'text:literal', 'alias:name', 'key:name' to force. --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --delegate <address>: delegate of the contract Must be a known address. Can be a public key hash name, a file or a raw public key hash literal. If the parameter is not the name of an existing public key hash, the client will look for a file containing a public key hash, and if it does not exist, the argument will be read as a raw public key hash. Use 'alias:name', 'file:path' or 'text:literal' to disable autodetect. --delegatable: allow future delegate change -f --force: overwrite existing keys --minimal-fees <amount>: exclude operations with fees lower than this threshold (in tez) Defaults to `0.0001`. --minimal-nanotez-per-byte <amount>: exclude operations with fees per byte lower than this threshold (in tez) Defaults to `1000`. --minimal-nanotez-per-gas-unit <amount>: exclude operations with fees per gas lower than this threshold (in nanotez) Defaults to `100`. --force-low-fee: Don't check that the fee is lower than the estimated default value --fee-cap <amount>: Set the fee cap Defaults to `1.0`. --burn-cap <amount>: Set the burn cap Defaults to `0`.
  • originate contract new for mgr transferring qty from src running prg [--fee <amount>] [-D --dry-run] [-G --gas-limit <amount>] [-S --storage-limit <amount>] [--delegate <address>] [-f --force] [--delegatable] [--spendable] [--init <data>] [-q --no-print-source] [--minimal-fees <amount>] [--minimal-nanotez-per-byte <amount>] [--minimal-nanotez-per-gas-unit <amount>] [--force-low-fee] [--fee-cap <amount>] [--burn-cap <amount>]
    Launch a smart contract on the blockchain. new: name of the new contract mgr: manager of the new contract Can be a public key hash name, a file or a raw public key hash literal. If the parameter is not the name of an existing public key hash, the client will look for a file containing a public key hash, and if it does not exist, the argument will be read as a raw public key hash. Use 'alias:name', 'file:path' or 'text:literal' to disable autodetect. qty: amount taken from source in ꜩ Text format: `DDDDDDD.DDDDDD`. Tez and mutez and separated by a period sign. Trailing and pending zeroes are allowed. src: name of the source contract Can be an alias, a key, or a literal (autodetected in order). Use 'text:literal', 'alias:name', 'key:name' to force. prg: script of the account Combine with -init if the storage type is not unit. Can be a script name, a file or a raw script literal. If the parameter is not the name of an existing script, the client will look for a file containing a script, and if it does not exist, the argument will be read as a raw script. Use 'alias:name', 'file:path' or 'text:literal' to disable autodetect. --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it -G --gas-limit <amount>: Set the gas limit of the transaction instead of letting the client decide based on a simulation -S --storage-limit <amount>: Set the storage limit of the transaction instead of letting the client decide based on a simulation --delegate <address>: delegate of the contract Must be a known address. Can be a public key hash name, a file or a raw public key hash literal. If the parameter is not the name of an existing public key hash, the client will look for a file containing a public key hash, and if it does not exist, the argument will be read as a raw public key hash. Use 'alias:name', 'file:path' or 'text:literal' to disable autodetect. -f --force: overwrite existing keys --delegatable: allow future delegate change --spendable: allow the manager to spend the contract's tokens --init <data>: initial value of the contract's storage Defaults to `Unit`. -q --no-print-source: don't print the source code If an error is encountered, the client will print the contract's source code by default. This option disables this behaviour. --minimal-fees <amount>: exclude operations with fees lower than this threshold (in tez) Defaults to `0.0001`. --minimal-nanotez-per-byte <amount>: exclude operations with fees per byte lower than this threshold (in tez) Defaults to `1000`. --minimal-nanotez-per-gas-unit <amount>: exclude operations with fees per gas lower than this threshold (in nanotez) Defaults to `100`. --force-low-fee: Don't check that the fee is lower than the estimated default value --fee-cap <amount>: Set the fee cap Defaults to `1.0`. --burn-cap <amount>: Set the burn cap Defaults to `0`.
  • transfer qty from src to dst [--fee <amount>] [-D --dry-run] [-G --gas-limit <amount>] [-S --storage-limit <amount>] [-C --counter <counter>] [--arg <data>] [-q --no-print-source] [--minimal-fees <amount>] [--minimal-nanotez-per-byte <amount>] [--minimal-nanotez-per-gas-unit <amount>] [--force-low-fee] [--fee-cap <amount>] [--burn-cap <amount>]
    Transfer tokens / call a smart contract. qty: amount taken from source in ꜩ Text format: `DDDDDDD.DDDDDD`. Tez and mutez and separated by a period sign. Trailing and pending zeroes are allowed. src: name of the source contract Can be an alias, a key, or a literal (autodetected in order). Use 'text:literal', 'alias:name', 'key:name' to force. dst: name/literal of the destination contract Can be an alias, a key, or a literal (autodetected in order). Use 'text:literal', 'alias:name', 'key:name' to force. --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it -G --gas-limit <amount>: Set the gas limit of the transaction instead of letting the client decide based on a simulation -S --storage-limit <amount>: Set the storage limit of the transaction instead of letting the client decide based on a simulation -C --counter <counter>: Set the counter to be used by the transaction --arg <data>: argument passed to the contract's script, if needed -q --no-print-source: don't print the source code If an error is encountered, the client will print the contract's source code by default. This option disables this behaviour. --minimal-fees <amount>: exclude operations with fees lower than this threshold (in tez) Defaults to `0.0001`. --minimal-nanotez-per-byte <amount>: exclude operations with fees per byte lower than this threshold (in tez) Defaults to `1000`. --minimal-nanotez-per-gas-unit <amount>: exclude operations with fees per gas lower than this threshold (in nanotez) Defaults to `100`. --force-low-fee: Don't check that the fee is lower than the estimated default value --fee-cap <amount>: Set the fee cap Defaults to `1.0`. --burn-cap <amount>: Set the burn cap Defaults to `0`.
  • reveal key for src [--fee <amount>] [--minimal-fees <amount>] [--minimal-nanotez-per-byte <amount>] [--minimal-nanotez-per-gas-unit <amount>] [--force-low-fee] [--fee-cap <amount>] [--burn-cap <amount>]
    Reveal the public key of the contract manager. src: name of the source contract Can be a contract alias or a key alias (autodetected in order). Use 'key:name' to force the later. --fee <amount>: fee in ꜩ to pay to the baker --minimal-fees <amount>: exclude operations with fees lower than this threshold (in tez) Defaults to `0.0001`. --minimal-nanotez-per-byte <amount>: exclude operations with fees per byte lower than this threshold (in tez) Defaults to `1000`. --minimal-nanotez-per-gas-unit <amount>: exclude operations with fees per gas lower than this threshold (in nanotez) Defaults to `100`. --force-low-fee: Don't check that the fee is lower than the estimated default value --fee-cap <amount>: Set the fee cap Defaults to `1.0`. --burn-cap <amount>: Set the burn cap Defaults to `0`.
  • register key mgr as delegate [--fee <amount>] [-D --dry-run] [--minimal-fees <amount>] [--minimal-nanotez-per-byte <amount>] [--minimal-nanotez-per-gas-unit <amount>] [--force-low-fee] [--fee-cap <amount>] [--burn-cap <amount>]
    Register the public key hash as a delegate. mgr: the delegate key Can be a public key hash name, a file or a raw public key hash literal. If the parameter is not the name of an existing public key hash, the client will look for a file containing a public key hash, and if it does not exist, the argument will be read as a raw public key hash. Use 'alias:name', 'file:path' or 'text:literal' to disable autodetect. --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --minimal-fees <amount>: exclude operations with fees lower than this threshold (in tez) Defaults to `0.0001`. --minimal-nanotez-per-byte <amount>: exclude operations with fees per byte lower than this threshold (in tez) Defaults to `1000`. --minimal-nanotez-per-gas-unit <amount>: exclude operations with fees per gas lower than this threshold (in nanotez) Defaults to `100`. --force-low-fee: Don't check that the fee is lower than the estimated default value --fee-cap <amount>: Set the fee cap Defaults to `1.0`. --burn-cap <amount>: Set the burn cap Defaults to `0`.
  • activate account new with activation_key [-f --force] [--encrypted]
    Register and activate an Alphanet/Zeronet faucet account. new: new secret_key alias activation_key: Activate an Alphanet/Zeronet faucet account from the downloaded JSON file. -f --force: overwrite existing secret_key --encrypted: encrypt the key on-disk

Commands for managing the record of known contracts

  • remember contract new src [-f --force]
    Add a contract to the wallet. new: new contract alias src: source contract Can be a contract name, a file or a raw contract literal. If the parameter is not the name of an existing contract, the client will look for a file containing a contract, and if it does not exist, the argument will be read as a raw contract. Use 'alias:name', 'file:path' or 'text:literal' to disable autodetect. -f --force: overwrite existing contract
  • forget contract name
    Remove a contract from the wallet. name: existing contract alias
  • list known contracts
    Lists all known contracts in the wallet.
  • forget all contracts [-f --force]
    Forget the entire wallet of known contracts. -f --force: overwrite existing contract
  • show known contract name
    Display a contract from the wallet. name: existing contract alias

Commands for managing the library of known scripts

  • list known scripts
    Lists all scripts in the library.
  • remember script new src [-f --force]
    Add a script to the library. new: new script alias src: source script Can be a script name, a file or a raw script literal. If the parameter is not the name of an existing script, the client will look for a file containing a script, and if it does not exist, the argument will be read as a raw script. Use 'alias:name', 'file:path' or 'text:literal' to disable autodetect. -f --force: overwrite existing script
  • forget script name
    Remove a script from the library. name: existing script alias
  • show known script name
    Display a script from the library. name: existing script alias
  • run script src on storage storage and input storage [--trace-stack] [--amount <amount>] [-q --no-print-source]
    Ask the node to run a script. src: source script Can be a script name, a file or a raw script literal. If the parameter is not the name of an existing script, the client will look for a file containing a script, and if it does not exist, the argument will be read as a raw script. Use 'alias:name', 'file:path' or 'text:literal' to disable autodetect. storage: the storage data storage: the input data --trace-stack: show the stack after each step --amount <amount>: amount of the transfer in ꜩ Defaults to `0.05`. -q --no-print-source: don't print the source code If an error is encountered, the client will print the contract's source code by default. This option disables this behaviour.
  • typecheck script src [-v --details] [--emacs] [-q --no-print-source] [-G --gas <gas>]
    Ask the node to typecheck a script. src: source script Can be a script name, a file or a raw script literal. If the parameter is not the name of an existing script, the client will look for a file containing a script, and if it does not exist, the argument will be read as a raw script. Use 'alias:name', 'file:path' or 'text:literal' to disable autodetect. -v --details: show the types of each instruction --emacs: output in `michelson-mode.el` compatible format -q --no-print-source: don't print the source code If an error is encountered, the client will print the contract's source code by default. This option disables this behaviour. -G --gas <gas>: Initial quantity of gas for typechecking and execution
  • typecheck data data against type type [-q --no-print-source] [-G --gas <gas>]
    Ask the node to typecheck a data expression. data: the data to typecheck type: the expected type -q --no-print-source: don't print the source code If an error is encountered, the client will print the contract's source code by default. This option disables this behaviour. -G --gas <gas>: Initial quantity of gas for typechecking and execution
  • hash data data of type type [-G --gas <gas>]
    Ask the node to pack a data expression. The returned hash is the same as what Michelson instruction `PACK` would have produced. Also displays the result of hashing this packed data with `BLAKE2B`, `SHA256` or `SHA512` instruction. data: the data to hash type: type of the data -G --gas <gas>: Initial quantity of gas for typechecking and execution
  • unpack michelson data bytes
    Parse a byte sequence (in hexadecimal notation) as a data expression, as per Michelson instruction `UNPACK`. bytes: the packed data to parse
  • sign bytes data for src
    Sign a raw sequence of bytes and display it using the format expected by Michelson instruction `CHECK_SIGNATURE`. data: the raw data to sign src: source secret_key Can be a secret_key name, a file or a raw secret_key literal. If the parameter is not the name of an existing secret_key, the client will look for a file containing a secret_key, and if it does not exist, the argument will be read as a raw secret_key. Use 'alias:name', 'file:path' or 'text:literal' to disable autodetect.
  • check that bytes was signed by key to produce signature [-q --quiet]
    Check the signature of a byte sequence as per Michelson instruction `CHECK_SIGNATURE`. bytes: the signed data key: existing public_key alias signature: the signature to check -q --quiet: Use only exit codes

Commands related to delegate operations.

  • bake for baker [--max-priority <slot>] [--minimal-fees <amount>] [--minimal-nanotez-per-gas-unit <amount>] [--minimal-nanotez-per-byte <amount>] [--await-late-endorsements] [-f --force] [--minimal-timestamp] [--mempool <file>] [--context <path>]
    Forge and inject block using the delegate rights. baker: name of the delegate owning the baking right Can be a public key hash name, a file or a raw public key hash literal. If the parameter is not the name of an existing public key hash, the client will look for a file containing a public key hash, and if it does not exist, the argument will be read as a raw public key hash. Use 'alias:name', 'file:path' or 'text:literal' to disable autodetect. --max-priority <slot>: maximum allowed baking slot --minimal-fees <amount>: exclude operations with fees lower than this threshold (in tez) Defaults to `0.0001`. --minimal-nanotez-per-gas-unit <amount>: exclude operations with fees per gas lower than this threshold (in nanotez) Defaults to `100`. --minimal-nanotez-per-byte <amount>: exclude operations with fees per byte lower than this threshold (in tez) Defaults to `1000`. --await-late-endorsements: Await late endorsements when baking a block -f --force: disables the node's injection checks Force the injection of branch-invalid operation or force the injection of block without a fitness greater than the current head. --minimal-timestamp: Use the minimal timestamp instead of the current date as timestamp of the baked block. --mempool <file>: When used the client will read the mempool in the provided file instead of querying the node through an RPC (useful for debugging only). --context <path>: When use the client will read in the local context at the provided path in order to build the block, instead of relying on the 'preapply' RPC.
  • reveal nonce for [block_hash...]
    Forge and inject a seed-nonce revelation operation. block_hash: A block identifier
  • reveal nonces
    Forge and inject all the possible seed-nonce revelation operations.
  • endorse for baker
    Forge and inject an endorsement operation. baker: name of the delegate owning the endorsement right Can be a public key hash name, a file or a raw public key hash literal. If the parameter is not the name of an existing public key hash, the client will look for a file containing a public key hash, and if it does not exist, the argument will be read as a raw public key hash. Use 'alias:name', 'file:path' or 'text:literal' to disable autodetect.

Commands for managing the wallet of cryptographic keys

  • list signing schemes
    List supported signing schemes. Signing schemes are identifiers for signer modules: the built-in signing routines, a hardware wallet, an external agent, etc. Each signer has its own format for describing secret keys, such a raw secret key for the default `unencrypted` scheme, the path on a hardware security module, an alias for an external agent, etc. This command gives the list of signer modules that this version of the tezos client supports.
  • gen keys new [-f --force] [-s --sig <ed25519|secp256k1|p256>] [--encrypted]
    Generate a pair of keys. new: new secret_key alias -f --force: overwrite existing secret_key -s --sig <ed25519|secp256k1|p256>: use custom signature algorithm Defaults to `ed25519`. --encrypted: Encrypt the key on-disk
  • gen vanity keys new matching [words...] [-P --prefix] [-f --force] [--encrypted]
    Generate keys including the given string. new: new public key hash alias words: string key must contain one of these words -P --prefix: the key must begin with tz1[word] -f --force: overwrite existing keys --encrypted: Encrypt the key on-disk
  • encrypt secret key
    Encrypt an unencrypted secret key.
  • import secret key new uri [-f --force]
    Add a secret key to the wallet. new: new secret_key alias uri: secret key Varies from one scheme to the other. Use command `list signing schemes` for more information. -f --force: overwrite existing secret_key
  • import public key new uri [-f --force]
    Add a public key to the wallet. new: new public_key alias uri: public key Varies from one scheme to the other. Use command `list signing schemes` for more information. -f --force: overwrite existing public_key
  • add address new src [-f --force]
    Add an address to the wallet. new: new public key hash alias src: source public key hash Can be a public key hash name, a file or a raw public key hash literal. If the parameter is not the name of an existing public key hash, the client will look for a file containing a public key hash, and if it does not exist, the argument will be read as a raw public key hash. Use 'alias:name', 'file:path' or 'text:literal' to disable autodetect. -f --force: overwrite existing public_key
  • list known addresses
    List all addresses and associated keys.
  • show address name [-S --show-secret]
    Show the keys associated with an implicit account. name: existing public key hash alias -S --show-secret: show the private key
  • forget address name [-f --force]
    Forget one address. name: existing public key hash alias -f --force: delete associated keys when present
  • forget all keys [-f --force]
    Forget the entire wallet of keys. -f --force: you got to use the force for that

Commands for managing the connected Ledger Nano S devices

  • list connected ledgers
    List supported Ledger Nano S devices connected.
  • show ledger path uri
    Show BIP32 derivation at path for Ledger uri: secret key Varies from one scheme to the other. Use command `list signing schemes` for more information.
  • get ledger authorized path for name
    Query the path of the authorized key name: existing public_key alias
  • authorize ledger to bake for name
    Authorize a Ledger to bake for a key name: existing public_key alias
  • get ledger high watermark for uri
    Get high water mark of a Ledger uri: secret key Varies from one scheme to the other. Use command `list signing schemes` for more information.
  • set ledger high watermark for uri to high watermark
    Set high water mark of a Ledger uri: secret key Varies from one scheme to the other. Use command `list signing schemes` for more information. high watermark: High watermark

Commands for the low level RPC layer

  • rpc list url
    List RPCs under a given URL prefix. Some parts of the RPC service hierarchy depend on parameters, they are marked by a suffix `<dynamic>`. You can list these sub-hierarchies by providing a concrete URL prefix whose arguments are set to a valid value. url: the URL prefix
  • rpc list
    Alias to `rpc list /`.
  • rpc schema HTTP method url
    Get the input and output JSON schemas of an RPC. HTTP method: url: the RPC url
  • rpc format HTTP method url [-b --binary]
    Get the humanoid readable input and output formats of an RPC. HTTP method: url: the RPC URL -b --binary: Binary format
  • rpc get url
    Call an RPC with the GET method. url: the RPC URL
  • rpc post url
    Call an RPC with the POST method. If input data is needed, a text editor will be popped up. url: the RPC URL
  • rpc post url with input
    Call an RPC with the POST method, providing input data via the command line. url: the RPC URL input: the raw JSON input to the RPC For instance, use `{}` to send the empty document. Alternatively, use `file:path` to read the JSON data from a file.

Commands for editing and viewing the client's config file

  • config show
    Show the config file.
  • config reset
    Reset the config file to the factory defaults.
  • config update
    Update the config based on the current cli values. Loads the current configuration (default or as specified with `-config-file`), applies alterations from other command line arguments (such as the node's address, etc.), and overwrites the updated configuration file.
  • config init [-o --output <path>]
    Create a config file based on the current CLI values. If the `-file` option is not passed, this will initialize the default config file, based on default parameters, altered by other command line options (such as the node's address, etc.). Otherwise, it will create a new config file, based on the default parameters (or the the ones specified with `-config-file`), altered by other command line options. The command will always fail if the file already exists. -o --output <path>: path at which to create the file Defaults to `$HOME/.tezos-client/config`.

Miscellaneous commands

  • list understood protocols
    List the protocol versions that this client understands.
  • complete prefix [-u --unique]
    Autocomplete a prefix of Base58Check-encoded hash. This actually works only for blocks, operations, public key and contract identifiers. prefix: the prefix of the hash to complete -u --unique: Fail when there is more than one possible completion.
  • bootstrapped
    Wait for the node to be bootstrapped.
  • wait for operation to be included [--confirmations <num_blocks>] [--check-previous <num_blocks>]
    Wait until an operation is included in a block operation: Operation to be included --confirmations <num_blocks>: do not end until after 'N' additional blocks after the operation appears Defaults to `0`. --check-previous <num_blocks>: number of previous blocks to check Defaults to `10`.
  • get receipt for operation [--check-previous <num_blocks>]
    Get receipt for past operation operation: Operation to be looked up --check-previous <num_blocks>: number of previous blocks to check Defaults to `10`.

Admin-client manual

Usage

  • tezos-admin-client [global options] command [command options]
  • tezos-admin-client --help (for global options)
  • tezos-admin-client [global options] command --help (for command options)

To browse the documentation

  • tezos-admin-client [global options] man (for a list of commands)
  • tezos-admin-client [global options] man -v 3 (for the full manual)

Global options (must come before the command)

-d --base-dir <path>: client data directory The directory where the Tezos client will store all its data. By default: '$HOME/.tezos-client'. -c --config-file <path>: configuration file -t --timings: show RPC request times -b --block <hash|tag>: block on which to apply contextual commands Defaults to `head`. -w --wait <none|<int>>: how many confirmation blocks before to consider an operation as included -p --protocol <hash>: use commands of a specific protocol -l --log-requests: log all requests to the node -A --addr <IP addr|host>: IP address of the node -P --port <number>: RPC port of the node -S --tls: use TLS to connect to node. -R --remote-signer <uri>: URI of the remote signer

Access the documentation

  • man [keyword...] [-v --verbosity <0|1|2|3>] [--format <plain|colors|html>]
    Print documentation of commands. Add search keywords to narrow list. Will display only the commands by default, unless [-verbosity <2|3>] is passed or the list of matching commands if less than 3. keyword: keyword to search for If several are given they must all appear in the command. -v --verbosity <0|1|2|3>: level of details 0. Only shows command mnemonics, without documentation. 1. Shows command mnemonics with short descriptions. 2. Show commands and arguments with short descriptions 3. Show everything --format <plain|colors|html>: the manual's output format Defaults to `plain`.

Commands for the low level RPC layer

  • rpc list url
    List RPCs under a given URL prefix. Some parts of the RPC service hierarchy depend on parameters, they are marked by a suffix `<dynamic>`. You can list these sub-hierarchies by providing a concrete URL prefix whose arguments are set to a valid value. url: the URL prefix
  • rpc list
    Alias to `rpc list /`.
  • rpc schema HTTP method url
    Get the input and output JSON schemas of an RPC. HTTP method: url: the RPC url
  • rpc format HTTP method url [-b --binary]
    Get the humanoid readable input and output formats of an RPC. HTTP method: url: the RPC URL -b --binary: Binary format
  • rpc get url
    Call an RPC with the GET method. url: the RPC URL
  • rpc post url
    Call an RPC with the POST method. If input data is needed, a text editor will be popped up. url: the RPC URL
  • rpc post url with input
    Call an RPC with the POST method, providing input data via the command line. url: the RPC URL input: the raw JSON input to the RPC For instance, use `{}` to send the empty document. Alternatively, use `file:path` to read the JSON data from a file.

Commands for managing protocols

  • list protocols
    List protocols known by the node.
  • inject protocol dir
    Inject a new protocol into the node. dir: directory containing the sources of a protocol
  • dump protocol protocol hash
    Dump a protocol from the node's record of protocol. protocol hash:

Commands for monitoring and controlling p2p-layer state

  • p2p stat
    show global network status
  • connect address address
    Connect to a new point. address: <IPv4>:PORT or <IPV6>:PORT address (PORT defaults to 9732).
  • kick peer peer
    Kick a peer. peer: peer network identity
  • ban address address
    Add an IP address and all its ports to the blacklist and kicks it. Remove the address from the whitelist if it was previously in it. address: <IPv4>:PORT or <IPV6>:PORT address (PORT defaults to 9732).
  • unban address address
    Remove an IP address and all its ports from the blacklist. address: <IPv4>:PORT or <IPV6>:PORT address (PORT defaults to 9732).
  • trust address address
    Add an IP address to the whitelist. Remove the address from the blacklist if it was previously in it. address: <IPv4>:PORT or <IPV6>:PORT address (PORT defaults to 9732).
  • untrust address address
    Removes an IP address from the whitelist. address: <IPv4>:PORT or <IPV6>:PORT address (PORT defaults to 9732).
  • is address banned address
    Check if an IP address is banned. address: <IPv4>:PORT or <IPV6>:PORT address (PORT defaults to 9732).
  • is peer banned peer
    Check if a peer ID is banned. peer: peer network identity
  • ban peer peer
    Add a peer ID to the blacklist and kicks it. Remove the peer ID from the blacklist if was previously in it. peer: peer network identity
  • unban peer peer
    Removes a peer ID from the blacklist. peer: peer network identity
  • trust peer peer
    Add a peer ID to the whitelist. Remove the peer ID from the blacklist if it was previously in it. peer: peer network identity
  • untrust peer peer
    Remove a peer ID from the whitelist. peer: peer network identity
  • clear acls
    Clear all access control rules.

Commands to perform privileged operations on the node

  • unmark invalid [block...]
    Make the node forget its decision of rejecting blocks. block: blocks to remove from invalid list
  • unmark all invalid blocks
    Make the node forget every decision of rejecting blocks.

Commands to report the node's status

  • list heads [-o --output <path>]
    The last heads that have been considered by the node. -o --output <path>: write to a file Defaults to `-`.
  • list rejected blocks [-o --output <path>]
    The blocks that have been marked invalid by the node. -o --output <path>: write to a file Defaults to `-`.

Commands for editing and viewing the client's config file

  • config show
    Show the config file.
  • config reset
    Reset the config file to the factory defaults.
  • config update
    Update the config based on the current cli values. Loads the current configuration (default or as specified with `-config-file`), applies alterations from other command line arguments (such as the node's address, etc.), and overwrites the updated configuration file.
  • config init [-o --output <path>]
    Create a config file based on the current CLI values. If the `-file` option is not passed, this will initialize the default config file, based on default parameters, altered by other command line options (such as the node's address, etc.). Otherwise, it will create a new config file, based on the default parameters (or the the ones specified with `-config-file`), altered by other command line options. The command will always fail if the file already exists. -o --output <path>: path at which to create the file Defaults to `$HOME/.tezos-client/config`.

Miscellaneous commands

  • list understood protocols
    List the protocol versions that this client understands.

Signer manual

Usage

  • tezos-signer [global options] command [command options]
  • tezos-signer --help (for global options)
  • tezos-signer [global options] command --help (for command options)

To browse the documentation

  • tezos-signer [global options] man (for a list of commands)
  • tezos-signer [global options] man -v 3 (for the full manual)

Global options (must come before the command)

-d --base-dir <path>: signer data directory The directory where the Tezos client will store all its data. By default: '$HOME/.tezos-signer'. -A --require-authentication: Require a signature from the caller to sign.

Access the documentation

  • man [keyword...] [-v --verbosity <0|1|2|3>] [--format <plain|colors|html>]
    Print documentation of commands. Add search keywords to narrow list. Will display only the commands by default, unless [-verbosity <2|3>] is passed or the list of matching commands if less than 3. keyword: keyword to search for If several are given they must all appear in the command. -v --verbosity <0|1|2|3>: level of details 0. Only shows command mnemonics, without documentation. 1. Shows command mnemonics with short descriptions. 2. Show commands and arguments with short descriptions 3. Show everything --format <plain|colors|html>: the manual's output format Defaults to `plain`.

Commands specific to the signing daemon

  • launch socket signer [-M --magic-bytes <0xHH,0xHH,...>] [-W --check-high-watermark] [-a --address <host|address>] [-p --port <port number>]
    Launch a signer daemon over a TCP socket. -M --magic-bytes <0xHH,0xHH,...>: values allowed for the magic bytes, defaults to any -W --check-high-watermark: high watermark restriction Stores the highest level signed for blocks and endorsements for each address, and forbids to sign a level that is inferior or equal afterwards, except for the exact same input data. -a --address <host|address>: listening address or host name Defaults to `localhost`. -p --port <port number>: listening TCP port or service name Defaults to `7732`.
  • launch local signer [-M --magic-bytes <0xHH,0xHH,...>] [-W --check-high-watermark] [-s --socket <path>]
    Launch a signer daemon over a local Unix socket. -M --magic-bytes <0xHH,0xHH,...>: values allowed for the magic bytes, defaults to any -W --check-high-watermark: high watermark restriction Stores the highest level signed for blocks and endorsements for each address, and forbids to sign a level that is inferior or equal afterwards, except for the exact same input data. -s --socket <path>: path to the local socket file Defaults to `$HOME/.tezos-signer/socket`.
  • launch http signer [-M --magic-bytes <0xHH,0xHH,...>] [-W --check-high-watermark] [-a --address <host|address>] [-p --port <port number>]
    Launch a signer daemon over HTTP. -M --magic-bytes <0xHH,0xHH,...>: values allowed for the magic bytes, defaults to any -W --check-high-watermark: high watermark restriction Stores the highest level signed for blocks and endorsements for each address, and forbids to sign a level that is inferior or equal afterwards, except for the exact same input data. -a --address <host|address>: listening address or host name Defaults to `localhost`. -p --port <port number>: listening HTTP port Defaults to `6732`.
  • launch https signer cert key [-M --magic-bytes <0xHH,0xHH,...>] [-W --check-high-watermark] [-a --address <host|address>] [-p --port <port number>]
    Launch a signer daemon over HTTPS. cert: path to th TLS certificate key: path to th TLS key -M --magic-bytes <0xHH,0xHH,...>: values allowed for the magic bytes, defaults to any -W --check-high-watermark: high watermark restriction Stores the highest level signed for blocks and endorsements for each address, and forbids to sign a level that is inferior or equal afterwards, except for the exact same input data. -a --address <host|address>: listening address or host name Defaults to `localhost`. -p --port <port number>: listening HTTPS port Defaults to `443`.
  • add authorized key pk [-N --name <name>]
    Authorize a given public key to perform signing requests. pk: full public key (Base58 encoded) -N --name <name>: an optional name for the key (defaults to the hash)

Commands for managing the connected Ledger Nano S devices

  • list connected ledgers
    List supported Ledger Nano S devices connected.
  • show ledger path uri
    Show BIP32 derivation at path for Ledger uri: secret key Varies from one scheme to the other. Use command `list signing schemes` for more information.
  • get ledger authorized path for name
    Query the path of the authorized key name: existing public_key alias
  • authorize ledger to bake for name
    Authorize a Ledger to bake for a key name: existing public_key alias
  • get ledger high watermark for uri
    Get high water mark of a Ledger uri: secret key Varies from one scheme to the other. Use command `list signing schemes` for more information.
  • set ledger high watermark for uri to high watermark
    Set high water mark of a Ledger uri: secret key Varies from one scheme to the other. Use command `list signing schemes` for more information. high watermark: High watermark

Commands for managing the wallet of cryptographic keys

  • list signing schemes
    List supported signing schemes. Signing schemes are identifiers for signer modules: the built-in signing routines, a hardware wallet, an external agent, etc. Each signer has its own format for describing secret keys, such a raw secret key for the default `unencrypted` scheme, the path on a hardware security module, an alias for an external agent, etc. This command gives the list of signer modules that this version of the tezos client supports.
  • gen keys new [-f --force] [-s --sig <ed25519|secp256k1|p256>] [--encrypted]
    Generate a pair of keys. new: new secret_key alias -f --force: overwrite existing secret_key -s --sig <ed25519|secp256k1|p256>: use custom signature algorithm Defaults to `ed25519`. --encrypted: Encrypt the key on-disk
  • gen vanity keys new matching [words...] [-P --prefix] [-f --force] [--encrypted]
    Generate keys including the given string. new: new public key hash alias words: string key must contain one of these words -P --prefix: the key must begin with tz1[word] -f --force: overwrite existing keys --encrypted: Encrypt the key on-disk
  • encrypt secret key
    Encrypt an unencrypted secret key.
  • import secret key new uri [-f --force]
    Add a secret key to the wallet. new: new secret_key alias uri: secret key Varies from one scheme to the other. Use command `list signing schemes` for more information. -f --force: overwrite existing secret_key
  • import public key new uri [-f --force]
    Add a public key to the wallet. new: new public_key alias uri: public key Varies from one scheme to the other. Use command `list signing schemes` for more information. -f --force: overwrite existing public_key
  • add address new src [-f --force]
    Add an address to the wallet. new: new public key hash alias src: source public key hash Can be a public key hash name, a file or a raw public key hash literal. If the parameter is not the name of an existing public key hash, the client will look for a file containing a public key hash, and if it does not exist, the argument will be read as a raw public key hash. Use 'alias:name', 'file:path' or 'text:literal' to disable autodetect. -f --force: overwrite existing public_key
  • list known addresses
    List all addresses and associated keys.
  • show address name [-S --show-secret]
    Show the keys associated with an implicit account. name: existing public key hash alias -S --show-secret: show the private key
  • forget address name [-f --force]
    Forget one address. name: existing public key hash alias -f --force: delete associated keys when present
  • forget all keys [-f --force]
    Forget the entire wallet of keys. -f --force: you got to use the force for that

Baker manual

Usage

  • tezos-baker-alpha [global options] command [command options]
  • tezos-baker-alpha --help (for global options)
  • tezos-baker-alpha [global options] command --help (for command options)

To browse the documentation

  • tezos-baker-alpha [global options] man (for a list of commands)
  • tezos-baker-alpha [global options] man -v 3 (for the full manual)

Global options (must come before the command)

-d --base-dir <path>: client data directory The directory where the Tezos client will store all its data. By default: '$HOME/.tezos-client'. -c --config-file <path>: configuration file -t --timings: show RPC request times -b --block <hash|tag>: block on which to apply contextual commands Defaults to `head`. -w --wait <none|<int>>: how many confirmation blocks before to consider an operation as included -p --protocol <hash>: use commands of a specific protocol -l --log-requests: log all requests to the node -A --addr <IP addr|host>: IP address of the node -P --port <number>: RPC port of the node -S --tls: use TLS to connect to node. -R --remote-signer <uri>: URI of the remote signer

Access the documentation

  • man [keyword...] [-v --verbosity <0|1|2|3>] [--format <plain|colors|html>]
    Print documentation of commands. Add search keywords to narrow list. Will display only the commands by default, unless [-verbosity <2|3>] is passed or the list of matching commands if less than 3. keyword: keyword to search for If several are given they must all appear in the command. -v --verbosity <0|1|2|3>: level of details 0. Only shows command mnemonics, without documentation. 1. Shows command mnemonics with short descriptions. 2. Show commands and arguments with short descriptions 3. Show everything --format <plain|colors|html>: the manual's output format Defaults to `plain`.

Commands related to the baker daemon.

  • run with local node context_path [name...] [--max-priority <slot>] [--minimal-fees <amount>] [--minimal-nanotez-per-gas-unit <amount>] [--minimal-nanotez-per-byte <amount>] [--no-waiting-for-late-endorsements]
    Launch the baker daemon. context_path: Path to the node data directory (e.g. $HOME/.tezos-node) name: existing public key hash alias --max-priority <slot>: maximum allowed baking slot --minimal-fees <amount>: exclude operations with fees lower than this threshold (in tez) Defaults to `0.0001`. --minimal-nanotez-per-gas-unit <amount>: exclude operations with fees per gas lower than this threshold (in nanotez) Defaults to `100`. --minimal-nanotez-per-byte <amount>: exclude operations with fees per byte lower than this threshold (in tez) Defaults to `1000`. --no-waiting-for-late-endorsements: Disable waiting for late endorsements

Commands for editing and viewing the client's config file

  • config show
    Show the config file.
  • config reset
    Reset the config file to the factory defaults.
  • config update
    Update the config based on the current cli values. Loads the current configuration (default or as specified with `-config-file`), applies alterations from other command line arguments (such as the node's address, etc.), and overwrites the updated configuration file.
  • config init [-o --output <path>]
    Create a config file based on the current CLI values. If the `-file` option is not passed, this will initialize the default config file, based on default parameters, altered by other command line options (such as the node's address, etc.). Otherwise, it will create a new config file, based on the default parameters (or the the ones specified with `-config-file`), altered by other command line options. The command will always fail if the file already exists. -o --output <path>: path at which to create the file Defaults to `$HOME/.tezos-client/config`.

Miscellaneous commands

  • list understood protocols
    List the protocol versions that this client understands.

Endorser manual

Usage

  • tezos-endorser-alpha [global options] command [command options]
  • tezos-endorser-alpha --help (for global options)
  • tezos-endorser-alpha [global options] command --help (for command options)

To browse the documentation

  • tezos-endorser-alpha [global options] man (for a list of commands)
  • tezos-endorser-alpha [global options] man -v 3 (for the full manual)

Global options (must come before the command)

-d --base-dir <path>: client data directory The directory where the Tezos client will store all its data. By default: '$HOME/.tezos-client'. -c --config-file <path>: configuration file -t --timings: show RPC request times -b --block <hash|tag>: block on which to apply contextual commands Defaults to `head`. -w --wait <none|<int>>: how many confirmation blocks before to consider an operation as included -p --protocol <hash>: use commands of a specific protocol -l --log-requests: log all requests to the node -A --addr <IP addr|host>: IP address of the node -P --port <number>: RPC port of the node -S --tls: use TLS to connect to node. -R --remote-signer <uri>: URI of the remote signer

Access the documentation

  • man [keyword...] [-v --verbosity <0|1|2|3>] [--format <plain|colors|html>]
    Print documentation of commands. Add search keywords to narrow list. Will display only the commands by default, unless [-verbosity <2|3>] is passed or the list of matching commands if less than 3. keyword: keyword to search for If several are given they must all appear in the command. -v --verbosity <0|1|2|3>: level of details 0. Only shows command mnemonics, without documentation. 1. Shows command mnemonics with short descriptions. 2. Show commands and arguments with short descriptions 3. Show everything --format <plain|colors|html>: the manual's output format Defaults to `plain`.

Commands related to endorser daemon.

  • run [name...] [--endorsement-delay <seconds>]
    Launch the endorser daemon name: existing public key hash alias --endorsement-delay <seconds>: delay before endorsing blocks Delay between notifications of new blocks from the node and production of endorsements for these blocks. Defaults to `5`.

Commands for editing and viewing the client's config file

  • config show
    Show the config file.
  • config reset
    Reset the config file to the factory defaults.
  • config update
    Update the config based on the current cli values. Loads the current configuration (default or as specified with `-config-file`), applies alterations from other command line arguments (such as the node's address, etc.), and overwrites the updated configuration file.
  • config init [-o --output <path>]
    Create a config file based on the current CLI values. If the `-file` option is not passed, this will initialize the default config file, based on default parameters, altered by other command line options (such as the node's address, etc.). Otherwise, it will create a new config file, based on the default parameters (or the the ones specified with `-config-file`), altered by other command line options. The command will always fail if the file already exists. -o --output <path>: path at which to create the file Defaults to `$HOME/.tezos-client/config`.

Miscellaneous commands

  • list understood protocols
    List the protocol versions that this client understands.

Accuser manual

Usage

  • tezos-accuser-alpha [global options] command [command options]
  • tezos-accuser-alpha --help (for global options)
  • tezos-accuser-alpha [global options] command --help (for command options)

To browse the documentation

  • tezos-accuser-alpha [global options] man (for a list of commands)
  • tezos-accuser-alpha [global options] man -v 3 (for the full manual)

Global options (must come before the command)

-d --base-dir <path>: client data directory The directory where the Tezos client will store all its data. By default: '$HOME/.tezos-client'. -c --config-file <path>: configuration file -t --timings: show RPC request times -b --block <hash|tag>: block on which to apply contextual commands Defaults to `head`. -w --wait <none|<int>>: how many confirmation blocks before to consider an operation as included -p --protocol <hash>: use commands of a specific protocol -l --log-requests: log all requests to the node -A --addr <IP addr|host>: IP address of the node -P --port <number>: RPC port of the node -S --tls: use TLS to connect to node. -R --remote-signer <uri>: URI of the remote signer

Access the documentation

  • man [keyword...] [-v --verbosity <0|1|2|3>] [--format <plain|colors|html>]
    Print documentation of commands. Add search keywords to narrow list. Will display only the commands by default, unless [-verbosity <2|3>] is passed or the list of matching commands if less than 3. keyword: keyword to search for If several are given they must all appear in the command. -v --verbosity <0|1|2|3>: level of details 0. Only shows command mnemonics, without documentation. 1. Shows command mnemonics with short descriptions. 2. Show commands and arguments with short descriptions 3. Show everything --format <plain|colors|html>: the manual's output format Defaults to `plain`.

Commands related to the accuser daemon.

  • run [--preserved-levels <threshold>]
    Launch the accuser daemon --preserved-levels <threshold>: Number of effective levels kept in the accuser's memory Defaults to `200`.

Commands for editing and viewing the client's config file

  • config show
    Show the config file.
  • config reset
    Reset the config file to the factory defaults.
  • config update
    Update the config based on the current cli values. Loads the current configuration (default or as specified with `-config-file`), applies alterations from other command line arguments (such as the node's address, etc.), and overwrites the updated configuration file.
  • config init [-o --output <path>]
    Create a config file based on the current CLI values. If the `-file` option is not passed, this will initialize the default config file, based on default parameters, altered by other command line options (such as the node's address, etc.). Otherwise, it will create a new config file, based on the default parameters (or the the ones specified with `-config-file`), altered by other command line options. The command will always fail if the file already exists. -o --output <path>: path at which to create the file Defaults to `$HOME/.tezos-client/config`.

Miscellaneous commands

  • list understood protocols
    List the protocol versions that this client understands.