aavegotchi-cli 0.2.1 → 0.2.2

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # 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

package/README.md

@@ -55,6 +55,34 @@ 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:
@@ -147,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`.

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"));

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/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 = {

package/dist/output.js

@@ -1,8 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildHelpText = buildHelpText;
 exports.outputSuccess = outputSuccess;
 exports.outputError = outputError;
 exports.outputHelp = outputHelp;
+const args_1 = require("./args");
+const abi_1 = require("./abi");
+const command_catalog_1 = require("./command-catalog");
+const mapped_1 = require("./commands/mapped");
+const stubs_1 = require("./commands/stubs");
 function stringifyWithBigInt(input) {
     return JSON.stringify(input, (_, value) => {
         if (typeof value === "bigint") {
@@ -17,6 +23,397 @@ function buildMeta(mode) {
         mode,
     };
 }
+function toLines(items, prefix = "  ") {
+    if (items.length === 0) {
+        return `${prefix}(none)`;
+    }
+    return items.map((item) => `${prefix}${item}`).join("\n");
+}
+function buildGlobalHelpText() {
+    return `
+Aavegotchi CLI (agent-first foundation)
+
+Usage:
+  ag <command> [options]
+  ag <command> --help
+  ag help <command>
+
+Core commands:
+  bootstrap
+  profile list|show|use|export
+  signer check
+  signer keychain list|import|remove
+  policy list|show|upsert
+  rpc check
+
+Tx commands:
+  tx send|status|resume|watch
+
+Automation commands:
+  batch run --file plan.yaml
+
+Power-user commands:
+  onchain call|send
+  subgraph list|check|query
+
+Subgraph wrappers:
+  baazaar listing get|active|mine
+  auction get|active|mine|bids|bids-mine
+
+Domain namespaces:
+  gotchi, portal, wearables, items, inventory, baazaar, auction, lending, staking, gotchi-points, realm, alchemica, forge, token
+  (many write flows are mapped aliases that route through onchain send)
+
+Global flags:
+  --mode <agent|human>   Agent mode implies --json --yes
+  --json, -j             Emit JSON envelope output
+  --yes, -y              Skip prompts
+  --profile NAME         Select profile globally
+  --help, -h             Show command-specific help
+
+Examples:
+  ag bootstrap --profile prod --chain base --signer readonly --json
+  ag tx send --profile prod --to 0xabc... --value-wei 0 --dry-run --json
+  ag onchain send --profile prod --abi-file ./abi.json --address 0xabc... --function approve --args-json '["0xdef...", "1"]' --dry-run --json
+  BANKR_API_KEY=... ag bootstrap --profile bankr --chain base --signer bankr --json
+  ag baazaar buy-now --help
+  ag help tx send
+`;
+}
+const STATIC_HELP = {
+    bootstrap: `
+Usage:
+  ag bootstrap --profile <name> [--chain <base|base-sepolia|id>] [--rpc-url <url>] [--signer <config>] [--policy <name>] [--skip-signer-check] [--json]
+
+Required:
+  --profile <name>
+
+Signer formats:
+  readonly
+  env:ENV_VAR
+  keychain:ACCOUNT_ID
+  ledger[:DERIVATION_PATH|ADDRESS|BRIDGE_ENV_VAR]
+  remote:URL|ADDRESS|AUTH_ENV_VAR
+  bankr[:ADDRESS|API_KEY_ENV|API_URL]
+`,
+    profile: `
+Usage:
+  ag profile list [--json]
+  ag profile show [--profile <name>] [--json]
+  ag profile use --profile <name> [--json]
+  ag profile export [--profile <name>] [--json]
+`,
+    "profile list": `
+Usage:
+  ag profile list [--json]
+`,
+    "profile show": `
+Usage:
+  ag profile show [--profile <name>] [--json]
+`,
+    "profile use": `
+Usage:
+  ag profile use --profile <name> [--json]
+`,
+    "profile export": `
+Usage:
+  ag profile export [--profile <name>] [--json]
+`,
+    signer: `
+Usage:
+  ag signer check [--profile <name>] [--json]
+  ag signer keychain list [--json]
+  ag signer keychain import --account-id <id> --private-key-env <ENV> [--json]
+  ag signer keychain remove --account-id <id> [--json]
+`,
+    "signer check": `
+Usage:
+  ag signer check [--profile <name>] [--json]
+`,
+    "signer keychain": `
+Usage:
+  ag signer keychain list [--json]
+  ag signer keychain import --account-id <id> --private-key-env <ENV> [--json]
+  ag signer keychain remove --account-id <id> [--json]
+`,
+    "signer keychain list": `
+Usage:
+  ag signer keychain list [--json]
+`,
+    "signer keychain import": `
+Usage:
+  ag signer keychain import --account-id <id> --private-key-env <ENV> [--json]
+`,
+    "signer keychain remove": `
+Usage:
+  ag signer keychain remove --account-id <id> [--json]
+`,
+    policy: `
+Usage:
+  ag policy list [--json]
+  ag policy show --policy <name> [--json]
+  ag policy upsert --policy <name> [--max-value-wei <wei>] [--max-gas-limit <gas>] [--max-fee-per-gas-wei <wei>] [--max-priority-fee-per-gas-wei <wei>] [--allowed-to <0x...,0x...>] [--json]
+`,
+    "policy list": `
+Usage:
+  ag policy list [--json]
+`,
+    "policy show": `
+Usage:
+  ag policy show --policy <name> [--json]
+`,
+    "policy upsert": `
+Usage:
+  ag policy upsert --policy <name> [policy flags...] [--json]
+`,
+    rpc: `
+Usage:
+  ag rpc check [--profile <name>] [--rpc-url <url>] [--json]
+`,
+    "rpc check": `
+Usage:
+  ag rpc check [--profile <name>] [--rpc-url <url>] [--json]
+`,
+    tx: `
+Usage:
+  ag tx send --to <0x...> [--value-wei <wei>] [--data <0x...>] [--profile <name>] [--nonce-policy <safe|replace|manual>] [--nonce <n>] [--dry-run] [--wait|--confirm] [--timeout-ms <ms>] [--json]
+  ag tx status [--idempotency-key <key> | --tx-hash <0x...> | --limit <n>] [--json]
+  ag tx resume --idempotency-key <key> [--profile <name>] [--timeout-ms <ms>] [--json]
+  ag tx watch --idempotency-key <key> [--interval-ms <ms>] [--timeout-ms <ms>] [--json]
+
+Notes:
+  --dry-run cannot be combined with --wait/--confirm.
+`,
+    "tx send": `
+Usage:
+  ag tx send --to <0x...> [--value-wei <wei>] [--data <0x...>] [--profile <name>] [--dry-run] [--wait|--confirm] [--json]
+`,
+    "tx status": `
+Usage:
+  ag tx status [--idempotency-key <key> | --tx-hash <0x...> | --limit <n>] [--json]
+`,
+    "tx resume": `
+Usage:
+  ag tx resume --idempotency-key <key> [--profile <name>] [--timeout-ms <ms>] [--json]
+`,
+    "tx watch": `
+Usage:
+  ag tx watch --idempotency-key <key> [--interval-ms <ms>] [--timeout-ms <ms>] [--json]
+`,
+    onchain: `
+Usage:
+  ag onchain call --profile <name> --abi-file <path> --address <0x...> --function <name> [--args-json '[...]'] [--json]
+  ag onchain send --profile <name> --abi-file <path> --address <0x...> --function <name> [--args-json '[...]'] [--value-wei <wei>] [--nonce-policy <safe|replace|manual>] [--nonce <n>] [--dry-run] [--wait] [--json]
+`,
+    "onchain call": `
+Usage:
+  ag onchain call --profile <name> --abi-file <path> --address <0x...> --function <name> [--args-json '[...]'] [--json]
+`,
+    "onchain send": `
+Usage:
+  ag onchain send --profile <name> --abi-file <path> --address <0x...> --function <name> [--args-json '[...]'] [--value-wei <wei>] [--nonce-policy <safe|replace|manual>] [--nonce <n>] [--dry-run] [--wait] [--json]
+
+Required:
+  --abi-file
+  --address
+  --function
+  --profile (or active profile)
+
+Notes:
+  --dry-run cannot be combined with --wait.
+`,
+    subgraph: `
+Usage:
+  ag subgraph list [--json]
+  ag subgraph check --source <core-base|gbm-base> [--timeout-ms <ms>] [--raw] [--json]
+  ag subgraph query --source <core-base|gbm-base> (--query <graphql> | --query-file <path>) [--variables-json '{...}'] [--timeout-ms <ms>] [--raw] [--json]
+`,
+    "subgraph list": `
+Usage:
+  ag subgraph list [--json]
+`,
+    "subgraph check": `
+Usage:
+  ag subgraph check --source <core-base|gbm-base> [--timeout-ms <ms>] [--raw] [--json]
+`,
+    "subgraph query": `
+Usage:
+  ag subgraph query --source <core-base|gbm-base> (--query <graphql> | --query-file <path>) [--variables-json '{...}'] [--timeout-ms <ms>] [--raw] [--json]
+`,
+    batch: `
+Usage:
+  ag batch run --file <plan.yaml> [--json]
+`,
+    "batch run": `
+Usage:
+  ag batch run --file <plan.yaml> [--json]
+`,
+    baazaar: `
+Usage:
+  ag baazaar listing get --kind <erc721|erc1155> --id <listingId> [--verify-onchain] [--json]
+  ag baazaar listing active --kind <erc721|erc1155> [--first <n>] [--skip <n>] [--json]
+  ag baazaar listing mine --kind <erc721|erc1155> --seller <0x...> [--first <n>] [--skip <n>] [--json]
+  ag baazaar <mapped-write> --help
+`,
+    "baazaar listing": `
+Usage:
+  ag baazaar listing get --kind <erc721|erc1155> --id <listingId> [--verify-onchain] [--json]
+  ag baazaar listing active --kind <erc721|erc1155> [--first <n>] [--skip <n>] [--json]
+  ag baazaar listing mine --kind <erc721|erc1155> --seller <0x...> [--first <n>] [--skip <n>] [--json]
+`,
+    "baazaar listing get": `
+Usage:
+  ag baazaar listing get --kind <erc721|erc1155> --id <listingId> [--verify-onchain] [--json]
+`,
+    "baazaar listing active": `
+Usage:
+  ag baazaar listing active --kind <erc721|erc1155> [--first <n>] [--skip <n>] [--json]
+`,
+    "baazaar listing mine": `
+Usage:
+  ag baazaar listing mine --kind <erc721|erc1155> --seller <0x...> [--first <n>] [--skip <n>] [--json]
+`,
+    auction: `
+Usage:
+  ag auction get --id <auctionId> [--verify-onchain] [--json]
+  ag auction active [--first <n>] [--skip <n>] [--at-time <unixSec>] [--json]
+  ag auction mine --seller <0x...> [--first <n>] [--skip <n>] [--at-time <unixSec>] [--json]
+  ag auction bids --auction-id <auctionId> [--first <n>] [--skip <n>] [--json]
+  ag auction bids-mine --bidder <0x...> [--first <n>] [--skip <n>] [--json]
+  ag auction <mapped-write> --help
+`,
+    "auction get": `
+Usage:
+  ag auction get --id <auctionId> [--verify-onchain] [--json]
+`,
+    "auction active": `
+Usage:
+  ag auction active [--first <n>] [--skip <n>] [--at-time <unixSec>] [--json]
+`,
+    "auction mine": `
+Usage:
+  ag auction mine --seller <0x...> [--first <n>] [--skip <n>] [--at-time <unixSec>] [--json]
+`,
+    "auction bids": `
+Usage:
+  ag auction bids --auction-id <auctionId> [--first <n>] [--skip <n>] [--json]
+`,
+    "auction bids-mine": `
+Usage:
+  ag auction bids-mine --bidder <0x...> [--first <n>] [--skip <n>] [--json]
+`,
+};
+function buildDomainRootHelp(root) {
+    const mapped = (0, mapped_1.listMappedCommandsForRoot)(root);
+    return `
+Usage:
+  ag ${root} read --profile <name> --abi-file <path> --address <0x...> --function <name> [--args-json '[...]'] [--json]
+  ag ${root} <mapped-write> --help
+
+Mapped writes for '${root}':
+${toLines(mapped)}
+`;
+}
+function buildMappedCommandHelp(commandPath, flags) {
+    const command = commandPath.join(" ");
+    const method = (0, mapped_1.findMappedFunction)(commandPath);
+    if (!method) {
+        return "";
+    }
+    const abiFile = (0, args_1.getFlagString)(flags, "abi-file");
+    const signatureLines = [];
+    const inputLines = [];
+    if (abiFile) {
+        try {
+            const abi = (0, abi_1.parseAbiFile)(abiFile);
+            const entries = (0, abi_1.getAbiFunctionEntries)(abi, method);
+            if (entries.length === 0) {
+                signatureLines.push(`No function named '${method}' found in '${abiFile}'.`);
+            }
+            else {
+                for (const entry of entries) {
+                    signatureLines.push((0, abi_1.formatAbiFunctionSignature)(entry));
+                    inputLines.push(...(0, abi_1.formatAbiFunctionInputs)(entry));
+                }
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Unable to parse ABI file.";
+            signatureLines.push(`Could not inspect ABI file '${abiFile}': ${message}`);
+        }
+    }
+    else {
+        signatureLines.push("Pass --abi-file <path> with --help to print exact ABI-derived signature and input names.");
+    }
+    return `
+Usage:
+  ag ${command} --profile <name> --abi-file <path> --address <0x...> --args-json '[...]' [--value-wei <wei>] [--nonce-policy <safe|replace|manual>] [--nonce <n>] [--dry-run] [--wait] [--json]
+
+Mapped to onchain function:
+  ${method}
+
+Required flags:
+  --abi-file
+  --address
+  --args-json
+  --profile (or active profile)
+
+Dry-run example:
+  ag ${command} --profile prod --abi-file ./abi.json --address 0xabc... --args-json '[<arg0>,<arg1>]' --dry-run --json
+
+ABI signature info:
+${toLines(signatureLines)}
+
+ABI inputs:
+${toLines(inputLines)}
+`;
+}
+function buildUnknownHelpText(commandPath) {
+    const command = commandPath.join(" ");
+    const suggestions = (0, command_catalog_1.suggestCommands)(command);
+    const suggestionBlock = suggestions.length
+        ? `\nSuggested commands:\n${toLines(suggestions)}`
+        : "";
+    return `No command-specific help found for '${command}'.${suggestionBlock}
+
+Use 'ag help' for the full command surface.
+`;
+}
+function normalizeHelpPath(commandPath) {
+    return commandPath.map((part) => part.trim()).filter(Boolean);
+}
+function buildHelpText(commandPath = [], flags = {}) {
+    const target = normalizeHelpPath(commandPath);
+    if (target.length === 0) {
+        return buildGlobalHelpText().trim();
+    }
+    const mappedHelp = buildMappedCommandHelp(target, flags);
+    if (mappedHelp) {
+        return mappedHelp.trim();
+    }
+    const key = target.join(" ");
+    if (STATIC_HELP[key]) {
+        return STATIC_HELP[key].trim();
+    }
+    if (target.length === 1 && (0, stubs_1.isDomainStubRoot)(target[0])) {
+        return buildDomainRootHelp(target[0]).trim();
+    }
+    if (target.length > 1 && (0, stubs_1.isDomainStubRoot)(target[0])) {
+        const root = target[0];
+        const mapped = (0, mapped_1.listMappedCommandsForRoot)(root);
+        return `
+No direct help entry for '${key}'.
+
+Mapped writes under '${root}':
+${toLines(mapped)}
+
+Try:
+  ag ${root} --help
+  ag ${root} read --help
+`.trim();
+    }
+    return buildUnknownHelpText(target).trim();
+}
 function outputSuccess(command, data, globals) {
     if (globals.json) {
         const envelope = {
@@ -53,70 +450,6 @@ function outputError(command, error, globals) {
         console.error(stringifyWithBigInt(error.details));
     }
 }
-function outputHelp() {
-    console.log(`
-Aavegotchi CLI (agent-first foundation)
-
-Usage:
-  ag <command> [options]
-
-Core commands:
-  bootstrap                         Create/update and activate a profile with RPC/signer preflight
-  profile list|show|use|export      Manage profiles
-  signer check                      Verify active profile signer backend and account readiness
-  signer keychain list|import|remove
-  policy list|show|upsert           Manage transaction policies
-  rpc check                          Verify RPC connectivity + signer backend health
-
-Tx commands:
-  tx send                            Send a raw EVM transaction (or simulate only with --dry-run)
-  tx status                          Read tx status by idempotency key/hash or list recent
-  tx resume                          Resume waiting for a previously submitted tx
-  tx watch                           Poll journal until tx is confirmed
-
-Automation commands:
-  batch run --file plan.yaml         Run a YAML execution plan (dependency-aware)
-
-Power-user commands:
-  onchain call                       Call any ABI function from --abi-file
-  onchain send                       Send any ABI function as a transaction (or simulate with --dry-run)
-  subgraph list|check|query          List/check/query canonical Goldsky subgraphs
-
-Domain namespaces:
-  gotchi, portal, wearables, items, inventory, baazaar, auction, lending, staking, gotchi-points, realm, alchemica, forge, token
-  (many write flows are mapped to onchain send aliases; unmatched commands return typed not-implemented)
-
-Subgraph wrappers:
-  baazaar listing get|active|mine    Read Baazaar listing data from core-base subgraph
-  auction get|active|mine|bids|bids-mine
-                                     Read GBM auction/bid data from gbm-base subgraph
-
-Global flags:
-  --mode <agent|human>               Agent mode implies --json --yes
-  --json, -j                         Emit JSON envelope output
-  --yes, -y                          Skip prompts (write commands assume explicit flags)
-  --profile NAME                     Select profile globally
-
-Bootstrap flags:
-  --profile NAME                     Profile to create or update (required)
-  --chain base|base-sepolia|<id>     Chain key or numeric chain id (default: base)
-  --rpc-url URL                      RPC endpoint (optional when chain preset exists)
-  --signer readonly|env:VAR|keychain:<id>|ledger[:path|address|bridgeEnv]|remote:<url|address|authEnv>
-  --signer-address 0x...             Optional override for remote/ledger signer address
-  --signer-auth-env-var ENV_VAR      Optional remote signer bearer token env var
-  --signer-bridge-env-var ENV_VAR    Optional ledger bridge command env var name
-  --policy NAME                      Policy label (default: default)
-  --skip-signer-check                Persist signer config without backend validation
-
-Examples:
-  ag bootstrap --mode agent --profile prod --chain base --signer env:AGCLI_PRIVATE_KEY --json
-  AGCLI_KEYCHAIN_PASSPHRASE=... AGCLI_PRIVATE_KEY=0x... ag signer keychain import --account-id bot --private-key-env AGCLI_PRIVATE_KEY --json
-  ag tx send --profile prod --to 0xabc... --value-wei 1000000000000000 --wait --json
-  ag tx send --profile prod --to 0xabc... --value-wei 0 --dry-run --json
-  ag subgraph check --source core-base --json
-  ag baazaar listing active --kind erc721 --first 20 --json
-  ag auction active --first 20 --json
-  ag lending create --profile prod --abi-file ./abis/GotchiLendingFacet.json --address 0xabc... --args-json '[...]' --json
-  ag batch run --file ./plan.yaml --json
-`);
+function outputHelp(commandPath = [], flags = {}) {
+    console.log(buildHelpText(commandPath, flags));
 }

package/dist/schemas.js

@@ -22,6 +22,12 @@ exports.signerSchema = zod_1.z.discriminatedUnion("type", [
         address: addressSchema.optional(),
         authEnvVar: zod_1.z.string().regex(/^[A-Z_][A-Z0-9_]*$/).optional(),
     }),
+    zod_1.z.object({
+        type: zod_1.z.literal("bankr"),
+        address: addressSchema.optional(),
+        apiKeyEnvVar: zod_1.z.string().regex(/^[A-Z_][A-Z0-9_]*$/).optional(),
+        apiUrl: zod_1.z.string().url().optional(),
+    }),
 ]);
 exports.policySchema = zod_1.z.object({
     name: zod_1.z.string().min(1),

package/dist/signer.js

@@ -9,6 +9,9 @@ const errors_1 = require("./errors");
 const keychain_1 = require("./keychain");
 const REMOTE_SIGN_ADDRESS_PATH = "/address";
 const REMOTE_SIGN_TX_PATH = "/sign-transaction";
+const BANKR_DEFAULT_API_URL = "https://api.bankr.bot";
+const BANKR_AGENT_ME_PATH = "/agent/me";
+const BANKR_AGENT_SUBMIT_PATH = "/agent/submit";
 function parsePrivateKey(value, hint) {
     if (!/^0x[0-9a-fA-F]{64}$/.test(value)) {
         throw new errors_1.CliError("INVALID_PRIVATE_KEY", `${hint} is not a valid private key.`, 2);
@@ -77,6 +80,111 @@ function buildRemoteHeaders(signer) {
     }
     return headers;
 }
+function requireEnvVarName(value, context) {
+    if (!/^[A-Z_][A-Z0-9_]*$/.test(value)) {
+        throw new errors_1.CliError("INVALID_SIGNER_SPEC", `Invalid ${context} env var '${value}'.`, 2);
+    }
+    return value;
+}
+function resolveBankrApiUrl(signer) {
+    return (signer.apiUrl || BANKR_DEFAULT_API_URL).replace(/\/+$/, "");
+}
+function buildBankrHeaders(signer) {
+    const envVar = signer.apiKeyEnvVar || "BANKR_API_KEY";
+    const token = process.env[envVar];
+    if (!token) {
+        throw new errors_1.CliError("MISSING_SIGNER_SECRET", `Missing environment variable '${envVar}'.`, 2);
+    }
+    return {
+        "content-type": "application/json",
+        "x-api-key": token,
+    };
+}
+async function fetchBankrJson(url, init) {
+    let response;
+    try {
+        response = await fetch(url, init);
+    }
+    catch (error) {
+        throw new errors_1.CliError("BANKR_API_UNREACHABLE", "Failed to connect to Bankr API.", 2, {
+            url,
+            message: error instanceof Error ? error.message : String(error),
+        });
+    }
+    const text = await response.text();
+    let parsed = {};
+    if (text) {
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            parsed = text;
+        }
+    }
+    if (!response.ok) {
+        throw new errors_1.CliError("BANKR_API_HTTP_ERROR", `Bankr API responded with HTTP ${response.status}.`, 2, {
+            url,
+            status: response.status,
+            body: parsed,
+        });
+    }
+    return parsed;
+}
+function parseBankrAddressCandidate(candidate) {
+    if (typeof candidate !== "string") {
+        return undefined;
+    }
+    if (!/^0x[a-fA-F0-9]{40}$/.test(candidate)) {
+        return undefined;
+    }
+    return candidate.toLowerCase();
+}
+async function resolveBankrAddress(signer, headers) {
+    if (signer.address) {
+        return ensureAddress(signer.address, "bankr signer address");
+    }
+    const apiUrl = resolveBankrApiUrl(signer);
+    const response = (await fetchBankrJson(addDefaultPaths(apiUrl, BANKR_AGENT_ME_PATH), {
+        method: "GET",
+        headers,
+    }));
+    const direct = parseBankrAddressCandidate(response.walletAddress) ||
+        parseBankrAddressCandidate(response.address) ||
+        parseBankrAddressCandidate(response.agent?.walletAddress) ||
+        parseBankrAddressCandidate(response.agent?.address);
+    if (direct) {
+        return direct;
+    }
+    if (Array.isArray(response.wallets)) {
+        const evmWallet = response.wallets.find((wallet) => wallet.chain === "evm");
+        const evmAddress = parseBankrAddressCandidate(evmWallet?.address) || parseBankrAddressCandidate(evmWallet?.walletAddress);
+        if (evmAddress) {
+            return evmAddress;
+        }
+        for (const wallet of response.wallets) {
+            const anyAddress = parseBankrAddressCandidate(wallet.address) || parseBankrAddressCandidate(wallet.walletAddress);
+            if (anyAddress) {
+                return anyAddress;
+            }
+        }
+    }
+    throw new errors_1.CliError("BANKR_API_PROTOCOL_ERROR", "Bankr /agent/me response missing wallet address.", 2, {
+        keys: Object.keys(response),
+    });
+}
+function parseBankrSubmitHash(response) {
+    if (typeof response !== "object" || response === null) {
+        return undefined;
+    }
+    const root = response;
+    const nested = typeof root.result === "object" && root.result !== null ? root.result : undefined;
+    return (parseTxHash(root.transactionHash) ||
+        parseTxHash(root.txHash) ||
+        parseTxHash(root.hash) ||
+        parseTxHash(nested?.transactionHash) ||
+        parseTxHash(nested?.txHash) ||
+        parseTxHash(nested?.hash));
+}
 async function resolveRemoteAddress(signer, headers) {
     if (signer.address) {
         return ensureAddress(signer.address, "remote signer address");
@@ -175,6 +283,47 @@ function parseSignerLedgerSpec(value) {
     }
     return signer;
 }
+function parseSignerBankrSpec(value) {
+    if (value === "bankr") {
+        return { type: "bankr" };
+    }
+    const body = value.slice("bankr:".length).trim();
+    const signer = {
+        type: "bankr",
+    };
+    if (!body) {
+        return signer;
+    }
+    if (!body.includes("|")) {
+        if (/^0x[a-fA-F0-9]{40}$/.test(body)) {
+            signer.address = ensureAddress(body, "bankr signer address");
+            return signer;
+        }
+        if (/^[A-Z_][A-Z0-9_]*$/.test(body)) {
+            signer.apiKeyEnvVar = requireEnvVarName(body, "bankr api key");
+            return signer;
+        }
+        if (/^https?:\/\//i.test(body)) {
+            signer.apiUrl = body;
+            return signer;
+        }
+        throw new errors_1.CliError("INVALID_SIGNER_SPEC", `Invalid bankr signer format '${value}'.`, 2);
+    }
+    const [addressPart, apiKeyEnvVarPart, apiUrlPart] = body.split("|").map((entry) => entry.trim());
+    if (addressPart) {
+        signer.address = ensureAddress(addressPart, "bankr signer address");
+    }
+    if (apiKeyEnvVarPart) {
+        signer.apiKeyEnvVar = requireEnvVarName(apiKeyEnvVarPart, "bankr api key");
+    }
+    if (apiUrlPart) {
+        if (!/^https?:\/\//i.test(apiUrlPart)) {
+            throw new errors_1.CliError("INVALID_SIGNER_SPEC", `Invalid bankr API URL in '${value}'.`, 2);
+        }
+        signer.apiUrl = apiUrlPart;
+    }
+    return signer;
+}
 function parseSigner(value) {
     if (!value || value === "readonly") {
         return { type: "readonly" };
@@ -205,7 +354,10 @@ function parseSigner(value) {
     if (value.startsWith("remote:")) {
         return parseSignerRemoteSpec(value);
     }
-    throw new errors_1.CliError("INVALID_SIGNER_SPEC", `Unsupported signer '${value}'. Use readonly, env:<ENV_VAR>, keychain:<id>, ledger[:path|address|bridgeEnv], or remote:<url|address|authEnv>.`, 2);
+    if (value === "bankr" || value.startsWith("bankr:")) {
+        return parseSignerBankrSpec(value);
+    }
+    throw new errors_1.CliError("INVALID_SIGNER_SPEC", `Unsupported signer '${value}'. Use readonly, env:<ENV_VAR>, keychain:<id>, ledger[:path|address|bridgeEnv], remote:<url|address|authEnv>, or bankr[:address|apiKeyEnv|apiUrl].`, 2);
 }
 async function resolveSignerRuntime(signer, publicClient, rpcUrl, chain, customHome) {
     if (signer.type === "readonly") {
@@ -307,6 +459,44 @@ async function resolveSignerRuntime(signer, publicClient, rpcUrl, chain, customH
             },
         };
     }
+    if (signer.type === "bankr") {
+        const apiUrl = resolveBankrApiUrl(signer);
+        const headers = buildBankrHeaders(signer);
+        const address = await resolveBankrAddress(signer, headers);
+        const summary = await resolveBalanceSummary("bankr", publicClient, address);
+        return {
+            summary,
+            sendTransaction: async (request) => {
+                const payload = {
+                    transaction: {
+                        chainId: request.chain.id,
+                        from: address,
+                        to: request.to,
+                        data: request.data,
+                        value: request.value?.toString() || "0",
+                        gas: request.gas.toString(),
+                        nonce: request.nonce,
+                        maxFeePerGas: request.maxFeePerGas?.toString(),
+                        maxPriorityFeePerGas: request.maxPriorityFeePerGas?.toString(),
+                    },
+                    waitForConfirmation: false,
+                    description: "Submitted via aavegotchi-cli",
+                };
+                const response = await fetchBankrJson(addDefaultPaths(apiUrl, BANKR_AGENT_SUBMIT_PATH), {
+                    method: "POST",
+                    headers,
+                    body: JSON.stringify(payload),
+                });
+                const txHash = parseBankrSubmitHash(response);
+                if (txHash) {
+                    return txHash;
+                }
+                throw new errors_1.CliError("BANKR_API_PROTOCOL_ERROR", "Bankr submit response missing transaction hash.", 2, {
+                    response,
+                });
+            },
+        };
+    }
     const bridgeEnvVar = signer.bridgeCommandEnvVar || "AGCLI_LEDGER_BRIDGE_CMD";
     const bridgeCommand = process.env[bridgeEnvVar];
     if (!bridgeCommand) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aavegotchi-cli",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Agent-first CLI for automating Aavegotchi app and onchain workflows",
   "license": "MIT",
   "repository": {