polkadot-cli 0.14.0 → 1.1.1

package/README.md

@@ -465,6 +465,24 @@ dot chain --help        # same as `dot chain` — shows chain actions
 dot hash --help         # same as `dot hash` — shows algorithms and examples
 ```
 
+#### Item-level help
+
+Use `--help` on any fully-qualified dot-path to see metadata detail and category-specific usage hints — all offline, no chain connection required:
+
+```bash
+dot tx.System.remark --help               # call args, docs, and tx options
+dot query.System.Account --help           # storage type, key/value info, and query options
+dot const.Balances.ExistentialDeposit --help  # constant type and docs
+dot events.Balances.Transfer --help       # event fields and docs
+dot errors.Balances.InsufficientBalance --help  # error docs
+```
+
+For `tx` commands, omitting both `--from` and `--encode` shows this same help output instead of an error:
+
+```bash
+dot tx.System.remark 0xdead               # shows call help (no error)
+```
+
 ### Global options
 
 | Flag | Description |
@@ -541,6 +559,10 @@ Config and metadata caches live in `~/.polkadot/`:
 
 > **Warning:** `accounts.json` stores secrets (mnemonics and seeds) in **plain text**. Encrypted-at-rest storage is planned but not yet implemented. Keep appropriate file permissions (`chmod 600 ~/.polkadot/accounts.json`) and do not use this for high-value mainnet accounts.
 
+## Environment compatibility
+
+The CLI works in Node.js, Bun, and sandboxed runtimes (e.g. LLM tool-use / MCP environments) that lack a native `globalThis.WebSocket`. WebSocket connections use the [`ws`](https://github.com/websockets/ws) package explicitly, so no global polyfill is required.
+
 ## Development
 
 Requires [Bun](https://bun.sh).