aavegotchi-cli 0.2.0 → 0.2.2

package/CHANGELOG.md

@@ -1,5 +1,48 @@
 # Changelog
 
+## Unreleased
+
+## 0.2.2 - 2026-02-27
+
+### Added
+
+- Command-targeted help:
+  - `ag --help`
+  - `ag <command> --help`
+  - `ag help <command>`
+- Mapped-write help now includes mapped function name, required flags, and dry-run pattern.
+- ABI-derived signature/input introspection for mapped help when `--abi-file` is passed.
+- Unknown command suggestion list in `UNKNOWN_COMMAND` error details.
+- CLI UX audit report: `docs/ux/cli-ux-audit-2026-02-27.md`.
+- Native `bankr` signer backend:
+  - signer spec: `bankr[:address|apiKeyEnv|apiUrl]`
+  - default auth env var: `BANKR_API_KEY`
+  - default API URL: `https://api.bankr.bot`
+  - address auto-resolution via `GET /agent/me` when address is not pinned
+  - transaction submit via `POST /agent/submit`
+- Bootstrap overrides now support `bankr`:
+  - `--signer-address` to pin wallet address
+  - `--signer-auth-env-var` to customize Bankr API key env var
+
+### Changed
+
+- Stub namespace errors now include mapped command options for the requested root.
+
+## 0.2.1 - 2026-02-27
+
+### Added
+
+- `--dry-run` mode for write surfaces:
+  - `ag tx send --dry-run`
+  - `ag onchain send --dry-run`
+  - mapped writes (for example `ag token approve --dry-run`)
+- `scripts/smoke-write-dryrun.sh` and npm script `smoke:write-dryrun` for automated write-path smoke checks without broadcasting.
+
+### Changed
+
+- Dry-run execution now returns `status: "simulated"` with simulation details and skips journal mutation and transaction submission.
+- `--dry-run` is explicitly blocked with `--wait` / `--confirm`.
+
 ## 0.2.0 - 2026-02-27
 
 ### Added

package/README.md

@@ -55,6 +55,54 @@ Planned domain namespaces are stubbed for parity tracking:
 Many Base-era write flows are already executable as mapped aliases in those namespaces (internally routed through `onchain send`).
 Example: `ag lending create --abi-file ./abis/GotchiLendingFacet.json --address 0x... --args-json '[...]' --json`
 
+## Command help and discoverability
+
+The CLI supports command-targeted help:
+
+```bash
+ag --help
+ag tx send --help
+ag help baazaar buy-now
+```
+
+Mapped write commands now expose their onchain function mapping and required flags:
+
+```bash
+ag baazaar buy-now --help
+```
+
+If you provide `--abi-file` with `--help`, the CLI prints ABI-derived function signature and input names for the mapped method:
+
+```bash
+ag baazaar buy-now --help --abi-file ./abis/BaazaarFacet.json
+```
+
+Unknown commands return suggestions:
+
+```bash
+ag tx snd --json
+```
+
+## Dry-run writes
+
+Use `--dry-run` on write commands to run full preflight without broadcasting:
+
+- runs simulation (`eth_call`)
+- runs gas + fee estimation
+- enforces policy checks
+- resolves nonce
+- returns `status: \"simulated\"` with simulation details
+
+Supported write surfaces:
+
+- `tx send --dry-run`
+- `onchain send --dry-run`
+- mapped write aliases (for example: `token approve --dry-run`)
+
+Safety rule:
+
+- `--dry-run` cannot be combined with `--wait` / `--confirm`
+
 ## Subgraph sources and endpoint policy
 
 Canonical source aliases:
@@ -127,12 +175,26 @@ npm run ag -- auction active --first 5 --raw --json
 - `keychain:ACCOUNT_ID` (encrypted local key store; requires `AGCLI_KEYCHAIN_PASSPHRASE`)
 - `remote:URL|ADDRESS|AUTH_ENV` (HTTP signer service)
 - `ledger:DERIVATION_PATH|ADDRESS|BRIDGE_ENV` (external bridge command signer)
+- `bankr[:ADDRESS|API_KEY_ENV|API_URL]` (Bankr-native signer via `/agent/me` + `/agent/submit`; defaults: `BANKR_API_KEY`, `https://api.bankr.bot`)
 
 Remote signer contract:
 
 - `GET /address` -> `{ "address": "0x..." }` (optional if address configured)
 - `POST /sign-transaction` -> `{ "rawTransaction": "0x..." }` or `{ "txHash": "0x..." }`
 
+Bankr signer contract:
+
+- `GET /agent/me` -> resolves wallet address when signer address is not pinned
+- `POST /agent/submit` -> submits transaction and returns transaction hash
+- auth header: `x-api-key: <BANKR_API_KEY>`
+
+Bankr bootstrap example:
+
+```bash
+BANKR_API_KEY=... \
+npm run ag -- bootstrap --mode agent --profile bankr --chain base --signer bankr --json
+```
+
 Ledger bridge contract:
 
 - Set `AGCLI_LEDGER_BRIDGE_CMD` (or custom env var in signer config) to a command that reads tx payload JSON from stdin and outputs JSON containing either `rawTransaction` or `txHash`.
@@ -186,5 +248,12 @@ npm run typecheck
 npm test
 npm run build
 npm run parity:check
+npm run smoke:write-dryrun
 npm run ag -- help
 ```
+
+Write dry-run smoke test notes:
+
+- `npm run smoke:write-dryrun` validates write paths without broadcasting any transaction.
+- To run against an installed binary instead of local source:
+  - `AG_BIN=/absolute/path/to/ag npm run smoke:write-dryrun`

package/dist/abi.js

@@ -0,0 +1,88 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseAbiFile = parseAbiFile;
+exports.getAbiFunctionEntries = getAbiFunctionEntries;
+exports.formatAbiFunctionSignature = formatAbiFunctionSignature;
+exports.formatAbiFunctionInputs = formatAbiFunctionInputs;
+const fs = __importStar(require("fs"));
+const errors_1 = require("./errors");
+function normalizeTypeName(item) {
+    if (!item.type) {
+        return "unknown";
+    }
+    if (!item.type.includes("tuple")) {
+        return item.type;
+    }
+    const components = item.components || [];
+    const componentTypes = components.map((component) => component.type).join(",");
+    return item.type.replace("tuple", `tuple(${componentTypes})`);
+}
+function parseAbiFile(filePath) {
+    if (!fs.existsSync(filePath)) {
+        throw new errors_1.CliError("ABI_NOT_FOUND", `ABI file not found: ${filePath}`, 2);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(fs.readFileSync(filePath, "utf8"));
+    }
+    catch {
+        throw new errors_1.CliError("INVALID_ABI", `ABI file is not valid JSON: ${filePath}`, 2);
+    }
+    if (Array.isArray(parsed)) {
+        return parsed;
+    }
+    if (typeof parsed === "object" && parsed !== null && "abi" in parsed && Array.isArray(parsed.abi)) {
+        return parsed.abi;
+    }
+    throw new errors_1.CliError("INVALID_ABI", "ABI file must be an array or object containing 'abi'.", 2);
+}
+function getAbiFunctionEntries(abi, functionName) {
+    return abi.filter((item) => item.type === "function" && typeof item.name === "string" && item.name === functionName);
+}
+function formatAbiFunctionSignature(item) {
+    const inputTypes = (item.inputs || []).map((input) => normalizeTypeName(input));
+    return `${item.name}(${inputTypes.join(",")})`;
+}
+function formatAbiFunctionInputs(item) {
+    const inputs = item.inputs || [];
+    if (inputs.length === 0) {
+        return ["(none)"];
+    }
+    return inputs.map((input, index) => {
+        const label = input.name ? input.name : `arg${index}`;
+        return `${index}: ${label} (${normalizeTypeName(input)})`;
+    });
+}

package/dist/command-catalog.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listKnownCommands = listKnownCommands;
+exports.suggestCommands = suggestCommands;
+const mapped_1 = require("./commands/mapped");
+const stubs_1 = require("./commands/stubs");
+const BUILTIN_COMMANDS = [
+    "help",
+    "bootstrap",
+    "profile list",
+    "profile show",
+    "profile use",
+    "profile export",
+    "signer check",
+    "signer keychain list",
+    "signer keychain import",
+    "signer keychain remove",
+    "policy list",
+    "policy show",
+    "policy upsert",
+    "rpc check",
+    "tx send",
+    "tx status",
+    "tx resume",
+    "tx watch",
+    "batch run",
+    "onchain call",
+    "onchain send",
+    "subgraph list",
+    "subgraph check",
+    "subgraph query",
+    "baazaar listing get",
+    "baazaar listing active",
+    "baazaar listing mine",
+    "auction get",
+    "auction active",
+    "auction mine",
+    "auction bids",
+    "auction bids-mine",
+];
+function listDomainReadCommands() {
+    return (0, stubs_1.listDomainStubRoots)().map((root) => `${root} read`);
+}
+function levenshteinDistance(a, b) {
+    if (a === b) {
+        return 0;
+    }
+    if (a.length === 0) {
+        return b.length;
+    }
+    if (b.length === 0) {
+        return a.length;
+    }
+    const previous = new Array(b.length + 1).fill(0).map((_, index) => index);
+    const current = new Array(b.length + 1).fill(0);
+    for (let i = 1; i <= a.length; i++) {
+        current[0] = i;
+        for (let j = 1; j <= b.length; j++) {
+            const substitutionCost = a[i - 1] === b[j - 1] ? 0 : 1;
+            current[j] = Math.min(current[j - 1] + 1, previous[j] + 1, previous[j - 1] + substitutionCost);
+        }
+        for (let j = 0; j <= b.length; j++) {
+            previous[j] = current[j];
+        }
+    }
+    return previous[b.length];
+}
+function listKnownCommands() {
+    return [
+        ...BUILTIN_COMMANDS,
+        ...listDomainReadCommands(),
+        ...(0, mapped_1.listMappedCommands)(),
+    ];
+}
+function suggestCommands(input, max = 5) {
+    const query = input.trim().toLowerCase();
+    if (!query) {
+        return [];
+    }
+    const scored = listKnownCommands().map((command) => {
+        const normalized = command.toLowerCase();
+        const startsWith = normalized.startsWith(query);
+        const includes = normalized.includes(query);
+        const distance = levenshteinDistance(query, normalized);
+        let score = distance;
+        if (startsWith) {
+            score = 0;
+        }
+        else if (includes) {
+            score = Math.min(score, 1);
+        }
+        return { command, score };
+    });
+    scored.sort((a, b) => {
+        if (a.score !== b.score) {
+            return a.score - b.score;
+        }
+        return a.command.localeCompare(b.command);
+    });
+    const threshold = Math.max(2, Math.floor(query.length / 2) + 1);
+    const filtered = scored.filter((entry) => entry.score <= threshold);
+    const results = (filtered.length > 0 ? filtered : scored).slice(0, max).map((entry) => entry.command);
+    return [...new Set(results)];
+}

package/dist/command-runner.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.normalizeCommandPath = normalizeCommandPath;
 exports.executeCommand = executeCommand;
 const errors_1 = require("./errors");
+const command_catalog_1 = require("./command-catalog");
 const batch_1 = require("./commands/batch");
 const bootstrap_1 = require("./commands/bootstrap");
 const mapped_1 = require("./commands/mapped");
@@ -17,9 +18,12 @@ const stubs_1 = require("./commands/stubs");
 const subgraph_1 = require("./commands/subgraph");
 const tx_1 = require("./commands/tx");
 function normalizeCommandPath(positionals) {
-    if (positionals.length === 0 || positionals[0] === "help") {
+    if (positionals.length === 0) {
         return ["help"];
     }
+    if (positionals[0] === "help") {
+        return positionals;
+    }
     return positionals;
 }
 async function executeCommand(ctx) {
@@ -220,5 +224,11 @@ async function executeCommand(ctx) {
             data: await (0, stubs_1.runDomainStubCommand)(ctx),
         };
     }
-    throw new errors_1.CliError("UNKNOWN_COMMAND", `Unknown command '${ctx.commandPath.join(" ")}'.`, 2);
+    const command = ctx.commandPath.join(" ");
+    const suggestions = (0, command_catalog_1.suggestCommands)(command);
+    throw new errors_1.CliError("UNKNOWN_COMMAND", `Unknown command '${command}'.`, 2, {
+        command,
+        suggestions,
+        hint: suggestions.length > 0 ? "Try one of the suggested commands with '--help'." : "Run 'ag help'.",
+    });
 }

package/dist/commands/bootstrap.js

@@ -26,6 +26,15 @@ function buildSignerConfig(ctx, signerInput) {
             ...(authEnvVar ? { authEnvVar } : {}),
         };
     }
+    if (signer.type === "bankr") {
+        const address = (0, args_1.getFlagString)(ctx.args.flags, "signer-address");
+        const apiKeyEnvVar = (0, args_1.getFlagString)(ctx.args.flags, "signer-auth-env-var");
+        return {
+            ...signer,
+            ...(address ? { address: address } : {}),
+            ...(apiKeyEnvVar ? { apiKeyEnvVar } : {}),
+        };
+    }
     if (signer.type === "ledger") {
         const address = (0, args_1.getFlagString)(ctx.args.flags, "signer-address");
         const bridgeCommandEnvVar = (0, args_1.getFlagString)(ctx.args.flags, "signer-bridge-env-var");

package/dist/commands/mapped.js

@@ -1,7 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.findMappedFunction = findMappedFunction;
+exports.listMappedCommands = listMappedCommands;
 exports.listMappedCommandsForRoot = listMappedCommandsForRoot;
+exports.getMappedCommandEntries = getMappedCommandEntries;
 exports.runMappedDomainCommand = runMappedDomainCommand;
 const errors_1 = require("../errors");
 const onchain_1 = require("./onchain");
@@ -50,8 +52,14 @@ function findMappedFunction(commandPath) {
     const key = commandPath.join(" ");
     return MAPPED_WRITE_COMMANDS[key];
 }
+function listMappedCommands() {
+    return Object.keys(MAPPED_WRITE_COMMANDS).sort((a, b) => a.localeCompare(b));
+}
 function listMappedCommandsForRoot(root) {
-    return Object.keys(MAPPED_WRITE_COMMANDS).filter((entry) => entry.startsWith(`${root} `));
+    return listMappedCommands().filter((entry) => entry.startsWith(`${root} `));
+}
+function getMappedCommandEntries() {
+    return { ...MAPPED_WRITE_COMMANDS };
 }
 async function runMappedDomainCommand(ctx) {
     const key = ctx.commandPath.join(" ");

package/dist/commands/onchain.js

@@ -1,44 +1,11 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runOnchainCallCommand = runOnchainCallCommand;
 exports.runOnchainSendWithFunction = runOnchainSendWithFunction;
 exports.runOnchainSendCommand = runOnchainSendCommand;
-const fs = __importStar(require("fs"));
 const viem_1 = require("viem");
 const args_1 = require("../args");
+const abi_1 = require("../abi");
 const chains_1 = require("../chains");
 const config_1 = require("../config");
 const errors_1 = require("../errors");
@@ -66,25 +33,6 @@ function parseArgsJson(value) {
     }
     return parsed;
 }
-function parseAbiFile(filePath) {
-    if (!fs.existsSync(filePath)) {
-        throw new errors_1.CliError("ABI_NOT_FOUND", `ABI file not found: ${filePath}`, 2);
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(fs.readFileSync(filePath, "utf8"));
-    }
-    catch {
-        throw new errors_1.CliError("INVALID_ABI", `ABI file is not valid JSON: ${filePath}`, 2);
-    }
-    if (Array.isArray(parsed)) {
-        return parsed;
-    }
-    if (typeof parsed === "object" && parsed !== null && "abi" in parsed && Array.isArray(parsed.abi)) {
-        return parsed.abi;
-    }
-    throw new errors_1.CliError("INVALID_ABI", `ABI file must be an array or object containing 'abi'.`, 2);
-}
 function parseValueWei(value) {
     if (!value) {
         return undefined;
@@ -123,7 +71,7 @@ async function runOnchainCallCommand(ctx) {
     const chain = (0, chains_1.resolveChain)(profile.chain);
     const rpcUrl = (0, chains_1.resolveRpcUrl)(chain, (0, args_1.getFlagString)(ctx.args.flags, "rpc-url") || profile.rpcUrl);
     const abiFile = requireFlag((0, args_1.getFlagString)(ctx.args.flags, "abi-file"), "--abi-file");
-    const abi = parseAbiFile(abiFile);
+    const abi = (0, abi_1.parseAbiFile)(abiFile);
     const address = parseAddress((0, args_1.getFlagString)(ctx.args.flags, "address"), "--address");
     const functionName = requireFlag((0, args_1.getFlagString)(ctx.args.flags, "function"), "--function");
     const args = parseArgsJson((0, args_1.getFlagString)(ctx.args.flags, "args-json"));
@@ -162,7 +110,7 @@ async function runOnchainSendWithFunction(ctx, forcedFunctionName, commandOverri
     const chain = (0, chains_1.resolveChain)(profile.chain);
     const rpcUrl = (0, chains_1.resolveRpcUrl)(chain, (0, args_1.getFlagString)(ctx.args.flags, "rpc-url") || profile.rpcUrl);
     const abiFile = requireFlag((0, args_1.getFlagString)(ctx.args.flags, "abi-file"), "--abi-file");
-    const abi = parseAbiFile(abiFile);
+    const abi = (0, abi_1.parseAbiFile)(abiFile);
     const address = parseAddress((0, args_1.getFlagString)(ctx.args.flags, "address"), "--address");
     const functionName = forcedFunctionName || requireFlag((0, args_1.getFlagString)(ctx.args.flags, "function"), "--function");
     const args = parseArgsJson((0, args_1.getFlagString)(ctx.args.flags, "args-json"));
@@ -184,6 +132,10 @@ async function runOnchainSendWithFunction(ctx, forcedFunctionName, commandOverri
         });
     }
     const waitForReceipt = (0, args_1.getFlagBoolean)(ctx.args.flags, "wait");
+    const dryRun = (0, args_1.getFlagBoolean)(ctx.args.flags, "dry-run");
+    if (dryRun && waitForReceipt) {
+        throw new errors_1.CliError("INVALID_ARGUMENT", "--dry-run cannot be combined with --wait.", 2);
+    }
     const intent = {
         idempotencyKey: (0, args_1.getFlagString)(ctx.args.flags, "idempotency-key"),
         profileName: profile.name,
@@ -197,6 +149,7 @@ async function runOnchainSendWithFunction(ctx, forcedFunctionName, commandOverri
         noncePolicy: noncePolicyRaw,
         nonce,
         waitForReceipt,
+        dryRun,
         timeoutMs: parseTimeoutMs((0, args_1.getFlagString)(ctx.args.flags, "timeout-ms")),
         command: commandOverride || `onchain send ${functionName}`,
     };

package/dist/commands/stubs.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isDomainStubRoot = isDomainStubRoot;
+exports.listDomainStubRoots = listDomainStubRoots;
 exports.runDomainStubCommand = runDomainStubCommand;
 const errors_1 = require("../errors");
+const mapped_1 = require("./mapped");
 const SUPPORTED_STUB_ROOTS = [
     "gotchi",
     "portal",
@@ -22,11 +24,17 @@ const SUPPORTED_STUB_ROOTS = [
 function isDomainStubRoot(root) {
     return SUPPORTED_STUB_ROOTS.includes(root);
 }
+function listDomainStubRoots() {
+    return SUPPORTED_STUB_ROOTS;
+}
 async function runDomainStubCommand(ctx) {
     const command = ctx.commandPath.join(" ");
+    const root = ctx.commandPath[0];
+    const availableMapped = (0, mapped_1.listMappedCommandsForRoot)(root);
     throw new errors_1.CliError("COMMAND_NOT_IMPLEMENTED", `Command '${command}' is planned but not implemented yet.`, 2, {
         command,
-        hint: "If this is a mapped onchain write, pass full subcommand plus --abi-file/--address/--args-json.",
+        hint: "Run 'ag help <command>' for usage. Mapped writes require --abi-file/--address/--args-json.",
+        availableMapped,
         plannedRoots: SUPPORTED_STUB_ROOTS,
     });
 }

package/dist/commands/tx.js

@@ -75,10 +75,14 @@ async function runTxSendCommand(ctx) {
     const nonceValue = (0, args_1.getFlagString)(ctx.args.flags, "nonce");
     const nonce = nonceValue ? parseNumberFlag(nonceValue, "--nonce", 0) : undefined;
     const waitForReceipt = (0, args_1.getFlagBoolean)(ctx.args.flags, "wait") || (0, args_1.getFlagBoolean)(ctx.args.flags, "confirm");
+    const dryRun = (0, args_1.getFlagBoolean)(ctx.args.flags, "dry-run");
     const timeoutMs = parseNumberFlag((0, args_1.getFlagString)(ctx.args.flags, "timeout-ms"), "--timeout-ms", 120000);
     if (noncePolicy === "manual" && nonce === undefined) {
         throw new errors_1.CliError("MISSING_NONCE", "--nonce is required when --nonce-policy=manual.", 2);
     }
+    if (dryRun && waitForReceipt) {
+        throw new errors_1.CliError("INVALID_ARGUMENT", "--dry-run cannot be combined with --wait/--confirm.", 2);
+    }
     const intent = {
         idempotencyKey,
         profileName: profile.name,
@@ -92,6 +96,7 @@ async function runTxSendCommand(ctx) {
         noncePolicy,
         nonce,
         waitForReceipt,
+        dryRun,
         timeoutMs,
         command: "tx send",
     };

package/dist/index.js

@@ -11,8 +11,13 @@ async function run() {
     const globals = (0, args_1.normalizeGlobals)(args);
     (0, logger_1.initializeLogger)(globals);
     const commandPath = (0, command_runner_1.normalizeCommandPath)(args.positionals);
+    const helpRequested = (0, args_1.getFlagBoolean)(args.flags, "help", "h");
     if (commandPath[0] === "help") {
-        (0, output_1.outputHelp)();
+        (0, output_1.outputHelp)(commandPath.slice(1), args.flags);
+        return;
+    }
+    if (helpRequested) {
+        (0, output_1.outputHelp)(commandPath, args.flags);
         return;
     }
     const ctx = {