polkadot-cli 1.1.1 → 1.3.0

package/README.md

@@ -79,6 +79,10 @@ dot accounts            # shorthand, same as above
 # List all accounts (dev + stored)
 dot account list
 
+# Add a watch-only address (no secret — for use as tx recipient or query target)
+dot account add treasury 5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY
+dot account add council 0xd43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d
+
 # Create a new account (generates a mnemonic)
 dot account create my-validator
 
@@ -113,6 +117,36 @@ dot account inspect alice --prefix 0         # Polkadot mainnet prefix
 dot account inspect alice --output json      # JSON output
 ```
 
+#### Watch-only accounts
+
+Add named addresses without secrets — useful for saving frequently-used recipients, multisig members, or query targets:
+
+```bash
+dot account add treasury 5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY
+dot account add council 0xd43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d
+```
+
+Watch-only accounts appear in `dot account list` with a `(watch-only)` badge and can be inspected and removed like any other account. They cannot be used with `--from` (signing) or as a source for `derive`.
+
+The `add` subcommand is context-sensitive: bare `add <name> <address>` creates a watch-only entry, while `add --secret` or `add --env` imports a keyed account (same as `import`).
+
+#### Named address resolution
+
+Named accounts (both watch-only and keyed) resolve automatically everywhere an AccountId32 or MultiAddress is expected — in `dot tx` arguments and `dot query` keys:
+
+```bash
+# Use a named account as transfer recipient
+dot tx Balances.transferKeepAlive treasury 1000000000000 --from alice
+
+# Query by account name
+dot query System.Account treasury
+
+# Dev accounts also resolve
+dot tx Balances.transferKeepAlive bob 1000000000000 --from alice
+```
+
+Resolution order: dev account name > stored account name > SS58 address > hex public key. If the input doesn't match any, the CLI shows an error listing available account names.
+
 #### Inspect accounts
 
 Convert between SS58 addresses, hex public keys, and account names. Accepts any of:
@@ -505,6 +539,35 @@ dot query System.Number --output json | jq
 
 In an interactive terminal, both streams render together so you see progress and results normally.
 
+### Shell completions
+
+Generate shell completion scripts for tab-completing subcommands, chain names, pallet names, and item names. Completions use cached metadata — no network calls are made.
+
+```bash
+# zsh — add to ~/.zshrc
+eval "$(dot completions zsh)"
+
+# bash — add to ~/.bashrc
+eval "$(dot completions bash)"
+
+# fish — save to completions directory
+dot completions fish > ~/.config/fish/completions/dot.fish
+```
+
+Once installed, press Tab to complete:
+
+```bash
+dot qu<Tab>              # → query
+dot query.<Tab>          # → query.System, query.Balances, ...
+dot query.System.<Tab>   # → query.System.Account, query.System.Number, ...
+dot polkadot.<Tab>       # → polkadot.query, polkadot.tx, ...
+dot --chain <Tab>        # → polkadot, paseo, ...
+dot --from <Tab>         # → alice, bob, ..., stored account names
+dot chain <Tab>          # → add, remove, update, list, default
+```
+
+Completions are context-aware: `query.` shows pallets with storage items, `tx.` shows pallets with calls, `events.` and `errors.` filter accordingly. Chain prefix paths like `polkadot.query.System.` work at any depth.
+
 ## How it compares
 
 | | polkadot-cli | @polkadot/api-cli | subxt-cli | Pop CLI |