polkadot-cli 0.11.0 → 0.12.0

package/README.md

@@ -4,7 +4,26 @@
 
 A command-line tool for interacting with Polkadot-ecosystem chains. Manage chains and accounts, query storage, look up constants, inspect metadata, submit extrinsics, and compute hashes — all from your terminal.
 
-Ships with Polkadot as the default chain. Add any Substrate-based chain by pointing to its RPC endpoint.
+Ships with Polkadot and all system parachains preconfigured with multiple fallback RPC endpoints. Add any Substrate-based chain by pointing to its RPC endpoint(s).
+
+### Preconfigured chains
+
+| Network | Chain | Light client |
+|---------|-------|:---:|
+| Polkadot | `polkadot` (relay, default) | yes |
+| | `polkadot-asset-hub` | yes |
+| | `polkadot-bridge-hub` | yes |
+| | `polkadot-collectives` | yes |
+| | `polkadot-coretime` | yes |
+| | `polkadot-people` | yes |
+| Paseo (testnet) | `paseo` (relay) | yes |
+| | `paseo-asset-hub` | yes |
+| | `paseo-bridge-hub` | — |
+| | `paseo-collectives` | — |
+| | `paseo-coretime` | yes |
+| | `paseo-people` | yes |
+
+Each chain ships with multiple RPC endpoints from decentralized infrastructure providers (IBP, Dotters, Dwellir, and others). The CLI automatically falls back to the next endpoint if the primary is unreachable.
 
 ## Install
 
@@ -23,8 +42,13 @@ This installs the `dot` command globally.
 dot chain               # shows available actions
 dot chains              # shorthand, same as above
 
-# Add a chain
+# Add a chain (single RPC)
 dot chain add kusama --rpc wss://kusama-rpc.polkadot.io
+
+# Add a chain with fallback RPCs (repeat --rpc for each endpoint)
+dot chain add kusama --rpc wss://kusama-rpc.polkadot.io --rpc wss://kusama-rpc.dwellir.com
+
+# Add a chain via light client
 dot chain add westend --light-client
 
 # List configured chains
@@ -58,17 +82,27 @@ dot account list
 # Create a new account (generates a mnemonic)
 dot account create my-validator
 
+# Create with a derivation path
+dot account create my-staking --path //staking
+
 # Import from a BIP39 mnemonic
 dot account import treasury --secret "word1 word2 ... word12"
 
+# Import with a derivation path
+dot account import hot-wallet --secret "word1 word2 ... word12" --path //hot
+
 # Import an env-var-backed account (secret stays off disk)
 dot account import ci-signer --env MY_SECRET
 
+# Derive a child account from an existing one
+dot account derive treasury treasury-staking --path //staking
+
 # Use it — the env var is read at signing time
 MY_SECRET="word1 word2 ..." dot tx System.remark 0xdead --from ci-signer
 
-# Remove an account
+# Remove one or more accounts
 dot account remove my-validator
+dot account delete my-validator stale-key
 ```
 
 #### Env-var-backed accounts
@@ -83,6 +117,33 @@ dot account import ci-signer --env MY_SECRET
 
 The secret is never written to disk. At signing time, the CLI reads `$MY_SECRET` and derives the keypair. If the variable is not set, the CLI errors with a clear message. `account list` shows an `(env: MY_SECRET)` badge and resolves the address live when the variable is available.
 
+#### Derivation paths
+
+Use `--path` with `create`, `import`, or the `derive` action to derive child keys from the same secret. Different paths produce different keypairs, enabling key separation (e.g. staking vs. governance) without managing multiple mnemonics.
+
+```bash
+# Create with a derivation path
+dot account create my-staking --path //staking
+
+# Multi-segment path (hard + soft junctions)
+dot account create multi --path //polkadot//0/wallet
+
+# Import with a path
+dot account import hot --secret "word1 word2 ..." --path //hot
+
+# Derive a child from an existing account
+dot account derive treasury treasury-staking --path //staking
+```
+
+`derive` copies the source account's secret and applies the given path. It requires both a source name, a new name, and `--path`. Works with env-backed accounts too — the derived account shares the same env var reference.
+
+`account list` shows the derivation path next to the account name:
+
+```
+  treasury-staking (//staking)  5FHneW46...
+  ci-signer (//ci) (env: MY_SECRET)  5EPCUjPx...
+```
+
 **Supported secret formats for import:**
 
 | Format | Example | Status |
@@ -286,12 +347,24 @@ dot hash blake2b256 0xdeadbeef --output json
 
 Run `dot hash` with no arguments to see all available algorithms.
 
+### Getting help
+
+Every command supports `--help` to show its detailed usage, available actions, and examples:
+
+```bash
+dot --help              # global help with all commands
+dot account --help      # same as `dot account` — shows account actions
+dot chain --help        # same as `dot chain` — shows chain actions
+dot hash --help         # same as `dot hash` — shows algorithms and examples
+```
+
 ### Global options
 
 | Flag | Description |
 |------|-------------|
+| `--help` | Show help (global or command-specific) |
 | `--chain <name>` | Target chain (default from config) |
-| `--rpc <url>` | Override RPC endpoint for this call |
+| `--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) |
 | `--limit <n>` | Max entries for map queries (0 = unlimited, default: 100) |

package/dist/cli.mjs

@@ -5,7 +5,7 @@ var __require = /* @__PURE__ */ createRequire(import.meta.url);
 // src/cli.ts
 import cac from "cac";
 // package.json
-var version = "0.11.0";
+var version = "0.12.0";
 
 // src/config/accounts-store.ts
 import { access as access2, mkdir as mkdir2, readFile as readFile2, writeFile as writeFile2 } from "node:fs/promises";
@@ -17,14 +17,117 @@ import { homedir } from "node:os";
 import { join } from "node:path";
 
 // src/config/types.ts
+function primaryRpc(rpc) {
+  return Array.isArray(rpc) ? rpc[0] : rpc;
+}
 var DEFAULT_CONFIG = {
   defaultChain: "polkadot",
   chains: {
-    polkadot: { rpc: "wss://rpc.polkadot.io" },
-    paseo: { rpc: "wss://rpc.ibp.network/paseo" },
-    "polkadot-asset-hub": { rpc: "wss://polkadot-asset-hub-rpc.polkadot.io" },
-    "paseo-asset-hub": { rpc: "wss://asset-hub-paseo-rpc.dwellir.com" },
-    "polkadot-people": { rpc: "wss://polkadot-people-rpc.polkadot.io" }
+    polkadot: {
+      rpc: [
+        "wss://polkadot.ibp.network",
+        "wss://polkadot.dotters.network",
+        "wss://polkadot-rpc.n.dwellir.com",
+        "wss://polkadot-rpc.publicnode.com",
+        "wss://rpc-polkadot.luckyfriday.io",
+        "wss://polkadot.api.onfinality.io/public-ws",
+        "wss://rpc-polkadot.helixstreet.io",
+        "wss://polkadot-rpc-tn.dwellir.com",
+        "wss://polkadot.public.curie.radiumblock.co/ws",
+        "wss://rpc-polkadot.stakeworld.io",
+        "wss://polkadot.rpc.subquery.network/public/ws",
+        "wss://rpc.polkadot.io"
+      ]
+    },
+    "polkadot-asset-hub": {
+      rpc: [
+        "wss://polkadot-asset-hub-rpc.polkadot.io",
+        "wss://asset-hub-polkadot.ibp.network",
+        "wss://asset-hub-polkadot.dotters.network",
+        "wss://asset-hub-polkadot-rpc.n.dwellir.com",
+        "wss://rpc-asset-hub-polkadot.luckyfriday.io",
+        "wss://statemint.api.onfinality.io/public-ws",
+        "wss://statemint-rpc-tn.dwellir.com",
+        "wss://statemint.public.curie.radiumblock.co/ws",
+        "wss://asset-hub-polkadot.rpc.permanence.io"
+      ]
+    },
+    "polkadot-bridge-hub": {
+      rpc: [
+        "wss://polkadot-bridge-hub-rpc.polkadot.io",
+        "wss://bridge-hub-polkadot.ibp.network",
+        "wss://bridge-hub-polkadot.dotters.network",
+        "wss://bridge-hub-polkadot-rpc.n.dwellir.com",
+        "wss://rpc-bridge-hub-polkadot.luckyfriday.io",
+        "wss://bridgehub-polkadot.api.onfinality.io/public-ws",
+        "wss://polkadot-bridge-hub-rpc-tn.dwellir.com",
+        "wss://bridgehub-polkadot.public.curie.radiumblock.co/ws"
+      ]
+    },
+    "polkadot-collectives": {
+      rpc: [
+        "wss://polkadot-collectives-rpc.polkadot.io",
+        "wss://collectives-polkadot.ibp.network",
+        "wss://collectives-polkadot.dotters.network",
+        "wss://collectives-polkadot-rpc.n.dwellir.com",
+        "wss://rpc-collectives-polkadot.luckyfriday.io",
+        "wss://collectives.api.onfinality.io/public-ws",
+        "wss://polkadot-collectives-rpc-tn.dwellir.com",
+        "wss://collectives.public.curie.radiumblock.co/ws"
+      ]
+    },
+    "polkadot-coretime": {
+      rpc: [
+        "wss://polkadot-coretime-rpc.polkadot.io",
+        "wss://coretime-polkadot.ibp.network",
+        "wss://coretime-polkadot.dotters.network",
+        "wss://coretime-polkadot-rpc.n.dwellir.com",
+        "wss://rpc-coretime-polkadot.luckyfriday.io",
+        "wss://coretime-polkadot.api.onfinality.io/public-ws"
+      ]
+    },
+    "polkadot-people": {
+      rpc: [
+        "wss://polkadot-people-rpc.polkadot.io",
+        "wss://people-polkadot.ibp.network",
+        "wss://people-polkadot.dotters.network",
+        "wss://people-polkadot-rpc.n.dwellir.com",
+        "wss://rpc-people-polkadot.luckyfriday.io",
+        "wss://people-polkadot.api.onfinality.io/public-ws"
+      ]
+    },
+    paseo: {
+      rpc: [
+        "wss://paseo.ibp.network",
+        "wss://paseo.dotters.network",
+        "wss://paseo-rpc.n.dwellir.com",
+        "wss://paseo.rpc.amforc.com"
+      ]
+    },
+    "paseo-asset-hub": {
+      rpc: [
+        "wss://asset-hub-paseo.ibp.network",
+        "wss://asset-hub-paseo.dotters.network",
+        "wss://asset-hub-paseo-rpc.n.dwellir.com",
+        "wss://sys.turboflakes.io/asset-hub-paseo"
+      ]
+    },
+    "paseo-bridge-hub": {
+      rpc: ["wss://bridge-hub-paseo.ibp.network", "wss://bridge-hub-paseo.dotters.network"]
+    },
+    "paseo-collectives": {
+      rpc: ["wss://collectives-paseo.ibp.network", "wss://collectives-paseo.dotters.network"]
+    },
+    "paseo-coretime": {
+      rpc: ["wss://coretime-paseo.ibp.network", "wss://coretime-paseo.dotters.network"]
+    },
+    "paseo-people": {
+      rpc: [
+        "wss://people-paseo.ibp.network",
+        "wss://people-paseo.dotters.network",
+        "wss://people-paseo.rpc.amforc.com"
+      ]
+    }
   }
 };
 var BUILTIN_CHAIN_NAMES = new Set(Object.keys(DEFAULT_CONFIG.chains));
@@ -177,24 +280,24 @@ function getDevAddress(name, prefix = 42) {
   const keypair = getDevKeypair(name);
   return ss58Address(keypair.publicKey, prefix);
 }
-function createNewAccount() {
+function createNewAccount(path = "") {
   const mnemonic = generateMnemonic();
   const entropy = mnemonicToEntropy(mnemonic);
   const miniSecret = entropyToMiniSecret(entropy);
   const derive = sr25519CreateDerive(miniSecret);
-  const keypair = derive("");
+  const keypair = derive(path);
   return { mnemonic, publicKey: keypair.publicKey };
 }
-function importAccount(secret) {
+function importAccount(secret, path = "") {
   const isHexSeed = /^0x[0-9a-fA-F]{64}$/.test(secret);
   if (isHexSeed) {
-    const keypair2 = deriveFromHexSeed(secret, "");
+    const keypair2 = deriveFromHexSeed(secret, path);
     return { publicKey: keypair2.publicKey };
   }
   if (!validateMnemonic(secret)) {
     throw new Error("Invalid secret. Expected a 0x-prefixed 32-byte hex seed or a valid BIP39 mnemonic.");
   }
-  const keypair = deriveFromMnemonic(secret, "");
+  const keypair = deriveFromMnemonic(secret, path);
   return { publicKey: keypair.publicKey };
 }
 function publicKeyToHex(publicKey) {
@@ -221,12 +324,12 @@ function resolveSecret(secret) {
   }
   return secret;
 }
-function tryDerivePublicKey(envVarName) {
+function tryDerivePublicKey(envVarName, path = "") {
   const value = process.env[envVarName];
   if (!value)
     return null;
   try {
-    const { publicKey } = importAccount(value);
+    const { publicKey } = importAccount(value, path);
     return publicKeyToHex(publicKey);
   } catch {
     return null;
@@ -345,41 +448,49 @@ class Spinner {
 // src/commands/account.ts
 var ACCOUNT_HELP = `
 ${BOLD}Usage:${RESET}
-  $ dot account create|new <name>                       Create a new account
-  $ dot account import|add <name> --secret <s>          Import from BIP39 mnemonic
-  $ dot account import|add <name> --env <VAR>           Import account backed by env variable
-  $ dot account list                                    List all accounts
-  $ dot account remove|delete <name>                    Remove a stored account
+  $ dot account create|new <name> [--path <derivation>]              Create a new account
+  $ dot account import|add <name> --secret <s> [--path <derivation>] Import from BIP39 mnemonic
+  $ dot account import|add <name> --env <VAR> [--path <derivation>]  Import account backed by env variable
+  $ dot account derive <source> <new-name> --path <derivation>       Derive a child account
+  $ dot account list                                                 List all accounts
+  $ dot account remove|delete <name> [name2] ...                     Remove stored account(s)
 
 ${BOLD}Examples:${RESET}
   $ dot account create my-validator
+  $ dot account create my-staking --path //staking
+  $ dot account create multi --path //polkadot//0/wallet
   $ dot account import treasury --secret "word1 word2 ... word12"
-  $ dot account import ci-signer --env MY_SECRET
+  $ dot account import ci-signer --env MY_SECRET --path //ci
+  $ dot account derive treasury treasury-staking --path //staking
   $ dot account list
-  $ dot account remove my-validator
+  $ dot account remove my-validator stale-key
 
 ${YELLOW}Note: Secrets are stored unencrypted in ~/.polkadot/accounts.json.
       Use --env to keep secrets off disk entirely.
       Hex seed import (0x...) is not supported via CLI.${RESET}
 `.trimStart();
 function registerAccountCommands(cli) {
-  cli.command("account [action] [name]", "Manage local accounts (create, import, list, remove)").alias("accounts").option("--secret <value>", "Secret key (mnemonic or hex seed) for import").option("--env <varName>", "Environment variable name holding the secret").action(async (action, name, opts) => {
+  cli.command("account [action] [...names]", "Manage local accounts (create, import, list, remove)").alias("accounts").option("--secret <value>", "Secret key (mnemonic or hex seed) for import").option("--env <varName>", "Environment variable name holding the secret").option("--path <derivation>", "Derivation path (e.g. //staking, //polkadot//0/wallet)").action(async (action, names, opts) => {
     if (!action) {
+      if (process.argv[2] === "accounts")
+        return accountList();
       console.log(ACCOUNT_HELP);
       return;
     }
     switch (action) {
       case "new":
       case "create":
-        return accountCreate(name);
+        return accountCreate(names[0], opts);
       case "import":
       case "add":
-        return accountImport(name, opts);
+        return accountImport(names[0], opts);
+      case "derive":
+        return accountDerive(names[0], names[1], opts);
       case "list":
         return accountList();
       case "delete":
       case "remove":
-        return accountRemove(name);
+        return accountRemove(names);
       default:
         console.error(`Unknown action "${action}".
 `);
@@ -388,7 +499,7 @@ function registerAccountCommands(cli) {
     }
   });
 }
-async function accountCreate(name) {
+async function accountCreate(name, opts) {
   if (!name) {
     console.error(`Account name is required.
 `);
@@ -402,18 +513,21 @@ async function accountCreate(name) {
   if (findAccount(accountsFile, name)) {
     throw new Error(`Account "${name}" already exists.`);
   }
-  const { mnemonic, publicKey } = createNewAccount();
+  const path = opts.path ?? "";
+  const { mnemonic, publicKey } = createNewAccount(path);
   const hexPub = publicKeyToHex(publicKey);
   const address = toSs58(publicKey);
   accountsFile.accounts.push({
     name,
     secret: mnemonic,
     publicKey: hexPub,
-    derivationPath: ""
+    derivationPath: path
   });
   await saveAccounts(accountsFile);
   printHeading("Account Created");
   console.log(`  ${BOLD}Name:${RESET}     ${name}`);
+  if (path)
+    console.log(`  ${BOLD}Path:${RESET}     ${path}`);
   console.log(`  ${BOLD}Address:${RESET}  ${address}`);
   console.log(`  ${BOLD}Mnemonic:${RESET} ${mnemonic}`);
   console.log();
@@ -446,17 +560,20 @@ async function accountImport(name, opts) {
   if (findAccount(accountsFile, name)) {
     throw new Error(`Account "${name}" already exists.`);
   }
+  const path = opts.path ?? "";
   if (opts.env) {
-    const publicKey = tryDerivePublicKey(opts.env) ?? "";
+    const publicKey = tryDerivePublicKey(opts.env, path) ?? "";
     accountsFile.accounts.push({
       name,
       secret: { env: opts.env },
       publicKey,
-      derivationPath: ""
+      derivationPath: path
     });
     await saveAccounts(accountsFile);
     printHeading("Account Imported");
     console.log(`  ${BOLD}Name:${RESET}    ${name}`);
+    if (path)
+      console.log(`  ${BOLD}Path:${RESET}    ${path}`);
     console.log(`  ${BOLD}Env:${RESET}     ${opts.env}`);
     if (publicKey) {
       console.log(`  ${BOLD}Address:${RESET} ${toSs58(publicKey)}`);
@@ -465,18 +582,90 @@ async function accountImport(name, opts) {
     }
     console.log();
   } else {
-    const { publicKey } = importAccount(opts.secret);
+    const { publicKey } = importAccount(opts.secret, path);
     const hexPub = publicKeyToHex(publicKey);
     const address = toSs58(publicKey);
     accountsFile.accounts.push({
       name,
       secret: opts.secret,
       publicKey: hexPub,
-      derivationPath: ""
+      derivationPath: path
     });
     await saveAccounts(accountsFile);
     printHeading("Account Imported");
     console.log(`  ${BOLD}Name:${RESET}    ${name}`);
+    if (path)
+      console.log(`  ${BOLD}Path:${RESET}    ${path}`);
+    console.log(`  ${BOLD}Address:${RESET} ${address}`);
+    console.log();
+  }
+}
+async function accountDerive(sourceName, newName, opts) {
+  if (!sourceName) {
+    console.error(`Source account name is required.
+`);
+    console.error("Usage: dot account derive <source> <new-name> --path <derivation>");
+    process.exit(1);
+  }
+  if (!newName) {
+    console.error(`New account name is required.
+`);
+    console.error("Usage: dot account derive <source> <new-name> --path <derivation>");
+    process.exit(1);
+  }
+  if (!opts.path) {
+    console.error(`--path is required for derive.
+`);
+    console.error("Usage: dot account derive <source> <new-name> --path <derivation>");
+    process.exit(1);
+  }
+  if (isDevAccount(newName)) {
+    throw new Error(`"${newName}" is a built-in dev account and cannot be used as a custom account name.`);
+  }
+  const accountsFile = await loadAccounts();
+  const source = findAccount(accountsFile, sourceName);
+  if (!source) {
+    throw new Error(`Source account "${sourceName}" not found.`);
+  }
+  if (findAccount(accountsFile, newName)) {
+    throw new Error(`Account "${newName}" already exists.`);
+  }
+  const path = opts.path;
+  if (isEnvSecret(source.secret)) {
+    const publicKey = tryDerivePublicKey(source.secret.env, path) ?? "";
+    accountsFile.accounts.push({
+      name: newName,
+      secret: source.secret,
+      publicKey,
+      derivationPath: path
+    });
+    await saveAccounts(accountsFile);
+    printHeading("Account Derived");
+    console.log(`  ${BOLD}Name:${RESET}    ${newName}`);
+    console.log(`  ${BOLD}Source:${RESET}  ${sourceName}`);
+    console.log(`  ${BOLD}Path:${RESET}    ${path}`);
+    console.log(`  ${BOLD}Env:${RESET}     ${source.secret.env}`);
+    if (publicKey) {
+      console.log(`  ${BOLD}Address:${RESET} ${toSs58(publicKey)}`);
+    } else {
+      console.log(`  ${YELLOW}Address will resolve when $${source.secret.env} is set.${RESET}`);
+    }
+    console.log();
+  } else {
+    const { publicKey } = importAccount(source.secret, path);
+    const hexPub = publicKeyToHex(publicKey);
+    const address = toSs58(publicKey);
+    accountsFile.accounts.push({
+      name: newName,
+      secret: source.secret,
+      publicKey: hexPub,
+      derivationPath: path
+    });
+    await saveAccounts(accountsFile);
+    printHeading("Account Derived");
+    console.log(`  ${BOLD}Name:${RESET}    ${newName}`);
+    console.log(`  ${BOLD}Source:${RESET}  ${sourceName}`);
+    console.log(`  ${BOLD}Path:${RESET}    ${path}`);
     console.log(`  ${BOLD}Address:${RESET} ${address}`);
     console.log();
   }
@@ -493,12 +682,15 @@ async function accountList() {
     printHeading("Stored Accounts");
     for (const account of accountsFile.accounts) {
       let displayName = account.name;
+      if (account.derivationPath) {
+        displayName += ` (${account.derivationPath})`;
+      }
       let address;
       if (isEnvSecret(account.secret)) {
         displayName += ` (env: ${account.secret.env})`;
         let pubKey = account.publicKey;
         if (!pubKey) {
-          pubKey = tryDerivePublicKey(account.secret.env) ?? "";
+          pubKey = tryDerivePublicKey(account.secret.env, account.derivationPath) ?? "";
         }
         address = pubKey ? toSs58(pubKey) : "n/a";
       } else {
@@ -512,24 +704,44 @@ async function accountList() {
   }
   console.log();
 }
-async function accountRemove(name) {
-  if (!name) {
-    console.error(`Account name is required.
+async function accountRemove(names) {
+  if (names.length === 0) {
+    console.error(`At least one account name is required.
 `);
-    console.error("Usage: dot account remove <name>");
+    console.error("Usage: dot account remove <name> [name2] ...");
     process.exit(1);
   }
-  if (isDevAccount(name)) {
-    throw new Error("Cannot remove built-in dev accounts.");
+  const errors = [];
+  for (const name of names) {
+    if (isDevAccount(name)) {
+      errors.push(`Cannot remove built-in dev account "${name}".`);
+    }
+  }
+  if (errors.length > 0) {
+    throw new Error(errors.join(`
+`));
   }
   const accountsFile = await loadAccounts();
-  const idx = accountsFile.accounts.findIndex((a) => a.name.toLowerCase() === name.toLowerCase());
-  if (idx === -1) {
-    throw new Error(`Account "${name}" not found.`);
+  const indicesToRemove = new Set;
+  for (const name of names) {
+    const idx = accountsFile.accounts.findIndex((a) => a.name.toLowerCase() === name.toLowerCase());
+    if (idx === -1) {
+      errors.push(`Account "${name}" not found.`);
+    } else {
+      indicesToRemove.add(idx);
+    }
+  }
+  if (errors.length > 0) {
+    throw new Error(errors.join(`
+`));
+  }
+  for (const idx of [...indicesToRemove].sort((a, b) => b - a)) {
+    accountsFile.accounts.splice(idx, 1);
   }
-  accountsFile.accounts.splice(idx, 1);
   await saveAccounts(accountsFile);
-  console.log(`Account "${name}" removed.`);
+  for (const name of names) {
+    console.log(`Account "${name}" removed.`);
+  }
 }
 
 // src/core/client.ts
@@ -566,8 +778,13 @@ var KNOWN_CHAIN_SPECS = {
   westend: { spec: "polkadot-api/chains/westend2" },
   paseo: { spec: "polkadot-api/chains/paseo" },
   "polkadot-asset-hub": { spec: "polkadot-api/chains/polkadot_asset_hub", relay: "polkadot" },
+  "polkadot-bridge-hub": { spec: "polkadot-api/chains/polkadot_bridge_hub", relay: "polkadot" },
+  "polkadot-collectives": { spec: "polkadot-api/chains/polkadot_collectives", relay: "polkadot" },
+  "polkadot-coretime": { spec: "polkadot-api/chains/polkadot_coretime", relay: "polkadot" },
   "polkadot-people": { spec: "polkadot-api/chains/polkadot_people", relay: "polkadot" },
-  "paseo-asset-hub": { spec: "polkadot-api/chains/paseo_asset_hub", relay: "paseo" }
+  "paseo-asset-hub": { spec: "polkadot-api/chains/paseo_asset_hub", relay: "paseo" },
+  "paseo-coretime": { spec: "polkadot-api/chains/paseo_coretime", relay: "paseo" },
+  "paseo-people": { spec: "polkadot-api/chains/paseo_people", relay: "paseo" }
 };
 function suppressWsNoise() {
   const orig = console.error;
@@ -788,6 +1005,7 @@ ${BOLD}Usage:${RESET}
 
 ${BOLD}Examples:${RESET}
   $ dot chain add kusama --rpc wss://kusama-rpc.polkadot.io
+  $ dot chain add kusama --rpc wss://kusama-rpc.polkadot.io --rpc wss://kusama-rpc.dwellir.com
   $ dot chain add westend --light-client
   $ dot chain default kusama
   $ dot chain list
@@ -798,6 +1016,8 @@ ${BOLD}Examples:${RESET}
 function registerChainCommands(cli) {
   cli.command("chain [action] [name]", "Manage chains (add, remove, update, list, default)").alias("chains").action(async (action, name, opts) => {
     if (!action) {
+      if (process.argv[2] === "chains")
+        return chainList();
       console.log(CHAIN_HELP);
       return;
     }
@@ -880,8 +1100,15 @@ async function chainList() {
   for (const [name, chainConfig] of Object.entries(config.chains)) {
     const isDefault = name === config.defaultChain;
     const marker = isDefault ? ` ${BOLD}(default)${RESET}` : "";
-    const provider = chainConfig.lightClient ? `${DIM}light-client${RESET}` : `${DIM}${chainConfig.rpc}${RESET}`;
-    console.log(`  ${CYAN}${name}${RESET}${marker}  ${provider}`);
+    if (chainConfig.lightClient) {
+      console.log(`  ${CYAN}${name}${RESET}${marker}  ${DIM}light-client${RESET}`);
+    } else {
+      const rpcs = Array.isArray(chainConfig.rpc) ? chainConfig.rpc : [chainConfig.rpc];
+      console.log(`  ${CYAN}${name}${RESET}${marker}  ${DIM}${rpcs[0]}${RESET}`);
+      for (let i = 1;i < rpcs.length; i++) {
+        console.log(`    ${DIM}${rpcs[i]}${RESET}`);
+      }
+    }
   }
   console.log();
 }
@@ -1816,7 +2043,7 @@ function registerTxCommand(cli) {
           }
         }
       }
-      const rpcUrl = opts.rpc ?? chainConfig.rpc;
+      const rpcUrl = primaryRpc(opts.rpc ?? chainConfig.rpc);
       if (rpcUrl) {
         const blockHash = result.block.hash;
         console.log(`  ${BOLD}Explorer:${RESET}`);
@@ -2492,7 +2719,7 @@ registerConstCommand(cli);
 registerAccountCommands(cli);
 registerTxCommand(cli);
 registerHashCommand(cli);
-cli.help();
+cli.option("--help, -h", "Display this message");
 cli.version(version);
 async function showUpdateAndExit(code) {
   await waitForPendingCheck();
@@ -2515,8 +2742,18 @@ async function handleError(err) {
 async function main() {
   try {
     cli.parse(process.argv, { run: false });
-    if (cli.options.version || cli.options.help) {
+    if (cli.options.version) {
       await showUpdateAndExit(0);
+    } else if (cli.options.help) {
+      if (cli.matchedCommandName) {
+        const result = cli.runMatchedCommand();
+        if (result && typeof result.then === "function") {
+          await result.then(() => showUpdateAndExit(0), handleError);
+        }
+      } else {
+        cli.outputHelp();
+        await showUpdateAndExit(0);
+      }
     } else if (!cli.matchedCommandName) {
       cli.outputHelp();
       await showUpdateAndExit(0);

package/package.json

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