Programmatic CLI

Programmatic CLI

Pass arguments directly to the CLI as single-line terminal commands.

You can interact with Entropy quickly by giving single-line commands to the entropy executable.

Usage: entropy [options] [command]

CLI interface for interacting with entropy.xyz.

Options:
  -v, --version                              Displays the current running version of Entropy CLI.
  -cv, --core-version                        Displays the current running version of the Entropy Protocol
  -h, --help                                 display help for command

Commands:
  tui [options]                              Text-based User Interface (interactive)
  account                                    Commands to work with accounts on the Entropy Network
  sign [options] <msg>                       Sign a message using the Entropy network. Output is a JSON { verifyingKey, signature }
  balance [options] <account>                Command to retrieive the balance of an account on the Entropy Network
  transfer [options] <destination> <amount>  Transfer funds between two Entropy accounts.
  program                                    Commands for working with programs deployed to the Entropy Network

tui

Usage: entropy tui [options]

Text-based User Interface (interactive)

Options:
  -a, --account <name|address>  Sets the account for the session. Defaults to the last set account (or the first account if one has not been set before). (default: "", env: ENTROPY_ACCOUNT)
  -e, --endpoint <url>          Runs entropy with the given endpoint and ignores network endpoints in config. Can also be given a stored endpoint name from config eg: `entropy --endpoint test-net`. (default: "wss://testnet.entropy.xyz/", env: ENTROPY_ENDPOINT)
  -h, --help                    display help for command

account

Usage: entropy account [options] [command]

Commands to work with accounts on the Entropy Network

Options:
  -h, --help                      display help for command

Commands:
  create|new [options] <name>     Create a new entropy account from scratch. Output is JSON of form {name, address}
  import [options] <name> <seed>  Import an existing entropy account from seed. Output is JSON of form {name, address}
  list|ls                         List all accounts. Output is JSON of form [{ name, address, verifyingKeys }]
  register [options]              Register an entropy account with a program
  help [command]                  display help for command

create

Usage: entropy account create|new [options] <name>

Create a new entropy account from scratch. Output is JSON of form {name, address}

Arguments:
  name        A user friendly name for your new account.

Options:
  --path      Derivation path
  -h, --help  display help for command

import

Usage: entropy account import [options] <name> <seed>

Import an existing entropy account from seed. Output is JSON of form {name, address}

Arguments:
  name        A user friendly name for your new account.
  seed        The seed for the account you are importing

Options:
  --path      Derivation path
  -h, --help  display help for command

list

Usage: entropy account list|ls [options]

List all accounts. Output is JSON of form [{ name, address, verifyingKeys }]

Options:
  -h, --help  display help for command

register

Usage: entropy account register [options]

Register an entropy account with a program

Options:
  -a, --account <name|address>  Sets the account for the session. Defaults to the last set account (or the first account if one has not been set before). (default: "", env: ENTROPY_ACCOUNT)
  -e, --endpoint <url>          Runs entropy with the given endpoint and ignores network endpoints in config. Can also be given a stored endpoint name from config eg: `entropy --endpoint test-net`. (default: "wss://testnet.entropy.xyz/", env: ENTROPY_ENDPOINT)
  -h, --help                    display help for command

sign

Usage: entropy sign [options] <msg>

Sign a message using the Entropy network. Output is a JSON { verifyingKey, signature }

Arguments:
  msg                           Message you would like to sign (string)

Options:
  -a, --account <name|address>  Sets the account for the session. Defaults to the last set account (or the first account if one has not been set before). (default: "", env: ENTROPY_ACCOUNT)
  -e, --endpoint <url>          Runs entropy with the given endpoint and ignores network endpoints in config. Can also be given a stored endpoint name from config eg: `entropy --endpoint test-net`. (default: "wss://testnet.entropy.xyz/", env: ENTROPY_ENDPOINT)
  -h, --help                    display help for command

balance

Usage: entropy balance [options] <account>

Command to retrieive the balance of an account on the Entropy Network

Arguments:
  account               The address an account address whose balance you want to query. Can also be the human-readable name of one of your accounts

Options:
  -e, --endpoint <url>  Runs entropy with the given endpoint and ignores network endpoints in config. Can also be given a stored endpoint name from config eg: `entropy --endpoint test-net`. (default: "wss://testnet.entropy.xyz/", env: ENTROPY_ENDPOINT)
  -h, --help            display help for command

transfer

Usage: entropy transfer [options] <destination> <amount>

Transfer funds between two Entropy accounts.

Arguments:
  destination                   Account address funds will be sent to
  amount                        Amount of funds to be moved (in "tokens")

Options:
  -a, --account <name|address>  Sets the account for the session. Defaults to the last set account (or the first account if one has not been set before). (default: "", env: ENTROPY_ACCOUNT)
  -e, --endpoint <url>          Runs entropy with the given endpoint and ignores network endpoints in config. Can also be given a stored endpoint name from config eg: `entropy --endpoint test-net`. (default: "wss://testnet.entropy.xyz/", env: ENTROPY_ENDPOINT)
  -h, --help                    display help for command

program

Usage: entropy program [options] [command]

Commands for working with programs deployed to the Entropy Network

Options:
  -h, --help                                                               display help for command

Commands:
  deploy [options] <bytecode> <configurationSchema> <auxillaryDataSchema>  Deploys a program to the Entropy network, returning a program pointer. Requires funds.
  get [options] <programPointer>                                           Get a program interface by it's pointer.
  listDeployed [options]                                                   Get a list of all programs the current account has deployed
  add [options] <programPointer> [programConfigPath]                       Add a program to the current account
  remove|rm [options] <programPointer>                                     Remove a program from an account (specified by a verifyingKey)
  list|ls [options] <verifyingKey>                                         List all the programs (an associated config) added to a particular verifyingKey.
  help [command]                                                           display help for command

deploy

Usage: entropy program deploy [options] <bytecode> <configurationSchema> <auxillaryDataSchema>

Deploys a program to the Entropy network, returning a program pointer. Requires
funds.

Arguments:
  bytecode                      The path to your program bytecode. Must be a .wasm file.
  configurationSchema           The path to the JSON Schema for validating configurations passed in by users installing this program. Must be a .json file.
  auxillaryDataSchema           The path to the JSON Schema for validating auxillary data passed to the program on calls to "sign". Must be a .json file.

Options:
  -a, --account <name|address>  Sets the account for the session. Defaults to the last set account (or the first account if one has not been set before). (default: "", env: ENTROPY_ACCOUNT)
  -e, --endpoint <url>          Runs entropy with the given endpoint and ignores network endpoints in config. Can also be given a stored endpoint name from config eg: `entropy --endpoint test-net`. (default: "wss://testnet.entropy.xyz/", env: ENTROPY_ENDPOINT)
  -h, --help                    display help for command

get

Usage: entropy program get [options] <programPointer>

Get a program interface by it's pointer.

Arguments:
  programPointer                The pointer for the program interface.

Options:
  -a, --account <name|address>  Sets the account for the session. Defaults to the last set account (or the first account if one has not been set before). (default: "", env: ENTROPY_ACCOUNT)
  -e, --endpoint <url>          Runs entropy with the given endpoint and ignores network endpoints in config. Can also be given a stored endpoint name from config eg: `entropy --endpoint test-net`. (default: "wss://testnet.entropy.xyz/", env: ENTROPY_ENDPOINT)
  -h, --help                    display help for command

listDeployed

Usage: entropy program listDeployed [options]

Get a list of all programs the current account has deployed

Options:
  -a, --account <name|address>  Sets the account for the session. Defaults to the last set account (or the first account if one has not been set before). (default: "", env: ENTROPY_ACCOUNT)
  -e, --endpoint <url>          Runs entropy with the given endpoint and ignores network endpoints in config. Can also be given a stored endpoint name from config eg: `entropy --endpoint test-net`. (default: "wss://testnet.entropy.xyz/", env: ENTROPY_ENDPOINT)
  -h, --help                    display help for command

add

Usage: entropy program add [options] <programPointer> [programConfigPath]

Add a program to the current account

Arguments:
  programPointer                The pointer for the program interface.
  programConfigPath             The path to the config to apply to the program.
                                Must be a .json file

Options:
  -a, --account <name|address>  Sets the account for the session. Defaults to the last set account (or the first account if one has not been set before). (default: "", env: ENTROPY_ACCOUNT)
  -e, --endpoint <url>          Runs entropy with the given endpoint and ignores network endpoints in config. Can also be given a stored endpoint name from config eg: `entropy --endpoint test-net`. (default: "wss://testnet.entropy.xyz/", env: ENTROPY_ENDPOINT)
  -k, --verifying-key <key>     The verifying key to perform this function
                                with.
  -h, --help                    display help for command

remove

Usage: entropy program remove|rm [options] <programPointer>

Remove a program from an account (specified by a verifyingKey)

Arguments:
  programPointer                The pointer for the program you want to remove.

Options:
  -a, --account <name|address>  Sets the account for the session. Defaults to the last set account (or the first account if one has not been set before). (default: "", env: ENTROPY_ACCOUNT)
  -e, --endpoint <url>          Runs entropy with the given endpoint and ignores network endpoints in config. Can also be given a stored endpoint name from config eg: `entropy --endpoint test-net`. (default: "wss://testnet.entropy.xyz/", env: ENTROPY_ENDPOINT)
  -k, --verifying-key <key>     The verifying key to perform this function
                                with.
  -p, --program-mod-key <key>   The programModKey to perform this function
                                with.
  -h, --help                    display help for command

list

Usage: entropy program list|ls [options] <verifyingKey>

List all the programs (an associated config) added to a particular
verifyingKey.

Arguments:
  verifyingKey                  The verifyingKey being queried.

Options:
  -a, --account <name|address>  Sets the account for the session. Defaults to the last set account (or the first account if one has not been set before). (default: "", env: ENTROPY_ACCOUNT)
  -e, --endpoint <url>          Runs entropy with the given endpoint and ignores network endpoints in config. Can also be given a stored endpoint name from config eg: `entropy --endpoint test-net`. (default: "wss://testnet.entropy.xyz/", env: ENTROPY_ENDPOINT)
  -h, --help                    display help for command