Command Line Interface#
This document is a prettier output of the documentation produced by
the command man
of the different Octez binaries. You can obtain similar pages
using shell commands such as (indicating the appropriate protocol):
octez-client -protocol <protocol_hash> man -verbosity 3
The rest of this page documents the protocol-dependent tools. The protocol-independent tools are documented here.
Client manual#
Usage
-
octez-client [global options] command [command options]
-
octez-client --help (for global options)
-
octez-client [global options] command --help (for command options)
-
octez-client --version (for version information)
To browse the documentation
-
octez-client [global options] man (for a list of commands)
-
octez-client [global options] man -v 3 (for the full manual)
Global options (must come before the command)
-d --base-dir <path>: client data directory (absent: TEZOS_CLIENT_DIR env)
The directory where the Tezos client will store all its data.
If absent, its value is the value of the TEZOS_CLIENT_DIR
environment variable. If TEZOS_CLIENT_DIR is itself not specified,
defaults to $HOME/.tezos-client
-n --no-base-dir-warnings: silence warnings about client data directory
-c --config-file <path>: configuration file
-t --timings: show RPC request times
--chain <hash|tag>: chain on which to apply contextual commands (commands dependent on the context associated with the specified chain). Possible tags are 'main' and 'test'.
Defaults to `main`.
-b --block <hash|level|tag>: block on which to apply contextual commands (commands dependent on the context associated with the specified block). Possible tags include 'head' and 'genesis' +/- an optional offset (e.g. "octez-client -b head-1 get timestamp"). Note that block queried must exist in node's storage.
Defaults to `head`.
-w --wait <none|<int>>: how many confirmation blocks are needed before an operation is considered included
-p --protocol <hash>: use commands of a specific protocol
-l --log-requests: log all requests to the node
--better-errors: Error reporting is more detailed. Can be used if a call to an RPC fails or if you don't know the input accepted by the RPC. It may happen that the RPC calls take more time however.
-A --addr <IP addr|host>: [DEPRECATED: use --endpoint instead] IP address of the node
-P --port <number>: [DEPRECATED: use --endpoint instead] RPC port of the node
-S --tls: [DEPRECATED: use --endpoint instead] use TLS to connect to node.
-m --media-type <json, binary, any or default>: Sets the "media-type" value for the "accept" header for RPC requests to the node. The media accept header indicates to the node which format of data serialisation is supported. Use the value "json" for serialisation to the JSON format.
Use the value "binary" for faster but less human-readable binary
serialisation format.
-E --endpoint <uri>: HTTP(S) endpoint of the node RPC interface; e.g. 'http://localhost:8732'
-s --sources <path>: path to JSON file containing sources for --mode light. Example file content: {"min_agreement": 1.0, "uris": ["http://localhost:8732", "https://localhost:8733"]}
-R --remote-signer <uri>: URI of the remote signer
-f --password-filename <filename>: path to the password filename
-M --mode <client|light|mockup|proxy>: how to interact with the node
Defaults to `client`.
--log-coloring <true|false>: Enable or disable light coloring in default stdout logs. Coloring is enabled by default.
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 managing FA1.2-compatible smart contracts
-
check contract contract implements fa1.2Check that a contract is FA1.2-compatible. contract: name or address of the FA1.2-compatible contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force.
-
from fa1.2 contract contract get balance for from [-G --gas <gas>] [--payer <src>] [--unparsing-mode <mode>]Ask for an address's balance offchain contract: name or address of the FA1.2-compatible contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. from: name or address of the account to lookup (also the source contract) Can be a literal, an alias, or a key (autodetected in order). Use 'text:<literal>', 'alias:<name>', 'key:<key>' to force. -G --gas <gas>: Initial quantity of gas for typechecking and execution --payer <src>: name of the payer (i.e. SOURCE) contract for the transaction 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. --unparsing-mode <mode>: Unparsing mode to use One of "Readable", "Optimized", or "Optimized_legacy". This option affects the way the values of the following Michelson types are represented: - timestamp: the Readable representation is a RFC3339 string, the Optimized and Optimized_legacy representations are the number of seconds since Epoch - key, signature, key_hash, address, contract, chain_id: the Readable representation is a Base58Check string, the Optimized and Optimized_legacy representations are byte sequences - nested pairs: in Readable mode, the Pair constructor is used even with arity bigger than 2 such as in Pair 0 1 2; in Optimized_legacy mode, the Pair constructor is always use with arity 2 such as in Pair 0 (Pair 1 2); in Optimized mode, a sequence is used if there are at least 4 elements and the behavior is the same as in Optimized_legacy mode otherwise. Defaults to `Readable`.
-
from fa1.2 contract contract get allowance on owner as operator [-G --gas <gas>] [--payer <src>] [--unparsing-mode <mode>]Ask for an address's allowance offchain contract: name or address of the FA1.2-compatible contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. owner: name or address of the account giving the allowance Can be a literal, an alias, or a key (autodetected in order). Use 'text:<literal>', 'alias:<name>', 'key:<key>' to force. operator: name or address of the account receiving the allowance Can be a literal, an alias, or a key (autodetected in order). Use 'text:<literal>', 'alias:<name>', 'key:<key>' to force. -G --gas <gas>: Initial quantity of gas for typechecking and execution --payer <src>: name of the payer (i.e. SOURCE) contract for the transaction 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. --unparsing-mode <mode>: Unparsing mode to use One of "Readable", "Optimized", or "Optimized_legacy". This option affects the way the values of the following Michelson types are represented: - timestamp: the Readable representation is a RFC3339 string, the Optimized and Optimized_legacy representations are the number of seconds since Epoch - key, signature, key_hash, address, contract, chain_id: the Readable representation is a Base58Check string, the Optimized and Optimized_legacy representations are byte sequences - nested pairs: in Readable mode, the Pair constructor is used even with arity bigger than 2 such as in Pair 0 1 2; in Optimized_legacy mode, the Pair constructor is always use with arity 2 such as in Pair 0 (Pair 1 2); in Optimized mode, a sequence is used if there are at least 4 elements and the behavior is the same as in Optimized_legacy mode otherwise. Defaults to `Readable`.
-
from fa1.2 contract contract get total supply [-G --gas <gas>] [--payer <src>] [--unparsing-mode <mode>]Ask for the contract's total token supply offchain contract: name or address of the FA1.2-compatible contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. -G --gas <gas>: Initial quantity of gas for typechecking and execution --payer <src>: name of the payer (i.e. SOURCE) contract for the transaction 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. --unparsing-mode <mode>: Unparsing mode to use One of "Readable", "Optimized", or "Optimized_legacy". This option affects the way the values of the following Michelson types are represented: - timestamp: the Readable representation is a RFC3339 string, the Optimized and Optimized_legacy representations are the number of seconds since Epoch - key, signature, key_hash, address, contract, chain_id: the Readable representation is a Base58Check string, the Optimized and Optimized_legacy representations are byte sequences - nested pairs: in Readable mode, the Pair constructor is used even with arity bigger than 2 such as in Pair 0 1 2; in Optimized_legacy mode, the Pair constructor is always use with arity 2 such as in Pair 0 (Pair 1 2); in Optimized mode, a sequence is used if there are at least 4 elements and the behavior is the same as in Optimized_legacy mode otherwise. Defaults to `Readable`.
-
from fa1.2 contract contract get balance for from callback on callback [--callback-entrypoint <name>] [--tez-amount <amount>] [--fee <amount>] [-D --dry-run] [--verbose-signing] [-G --gas-limit <amount>] [--safety-guard <extra_gas>] [-S --storage-limit <amount>] [-C --counter <counter>] [-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>]Ask for an address's balance using a callback contract contract: name or address of the FA1.2-compatible contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. from: name or address of the account to lookup (also the source 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. callback: name or address of the callback contract Can be a literal, an alias, or a key (autodetected in order). Use 'text:<literal>', 'alias:<name>', 'key:<key>' to force. --callback-entrypoint <name>: Entrypoint the view should use to callback to --tez-amount <amount>: amount in ꜩ Defaults to `0`. --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation -G --gas-limit <amount>: Set the gas limit of the transaction instead of letting the client decide based on a simulation --safety-guard <extra_gas>: Amount of gas to add to value computed by simulation. The gas safety guard allows operations that consume a little more gas than expected to be successful -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 -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 nanotez) 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`.
-
from fa1.2 contract contract get allowance on from as to callback on callback [--callback-entrypoint <name>] [--tez-amount <amount>] [--fee <amount>] [-D --dry-run] [--verbose-signing] [-G --gas-limit <amount>] [--safety-guard <extra_gas>] [-S --storage-limit <amount>] [-C --counter <counter>] [-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>]Ask for an address's allowance using a callback contract contract: name or address of the FA1.2-compatible contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. from: name or address of the account giving the allowance 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. to: name or address of the account receiving the allowance Can be a literal, an alias, or a key (autodetected in order). Use 'text:<literal>', 'alias:<name>', 'key:<key>' to force. callback: name or address of the callback contract Can be a literal, an alias, or a key (autodetected in order). Use 'text:<literal>', 'alias:<name>', 'key:<key>' to force. --callback-entrypoint <name>: Entrypoint the view should use to callback to --tez-amount <amount>: amount in ꜩ Defaults to `0`. --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation -G --gas-limit <amount>: Set the gas limit of the transaction instead of letting the client decide based on a simulation --safety-guard <extra_gas>: Amount of gas to add to value computed by simulation. The gas safety guard allows operations that consume a little more gas than expected to be successful -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 -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 nanotez) 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`.
-
from fa1.2 contract contract get total supply as from callback on callback [--callback-entrypoint <name>] [--tez-amount <amount>] [--fee <amount>] [-D --dry-run] [--verbose-signing] [-G --gas-limit <amount>] [--safety-guard <extra_gas>] [-S --storage-limit <amount>] [-C --counter <counter>] [-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>]Ask for a contract's total token supply using a callback contract contract: name or address of the FA1.2-compatible contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. from: name or address of the source account 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. callback: name or address of the callback contract Can be a literal, an alias, or a key (autodetected in order). Use 'text:<literal>', 'alias:<name>', 'key:<key>' to force. --callback-entrypoint <name>: Entrypoint the view should use to callback to --tez-amount <amount>: amount in ꜩ Defaults to `0`. --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation -G --gas-limit <amount>: Set the gas limit of the transaction instead of letting the client decide based on a simulation --safety-guard <extra_gas>: Amount of gas to add to value computed by simulation. The gas safety guard allows operations that consume a little more gas than expected to be successful -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 -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 nanotez) 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`.
-
from fa1.2 contract contract transfer amount from from to to [--as <src>] [--tez-amount <amount>] [--fee <amount>] [-D --dry-run] [--verbose-signing] [-G --gas-limit <amount>] [--safety-guard <extra_gas>] [-S --storage-limit <amount>] [-C --counter <counter>] [-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 between two given accounts contract: name or address of the FA1.2-compatible contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. amount: number of tokens from: name or address of the sender 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. to: name or address of the receiver Can be a literal, an alias, or a key (autodetected in order). Use 'text:<literal>', 'alias:<name>', 'key:<key>' to force. --as <src>: name or address of the caller of the 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. --tez-amount <amount>: amount in ꜩ Defaults to `0`. --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation -G --gas-limit <amount>: Set the gas limit of the transaction instead of letting the client decide based on a simulation --safety-guard <extra_gas>: Amount of gas to add to value computed by simulation. The gas safety guard allows operations that consume a little more gas than expected to be successful -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 -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 nanotez) 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`.
-
from fa1.2 contract contract as as approve amount from from [--tez-amount <amount>] [--fee <amount>] [-D --dry-run] [--verbose-signing] [-G --gas-limit <amount>] [--safety-guard <extra_gas>] [-S --storage-limit <amount>] [-C --counter <counter>] [-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>]Allow account to transfer an amount of token contract: name or address of the FA1.2-compatible contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. as: name or address of the sender 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. amount: number of tokens from: name or address to approve withdrawal Can be a literal, an alias, or a key (autodetected in order). Use 'text:<literal>', 'alias:<name>', 'key:<key>' to force. --tez-amount <amount>: amount in ꜩ Defaults to `0`. --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation -G --gas-limit <amount>: Set the gas limit of the transaction instead of letting the client decide based on a simulation --safety-guard <extra_gas>: Amount of gas to add to value computed by simulation. The gas safety guard allows operations that consume a little more gas than expected to be successful -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 -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 nanotez) 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`.
-
multiple fa1.2 transfers from src using transfers [--default-fee <amount>] [--as <src>] [-D --dry-run] [--verbose-signing] [-G --default-gas-limit <amount>] [--safety-guard <extra_gas>] [-S --default-storage-limit <amount>] [-C --counter <counter>] [-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>]Execute multiple token transfers from a single source account. If one of the token transfers fails, none of them are executed. src: name or address of the source of the transfers 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. transfers: List of token transfers to inject from the source contract in JSON format (as a file or string). The JSON must be an array of objects of the form: '[ {"token_contract": address or alias, "destination": address or alias, "amount": non-negative integer (, <field>: <val> ...) } (, ...) ]', where an optional <field> can either be "tez-amount", "fee", "gas-limit" or "storage-limit". The complete schema can be inspected via `tezos-codec describe alpha.fa1.2.token_transfer json schema`. --default-fee <amount>: default fee in ꜩ to pay to the baker for each transaction --as <src>: name or address of the caller of the 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. -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation -G --default-gas-limit <amount>: Set the default gas limit for each transaction instead of letting the client decide based on a simulation --safety-guard <extra_gas>: Amount of gas to add to value computed by simulation. The gas safety guard allows operations that consume a little more gas than expected to be successful -S --default-storage-limit <amount>: Set the default storage limit for each transaction instead of letting the client decide based on a simulation -C --counter <counter>: Set the counter to be used by the transaction -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 nanotez) 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`.
Commands for stress-testing the network
-
stresstest transfer using sources.json [--seed <int>] [--tps <float>] [--fresh-probability <float in [0;1]>] [--smart-contract-parameters <JSON file with smart contract parameters>] [--strategy <fixed:mutez | evaporation:[0;1]>] [--fee <amount>] [-G --gas-limit <amount>] [-S --storage-limit <amount>] [--transfers <integer>] [--level-limit <integer | +integer>] [-v --verbose] [-V --debug]Generate random transactions sources.json: List of accounts from which to perform transfers in JSON format. The input JSON must be an array of objects of the form {"pkh":"<pkh>","pk":"<pk>","sk":"<sk>"} or {"alias":"<alias from wallet>"} or {"pkh":"<pkh from wallet>"} with the pkh, pk and sk encoded in B58 form." --seed <int>: random seed --tps <float>: transactions per seconds target --fresh-probability <float in [0;1]>: Probability for each transaction's destination to be a fresh account. The default value is 0.001. This new account may then be used as source or destination of subsequent transactions, just like the accounts that were initially provided to the command. Note that when [--single-op-per-pkh-per-block] is set, the new account will not be used as source until the head changes. --smart-contract-parameters <JSON file with smart contract parameters>: A JSON object that maps smart contract aliases to objects with three fields: probability in [0;1], invocation_fee, and invocation_gas_limit. --strategy <fixed:mutez | evaporation:[0;1]>: wealth redistribution strategy --fee <amount>: fee in ꜩ to pay to the baker -G --gas-limit <amount>: Set the gas limit of the transaction instead of using the default value of 1600 -S --storage-limit <amount>: Set the storage limit of the transaction instead of using the default value of 0 --transfers <integer>: total number of transfers to perform, unbounded if not specified --level-limit <integer | +integer>: Level at which the stresstest will stop (if prefixed by '+', the level is relative to the current head) -v --verbose: Display detailed logs of the injected operations -V --debug: Display debug logs
-
stresstest estimate gasOutput gas estimations for transactions that stresstest uses
-
stresstest fund accounts from source_key_arg [--batch-size <integer>] [--batches-per-block <integer>] [--initial-amount <integer>] [--default-fee <amount>] [-G --default-gas-limit <amount>] [-S --default-storage-limit <amount>] [--minimal-fees <amount>] [--minimal-nanotez-per-byte <amount>] [--minimal-nanotez-per-gas-unit <amount>] [--force-low-fee] [--fee-cap <amount>] [--burn-cap <amount>]Funds all the given accounts source_key_arg: Source key public key hash from which the tokens will be transferred to start the funding. --batch-size <integer>: Maximum number of operations that can be put into a single batch (250 by default) Defaults to `250`. --batches-per-block <integer>: Maximum number of batches that can be put into a single block (100 by default) Defaults to `100`. --initial-amount <integer>: Number of token, in μtz, that will be funded on each of the accounts to fund (1 by default) Defaults to `1_000_000`. --default-fee <amount>: default fee in ꜩ to pay to the baker for each transaction -G --default-gas-limit <amount>: Set the default gas limit for each transaction instead of letting the client decide based on a simulation -S --default-storage-limit <amount>: Set the default storage limit for each transaction instead of letting the client decide based on a simulation --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 nanotez) 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`.
Utility Commands
-
sign message message for src [-b --branch <hash|tag>]Sign a message and display it using the failing_noop operation. This operation is not executable in the protocol. Please note that signing/checking an arbitrary message in itself is not sufficient to verify a key ownership message: message to sign src: name of the signer contract 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. -b --branch <hash|tag>: Block hash used to create the no-op operation to sign (possible tags are 'head' and 'genesis'). Defaults to 'genesis'. Note that the the genesis block hash is network-dependent. Defaults to `genesis`.
-
check that message message was signed by signer to produce signature [-b --branch <hash|tag>] [-q --quiet]Check the signature of an arbitrary message using the failing_noop operation. Please note that signing/checking an arbitrary message in itself is not sufficient to verify a key ownership. message: signed message signer: name of the signer contract Can be a public_key name, a file or a raw public_key literal. If the parameter is not the name of an existing public_key, the client will look for a file containing a public_key, and if it does not exist, the argument will be read as a raw public_key. Use 'alias:<name>', 'file:<path>' or 'text:<literal>' to disable autodetect. signature: the signature to check -b --branch <hash|tag>: Block hash used to create the no-op operation to sign (possible tags are 'head' and 'genesis'). Defaults to 'genesis'. Note that the the genesis block hash is network-dependent. Defaults to `genesis`. -q --quiet: Use only exit codes
-
sign block unsigned block header for delegateSign an arbitrary unsigned block header for a given delegate and return the signed block. unsigned block header: A hex or JSON encoded unsigned block header delegate: signing delegate 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 working with Sapling transactions
-
sapling gen key new [-f --force] [--unencrypted]Generate a new sapling key. new: new sapling_key alias -f --force: overwrite existing sapling_key --unencrypted: Do not encrypt the key on-disk (for testing and debugging).
-
sapling use key sapling-key for contract contract [--memo-size <memo-size>]Use a sapling key for a contract. sapling-key: Sapling key to use for the contract. contract: Contract the key will be used on. Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. --memo-size <memo-size>: Expected length for message of Sapling transaction
-
sapling import key new [-f --force] [--unencrypted] [--mnemonic <mnemonic>]Restore a sapling key from mnemonic. new: new sapling_key alias -f --force: overwrite existing sapling_key --unencrypted: Do not encrypt the key on-disk (for testing and debugging). --mnemonic <mnemonic>: Mnemonic as an option, only used for testing and debugging.
-
sapling derive key new from name at index child-index [-f --force] [--for-contract <for-contract>] [--unencrypted] [--memo-size <memo-size>]Derive a key from an existing one using zip32. new: new sapling_key alias name: existing sapling_key alias child-index: Index of the child to derive. -f --force: overwrite existing sapling_key --for-contract <for-contract>: name of the contract to associate new key with Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. --unencrypted: Do not encrypt the key on-disk (for testing and debugging). --memo-size <memo-size>: Expected length for message of Sapling transaction
-
sapling gen address name [--address-index <idx>]Generate an address for a key referenced by alias. name: existing sapling_key alias --address-index <idx>: index of the address to generate
-
sapling export key name in fileSave a sapling viewing key in a JSON file. name: existing sapling_key alias file: Filename.
-
sapling get balance for sapling-key in contract contract [-v --verbose]Get balance associated with given sapling key and contract sapling-key: Sapling key we get balance for. contract: Contract we get balance from. Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. -v --verbose: Print the collection of non-spent inputs.
-
sapling list keysList sapling keys.
Commands for managing a multisig smart contract
-
show supported multisig hashesShow the hashes of the supported multisig contracts.
-
show multisig scriptShow the script of the recommended multisig contract.
-
deploy multisig new_multisig transferring qty from src with threshold threshold on public keys [key...] [--fee <amount>] [-D --dry-run] [-G --gas-limit <amount>] [--safety-guard <extra_gas>] [-S --storage-limit <amount>] [--delegate <address>] [-f --force] [-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>] [--verbose-signing]Originate a new multisig contract. new_multisig: name of the new multisig 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 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. threshold: Number of required signatures key: Each signer of the multisig contract Can be a public_key name, a file or a raw public_key literal. If the parameter is not the name of an existing public_key, the client will look for a file containing a public_key, and if it does not exist, the argument will be read as a raw public_key. 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 --safety-guard <extra_gas>: Amount of gas to add to value computed by simulation. The gas safety guard allows operations that consume a little more gas than expected to be successful -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 -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 nanotez) 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`. --verbose-signing: display extra information before signing the operation
-
sign multisig transaction on multisig transferring qty to dst using secret key key [--arg <data>] [--entrypoint <name>]Sign a transaction for a multisig contract. multisig: name or address of the originated multisig contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. 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. dst: name/literal of the destination contract Can be a literal, an alias, or a key (autodetected in order). Use 'text:<literal>', 'alias:<name>', 'key:<key>' to force. key: Secret key corresponding to one of the public keys stored on the multisig contract 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. --arg <data>: argument passed to the contract's script, if needed --entrypoint <name>: entrypoint of the smart contract
-
sign multisig transaction on multisig running lambda lambda using secret key keySign a lambda for a generic multisig contract. multisig: name or address of the originated multisig contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. lambda: the lambda to execute, of type lambda unit (list operation) key: Secret key corresponding to one of the public keys stored on the multisig contract 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.
-
sign multisig transaction on multisig setting delegate to dlgt using secret key keySign a delegate change for a multisig contract. multisig: name or address of the originated multisig contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. dlgt: new delegate of the new multisig 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. key: Secret key corresponding to one of the public keys stored on the multisig contract 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.
-
sign multisig transaction on multisig withdrawing delegate using secret key keySign a delegate withdraw for a multisig contract. multisig: name or address of the originated multisig contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. key: Secret key corresponding to one of the public keys stored on the multisig contract 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.
-
sign multisig transaction on multisig using secret key key setting threshold to threshold and public keys to [key...]Sign a change of public keys and threshold for a multisig contract. multisig: name or address of the originated multisig contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. key: Secret key corresponding to one of the public keys stored on the multisig contract 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. threshold: Number of required signatures key: Each signer of the multisig contract Can be a public_key name, a file or a raw public_key literal. If the parameter is not the name of an existing public_key, the client will look for a file containing a public_key, and if it does not exist, the argument will be read as a raw public_key. Use 'alias:<name>', 'file:<path>' or 'text:<literal>' to disable autodetect.
-
from multisig contract multisig transfer qty to dst on behalf of src with signatures [signature...] [--fee <amount>] [-D --dry-run] [--verbose-signing] [-G --gas-limit <amount>] [--safety-guard <extra_gas>] [-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>] [--entrypoint <name>]Transfer tokens using a multisig contract. multisig: name/literal of the multisig contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. qty: amount taken from the multisig contract in ꜩ Text format: `DDDDDDD.DDDDDD`. Tez and mutez and separated by a period sign. Trailing and pending zeroes are allowed. dst: name/literal of the destination contract Can be a literal, an alias, or a key (autodetected in order). Use 'text:<literal>', 'alias:<name>', 'key:<key>' to force. src: source calling the multisig 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. signature: Each signer of the multisig contract --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation -G --gas-limit <amount>: Set the gas limit of the transaction instead of letting the client decide based on a simulation --safety-guard <extra_gas>: Amount of gas to add to value computed by simulation. The gas safety guard allows operations that consume a little more gas than expected to be successful -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 nanotez) 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`. --entrypoint <name>: entrypoint of the smart contract
-
from multisig contract multisig run lambda lambda on behalf of src with signatures [signature...] [--fee <amount>] [-D --dry-run] [--verbose-signing] [-G --gas-limit <amount>] [--safety-guard <extra_gas>] [-S --storage-limit <amount>] [-C --counter <counter>] [-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>]Run a lambda on a generic multisig contract. multisig: name/literal of the multisig contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. lambda: the lambda to execute, of type lambda unit (list operation) src: source calling the multisig 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. signature: Each signer of the multisig contract --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation -G --gas-limit <amount>: Set the gas limit of the transaction instead of letting the client decide based on a simulation --safety-guard <extra_gas>: Amount of gas to add to value computed by simulation. The gas safety guard allows operations that consume a little more gas than expected to be successful -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 -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 nanotez) 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`.
-
set delegate of multisig contract multisig to dlgt on behalf of src with signatures [signature...] [--fee <amount>] [-D --dry-run] [--verbose-signing] [-G --gas-limit <amount>] [--safety-guard <extra_gas>] [-S --storage-limit <amount>] [-C --counter <counter>] [-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>]Change the delegate of a multisig contract. multisig: name or address of the originated multisig contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. dlgt: new delegate of the new multisig 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. src: source calling the multisig 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. signature: Each signer of the multisig contract --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation -G --gas-limit <amount>: Set the gas limit of the transaction instead of letting the client decide based on a simulation --safety-guard <extra_gas>: Amount of gas to add to value computed by simulation. The gas safety guard allows operations that consume a little more gas than expected to be successful -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 -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 nanotez) 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 of multisig contract multisig on behalf of src with signatures [signature...] [--fee <amount>] [-D --dry-run] [--verbose-signing] [-G --gas-limit <amount>] [--safety-guard <extra_gas>] [-S --storage-limit <amount>] [-C --counter <counter>] [-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>]Withdraw the delegate of a multisig contract. multisig: name or address of the originated multisig contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. src: source calling the multisig 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. signature: Each signer of the multisig contract --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation -G --gas-limit <amount>: Set the gas limit of the transaction instead of letting the client decide based on a simulation --safety-guard <extra_gas>: Amount of gas to add to value computed by simulation. The gas safety guard allows operations that consume a little more gas than expected to be successful -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 -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 nanotez) 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`.
-
set threshold of multisig contract multisig to threshold and public keys to [key...] on behalf of src with signatures [signature...] [--fee <amount>] [-D --dry-run] [--verbose-signing] [-G --gas-limit <amount>] [--safety-guard <extra_gas>] [-S --storage-limit <amount>] [-C --counter <counter>] [-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>] [--fee <amount>] [-D --dry-run] [--verbose-signing] [-G --gas-limit <amount>] [--safety-guard <extra_gas>] [-S --storage-limit <amount>] [-C --counter <counter>] [-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>]Change public keys and threshold for a multisig contract. multisig: name or address of the originated multisig contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. threshold: Number of required signatures key: Each signer of the multisig contract Can be a public_key name, a file or a raw public_key literal. If the parameter is not the name of an existing public_key, the client will look for a file containing a public_key, and if it does not exist, the argument will be read as a raw public_key. Use 'alias:<name>', 'file:<path>' or 'text:<literal>' to disable autodetect. src: source calling the multisig 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. signature: Each signer of the multisig contract --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation -G --gas-limit <amount>: Set the gas limit of the transaction instead of letting the client decide based on a simulation --safety-guard <extra_gas>: Amount of gas to add to value computed by simulation. The gas safety guard allows operations that consume a little more gas than expected to be successful -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 -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 nanotez) 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`.
-
run transaction bytes on multisig contract multisig on behalf of src with signatures [signature...] [--fee <amount>] [-D --dry-run] [--verbose-signing] [-G --gas-limit <amount>] [--safety-guard <extra_gas>] [-S --storage-limit <amount>] [-C --counter <counter>] [-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>]Run a transaction described by a sequence of bytes on a multisig contract. bytes: the sequence of bytes to deserialize as a multisig action, can be obtained by one of the "prepare multisig transaction" commands multisig: name or address of the originated multisig contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. src: source calling the multisig 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. signature: Each signer of the multisig contract --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation -G --gas-limit <amount>: Set the gas limit of the transaction instead of letting the client decide based on a simulation --safety-guard <extra_gas>: Amount of gas to add to value computed by simulation. The gas safety guard allows operations that consume a little more gas than expected to be successful -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 -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 nanotez) 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`.
-
prepare multisig transaction on multisig transferring qty to dst [--bytes-only] [--arg <data>] [--entrypoint <name>]Display the threshold, public keys, and byte sequence to sign for a multisigned transfer. multisig: name or address of the originated multisig contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. 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. dst: name/literal of the destination contract Can be a literal, an alias, or a key (autodetected in order). Use 'text:<literal>', 'alias:<name>', 'key:<key>' to force. --bytes-only: return only the byte sequence to be signed --arg <data>: argument passed to the contract's script, if needed --entrypoint <name>: entrypoint of the smart contract
-
prepare multisig transaction on multisig running lambda lambda [--bytes-only]Display the threshold, public keys, and byte sequence to sign for a multisigned lambda execution in a generic multisig contract. multisig: name or address of the originated multisig contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. lambda: the lambda to execute, of type lambda unit (list operation) --bytes-only: return only the byte sequence to be signed
-
prepare multisig transaction on multisig setting delegate to dlgt [--bytes-only]Display the threshold, public keys, and byte sequence to sign for a multisigned delegate change. multisig: name or address of the originated multisig contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. dlgt: new delegate of the new multisig 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. --bytes-only: return only the byte sequence to be signed
-
prepare multisig transaction on multisig withdrawing delegate [--bytes-only]Display the threshold, public keys, and byte sequence to sign for a multisigned delegate withdraw. multisig: name or address of the originated multisig contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. --bytes-only: return only the byte sequence to be signed
-
prepare multisig transaction on multisig setting threshold to threshold and public keys to [key...] [--bytes-only]Display the threshold, public keys, and byte sequence to sign for a multisigned change of keys and threshold. multisig: name or address of the originated multisig contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. threshold: Number of required signatures key: Each signer of the multisig contract Can be a public_key name, a file or a raw public_key literal. If the parameter is not the name of an existing public_key, the client will look for a file containing a public_key, and if it does not exist, the argument will be read as a raw public_key. Use 'alias:<name>', 'file:<path>' or 'text:<literal>' to disable autodetect. --bytes-only: return only the byte sequence to be signed
Binary Description
-
describe unsigned block headerDescribe unsigned block header
-
describe unsigned operationDescribe unsigned operation
Block contextual commands (see option -block)
-
set delegate for src to dlgt [--fee <amount>] [-D --dry-run] [--verbose-signing] [--simulation] [--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 a literal, an alias, or a key (autodetected in order). Use 'text:<literal>', 'alias:<name>', 'key:<key>' to force. dlgt: new delegate of the 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. --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation --simulation: Simulate the execution of the command, without needing any signatures. --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 nanotez) 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] [--verbose-signing] [--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 a literal, an alias, or a key (autodetected in order). Use 'text:<literal>', 'alias:<name>', 'key:<key>' to force. --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation --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 nanotez) 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 transferring qty from src running prg [--fee <amount>] [-D --dry-run] [--verbose-signing] [-G --gas-limit <amount>] [--safety-guard <extra_gas>] [-S --storage-limit <amount>] [--delegate <address>] [-f --force] [--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 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 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. 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 --verbose-signing: display extra information before signing the operation -G --gas-limit <amount>: Set the gas limit of the transaction instead of letting the client decide based on a simulation --safety-guard <extra_gas>: Amount of gas to add to value computed by simulation. The gas safety guard allows operations that consume a little more gas than expected to be successful -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 --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 nanotez) 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`.
-
multiple transfers from src using transfers.json [--default-fee <amount>] [-D --dry-run] [--verbose-signing] [--simulation] [--force] [-G --default-gas-limit <amount>] [--safety-guard <extra_gas>] [-S --default-storage-limit <amount>] [-C --counter <counter>] [--default-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>] [--default-entrypoint <name>] [--replace]Execute multiple transfers from a single source account. If one of the transfers fails, none of them get executed. src: name of the source contract Can be a literal, an alias, or a key (autodetected in order). Use 'text:<literal>', 'alias:<name>', 'key:<key>' to force. transfers.json: List of operations originating from the source contract in JSON format (from a file or directly inlined). The input JSON must be an array of objects of the form: '[ {"destination": dst, "amount": qty (, <field>: <val> ...) } (, ...) ]', where an optional <field> can either be "fee", "gas-limit", "storage-limit", "arg", or "entrypoint". --default-fee <amount>: default fee in ꜩ to pay to the baker for each transaction -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation --simulation: Simulate the execution of the command, without needing any signatures. --force: Inject the operation even if the simulation results in a failure. This switch requires --gas-limit, --storage-limit, and --fee. -G --default-gas-limit <amount>: Set the default gas limit for each transaction instead of letting the client decide based on a simulation --safety-guard <extra_gas>: Amount of gas to add to value computed by simulation. The gas safety guard allows operations that consume a little more gas than expected to be successful -S --default-storage-limit <amount>: Set the default storage limit for each transaction instead of letting the client decide based on a simulation -C --counter <counter>: Set the counter to be used by the transaction --default-arg <data>: default argument passed to each 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 nanotez) 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`. --default-entrypoint <name>: default entrypoint of the smart contracts --replace: Replace an existing pending transaction from the same source, if any, with another one with higher fees. There are no guarantees that the first operation will not be included or that the second one will be. But, only one of the operations at most will end in a block (in precheck mode).
-
originate epoxy epoxy from src public_parameters public_parameters init_state init_state circuits_info circuits_info nb_ops nb_ops [--force] [--default-fee <amount>] [-D --dry-run] [--verbose-signing] [--simulation] [-G --default-gas-limit <amount>] [--safety-guard <extra_gas>] [-S --default-storage-limit <amount>] [-C --counter <counter>] [--default-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>] [--default-entrypoint <name>] [--replace]Execute an Epoxy origination operation. epoxy: Fresh name for an Epoxy rollup src: name of the source 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. public_parameters: public_parameters init_state: init_state circuits_info: circuits_info nb_ops: nb_ops --force: Inject the operation even if the simulation results in a failure. This switch requires --gas-limit, --storage-limit, and --fee. --default-fee <amount>: default fee in ꜩ to pay to the baker for each transaction -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation --simulation: Simulate the execution of the command, without needing any signatures. -G --default-gas-limit <amount>: Set the default gas limit for each transaction instead of letting the client decide based on a simulation --safety-guard <extra_gas>: Amount of gas to add to value computed by simulation. The gas safety guard allows operations that consume a little more gas than expected to be successful -S --default-storage-limit <amount>: Set the default storage limit for each transaction instead of letting the client decide based on a simulation -C --counter <counter>: Set the counter to be used by the transaction --default-arg <data>: default argument passed to each 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 nanotez) 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`. --default-entrypoint <name>: default entrypoint of the smart contracts --replace: Replace an existing pending transaction from the same source, if any, with another one with higher fees. There are no guarantees that the first operation will not be included or that the second one will be. But, only one of the operations at most will end in a block (in precheck mode).
-
epoxy publish from src rollup rollup ops ops [--default-fee <amount>] [-D --dry-run] [--verbose-signing] [--simulation] [-G --default-gas-limit <amount>] [--safety-guard <extra_gas>] [-S --default-storage-limit <amount>] [-C --counter <counter>] [--default-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>] [--default-entrypoint <name>] [--replace]Execute an Epoxy publish operation. src: name of the source 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. rollup: rollup ops: ops --default-fee <amount>: default fee in ꜩ to pay to the baker for each transaction -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation --simulation: Simulate the execution of the command, without needing any signatures. -G --default-gas-limit <amount>: Set the default gas limit for each transaction instead of letting the client decide based on a simulation --safety-guard <extra_gas>: Amount of gas to add to value computed by simulation. The gas safety guard allows operations that consume a little more gas than expected to be successful -S --default-storage-limit <amount>: Set the default storage limit for each transaction instead of letting the client decide based on a simulation -C --counter <counter>: Set the counter to be used by the transaction --default-arg <data>: default argument passed to each 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 nanotez) 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`. --default-entrypoint <name>: default entrypoint of the smart contracts --replace: Replace an existing pending transaction from the same source, if any, with another one with higher fees. There are no guarantees that the first operation will not be included or that the second one will be. But, only one of the operations at most will end in a block (in precheck mode).
-
epoxy update from src rollup rollup update update [--default-fee <amount>] [-D --dry-run] [--verbose-signing] [--simulation] [-G --default-gas-limit <amount>] [--safety-guard <extra_gas>] [-S --default-storage-limit <amount>] [-C --counter <counter>] [--default-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>] [--default-entrypoint <name>] [--replace]Execute an Epoxy update operation. src: name of the source 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. rollup: rollup update: update --default-fee <amount>: default fee in ꜩ to pay to the baker for each transaction -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation --simulation: Simulate the execution of the command, without needing any signatures. -G --default-gas-limit <amount>: Set the default gas limit for each transaction instead of letting the client decide based on a simulation --safety-guard <extra_gas>: Amount of gas to add to value computed by simulation. The gas safety guard allows operations that consume a little more gas than expected to be successful -S --default-storage-limit <amount>: Set the default storage limit for each transaction instead of letting the client decide based on a simulation -C --counter <counter>: Set the counter to be used by the transaction --default-arg <data>: default argument passed to each 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 nanotez) 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`. --default-entrypoint <name>: default entrypoint of the smart contracts --replace: Replace an existing pending transaction from the same source, if any, with another one with higher fees. There are no guarantees that the first operation will not be included or that the second one will be. But, only one of the operations at most will end in a block (in precheck mode).
-
transfer qty from src to dst [--fee <amount>] [-D --dry-run] [--verbose-signing] [--simulation] [--force] [-G --gas-limit <amount>] [--safety-guard <extra_gas>] [-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>] [--entrypoint <name>] [--replace] [--simulate-successor-level]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 a literal, an alias, or a key (autodetected in order). Use 'text:<literal>', 'alias:<name>', 'key:<key>' to force. dst: name/literal of the destination contract Can be a literal, an alias, or a key (autodetected in order). Use 'text:<literal>', 'alias:<name>', 'key:<key>' to force. --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation --simulation: Simulate the execution of the command, without needing any signatures. --force: Inject the operation even if the simulation results in a failure. This switch requires --gas-limit, --storage-limit, and --fee. -G --gas-limit <amount>: Set the gas limit of the transaction instead of letting the client decide based on a simulation --safety-guard <extra_gas>: Amount of gas to add to value computed by simulation. The gas safety guard allows operations that consume a little more gas than expected to be successful -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 nanotez) 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`. --entrypoint <name>: entrypoint of the smart contract --replace: Replace an existing pending transaction from the same source, if any, with another one with higher fees. There are no guarantees that the first operation will not be included or that the second one will be. But, only one of the operations at most will end in a block (in precheck mode). --simulate-successor-level: Make the simulate on the successor level of the current head.
-
register global constant expression from src [--fee <amount>] [-D --dry-run] [--verbose-signing] [--simulation] [--minimal-fees <amount>] [--minimal-nanotez-per-byte <amount>] [--minimal-nanotez-per-gas-unit <amount>] [--force-low-fee] [--fee-cap <amount>] [--burn-cap <amount>] [-S --storage-limit <amount>] [-C --counter <counter>]Register a global constant expression: Michelson expression to register. Note the value is not typechecked before registration. src: name of the account registering the global constant 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 --verbose-signing: display extra information before signing the operation --simulation: Simulate the execution of the command, without needing any signatures. --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 nanotez) 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`. -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
-
call dst from src [--fee <amount>] [-D --dry-run] [--verbose-signing] [--simulation] [--force] [-G --gas-limit <amount>] [--safety-guard <extra_gas>] [-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>] [--entrypoint <name>] [--replace] [--simulate-successor-level]Call a smart contract (same as 'transfer 0'). dst: name/literal of the destination contract Can be a literal, an alias, or a key (autodetected in order). Use 'text:<literal>', 'alias:<name>', 'key:<key>' to force. src: name of the source contract Can be a literal, an alias, or a key (autodetected in order). Use 'text:<literal>', 'alias:<name>', 'key:<key>' to force. --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation --simulation: Simulate the execution of the command, without needing any signatures. --force: Inject the operation even if the simulation results in a failure. This switch requires --gas-limit, --storage-limit, and --fee. -G --gas-limit <amount>: Set the gas limit of the transaction instead of letting the client decide based on a simulation --safety-guard <extra_gas>: Amount of gas to add to value computed by simulation. The gas safety guard allows operations that consume a little more gas than expected to be successful -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 nanotez) 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`. --entrypoint <name>: entrypoint of the smart contract --replace: Replace an existing pending transaction from the same source, if any, with another one with higher fees. There are no guarantees that the first operation will not be included or that the second one will be. But, only one of the operations at most will end in a block (in precheck mode). --simulate-successor-level: Make the simulate on the successor level of the current head.
-
stake qty for src [--fee <amount>] [-D --dry-run] [--verbose-signing] [--simulation] [--force] [-G --gas-limit <amount>] [--safety-guard <extra_gas>] [-S --storage-limit <amount>] [-C --counter <counter>] [-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>] [--replace] [--simulate-successor-level]Stake the given amount for the source. The source must be a delegator to be allowed to stake. qty: amount staked 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 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 --verbose-signing: display extra information before signing the operation --simulation: Simulate the execution of the command, without needing any signatures. --force: Inject the operation even if the simulation results in a failure. This switch requires --gas-limit, --storage-limit, and --fee. -G --gas-limit <amount>: Set the gas limit of the transaction instead of letting the client decide based on a simulation --safety-guard <extra_gas>: Amount of gas to add to value computed by simulation. The gas safety guard allows operations that consume a little more gas than expected to be successful -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 -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 nanotez) 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`. --replace: Replace an existing pending transaction from the same source, if any, with another one with higher fees. There are no guarantees that the first operation will not be included or that the second one will be. But, only one of the operations at most will end in a block (in precheck mode). --simulate-successor-level: Make the simulate on the successor level of the current head.
-
unstake qty for src [--fee <amount>] [-D --dry-run] [--verbose-signing] [--simulation] [--force] [-G --gas-limit <amount>] [--safety-guard <extra_gas>] [-S --storage-limit <amount>] [-C --counter <counter>] [-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>] [--replace] [--simulate-successor-level]Unstake the given amount. If "everything" is given as amount, unstakes everything from the staking balance. Unstaked tez remains frozen for a set amount of cycles (the slashing period) after the operation. Once this period is over, the operation "finalize unstake" must be called for the funds to appear in the liquid balance. qty: amount to unstake from source in ꜩ (or everything) 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 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 --verbose-signing: display extra information before signing the operation --simulation: Simulate the execution of the command, without needing any signatures. --force: Inject the operation even if the simulation results in a failure. This switch requires --gas-limit, --storage-limit, and --fee. -G --gas-limit <amount>: Set the gas limit of the transaction instead of letting the client decide based on a simulation --safety-guard <extra_gas>: Amount of gas to add to value computed by simulation. The gas safety guard allows operations that consume a little more gas than expected to be successful -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 -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 nanotez) 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`. --replace: Replace an existing pending transaction from the same source, if any, with another one with higher fees. There are no guarantees that the first operation will not be included or that the second one will be. But, only one of the operations at most will end in a block (in precheck mode). --simulate-successor-level: Make the simulate on the successor level of the current head.
-
finalize unstake for src [--fee <amount>] [-D --dry-run] [--verbose-signing] [--simulation] [--force] [-G --gas-limit <amount>] [--safety-guard <extra_gas>] [-S --storage-limit <amount>] [-C --counter <counter>] [-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>] [--replace] [--simulate-successor-level]Transfer all the finalizable unstaked funds of the source to their liquid balance. src: name of the source 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. --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation --simulation: Simulate the execution of the command, without needing any signatures. --force: Inject the operation even if the simulation results in a failure. This switch requires --gas-limit, --storage-limit, and --fee. -G --gas-limit <amount>: Set the gas limit of the transaction instead of letting the client decide based on a simulation --safety-guard <extra_gas>: Amount of gas to add to value computed by simulation. The gas safety guard allows operations that consume a little more gas than expected to be successful -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 -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 nanotez) 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`. --replace: Replace an existing pending transaction from the same source, if any, with another one with higher fees. There are no guarantees that the first operation will not be included or that the second one will be. But, only one of the operations at most will end in a block (in precheck mode). --simulate-successor-level: Make the simulate on the successor level of the current head.
-
set delegate parameters for src [--limit-of-staking-over-baking <limit>] [--edge-of-baking-over-staking <edge>] [--fee <amount>] [-D --dry-run] [--verbose-signing] [--simulation] [--force] [-G --gas-limit <amount>] [--safety-guard <extra_gas>] [-S --storage-limit <amount>] [-C --counter <counter>] [-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>] [--replace] [--simulate-successor-level]Set delegate parameters src: name of the delegate 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. --limit-of-staking-over-baking <limit>: Limits the total amount of stake for the source's delegators as a proportion of the source's own stake. Any amount exceeding this limit is considered as delegation in the stake of the delegate. The value should be between 0 and 5 (default 0 if not set). If this parameter is 0, as is the default, any staking operation from the source's delegators are forbidden and will fail (unstaking operations are still allowed). --edge-of-baking-over-staking <edge>: Sets the portion of the delegate's stakers rewards that goes to the delegate. This edge, taken from the staker's rewards, is accrued to the delegate's own frozen balance. This value must be between 0 and 1 (e.g. 0.05 for the delegate to receive 5% of the staker's rewards). Default value is 1 (delegate receives all staker's rewards). --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation --simulation: Simulate the execution of the command, without needing any signatures. --force: Inject the operation even if the simulation results in a failure. This switch requires --gas-limit, --storage-limit, and --fee. -G --gas-limit <amount>: Set the gas limit of the transaction instead of letting the client decide based on a simulation --safety-guard <extra_gas>: Amount of gas to add to value computed by simulation. The gas safety guard allows operations that consume a little more gas than expected to be successful -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 -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 nanotez) 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`. --replace: Replace an existing pending transaction from the same source, if any, with another one with higher fees. There are no guarantees that the first operation will not be included or that the second one will be. But, only one of the operations at most will end in a block (in precheck mode). --simulate-successor-level: Make the simulate on the successor level of the current head.
-
reveal key for src [--fee <amount>] [-D --dry-run] [--verbose-signing] [--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 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 --verbose-signing: display extra information before signing the operation --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 nanotez) 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] [--verbose-signing] [--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 --verbose-signing: display extra information before signing the operation --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 nanotez) 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 with consensus key key [--fee <amount>] [-D --dry-run] [--verbose-signing] [--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. key: the consensus key Can be a public_key name, a file or a raw public_key literal. If the parameter is not the name of an existing public_key, the client will look for a file containing a public_key, and if it does not exist, the argument will be read as a raw public_key. 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 --verbose-signing: display extra information before signing the operation --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 nanotez) 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`.
-
set consensus key for mgr to key [--fee <amount>] [-D --dry-run] [--verbose-signing] [--minimal-fees <amount>] [--minimal-nanotez-per-byte <amount>] [--minimal-nanotez-per-gas-unit <amount>] [--force-low-fee] [--fee-cap <amount>] [--burn-cap <amount>]Update the consensus key of 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. key: the consensus key Can be a public_key name, a file or a raw public_key literal. If the parameter is not the name of an existing public_key, the client will look for a file containing a public_key, and if it does not exist, the argument will be read as a raw public_key. 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 --verbose-signing: display extra information before signing the operation --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 nanotez) 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`.
-
drain delegate mgr to dest [-D --dry-run] [--verbose-signing]Drain all funds from 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. dest: the consensus 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. -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation
-
drain delegate mgr to dest with consensus_key [-D --dry-run] [--verbose-signing]Drain all funds from 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. dest: the destination 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. consensus_key: the consensus 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. -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation
-
submit proposals for delegate [proposal...] [-D --dry-run] [--verbose-signing] [--force]Submit protocol proposals delegate: the delegate who makes the proposal 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. proposal: the protocol hash proposal to be submitted -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation --force: Do not fail when the checks that try to prevent the user from shooting themselves in the foot do fail.
-
submit ballot for delegate proposal ballot [--verbose-signing] [-D --dry-run] [--force]Submit a ballot delegate: the delegate who votes 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. proposal: the protocol hash proposal to vote for ballot: the ballot value (yea, nay, or pass; yay is a deprecated synonym for yea) --verbose-signing: display extra information before signing the operation -D --dry-run: don't inject the operation, just display it --force: Do not fail when the checks that try to prevent the user from shooting themselves in the foot do fail.
-
set deposits limit for src to deposits limit [--fee <amount>] [-D --dry-run] [--verbose-signing] [--simulation] [--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 deposits limit of a registered delegate. src: source 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. deposits limit: the maximum amount of frozen deposits in ꜩ Text format: `DDDDDDD.DDDDDD`. Tez and mutez and separated by a period sign. Trailing and pending zeroes are allowed. --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation --simulation: Simulate the execution of the command, without needing any signatures. --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 nanotez) 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`.
-
unset deposits limit for src [--fee <amount>] [-D --dry-run] [--verbose-signing] [--simulation] [--minimal-fees <amount>] [--minimal-nanotez-per-byte <amount>] [--minimal-nanotez-per-gas-unit <amount>] [--force-low-fee] [--fee-cap <amount>] [--burn-cap <amount>]Remove the deposits limit of a registered delegate. src: source 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. --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation --simulation: Simulate the execution of the command, without needing any signatures. --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 nanotez) 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`.
-
increase the paid storage of contract by amount bytes from payer [--force] [--fee <amount>] [-D --dry-run] [--verbose-signing] [--simulation] [--minimal-fees <amount>] [--minimal-nanotez-per-byte <amount>] [--minimal-nanotez-per-gas-unit <amount>] [--force-low-fee] [--fee-cap <amount>] [--burn-cap <amount>]Increase the paid storage of a smart contract. contract: name of the smart contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. amount: amount of increase in bytes payer: payer of the storage increase 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. --force: Inject the operation even if the simulation results in a failure. This switch requires --gas-limit, --storage-limit, and --fee. --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation --simulation: Simulate the execution of the command, without needing any signatures. --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 nanotez) 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 tickets from tickets owner to recipient contract with entrypoint entrypoint and contents tickets content and type tickets type and ticketer tickets ticketer [--fee <amount>] [-D --dry-run] [--verbose-signing] [--simulation] [--minimal-fees <amount>] [--minimal-nanotez-per-byte <amount>] [--minimal-nanotez-per-gas-unit <amount>] [--force-low-fee] [--fee-cap <amount>] [--burn-cap <amount>] [-S --storage-limit <amount>] [-C --counter <counter>]Transfer tickets from an implicit account to a contract or another implicit account. qty: Amount of tickets to transfer. tickets owner: Implicit account owning the tickets. 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. recipient contract: Contract receiving the tickets. Can be a literal, an alias, or a key (autodetected in order). Use 'text:<literal>', 'alias:<name>', 'key:<key>' to force. entrypoint: Entrypoint to use on the receiving contract or implicit account. Needs to be "default" for implicit account destinations. tickets content: Content of the tickets. tickets type: Type of the tickets. tickets ticketer: Ticketer contract of the tickets. Can be a literal, an alias, or a key (autodetected in order). Use 'text:<literal>', 'alias:<name>', 'key:<key>' to force. --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation --simulation: Simulate the execution of the command, without needing any signatures. --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 nanotez) 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`. -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
-
originate smart rollup alias from src of kind smart_rollup_kind of type parameters_type with kernel kernel [--fee <amount>] [-D --dry-run] [--verbose-signing] [--simulation] [--minimal-fees <amount>] [--minimal-nanotez-per-byte <amount>] [--minimal-nanotez-per-gas-unit <amount>] [--force-low-fee] [--fee-cap <amount>] [--burn-cap <amount>] [-S --storage-limit <amount>] [-C --counter <counter>] [-f --force] [-W --whitelist <whitelist>]Originate a new smart rollup. alias: name of the new smart rollup src: Name of the account originating the smart rollup. 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. smart_rollup_kind: Kind of the smart rollup to be originated. parameters_type: The interface of the smart rollup including its entrypoints and their signatures. kernel: The kernel for the smart rollup. --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation --simulation: Simulate the execution of the command, without needing any signatures. --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 nanotez) 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`. -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 -f --force: overwrite existing keys -W --whitelist <whitelist>: Whitelist for private rollups. Members of the whitelist are stakers that are allowed to publish commitments.
-
send smart rollup message messages from src [--fee <amount>] [-D --dry-run] [--verbose-signing] [--simulation] [--minimal-fees <amount>] [--minimal-nanotez-per-byte <amount>] [--minimal-nanotez-per-gas-unit <amount>] [--force-low-fee] [--fee-cap <amount>] [--burn-cap <amount>] [-G --gas-limit <amount>] [--safety-guard <extra_gas>] [-S --storage-limit <amount>] [-C --counter <counter>]Send one or more messages to a smart rollup. messages: The message(s) to be sent to the rollup (syntax: bin:<path_to_binary_file>|text:<json list of raw string messages>|hex:<json list of hex-encoded messages>|file:<json_file>). src: Name of the source 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. --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation --simulation: Simulate the execution of the command, without needing any signatures. --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 nanotez) 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`. -G --gas-limit <amount>: Set the gas limit of the transaction instead of letting the client decide based on a simulation --safety-guard <extra_gas>: Amount of gas to add to value computed by simulation. The gas safety guard allows operations that consume a little more gas than expected to be successful -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
-
publish commitment from src for smart rollup smart rollup address with compressed state compressed_state at inbox level inbox_level and predecessor predecessor and number of ticks number_of_ticks [--fee <amount>] [-D --dry-run] [--verbose-signing] [--simulation] [-S --storage-limit <amount>] [-C --counter <counter>] [--minimal-fees <amount>] [--minimal-nanotez-per-byte <amount>] [--minimal-nanotez-per-gas-unit <amount>] [--force-low-fee] [--fee-cap <amount>] [--burn-cap <amount>]Publish a commitment for a smart rollup src: Name of the source 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. smart rollup address: The address of the smart rollup where the commitment will be published. Can be a literal or an alias (autodetected in order). Use 'alias:<name>' or 'text:<literal>' to force. compressed_state: The compressed state of the smart rollup for the commitment. inbox_level: The inbox level for the commitment. predecessor: The hash of the commitment's predecessor number_of_ticks: The number of ticks for the commitment. --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation --simulation: Simulate the execution of the command, without needing any signatures. -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 --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 nanotez) 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`.
-
cement commitment from src for smart rollup smart rollup address [--fee <amount>] [-D --dry-run] [--verbose-signing] [--simulation] [-S --storage-limit <amount>] [-C --counter <counter>] [--minimal-fees <amount>] [--minimal-nanotez-per-byte <amount>] [--minimal-nanotez-per-gas-unit <amount>] [--force-low-fee] [--fee-cap <amount>] [--burn-cap <amount>]Cement a commitment for a smart rollup. src: Name of the source 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. smart rollup address: The address of the smart rollup of which the commitment will be cemented. Can be a literal or an alias (autodetected in order). Use 'alias:<name>' or 'text:<literal>' to force. --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation --simulation: Simulate the execution of the command, without needing any signatures. -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 --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 nanotez) 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`.
-
timeout dispute on smart rollup smart rollup address with staker1 against staker2 from src [--fee <amount>] [-D --dry-run] [--verbose-signing] [--simulation] [-S --storage-limit <amount>] [-C --counter <counter>] [--minimal-fees <amount>] [--minimal-nanotez-per-byte <amount>] [--minimal-nanotez-per-gas-unit <amount>] [--force-low-fee] [--fee-cap <amount>] [--burn-cap <amount>]Timeout a staker from dispute on a smart rollup. smart rollup address: The address of the smart rollup where the staker of the dispute has timed-out. Can be a literal or an alias (autodetected in order). Use 'alias:<name>' or 'text:<literal>' to force. staker1: The staker that has timed out. 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. staker2: The opponent of this staker. 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. src: Name of the source 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. --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation --simulation: Simulate the execution of the command, without needing any signatures. -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 --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 nanotez) 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`.
-
list smart rollupsList originated smart rollups.
-
execute outbox message of smart rollup smart rollup address from source for commitment hash cemented commitment and output proof output proof [--fee <amount>] [-D --dry-run] [--verbose-signing] [--simulation] [--minimal-fees <amount>] [--minimal-nanotez-per-byte <amount>] [--minimal-nanotez-per-gas-unit <amount>] [--force-low-fee] [--fee-cap <amount>] [--burn-cap <amount>] [-S --storage-limit <amount>] [-C --counter <counter>]Execute a message from a smart rollup's outbox of a cemented commitment. smart rollup address: The address of the smart rollup where the message resides. Can be a literal or an alias (autodetected in order). Use 'alias:<name>' or 'text:<literal>' to force. source: The account used for executing the outbox message. 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. cemented commitment: The hash of the cemented commitment of the rollup. output proof: The output proof containing the outbox level, index and message. --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation --simulation: Simulate the execution of the command, without needing any signatures. --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 nanotez) 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`. -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
-
recover bond of staker for smart rollup smart rollup address from src [--fee <amount>] [-D --dry-run] [--verbose-signing] [--simulation] [--minimal-fees <amount>] [--minimal-nanotez-per-byte <amount>] [--minimal-nanotez-per-gas-unit <amount>] [--force-low-fee] [--fee-cap <amount>] [--burn-cap <amount>] [-S --storage-limit <amount>] [-C --counter <counter>]Recover commitment bond from a smart rollup. staker: The implicit account that owns the frozen bond. 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. smart rollup address: The address of the smart rollup of the bond. Can be a literal or an alias (autodetected in order). Use 'alias:<name>' or 'text:<literal>' to force. src: The implicit account that triggers the operation. 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 --verbose-signing: display extra information before signing the operation --simulation: Simulate the execution of the command, without needing any signatures. --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 nanotez) 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`. -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
-
timelock precompute for time in file [--timelock-locked-valuec <timelock-locked>]Precompute timelock tuple. time: timelock difficulty file: updates dir --timelock-locked-valuec <timelock-locked>: Timelock RSA group modulus
-
timelock create for time with payload in fileGenerate timelock chest. time: timelock difficulty payload: timelock message file: updates dir
-
timelock open for time chest chest in fileOpen timelock chest. time: timelock difficulty chest: timelock chest file: updates dir
-
timelock verify for time chest chest chest_key chest_keyVerify timelock chest. time: timelock difficulty chest: timelock chest chest_key: timelock chest's key
-
publish dal commitment commitment from src for slot DAL slot index with proof commitment proof [--fee <amount>] [-D --dry-run] [--verbose-signing] [--simulation] [-S --storage-limit <amount>] [-C --counter <counter>] [--minimal-fees <amount>] [--minimal-nanotez-per-byte <amount>] [--minimal-nanotez-per-gas-unit <amount>] [--force-low-fee] [--fee-cap <amount>] [--burn-cap <amount>]Publish a DAL commitment on L1 for the given slot index commitment: The DAL commitment to publish. src: Name of the source 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. DAL slot index: The index of the DAL slot. commitment proof: The proof of the DAL commitment to publish. --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation --simulation: Simulate the execution of the command, without needing any signatures. -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 --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 nanotez) 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 JSON (file or directly inlined). -f --force: overwrite existing secret_key --encrypted: encrypt the key on-disk
-
get timestamp [-s --seconds]Access the timestamp of the block. -s --seconds: output time in seconds
-
list contractsLists all non empty contracts of the block.
-
list cached contractsLists cached contracts and their age in LRU ordering.
-
get cached contract rank for srcGet the key rank of a cache key. src: contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force.
-
get cache contract sizeGet cache contract size.
-
get cache contract size limitGet cache contract size limit.
-
get balance for srcGet the liquid balance of a contract. src: source contract Can be a literal, an alias, or a key (autodetected in order). Use 'text:<literal>', 'alias:<name>', 'key:<key>' to force.
-
get staked balance for srcGet the staked balance of a contract. src: source contract Can be a literal, an alias, or a key (autodetected in order). Use 'text:<literal>', 'alias:<name>', 'key:<key>' to force.
-
get full balance for srcGet the full balance of a contract. src: source contract Can be a literal, an alias, or a key (autodetected in order). Use 'text:<literal>', 'alias:<name>', 'key:<key>' to force.
-
get contract storage for src [--unparsing-mode <mode>]Get the storage of a contract. src: source contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. --unparsing-mode <mode>: Unparsing mode to use One of "Readable", "Optimized", or "Optimized_legacy". This option affects the way the values of the following Michelson types are represented: - timestamp: the Readable representation is a RFC3339 string, the Optimized and Optimized_legacy representations are the number of seconds since Epoch - key, signature, key_hash, address, contract, chain_id: the Readable representation is a Base58Check string, the Optimized and Optimized_legacy representations are byte sequences - nested pairs: in Readable mode, the Pair constructor is used even with arity bigger than 2 such as in Pair 0 1 2; in Optimized_legacy mode, the Pair constructor is always use with arity 2 such as in Pair 0 (Pair 1 2); in Optimized mode, a sequence is used if there are at least 4 elements and the behavior is the same as in Optimized_legacy mode otherwise. Defaults to `Readable`.
-
get contract used storage space for srcGet the used storage space of a contract. src: source contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force.
-
get contract paid storage space for srcGet the paid storage space of a contract. src: source contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force.
-
get big map value for key of type type in srcGet the value associated to a key in the big map storage of a contract (deprecated). key: the key to look for type: type of the key src: source contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force.
-
get element key of big map big_map [--unparsing-mode <mode>]Get a value in a big map. key: the key to look for big_map: identifier of the big_map --unparsing-mode <mode>: Unparsing mode to use One of "Readable", "Optimized", or "Optimized_legacy". This option affects the way the values of the following Michelson types are represented: - timestamp: the Readable representation is a RFC3339 string, the Optimized and Optimized_legacy representations are the number of seconds since Epoch - key, signature, key_hash, address, contract, chain_id: the Readable representation is a Base58Check string, the Optimized and Optimized_legacy representations are byte sequences - nested pairs: in Readable mode, the Pair constructor is used even with arity bigger than 2 such as in Pair 0 1 2; in Optimized_legacy mode, the Pair constructor is always use with arity 2 such as in Pair 0 (Pair 1 2); in Optimized mode, a sequence is used if there are at least 4 elements and the behavior is the same as in Optimized_legacy mode otherwise. Defaults to `Readable`.
-
get contract code for src [--unparsing-mode <mode>] [--normalize-types]Get the code of a contract. src: source contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. --unparsing-mode <mode>: Unparsing mode to use One of "Readable", "Optimized", or "Optimized_legacy". This option affects the way the values of the following Michelson types are represented: - timestamp: the Readable representation is a RFC3339 string, the Optimized and Optimized_legacy representations are the number of seconds since Epoch - key, signature, key_hash, address, contract, chain_id: the Readable representation is a Base58Check string, the Optimized and Optimized_legacy representations are byte sequences - nested pairs: in Readable mode, the Pair constructor is used even with arity bigger than 2 such as in Pair 0 1 2; in Optimized_legacy mode, the Pair constructor is always use with arity 2 such as in Pair 0 (Pair 1 2); in Optimized mode, a sequence is used if there are at least 4 elements and the behavior is the same as in Optimized_legacy mode otherwise. Defaults to `Readable`. --normalize-types: Whether types should be normalized (annotations removed, combs flattened) or kept as they appeared in the original script.
-
get contract script hash for srcGet the `BLAKE2B` script hash of a contract. src: source contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force.
-
get contract entrypoint type of entrypoint for src [--normalize-types]Get the type of an entrypoint of a contract. entrypoint: the entrypoint to describe src: source contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. --normalize-types: Whether types should be normalized (annotations removed, combs flattened) or kept as they appeared in the original script.
-
get contract entrypoints for src [--normalize-types]Get the entrypoint list of a contract. src: source contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. --normalize-types: Whether types should be normalized (annotations removed, combs flattened) or kept as they appeared in the original script.
-
get contract unreachable paths for srcGet the list of unreachable paths in a contract's parameter type. src: source contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force.
-
get delegate for srcGet the delegate of a contract. src: source contract Can be a literal, an alias, or a key (autodetected in order). Use 'text:<literal>', 'alias:<name>', 'key:<key>' to force.
-
get ticket balance for src with ticketer ticketer and type ticket content type and content ticket contentGet contract's balance of ticket with specified ticketer, content type, and content. src: Source address. Can be a literal, an alias, or a key (autodetected in order). Use 'text:<literal>', 'alias:<name>', 'key:<key>' to force. ticketer: Ticketer contract of the ticket. Can be a literal, an alias, or a key (autodetected in order). Use 'text:<literal>', 'alias:<name>', 'key:<key>' to force. ticket content type: Type of the content of the ticket. ticket content: Content of the ticket.
-
get all ticket balances for srcGet the complete list of tickets owned by a given contract. src: Source contract. Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force.
-
show voting periodSummarize the current voting period
-
get deposits limit for srcGet the frozen deposits limit of a delegate. src: source delegate 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.
-
sapling shield qty from src-tz to dst-sap using sapling contract [--fee <amount>] [-D --dry-run] [--verbose-signing] [-G --gas-limit <amount>] [-S --storage-limit <amount>] [-C --counter <counter>] [-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>] [--message <>]Shield tokens from an implicit account to a Sapling address. qty: Amount taken from transparent wallet of source. in ꜩ Text format: `DDDDDDD.DDDDDD`. Tez and mutez and separated by a period sign. Trailing and pending zeroes are allowed. src-tz: Transparent source account. 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. dst-sap: Sapling address of destination. sapling contract: Smart contract to submit this transaction to. Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation -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 -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 nanotez) 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`. --message <>: Message for Sapling transaction
-
sapling unshield qty from src-sap to dst-tz using sapling contract [--fee <amount>] [-D --dry-run] [--verbose-signing] [-G --gas-limit <amount>] [-S --storage-limit <amount>] [-C --counter <counter>] [-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>]Unshield tokens from a Sapling address to an implicit account. qty: Amount taken from shielded wallet of source. in ꜩ Text format: `DDDDDDD.DDDDDD`. Tez and mutez and separated by a period sign. Trailing and pending zeroes are allowed. src-sap: Sapling account of source. dst-tz: Transparent destination account. 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. sapling contract: Smart contract to submit this transaction to. Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation -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 -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 nanotez) 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`.
-
sapling forge transaction qty from src-sap to dst-sap using sapling contract [--fee <amount>] [-D --dry-run] [--verbose-signing] [-G --gas-limit <amount>] [-S --storage-limit <amount>] [-C --counter <counter>] [-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>] [--message <>] [--file <sapling_transaction>] [--json]Forge a sapling transaction and save it to a file. qty: Amount taken from shielded wallet of source. in ꜩ Text format: `DDDDDDD.DDDDDD`. Tez and mutez and separated by a period sign. Trailing and pending zeroes are allowed. src-sap: Sapling account of source. dst-sap: Sapling address of destination. sapling contract: Smart contract to submit this transaction to. Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation -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 -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 nanotez) 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`. --message <>: Message for Sapling transaction --file <sapling_transaction>: file name --json: Use JSON format
-
sapling submit file from alias-tz using sapling contract [--fee <amount>] [-D --dry-run] [--verbose-signing] [-G --gas-limit <amount>] [-S --storage-limit <amount>] [-C --counter <counter>] [-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>] [--json]Submit a forged sapling transaction. file: Filename of the forged transaction. alias-tz: Transparent account paying the fees. 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. sapling contract: Smart contract to submit this transaction to. Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. --fee <amount>: fee in ꜩ to pay to the baker -D --dry-run: don't inject the operation, just display it --verbose-signing: display extra information before signing the operation -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 -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 nanotez) 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`. --json: Use JSON format
-
stresstest originate smart contracts from srcOriginate all supported smart contracts for use in the stresstest. src: name of the source 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.
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 nameRemove a contract from the wallet. name: existing contract alias
-
list known contractsLists 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 nameDisplay a contract from the wallet. name: existing contract alias
Commands for managing the library of known scripts
-
list known scriptsLists 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 nameRemove a script from the library. name: existing script alias
-
show known script nameDisplay a script from the library. name: existing script alias
-
run script src on storage storage and input input [--trace-stack] [--amount <amount>] [--balance <amount>] [--source <source>] [--payer <src>] [--self-address <self-address>] [-q --no-print-source] [-G --gas <gas>] [--entrypoint <name>] [--unparsing-mode <mode>] [--now <timestamp>] [--level <level>] [--other-contracts <contracts>] [--extra-big-maps <big maps>]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 input: the input data --trace-stack: show the stack after each step --amount <amount>: amount of the transfer in ꜩ Defaults to `0.05`. --balance <amount>: balance of run contract in ꜩ --source <source>: name of the source (i.e. SENDER) contract for the transaction Can be a literal, an alias, or a key (autodetected in order). Use 'text:<literal>', 'alias:<name>', 'key:<key>' to force. --payer <src>: name of the payer (i.e. SOURCE) contract for the transaction 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. --self-address <self-address>: address of the contract (i.e. SELF_ADDRESS) for the transaction Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. -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 --entrypoint <name>: entrypoint of the smart contract --unparsing-mode <mode>: Unparsing mode to use One of "Readable", "Optimized", or "Optimized_legacy". This option affects the way the values of the following Michelson types are represented: - timestamp: the Readable representation is a RFC3339 string, the Optimized and Optimized_legacy representations are the number of seconds since Epoch - key, signature, key_hash, address, contract, chain_id: the Readable representation is a Base58Check string, the Optimized and Optimized_legacy representations are byte sequences - nested pairs: in Readable mode, the Pair constructor is used even with arity bigger than 2 such as in Pair 0 1 2; in Optimized_legacy mode, the Pair constructor is always use with arity 2 such as in Pair 0 (Pair 1 2); in Optimized mode, a sequence is used if there are at least 4 elements and the behavior is the same as in Optimized_legacy mode otherwise. Defaults to `Readable`. --now <timestamp>: Set the timestamp to be returned by the NOW instruction. Allowed format are RFC 3339 (YYYY-MM-DDTHH:MM:SSZ) or number of seconds since epoch. --level <level>: Set the level to be returned by the LEVEL instruction --other-contracts <contracts>: types and addresses of extra contracts, formatted as {Contract "KT1..." <ty1>; Contract "KT1..." <ty2>; ...} --extra-big-maps <big maps>: identifier and content of extra big maps, formatted as {Big_map <index> <key_type> <value_type> {Elt <key1> <value1>; Elt <key2> <value2>; ...}}
-
run michelson code src on stack stack [--amount <amount>] [--balance <amount>] [--source <source>] [--payer <src>] [--self-address <self-address>] [-G --gas <gas>] [--unparsing-mode <mode>] [--now <timestamp>] [--level <level>] [--other-contracts <contracts>] [--extra-big-maps <big maps>] [--legacy]Ask the node to run a Michelson instruction or a sequence of Michelson instructions on a stack. 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. stack: a Michelson stack in the following format: {Stack_elt <ty_1> <val_1>; ...; Stack_elt <ty_n> <val_n>}, where each <val_i> is a Michelson value of type <ty_i>. The topmost element of the stack is <val_1>. --amount <amount>: amount of the transfer in ꜩ Defaults to `0.05`. --balance <amount>: balance of run contract in ꜩ --source <source>: name of the source (i.e. SENDER) contract for the transaction Can be a literal, an alias, or a key (autodetected in order). Use 'text:<literal>', 'alias:<name>', 'key:<key>' to force. --payer <src>: name of the payer (i.e. SOURCE) contract for the transaction 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. --self-address <self-address>: address of the contract (i.e. SELF_ADDRESS) for the transaction Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. -G --gas <gas>: Initial quantity of gas for typechecking and execution --unparsing-mode <mode>: Unparsing mode to use One of "Readable", "Optimized", or "Optimized_legacy". This option affects the way the values of the following Michelson types are represented: - timestamp: the Readable representation is a RFC3339 string, the Optimized and Optimized_legacy representations are the number of seconds since Epoch - key, signature, key_hash, address, contract, chain_id: the Readable representation is a Base58Check string, the Optimized and Optimized_legacy representations are byte sequences - nested pairs: in Readable mode, the Pair constructor is used even with arity bigger than 2 such as in Pair 0 1 2; in Optimized_legacy mode, the Pair constructor is always use with arity 2 such as in Pair 0 (Pair 1 2); in Optimized mode, a sequence is used if there are at least 4 elements and the behavior is the same as in Optimized_legacy mode otherwise. Defaults to `Readable`. --now <timestamp>: Set the timestamp to be returned by the NOW instruction. Allowed format are RFC 3339 (YYYY-MM-DDTHH:MM:SSZ) or number of seconds since epoch. --level <level>: Set the level to be returned by the LEVEL instruction --other-contracts <contracts>: types and addresses of extra contracts, formatted as {Contract "KT1..." <ty1>; Contract "KT1..." <ty2>; ...} --extra-big-maps <big maps>: identifier and content of extra big maps, formatted as {Big_map <index> <key_type> <value_type> {Elt <key1> <value1>; Elt <key2> <value2>; ...}} --legacy: typecheck in legacy mode as if the data was taken from the chain
-
compute size for script src on storage storage [--emacs] [-q --no-print-source] [-G --gas <gas>] [--legacy]Ask the node to compute the size of 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 --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 --legacy: typecheck in legacy mode as if the data was taken from the chain
-
run unit tests from [source...]Ask the node to run Michelson unit tests from files or literals source: literal or a path to a file
-
typecheck script [source...] [-v --details] [--emacs] [-q --no-print-source] [-G --gas <gas>] [--legacy] [--display-names]Ask the node to typecheck one or several scripts. source: literal or a path to a file -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 --legacy: typecheck in legacy mode as if the data was taken from the chain --display-names: Print names of scripts passed to this command
-
typecheck data data against type type [-q --no-print-source] [-G --gas <gas>] [--legacy]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 --legacy: typecheck in legacy mode as if the data was taken from the chain
-
hash data data of type type [-G --gas <gas>] [--for-script <FORMAT>]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 --for-script <FORMAT>: Make the output script-friendly. Possible values are 'TSV' and 'CSV'.
-
hash script [source...] [--enforce-indentation] [--display-names] [--for-script <FORMAT>]Ask the node to hash a Michelson script with `BLAKE2B`. source: literal or a path to a file --enforce-indentation: Check that the Micheline expression passed to this command is well-indented. --display-names: Print names of scripts passed to this command --for-script <FORMAT>: Make the output script-friendly. Possible values are 'TSV' and 'CSV'.
-
unpack michelson data bytesParse a byte sequence (in hexadecimal notation) as a data expression, as per Michelson instruction `UNPACK`. bytes: the packed data to parse
-
normalize script src [--unparsing-mode <mode>]Ask the node to normalize 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. --unparsing-mode <mode>: Unparsing mode to use One of "Readable", "Optimized", or "Optimized_legacy". This option affects the way the values of the following Michelson types are represented: - timestamp: the Readable representation is a RFC3339 string, the Optimized and Optimized_legacy representations are the number of seconds since Epoch - key, signature, key_hash, address, contract, chain_id: the Readable representation is a Base58Check string, the Optimized and Optimized_legacy representations are byte sequences - nested pairs: in Readable mode, the Pair constructor is used even with arity bigger than 2 such as in Pair 0 1 2; in Optimized_legacy mode, the Pair constructor is always use with arity 2 such as in Pair 0 (Pair 1 2); in Optimized mode, a sequence is used if there are at least 4 elements and the behavior is the same as in Optimized_legacy mode otherwise. Defaults to `Readable`.
-
normalize data data of type type [--unparsing-mode <mode>] [--legacy] [--other-contracts <contracts>] [--extra-big-maps <big maps>]Ask the node to normalize a data expression. data: the data expression to normalize type: type of the data expression --unparsing-mode <mode>: Unparsing mode to use One of "Readable", "Optimized", or "Optimized_legacy". This option affects the way the values of the following Michelson types are represented: - timestamp: the Readable representation is a RFC3339 string, the Optimized and Optimized_legacy representations are the number of seconds since Epoch - key, signature, key_hash, address, contract, chain_id: the Readable representation is a Base58Check string, the Optimized and Optimized_legacy representations are byte sequences - nested pairs: in Readable mode, the Pair constructor is used even with arity bigger than 2 such as in Pair 0 1 2; in Optimized_legacy mode, the Pair constructor is always use with arity 2 such as in Pair 0 (Pair 1 2); in Optimized mode, a sequence is used if there are at least 4 elements and the behavior is the same as in Optimized_legacy mode otherwise. Defaults to `Readable`. --legacy: typecheck in legacy mode as if the data was taken from the chain --other-contracts <contracts>: types and addresses of extra contracts, formatted as {Contract "KT1..." <ty1>; Contract "KT1..." <ty2>; ...} --extra-big-maps <big maps>: identifier and content of extra big maps, formatted as {Big_map <index> <key_type> <value_type> {Elt <key1> <value1>; Elt <key2> <value2>; ...}}
-
normalize stack stack [--unparsing-mode <mode>] [--legacy] [--other-contracts <contracts>] [--extra-big-maps <big maps>]Ask the node to normalize a typed Michelson stack. stack: a Michelson stack in the following format: {Stack_elt <ty_1> <val_1>; ...; Stack_elt <ty_n> <val_n>}, where each <val_i> is a Michelson value of type <ty_i>. The topmost element of the stack is <val_1>. --unparsing-mode <mode>: Unparsing mode to use One of "Readable", "Optimized", or "Optimized_legacy". This option affects the way the values of the following Michelson types are represented: - timestamp: the Readable representation is a RFC3339 string, the Optimized and Optimized_legacy representations are the number of seconds since Epoch - key, signature, key_hash, address, contract, chain_id: the Readable representation is a Base58Check string, the Optimized and Optimized_legacy representations are byte sequences - nested pairs: in Readable mode, the Pair constructor is used even with arity bigger than 2 such as in Pair 0 1 2; in Optimized_legacy mode, the Pair constructor is always use with arity 2 such as in Pair 0 (Pair 1 2); in Optimized mode, a sequence is used if there are at least 4 elements and the behavior is the same as in Optimized_legacy mode otherwise. Defaults to `Readable`. --legacy: typecheck in legacy mode as if the data was taken from the chain --other-contracts <contracts>: types and addresses of extra contracts, formatted as {Contract "KT1..." <ty1>; Contract "KT1..." <ty2>; ...} --extra-big-maps <big maps>: identifier and content of extra big maps, formatted as {Big_map <index> <key_type> <value_type> {Elt <key1> <value1>; Elt <key2> <value2>; ...}}
-
normalize type typAsk the node to normalize a type (remove annotations and flatten combs). typ: the Michelson type to normalize
-
sign bytes data for srcSign 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 bytes were 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
-
get script entrypoint type of entrypoint for src [--emacs] [-q --no-print-source]Ask the type of an entrypoint of a script. entrypoint: the entrypoint to describe 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. --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.
-
get script entrypoints for src [--emacs] [-q --no-print-source]Ask the node to list the entrypoints of 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. --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.
-
get script unreachable paths for src [--emacs] [-q --no-print-source]Ask the node to list the unreachable paths in a script's parameter type. 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. --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.
-
expand macros in srcAsk the node to expand the Michelson macros in 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.
-
run tzip4 view entrypoint on contract contract with input input [--source <source>] [--payer <src>] [-G --gas <gas>] [--unparsing-mode <mode>] [--now <timestamp>] [--level <level>] [--other-contracts <contracts>] [--extra-big-maps <big maps>]Ask the node to run a TZIP-4 view. entrypoint: the name of the view contract: viewed contract Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. input: the input data --source <source>: name of the source (i.e. SENDER) contract for the transaction Can be a literal, an alias, or a key (autodetected in order). Use 'text:<literal>', 'alias:<name>', 'key:<key>' to force. --payer <src>: name of the payer (i.e. SOURCE) contract for the transaction 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. -G --gas <gas>: Initial quantity of gas for typechecking and execution --unparsing-mode <mode>: Unparsing mode to use One of "Readable", "Optimized", or "Optimized_legacy". This option affects the way the values of the following Michelson types are represented: - timestamp: the Readable representation is a RFC3339 string, the Optimized and Optimized_legacy representations are the number of seconds since Epoch - key, signature, key_hash, address, contract, chain_id: the Readable representation is a Base58Check string, the Optimized and Optimized_legacy representations are byte sequences - nested pairs: in Readable mode, the Pair constructor is used even with arity bigger than 2 such as in Pair 0 1 2; in Optimized_legacy mode, the Pair constructor is always use with arity 2 such as in Pair 0 (Pair 1 2); in Optimized mode, a sequence is used if there are at least 4 elements and the behavior is the same as in Optimized_legacy mode otherwise. Defaults to `Readable`. --now <timestamp>: Set the timestamp to be returned by the NOW instruction. Allowed format are RFC 3339 (YYYY-MM-DDTHH:MM:SSZ) or number of seconds since epoch. --level <level>: Set the level to be returned by the LEVEL instruction --other-contracts <contracts>: types and addresses of extra contracts, formatted as {Contract "KT1..." <ty1>; Contract "KT1..." <ty2>; ...} --extra-big-maps <big maps>: identifier and content of extra big maps, formatted as {Big_map <index> <key_type> <value_type> {Elt <key1> <value1>; Elt <key2> <value2>; ...}}
-
run view view on contract contract [--source <source>] [--payer <src>] [-G --gas <gas>] [--unlimited-gas] [--unparsing-mode <mode>] [--now <timestamp>] [--level <level>] [--other-contracts <contracts>] [--extra-big-maps <big maps>]Ask the node to run a Michelson view with Unit as input. view: the name of the view contract: the contract containing the view Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. --source <source>: name of the source (i.e. SENDER) contract for the transaction Can be a literal, an alias, or a key (autodetected in order). Use 'text:<literal>', 'alias:<name>', 'key:<key>' to force. --payer <src>: name of the payer (i.e. SOURCE) contract for the transaction 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. -G --gas <gas>: Initial quantity of gas for typechecking and execution --unlimited-gas: Allows interpretation with virtually unlimited gas --unparsing-mode <mode>: Unparsing mode to use One of "Readable", "Optimized", or "Optimized_legacy". This option affects the way the values of the following Michelson types are represented: - timestamp: the Readable representation is a RFC3339 string, the Optimized and Optimized_legacy representations are the number of seconds since Epoch - key, signature, key_hash, address, contract, chain_id: the Readable representation is a Base58Check string, the Optimized and Optimized_legacy representations are byte sequences - nested pairs: in Readable mode, the Pair constructor is used even with arity bigger than 2 such as in Pair 0 1 2; in Optimized_legacy mode, the Pair constructor is always use with arity 2 such as in Pair 0 (Pair 1 2); in Optimized mode, a sequence is used if there are at least 4 elements and the behavior is the same as in Optimized_legacy mode otherwise. Defaults to `Readable`. --now <timestamp>: Set the timestamp to be returned by the NOW instruction. Allowed format are RFC 3339 (YYYY-MM-DDTHH:MM:SSZ) or number of seconds since epoch. --level <level>: Set the level to be returned by the LEVEL instruction --other-contracts <contracts>: types and addresses of extra contracts, formatted as {Contract "KT1..." <ty1>; Contract "KT1..." <ty2>; ...} --extra-big-maps <big maps>: identifier and content of extra big maps, formatted as {Big_map <index> <key_type> <value_type> {Elt <key1> <value1>; Elt <key2> <value2>; ...}}
-
run view view on contract contract with input input [--source <source>] [--payer <src>] [-G --gas <gas>] [--unlimited-gas] [--unparsing-mode <mode>] [--now <timestamp>] [--level <level>] [--other-contracts <contracts>] [--extra-big-maps <big maps>]Ask the node to run a Michelson view. view: the name of the view contract: the contract containing the view Can be a literal or an alias (autodetected in order). Use 'text:<literal>' or 'alias:<name>' to force. input: the argument provided to the view --source <source>: name of the source (i.e. SENDER) contract for the transaction Can be a literal, an alias, or a key (autodetected in order). Use 'text:<literal>', 'alias:<name>', 'key:<key>' to force. --payer <src>: name of the payer (i.e. SOURCE) contract for the transaction 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. -G --gas <gas>: Initial quantity of gas for typechecking and execution --unlimited-gas: Allows interpretation with virtually unlimited gas --unparsing-mode <mode>: Unparsing mode to use One of "Readable", "Optimized", or "Optimized_legacy". This option affects the way the values of the following Michelson types are represented: - timestamp: the Readable representation is a RFC3339 string, the Optimized and Optimized_legacy representations are the number of seconds since Epoch - key, signature, key_hash, address, contract, chain_id: the Readable representation is a Base58Check string, the Optimized and Optimized_legacy representations are byte sequences - nested pairs: in Readable mode, the Pair constructor is used even with arity bigger than 2 such as in Pair 0 1 2; in Optimized_legacy mode, the Pair constructor is always use with arity 2 such as in Pair 0 (Pair 1 2); in Optimized mode, a sequence is used if there are at least 4 elements and the behavior is the same as in Optimized_legacy mode otherwise. Defaults to `Readable`. --now <timestamp>: Set the timestamp to be returned by the NOW instruction. Allowed format are RFC 3339 (YYYY-MM-DDTHH:MM:SSZ) or number of seconds since epoch. --level <level>: Set the level to be returned by the LEVEL instruction --other-contracts <contracts>: types and addresses of extra contracts, formatted as {Contract "KT1..." <ty1>; Contract "KT1..." <ty2>; ...} --extra-big-maps <big maps>: identifier and content of extra big maps, formatted as {Big_map <index> <key_type> <value_type> {Elt <key1> <value1>; Elt <key2> <value2>; ...}}
Tenderbake client commands
-
bench nb_draw baking PoW challenges [--threshold <int>] [--seed <int>]Benchmark the proof of work challenge resolution nb_draw: number of draws --threshold <int>: Proof of work threshold Defaults to `281474976710655`. --seed <int>: Random seed
-
bake for [baker...] [--minimal-fees <amount>] [--minimal-nanotez-per-gas-unit <amount>] [--minimal-nanotez-per-byte <amount>] [--minimal-timestamp] [--force-apply-from-round <round>] [-f --force] [--operations-pool <file|uri>] [--context <path>] [--adaptive-issuance-vote <vote>] [--ignore-node-mempool] [--dal-node <uri>] [-n --count <block count>] [--record-state]Forge and inject block using the delegates' rights. baker: name of the delegate owning the attestation/baking right or name of the consensus key signing on the delegate's behalf 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. --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 nanotez) Defaults to `1000`. --minimal-timestamp: Use the minimal timestamp instead of the current date as timestamp of the baked block. --force-apply-from-round <round>: Force the baker to not only validate but also apply operations starting from the specified round. -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. --operations-pool <file|uri>: When specified, the baker will try to fetch operations from this file (or uri) and to include retrieved operations in the block. The expected format of the contents is a list of operations [ alpha.operation ]. Environment variable 'TEZOS_CLIENT_REMOTE_OPERATIONS_POOL_HTTP_HEADERS' may also be specified to add headers to the requests (only 'host' headers are supported). If the resource cannot be retrieved, e.g., if the file is absent, unreadable, or the web service returns a 404 error, the resource is simply ignored. --context <path>: When specified, 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. --adaptive-issuance-vote <vote>: Vote to adopt or not the adaptive issuance feature. The possible values for this option are: "off" to request not activating it, "on" to request activating it, and "pass" to abstain. If you do not vote, default value is "pass". --ignore-node-mempool: Ignore mempool operations from the node and do not subsequently monitor them. Use in conjunction with --operations option to restrict the observed operations to those of the mempool file. --dal-node <uri>: endpoint of the DAL node, e.g. 'http://localhost:8933' -n --count <block count>: number of blocks to bake Defaults to `1`. --record-state: If record-state flag is set, the baker saves all its internal consensus state in the filesystem, otherwise just in memory.
-
attest for [baker...] [-f --force]Forge and inject an attestation operation. baker: name of the delegate owning the attestation/baking right or name of the consensus key signing on the delegate's behalf 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: Disable consistency, injection and double signature checks for (pre)attestations.
-
preattest for [baker...] [-f --force]Forge and inject a preattestation operation. baker: name of the delegate owning the attestation/baking right or name of the consensus key signing on the delegate's behalf 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: Disable consistency, injection and double signature checks for (pre)attestations.
-
propose for [baker...] [--minimal-fees <amount>] [--minimal-nanotez-per-gas-unit <amount>] [--minimal-nanotez-per-byte <amount>] [--minimal-timestamp] [--force-apply-from-round <round>] [-f --force] [--operations-pool <file|uri>] [--context <path>] [--record-state]Send a Tenderbake proposal baker: name of the delegate owning the attestation/baking right or name of the consensus key signing on the delegate's behalf 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. --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 nanotez) Defaults to `1000`. --minimal-timestamp: Use the minimal timestamp instead of the current date as timestamp of the baked block. --force-apply-from-round <round>: Force the baker to not only validate but also apply operations starting from the specified round. -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. --operations-pool <file|uri>: When specified, the baker will try to fetch operations from this file (or uri) and to include retrieved operations in the block. The expected format of the contents is a list of operations [ alpha.operation ]. Environment variable 'TEZOS_CLIENT_REMOTE_OPERATIONS_POOL_HTTP_HEADERS' may also be specified to add headers to the requests (only 'host' headers are supported). If the resource cannot be retrieved, e.g., if the file is absent, unreadable, or the web service returns a 404 error, the resource is simply ignored. --context <path>: When specified, 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. --record-state: If record-state flag is set, the baker saves all its internal consensus state in the filesystem, otherwise just in memory.
Commands for managing the record of known smart rollup
-
remember smart rollup new src [-f --force]Add a smart rollup to the wallet. new: new smart rollup alias src: source smart rollup Can be a smart rollup name, a file or a raw smart rollup literal. If the parameter is not the name of an existing smart rollup, the client will look for a file containing a smart rollup, and if it does not exist, the argument will be read as a raw smart rollup. Use 'alias:<name>', 'file:<path>' or 'text:<literal>' to disable autodetect. -f --force: overwrite existing smart rollup
-
forget smart rollup nameRemove a smart rollup from the wallet. name: existing smart rollup alias
-
list known smart rollupsLists all known smart rollup in the wallet.
-
forget all smart rollups [-f --force]Forget the entire wallet of known smart rollups. -f --force: overwrite existing smart rollup
-
show known smart rollup nameDisplay a smart rollup from the wallet. name: existing smart rollup alias
Commands querying proxy and light mode support
-
list proxy protocolsList protocols supported by proxy mode
-
list light protocolsList protocols supported by light mode
Commands for creating mockup environments
-
list mockup protocolsList available protocols available for mockup construction.
-
migrate mockup to hashMigrates an on-disk mockup context from a protocol to another. hash: Protocol hash of the next protocol
-
create mockup [--protocol-constants <path>] [--bootstrap-accounts <path>] [--asynchronous]Create a mockup environment. --protocol-constants <path>: a JSON file that contains protocol constants to set. --bootstrap-accounts <path>: a JSON file that contains definitions of bootstrap accounts to create. --asynchronous: put operations in mempool and require baking to include in the chain
Commands for managing the wallet of cryptographic keys
-
stresstest gen keys keys_count [--alias-prefix <PREFIX>]Generate an array of accounts for testing purposes. keys_count: How many keys to generate --alias-prefix <PREFIX>: use a custom alias prefix (default: bootstrap). Keys will be generated with alias "PREFIX<ID>" where ID is unique for all key
-
list signing schemesList 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|bls>] [--encrypted]Generate a pair of keys. new: new secret_key alias -f --force: overwrite existing secret_key -s --sig <ed25519|secp256k1|p256|bls>: use custom signature algorithm Defaults to `ed25519`. --encrypted: Encrypt the key on-disk
-
gen vanity keys new matching [words...] [-P --prefix] [-I --ignore-case] [-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] -I --ignore-case: make the pattern case-insensitive -f --force: overwrite existing keys --encrypted: Encrypt the key on-disk
-
encrypt secret keyEncrypt 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 addressesList 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
-
generate nonce for name from dataCompute deterministic nonce. name: existing public key hash alias data: string from which to deterministically generate the nonce
-
generate nonce hash for name from dataCompute deterministic nonce hash. name: existing public key hash alias data: string from which to deterministically generate the nonce hash
-
import keys from mnemonic new [-f --force] [--encrypt]Import a pair of keys to the wallet from a mnemonic phrase. This command uses the BIP39 algorithm, and therefore imports public/secret keys that may be different from a Ledger application, depending on the BIP32 derivation path used in the Ledger. This command also uses the Ed25519 algorithm, which means it generates tz1 public key hashes. new: new secret_key alias -f --force: overwrite existing secret_key --encrypt: encrypt the secret key
Commands for managing the connected Ledger Nano devices
-
list connected ledgersList supported Ledger Nano devices connected.
-
show ledger account-alias-or-ledger-uri [--test-sign]Display version/public-key/address information for a Ledger URI account-alias-or-ledger-uri: An imported ledger alias or a ledger URI (e.g. "ledger://animal/curve/path"). --test-sign: Test signing operation
-
get ledger authorized path for account-alias-or-ledger-uriQuery the path of the authorized key account-alias-or-ledger-uri: An imported ledger alias or a ledger URI (e.g. "ledger://animal/curve/path").
-
authorize ledger to bake for account-alias-or-ledger-uriAuthorize a Ledger to bake for a key (deprecated, use `setup ledger ...` with recent versions of the Baking app) account-alias-or-ledger-uri: An imported ledger alias or a ledger URI (e.g. "ledger://animal/curve/path").
-
setup ledger to bake for account-alias-or-ledger-uri [--main-chain-id <ID>] [--main-hwm <HWM>] [--test-hwm <HWM>]Setup a Ledger to bake for a key account-alias-or-ledger-uri: An imported ledger alias or a ledger URI (e.g. "ledger://animal/curve/path"). --main-chain-id <ID>: Use <ID> as main chain-id instead of asking the node. Defaults to `ASK-NODE`. --main-hwm <HWM>: Use <HWM> as main chain high watermark instead of asking the ledger. Defaults to `ASK-LEDGER`. --test-hwm <HWM>: Use <HWM> as test chain high watermark instead of asking the ledger. Defaults to `ASK-LEDGER`.
-
deauthorize ledger baking for account-alias-or-ledger-uriDeauthorize Ledger from baking account-alias-or-ledger-uri: An imported ledger alias or a ledger URI (e.g. "ledger://animal/curve/path").
-
get ledger high water mark for account-alias-or-ledger-uri [--no-legacy-instructions]Get high water mark of a Ledger account-alias-or-ledger-uri: An imported ledger alias or a ledger URI (e.g. "ledger://animal/curve/path"). --no-legacy-instructions: Prevent the fallback to the (deprecated) Ledger instructions (for 1.x.y versions of the Baking app)
-
set ledger high water mark for account-alias-or-ledger-uri to high watermarkSet high water mark of a Ledger account-alias-or-ledger-uri: An imported ledger alias or a ledger URI (e.g. "ledger://animal/curve/path"). high watermark: High watermark
-
get ledger high watermark for account-alias-or-ledger-uri [--no-legacy-instructions]Get high water mark of a Ledger (legacy/deprecated spelling) account-alias-or-ledger-uri: An imported ledger alias or a ledger URI (e.g. "ledger://animal/curve/path"). --no-legacy-instructions: Prevent the fallback to the (deprecated) Ledger instructions (for 1.x.y versions of the Baking app)
-
set ledger high watermark for account-alias-or-ledger-uri to high watermarkSet high water mark of a Ledger (legacy/deprecated spelling) account-alias-or-ledger-uri: An imported ledger alias or a ledger URI (e.g. "ledger://animal/curve/path"). high watermark: High watermark
Commands for the low level RPC layer
-
rpc list urlList 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 listAlias to `rpc list /`.
-
rpc schema HTTP method urlGet 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 urlCall an RPC with the GET method. url: the RPC URL
-
rpc post urlCall an RPC with the POST method. It invokes $EDITOR if input data is needed. url: the RPC URL
-
rpc post url with inputCall 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.
-
rpc patch urlCall an RPC with the PATCH method. It invokes $EDITOR if input data is needed. url: the RPC URL
-
rpc patch url with inputCall an RPC with the PATCH 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.
-
rpc put urlCall an RPC with the PUT method. It invokes $EDITOR if input data is needed. url: the RPC URL
-
rpc put url with inputCall an RPC with the PUT 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.
-
rpc delete urlCall an RPC with the DELETE method. url: the RPC URL
Commands for editing and viewing the client's config file
-
config showShow the current config (config file content + command line arguments) or the mockup config files if `--mode mockup` is specified.
-
config resetReset the config file to the factory defaults.
-
config updateUpdate 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>] [--bootstrap-accounts <path>] [--protocol-constants <path>]Create config file(s) 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. If `-mode mockup` is specified, this will initialize the mockup's default files instead of the config file. Use `-bootstrap-accounts` and `-protocol-constants` to specify custom paths. The command will always fail if file(s) to create exist already -o --output <path>: path at which to create the file Defaults to `$HOME/.tezos-client/config`. --bootstrap-accounts <path>: path at which to create the file Defaults to `$HOME/.tezos-client/bootstrap-accounts.json`. --protocol-constants <path>: path at which to create the file Defaults to `$HOME/.tezos-client/protocol-constants.json`.
Miscellaneous commands
-
list understood protocolsList 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.
-
bootstrappedWait for the node to be bootstrapped.
-
compute chain id from block hash hashComputes the chain id corresponding to a block hash. hash: the block hash from which to compute the chain id
-
compute chain id from seed stringComputes a chain id from a seed string: the seed from which to compute the chain id
-
convert script source from input_format to output_format [-z --zero-loc] [--legacy] [--enforce-indentation]Conversion of Michelson script from Micheline, JSON or binary to Micheline, JSON, binary or OCaml source: literal or a path to a file input_format: format of the input for conversion output_format: format of the conversion output -z --zero-loc: replace location with "0" --legacy: typecheck in legacy mode as if the data was taken from the chain --enforce-indentation: Check that the Micheline expression passed to this command is well-indented.
-
convert data source from input_format to output_format [-z --zero-loc] [-t --type <unit>]Conversion of Micheline expression from Micheline, JSON or binary to Micheline, JSON, binary or OCaml source: literal or a path to a file input_format: format of the input for conversion output_format: format of the conversion output -z --zero-loc: replace location with "0" -t --type <unit>: the given data will be type-checked against this type
-
wait for operation to be included [--confirmations <num_blocks>] [--check-previous <num_blocks>] [--branch <block_hash>]Wait until an operation is included in a block operation: Operation to be included --confirmations <num_blocks>: wait until 'N' additional blocks after the operation appears in the considered chain Defaults to `0`. --check-previous <num_blocks>: number of previous blocks to check Defaults to `10`. --branch <block_hash>: hash of the oldest block where we should look for the operation
-
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`.
Baker manual#
Usage
-
octez-baker-alpha [global options] command [command options]
-
octez-baker-alpha --help (for global options)
-
octez-baker-alpha [global options] command --help (for command options)
-
octez-baker-alpha --version (for version information)
To browse the documentation
-
octez-baker-alpha [global options] man (for a list of commands)
-
octez-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 (absent: TEZOS_CLIENT_DIR env)
The directory where the Tezos client will store all its data.
If absent, its value is the value of the TEZOS_CLIENT_DIR
environment variable. If TEZOS_CLIENT_DIR is itself not specified,
defaults to $HOME/.tezos-client
-n --no-base-dir-warnings: silence warnings about client data directory
-c --config-file <path>: configuration file
-t --timings: show RPC request times
--chain <hash|tag>: chain on which to apply contextual commands (commands dependent on the context associated with the specified chain). Possible tags are 'main' and 'test'.
Defaults to `main`.
-b --block <hash|level|tag>: block on which to apply contextual commands (commands dependent on the context associated with the specified block). Possible tags include 'head' and 'genesis' +/- an optional offset (e.g. "octez-client -b head-1 get timestamp"). Note that block queried must exist in node's storage.
Defaults to `head`.
-w --wait <none|<int>>: how many confirmation blocks are needed before an operation is considered included
-p --protocol <hash>: use commands of a specific protocol
-l --log-requests: log all requests to the node
--better-errors: Error reporting is more detailed. Can be used if a call to an RPC fails or if you don't know the input accepted by the RPC. It may happen that the RPC calls take more time however.
-A --addr <IP addr|host>: [DEPRECATED: use --endpoint instead] IP address of the node
-P --port <number>: [DEPRECATED: use --endpoint instead] RPC port of the node
-S --tls: [DEPRECATED: use --endpoint instead] use TLS to connect to node.
-m --media-type <json, binary, any or default>: Sets the "media-type" value for the "accept" header for RPC requests to the node. The media accept header indicates to the node which format of data serialisation is supported. Use the value "json" for serialisation to the JSON format.
Use the value "binary" for faster but less human-readable binary
serialisation format.
-E --endpoint <uri>: HTTP(S) endpoint of the node RPC interface; e.g. 'http://localhost:8732'
-s --sources <path>: path to JSON file containing sources for --mode light. Example file content: {"min_agreement": 1.0, "uris": ["http://localhost:8732", "https://localhost:8733"]}
-R --remote-signer <uri>: URI of the remote signer
-f --password-filename <filename>: path to the password filename
-M --mode <client|light|mockup|proxy>: how to interact with the node
Defaults to `client`.
--log-coloring <true|false>: Enable or disable light coloring in default stdout logs. Coloring is enabled by default.
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 node_data_path [baker...] [-P --pidfile <filename>] [--node-version-check-bypass] [--node-version-allowed <<product>-[v]<major>.<minor>[.0]<info>[:<commit>]>] [--minimal-fees <amount>] [--minimal-nanotez-per-gas-unit <amount>] [--minimal-nanotez-per-byte <amount>] [--force-apply-from-round <round>] [-K --keep-alive] [--liquidity-baking-toggle-vote <vote>] [--adaptive-issuance-vote <vote>] [-V --votefile <filename>] [--operations-pool <file|uri>] [--dal-node <uri>] [--record-state] [--pre-emptive-forge-time <seconds>] [--remote-calls-timeout <seconds>]Launch the baker daemon. node_data_path: Path to the node data directory (e.g. $HOME/.tezos-node) baker: name of the delegate owning the attestation/baking right or name of the consensus key signing on the delegate's behalf 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. -P --pidfile <filename>: write process id in file --node-version-check-bypass: If node-version-check-bypass flag is set, the baker will not check its compatibility with the version of the node to which it is connected. --node-version-allowed <<product>-[v]<major>.<minor>[.0]<info>[:<commit>]>: When specified the baker will accept to run with a node of this version. The specified version is composed of the product, for example 'octez'; the major and the minor versions that are positive integers; the info, for example '-rc', '-beta1+dev' or realese if none is provided; optionally the commit that is the hash of the last git commit or a prefix of at least 8 characters long. --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 nanotez) Defaults to `1000`. --force-apply-from-round <round>: Force the baker to not only validate but also apply operations starting from the specified round. -K --keep-alive: Keep the daemon process alive: when the connection with the node is lost, the daemon periodically tries to reach it. --liquidity-baking-toggle-vote <vote>: Vote to continue or end the liquidity baking subsidy. The possible values for this option are: "off" to request ending the subsidy, "on" to request continuing or restarting the subsidy, and "pass" to abstain. Note that this "option" is mandatory! --adaptive-issuance-vote <vote>: Vote to adopt or not the adaptive issuance feature. The possible values for this option are: "off" to request not activating it, "on" to request activating it, and "pass" to abstain. If you do not vote, default value is "pass". -V --votefile <filename>: read per block votes as json file --operations-pool <file|uri>: When specified, the baker will try to fetch operations from this file (or uri) and to include retrieved operations in the block. The expected format of the contents is a list of operations [ alpha.operation ]. Environment variable 'TEZOS_CLIENT_REMOTE_OPERATIONS_POOL_HTTP_HEADERS' may also be specified to add headers to the requests (only 'host' headers are supported). If the resource cannot be retrieved, e.g., if the file is absent, unreadable, or the web service returns a 404 error, the resource is simply ignored. --dal-node <uri>: endpoint of the DAL node, e.g. 'http://localhost:8933' --record-state: If record-state flag is set, the baker saves all its internal consensus state in the filesystem, otherwise just in memory. --pre-emptive-forge-time <seconds>: Sets the pre-emptive forge time optimization, in seconds. When set, the baker, if it is the next level round 0 proposer, will start forging after quorum has been reached in the current level while idly waiting for it to end. When it is its time to propose, the baker will inject the pre-emptively forged block immediately, allowing more time for the network to reach quorum on it. Operators should note that the higher this value `t`, the lower the operation inclusion window (specifically `block_time - t`) which may lead to lower baking rewards. Defaults to 15/% of block time. Set to 0 to ignore pre-emptive forging. --remote-calls-timeout <seconds>: Sets a timeout for client calls such as signing block header or attestation and for the creation of deterministic nonce. Use only if your remote signer can handle concurrent requests.
-
run remotely [baker...] [-P --pidfile <filename>] [--node-version-check-bypass] [--node-version-allowed <<product>-[v]<major>.<minor>[.0]<info>[:<commit>]>] [--minimal-fees <amount>] [--minimal-nanotez-per-gas-unit <amount>] [--minimal-nanotez-per-byte <amount>] [--force-apply-from-round <round>] [-K --keep-alive] [--liquidity-baking-toggle-vote <vote>] [--adaptive-issuance-vote <vote>] [-V --votefile <filename>] [--operations-pool <file|uri>] [--dal-node <uri>] [--record-state] [--pre-emptive-forge-time <seconds>] [--remote-calls-timeout <seconds>]Launch the baker daemon using RPCs only. baker: name of the delegate owning the attestation/baking right or name of the consensus key signing on the delegate's behalf 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. -P --pidfile <filename>: write process id in file --node-version-check-bypass: If node-version-check-bypass flag is set, the baker will not check its compatibility with the version of the node to which it is connected. --node-version-allowed <<product>-[v]<major>.<minor>[.0]<info>[:<commit>]>: When specified the baker will accept to run with a node of this version. The specified version is composed of the product, for example 'octez'; the major and the minor versions that are positive integers; the info, for example '-rc', '-beta1+dev' or realese if none is provided; optionally the commit that is the hash of the last git commit or a prefix of at least 8 characters long. --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 nanotez) Defaults to `1000`. --force-apply-from-round <round>: Force the baker to not only validate but also apply operations starting from the specified round. -K --keep-alive: Keep the daemon process alive: when the connection with the node is lost, the daemon periodically tries to reach it. --liquidity-baking-toggle-vote <vote>: Vote to continue or end the liquidity baking subsidy. The possible values for this option are: "off" to request ending the subsidy, "on" to request continuing or restarting the subsidy, and "pass" to abstain. Note that this "option" is mandatory! --adaptive-issuance-vote <vote>: Vote to adopt or not the adaptive issuance feature. The possible values for this option are: "off" to request not activating it, "on" to request activating it, and "pass" to abstain. If you do not vote, default value is "pass". -V --votefile <filename>: read per block votes as json file --operations-pool <file|uri>: When specified, the baker will try to fetch operations from this file (or uri) and to include retrieved operations in the block. The expected format of the contents is a list of operations [ alpha.operation ]. Environment variable 'TEZOS_CLIENT_REMOTE_OPERATIONS_POOL_HTTP_HEADERS' may also be specified to add headers to the requests (only 'host' headers are supported). If the resource cannot be retrieved, e.g., if the file is absent, unreadable, or the web service returns a 404 error, the resource is simply ignored. --dal-node <uri>: endpoint of the DAL node, e.g. 'http://localhost:8933' --record-state: If record-state flag is set, the baker saves all its internal consensus state in the filesystem, otherwise just in memory. --pre-emptive-forge-time <seconds>: Sets the pre-emptive forge time optimization, in seconds. When set, the baker, if it is the next level round 0 proposer, will start forging after quorum has been reached in the current level while idly waiting for it to end. When it is its time to propose, the baker will inject the pre-emptively forged block immediately, allowing more time for the network to reach quorum on it. Operators should note that the higher this value `t`, the lower the operation inclusion window (specifically `block_time - t`) which may lead to lower baking rewards. Defaults to 15/% of block time. Set to 0 to ignore pre-emptive forging. --remote-calls-timeout <seconds>: Sets a timeout for client calls such as signing block header or attestation and for the creation of deterministic nonce. Use only if your remote signer can handle concurrent requests.
-
run vdf [-P --pidfile <filename>] [-K --keep-alive]Launch the VDF daemon -P --pidfile <filename>: write process id in file -K --keep-alive: Keep the daemon process alive: when the connection with the node is lost, the daemon periodically tries to reach it.
Commands for editing and viewing the client's config file
-
config showShow the current config (config file content + command line arguments) or the mockup config files if `--mode mockup` is specified.
-
config resetReset the config file to the factory defaults.
-
config updateUpdate 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>] [--bootstrap-accounts <path>] [--protocol-constants <path>]Create config file(s) 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. If `-mode mockup` is specified, this will initialize the mockup's default files instead of the config file. Use `-bootstrap-accounts` and `-protocol-constants` to specify custom paths. The command will always fail if file(s) to create exist already -o --output <path>: path at which to create the file Defaults to `$HOME/.tezos-client/config`. --bootstrap-accounts <path>: path at which to create the file Defaults to `$HOME/.tezos-client/bootstrap-accounts.json`. --protocol-constants <path>: path at which to create the file Defaults to `$HOME/.tezos-client/protocol-constants.json`.
Miscellaneous commands
-
list understood protocolsList the protocol versions that this client understands.
Accuser manual#
Usage
-
octez-accuser-alpha [global options] command [command options]
-
octez-accuser-alpha --help (for global options)
-
octez-accuser-alpha [global options] command --help (for command options)
-
octez-accuser-alpha --version (for version information)
To browse the documentation
-
octez-accuser-alpha [global options] man (for a list of commands)
-
octez-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 (absent: TEZOS_CLIENT_DIR env)
The directory where the Tezos client will store all its data.
If absent, its value is the value of the TEZOS_CLIENT_DIR
environment variable. If TEZOS_CLIENT_DIR is itself not specified,
defaults to $HOME/.tezos-client
-n --no-base-dir-warnings: silence warnings about client data directory
-c --config-file <path>: configuration file
-t --timings: show RPC request times
--chain <hash|tag>: chain on which to apply contextual commands (commands dependent on the context associated with the specified chain). Possible tags are 'main' and 'test'.
Defaults to `main`.
-b --block <hash|level|tag>: block on which to apply contextual commands (commands dependent on the context associated with the specified block). Possible tags include 'head' and 'genesis' +/- an optional offset (e.g. "octez-client -b head-1 get timestamp"). Note that block queried must exist in node's storage.
Defaults to `head`.
-w --wait <none|<int>>: how many confirmation blocks are needed before an operation is considered included
-p --protocol <hash>: use commands of a specific protocol
-l --log-requests: log all requests to the node
--better-errors: Error reporting is more detailed. Can be used if a call to an RPC fails or if you don't know the input accepted by the RPC. It may happen that the RPC calls take more time however.
-A --addr <IP addr|host>: [DEPRECATED: use --endpoint instead] IP address of the node
-P --port <number>: [DEPRECATED: use --endpoint instead] RPC port of the node
-S --tls: [DEPRECATED: use --endpoint instead] use TLS to connect to node.
-m --media-type <json, binary, any or default>: Sets the "media-type" value for the "accept" header for RPC requests to the node. The media accept header indicates to the node which format of data serialisation is supported. Use the value "json" for serialisation to the JSON format.
Use the value "binary" for faster but less human-readable binary
serialisation format.
-E --endpoint <uri>: HTTP(S) endpoint of the node RPC interface; e.g. 'http://localhost:8732'
-s --sources <path>: path to JSON file containing sources for --mode light. Example file content: {"min_agreement": 1.0, "uris": ["http://localhost:8732", "https://localhost:8733"]}
-R --remote-signer <uri>: URI of the remote signer
-f --password-filename <filename>: path to the password filename
-M --mode <client|light|mockup|proxy>: how to interact with the node
Defaults to `client`.
--log-coloring <true|false>: Enable or disable light coloring in default stdout logs. Coloring is enabled by default.
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 [-P --pidfile <filename>] [--preserved-levels <threshold>] [-K --keep-alive]Launch the accuser daemon -P --pidfile <filename>: write process id in file --preserved-levels <threshold>: Number of effective levels kept in the accuser's memory Defaults to `200`. -K --keep-alive: Keep the daemon process alive: when the connection with the node is lost, the daemon periodically tries to reach it.
Commands for editing and viewing the client's config file
-
config showShow the current config (config file content + command line arguments) or the mockup config files if `--mode mockup` is specified.
-
config resetReset the config file to the factory defaults.
-
config updateUpdate 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>] [--bootstrap-accounts <path>] [--protocol-constants <path>]Create config file(s) 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. If `-mode mockup` is specified, this will initialize the mockup's default files instead of the config file. Use `-bootstrap-accounts` and `-protocol-constants` to specify custom paths. The command will always fail if file(s) to create exist already -o --output <path>: path at which to create the file Defaults to `$HOME/.tezos-client/config`. --bootstrap-accounts <path>: path at which to create the file Defaults to `$HOME/.tezos-client/bootstrap-accounts.json`. --protocol-constants <path>: path at which to create the file Defaults to `$HOME/.tezos-client/protocol-constants.json`.
Miscellaneous commands
-
list understood protocolsList the protocol versions that this client understands.