polkadot-cli 1.3.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

package/dist/cli.mjs

@@ -807,7 +807,11 @@ async function completeDotpath(currentWord, config, knownChains, precedingWords)
   const partial = endsWithDot ? "" : parts[parts.length - 1] ?? "";
   const numComplete = completeSegments.length;
   if (numComplete === 0 && !endsWithDot) {
-    const candidates = [...CATEGORIES.map(String), ...knownChains, ...NAMED_COMMANDS];
+    const candidates = [
+      ...CATEGORIES.map((c) => `${c}.`),
+      ...knownChains.map((c) => `${c}.`),
+      ...NAMED_COMMANDS
+    ];
     return filterPrefix(candidates, partial);
   }
   const first = completeSegments[0] ?? "";
@@ -822,7 +826,7 @@ async function completeDotpath(currentWord, config, knownChains, precedingWords)
       if (!pallets)
         return [];
       const filtered = filterPallets(pallets, category);
-      const candidates = filtered.map((p) => `${first}.${p.name}`);
+      const candidates = filtered.map((p) => `${first}.${p.name}.`);
       return filterPrefix(candidates, currentWord.slice(0, -1));
     }
     if (numComplete === 1 && !endsWithDot) {
@@ -831,7 +835,7 @@ async function completeDotpath(currentWord, config, knownChains, precedingWords)
       if (!pallets)
         return [];
       const filtered = filterPallets(pallets, category);
-      const candidates = filtered.map((p) => `${first}.${p.name}`);
+      const candidates = filtered.map((p) => `${first}.${p.name}.`);
       return filterPrefix(candidates, currentWord);
     }
     if (numComplete === 2) {
@@ -852,11 +856,11 @@ async function completeDotpath(currentWord, config, knownChains, precedingWords)
   if (firstIsChain) {
     const chainName = first;
     if (numComplete === 1 && endsWithDot) {
-      const candidates = CATEGORIES.map((c) => `${first}.${c}`);
+      const candidates = CATEGORIES.map((c) => `${first}.${c}.`);
       return filterPrefix(candidates, currentWord.slice(0, -1));
     }
     if (numComplete === 1 && !endsWithDot) {
-      const candidates = CATEGORIES.map((c) => `${first}.${c}`);
+      const candidates = CATEGORIES.map((c) => `${first}.${c}.`);
       return filterPrefix(candidates, currentWord);
     }
     if (numComplete === 2) {
@@ -868,7 +872,7 @@ async function completeDotpath(currentWord, config, knownChains, precedingWords)
         return [];
       const filtered = filterPallets(pallets, category);
       const prefix = `${first}.${completeSegments[1]}`;
-      const candidates = filtered.map((p) => `${prefix}.${p.name}`);
+      const candidates = filtered.map((p) => `${prefix}.${p.name}.`);
       return filterPrefix(candidates, endsWithDot ? currentWord.slice(0, -1) : currentWord);
     }
     if (numComplete === 3) {
@@ -931,7 +935,7 @@ var init_complete = __esm(() => {
 // src/cli.ts
 import cac from "cac";
 // package.json
-var version = "1.3.0";
+var version = "1.4.0";
 
 // src/commands/account.ts
 init_accounts_store();
@@ -1700,9 +1704,10 @@ async function chainDefault(name) {
 
 // src/commands/completions.ts
 var ZSH_SCRIPT = `_dot_completions() {
+  emulate -L zsh
   local -a completions
   local current_word="\${words[CURRENT]}"
-  local preceding=("\${words[@]:1:CURRENT-2}")
+  local preceding=("\${words[2,CURRENT-1]}")
 
   # Build args: -- <current_word> <preceding_words...>
   local args=("__complete" "--" "\${current_word}")
@@ -2132,13 +2137,14 @@ async function showItemHelp(category, target, opts) {
       if (storageItem.keyTypeId != null) {
         console.log(`${BOLD}Usage:${RESET}`);
         console.log(`  dot query.${pallet.name}.${storageItem.name} <key>`);
-        console.log(`  dot query.${pallet.name}.${storageItem.name}              # all entries`);
+        console.log(`  dot query.${pallet.name}.${storageItem.name} --dump       # all entries`);
       } else {
         console.log(`${BOLD}Usage:${RESET}`);
         console.log(`  dot query.${pallet.name}.${storageItem.name}`);
       }
       console.log();
       console.log(`${BOLD}Options:${RESET}`);
+      console.log(`  --dump           Dump all entries of a map (required for keyless map queries)`);
       console.log(`  --limit <n>      Max entries for map queries (0 = unlimited, default: 100)`);
       console.log();
       return;
@@ -2576,13 +2582,14 @@ async function showItemHelp2(category, target, opts) {
       if (storageItem.keyTypeId != null) {
         console.log(`${BOLD}Usage:${RESET}`);
         console.log(`  dot query.${pallet.name}.${storageItem.name} <key>`);
-        console.log(`  dot query.${pallet.name}.${storageItem.name}              # all entries`);
+        console.log(`  dot query.${pallet.name}.${storageItem.name} --dump       # all entries`);
       } else {
         console.log(`${BOLD}Usage:${RESET}`);
         console.log(`  dot query.${pallet.name}.${storageItem.name}`);
       }
       console.log();
       console.log(`${BOLD}Options:${RESET}`);
+      console.log(`  --dump           Dump all entries of a map (required for keyless map queries)`);
       console.log(`  --limit <n>      Max entries for map queries (0 = unlimited, default: 100)`);
       console.log();
       return;
@@ -3256,7 +3263,8 @@ async function parseTypedArg(meta, entry, arg) {
       const matched = variants.find((v) => v.toLowerCase() === arg.toLowerCase());
       if (matched) {
         const variant = entry.value[matched];
-        if (variant.type === "void") {
+        const resolved = variant.type === "lookupEntry" ? variant.value : variant;
+        if (resolved.type === "void") {
           return { type: matched };
         }
       }
@@ -3404,6 +3412,12 @@ async function handleQuery(target, keys, opts) {
     const parsedKeys = await parseStorageKeys(meta, palletInfo.name, storageItem, keys);
     const format = opts.output ?? "pretty";
     if (storageItem.type === "map" && parsedKeys.length === 0) {
+      if (!opts.dump) {
+        clientHandle.destroy();
+        await showItemHelp("query", target, { chain: opts.chain, rpc: opts.rpc });
+        console.log(`${DIM}Hint: use --dump to fetch all entries${RESET}`);
+        return;
+      }
       const entries = await storageApi.getEntries();
       const limit = Number(opts.limit);
       const truncated = limit > 0 && entries.length > limit;
@@ -4089,7 +4103,8 @@ async function parseTypedArg2(meta, entry, arg) {
       const matched = variants.find((v) => v.toLowerCase() === arg.toLowerCase());
       if (matched) {
         const variant = entry.value[matched];
-        if (variant.type === "void") {
+        const resolved = variant.type === "lookupEntry" ? variant.value : variant;
+        if (resolved.type === "void") {
           return { type: matched };
         }
       }
@@ -4557,7 +4572,7 @@ if (process.argv[2] === "__complete") {
   registerCompletionsCommand(cli);
   cli.command("[dotpath] [...args]").option("--from <name>", "Account to sign with (for tx)").option("--dry-run", "Estimate fees without submitting (for tx)").option("--encode", "Encode call to hex without signing (for tx)").option("--ext <json>", "Custom signed extension values as JSON (for tx)").option("--limit <n>", "Max entries to return for map queries (0 = unlimited)", {
     default: 100
-  }).action(async (dotpath, args, opts) => {
+  }).option("--dump", "Dump all entries of a storage map (without specifying a key)").action(async (dotpath, args, opts) => {
     if (!dotpath) {
       printHelp();
       return;
@@ -4582,7 +4597,7 @@ if (process.argv[2] === "__complete") {
     }
     switch (parsed.category) {
       case "query":
-        await handleQuery(target, args, { ...handlerOpts, limit: opts.limit });
+        await handleQuery(target, args, { ...handlerOpts, limit: opts.limit, dump: opts.dump });
         break;
       case "tx":
         if (parsed.pallet && /^0x[0-9a-fA-F]+$/.test(parsed.pallet)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "polkadot-cli",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "CLI tool for querying Polkadot-ecosystem on-chain state",
   "type": "module",
   "bin": {