wash

waSCC Shell - A single CLI to handle all of your waSCC tooling needs

Installing wash

cargo install wash-cli

Using wash

wash <subcommand> [args]

Subcommands

claims

``` USAGE: wash claims inspect [FLAGS]

FLAGS: -h, --help Prints help information -r, --raw Extract the raw JWT from the file and print to stdout

ARGS: The WASM file to inspect ```

``` USAGE: wash claims sign [FLAGS] [OPTIONS]

--name

FLAGS: -f, --blobstore Enable access to the blob store capability -e, --events Enable access to an append-only event stream provider -z, --extras Enable access to the extras functionality (random nos, guids, etc) --help Prints help information -h, --httpclient Enable the HTTP client standard capability -s, --http_server Enable the HTTP server standard capability -k, --keyvalue Enable the Key/Value Store standard capability -l, --logging Enable access to logging capability -g, --msg Enable the Message broker standard capability -p, --prov Indicates whether the signed module is a capability provider instead of an actor (the default is actor)

OPTIONS: -c, --cap ... Add custom capabilities -x, --expires Indicates the token expires in the given amount of days. If this option is left off, the token will never expire -i, --issuer Issuer seed key path (usually a .nk file). If this option is left off, wash will attempt to locate an account key at $HOME/.wash/keys/<module>_account.nk, and if it is not found then an issuer key will be generated and placed in $HOME/.wash/keys/<module>_account.nk. You can also override this directory by setting the WASH_KEYS environment variable. -n, --name A human-readable, descriptive name for the token -b, --nbf Period in days that must elapse before this token is valid. If this option is left off, the token will be valid immediately -r, --rev Revision number -u, --subject Subject seed key path (usually a .nk file). If this option is left off, wash will attempt to locate a module key at $HOME/.wash/keys/<module>_module.nk, and if it is not found then a module key will be generated and placed in $HOME/.wash/keys/<module>_module.nk. You can also override this directory by setting the WASH_KEYS environment variable. -t, --tag ... A list of arbitrary tags to be embedded in the token -v, --ver Human-readable version string

ARGS: WASM to read

Target output file. Defaults to <module_location>/<module>_signed.wasm ```

``` USAGE: wash claims token

FLAGS: -h, --help Prints help information

SUBCOMMANDS: account Generate a signed JWT for an account actor Generate a signed JWT for an actor module operator Generate a signed JWT for an operator ```

keys

``` USAGE: wash keys gen

FLAGS: -h, --help Prints help information

ARGS: The type of keypair to generate. May be Account, User, Module (Actor), Server, Operator, Cluster, Service (Capability Provider) ```

``` USAGE: wash keys get [OPTIONS]

FLAGS: -h, --help Prints help information

OPTIONS: -d, --directory The directory where keys are stored for listing. Defaults to $HOME/.wash/keys, and can also be overwritten by setting the WASH_KEYS environment variable.

ARGS: The name of the key to output ```

``` USAGE: wash keys list [OPTIONS]

FLAGS: -h, --help Prints help information

OPTIONS: -d, --directory The directory where keys are stored for listing. Defaults to $HOME/.wash/keys, and can also be overwritten by setting the WASH_KEYS environment variable. ```

lattice

``` USAGE: wash lattice [FLAGS] [OPTIONS]

FLAGS: -h, --help Prints help information -j, --json Render the output in JSON (if the command supports it) -V, --version Prints version information

OPTIONS: -t, --timeout Lattice invocation / request timeout period, in milliseconds [env: LATTICERPCTIMEOUTMILLIS] [default: 600] -c, --creds Credentials file used to authenticate against NATS [env: LATTICECREDSFILE] -n, --namespace Lattice namespace [env: LATTICENAMESPACE] -u, --url The host IP of the nearest NATS server/leaf node to connect to the lattice [env: LATTICE_HOST] [default: 127.0.0.1]

SUBCOMMANDS: list List entities of various types within the lattice start Hold a lattice auction for a given actor and start it if a suitable host is found stop Tell a given host to terminate the given actor watch Watch events on the lattice ```

par

``` USAGE: wash par [FLAGS]

FLAGS: -h, --help Prints help information -V, --version Prints version information

SUBCOMMANDS: create Build a provider archive file insert Insert a provider into a provider archive file inspect Inspect a provider archive file ```

reg

``` USAGE: wash reg [FLAGS]

FLAGS: -h, --help Prints help information -V, --version Prints version information

SUBCOMMANDS: pull Downloads a blob from an OCI compliant registry push Uploads a blob to an OCI compliant registry

ARGS: URI of the artifact ```

up

Starts an interactive REPL session for waSCC development ``` USAGE: wash up [FLAGS]

FLAGS: -h, --help Prints help information -V, --version Prints version information

SUBCOMMANDS: help Prints this message or the help of the given subcommand(s) ```