polkadot-cli 1.2.0 → 1.4.0

package/README.md

@@ -251,11 +251,17 @@ dot query System.Number
 # Map entry by key
 dot query System.Account 5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY
 
-# All map entries (default limit: 100)
-dot query System.Account --limit 10
+# Map without key — shows help/usage (use --dump to fetch all entries)
+dot query System.Account
+
+# Dump all map entries (requires --dump, default limit: 100)
+dot query System.Account --dump --limit 10
+
+# Enum variant as map key (case-insensitive)
+dot query people-preview.ChunksManager.Chunks R2e9 1
 
 # Pipe-safe — stdout is clean data, progress messages go to stderr
-dot query System.Account --limit 5 | jq '.[0].value.data.free'
+dot query System.Account --dump --limit 5 | jq '.[0].value.data.free'
 dot query System.Number --output json | jq '.+1'
 
 # Query a specific chain using chain prefix
@@ -526,6 +532,7 @@ dot tx.System.remark 0xdead               # shows call help (no error)
 | `--rpc <url>` | Override RPC endpoint(s) for this call (repeat for fallback) |
 | `--light-client` | Use Smoldot light client |
 | `--output json` | Raw JSON output (default: pretty) |
+| `--dump` | Dump all entries of a storage map (required for keyless map queries) |
 | `--limit <n>` | Max entries for map queries (0 = unlimited, default: 100) |
 
 ### Pipe-safe output
@@ -539,6 +546,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 |