aavegotchi-cli 0.2.2 → 0.2.5

package/dist/commands/bootstrap.js

@@ -5,6 +5,7 @@ const args_1 = require("../args");
 const chains_1 = require("../chains");
 const config_1 = require("../config");
 const errors_1 = require("../errors");
+const profile_env_1 = require("../profile-env");
 const rpc_1 = require("../rpc");
 const signer_1 = require("../signer");
 function getRequiredProfileName(ctx) {
@@ -51,12 +52,14 @@ async function runBootstrapCommand(ctx) {
     const chainInput = (0, args_1.getFlagString)(ctx.args.flags, "chain");
     const rpcFlag = (0, args_1.getFlagString)(ctx.args.flags, "rpc-url");
     const signerInput = (0, args_1.getFlagString)(ctx.args.flags, "signer") || "readonly";
+    const envFile = (0, args_1.getFlagString)(ctx.args.flags, "env-file");
     const policyName = (0, args_1.getFlagString)(ctx.args.flags, "policy") || "default";
     const skipSignerCheck = (0, args_1.getFlagBoolean)(ctx.args.flags, "skip-signer-check");
     const chain = (0, chains_1.resolveChain)(chainInput);
     const rpcUrl = (0, chains_1.resolveRpcUrl)(chain, rpcFlag);
     const preflight = await (0, rpc_1.runRpcPreflight)(chain, rpcUrl);
     const signer = buildSignerConfig(ctx, signerInput);
+    const environment = (0, profile_env_1.applySignerEnvironment)(signer, { envFile });
     let signerSummary = {
         signerType: signer.type,
         backendStatus: "not-checked",
@@ -74,6 +77,7 @@ async function runBootstrapCommand(ctx) {
         chainId: preflight.chainId,
         rpcUrl,
         signer,
+        ...(envFile ? { envFile } : {}),
         policy: policyName,
         createdAt: existingProfile?.createdAt || now,
         updatedAt: now,
@@ -101,6 +105,7 @@ async function runBootstrapCommand(ctx) {
             chainName: preflight.chainName,
         },
         signer: signerSummary,
+        environment,
         configPath,
     };
 }

package/dist/commands/mapped-defaults.js

@@ -0,0 +1,242 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMappedWriteDefaults = getMappedWriteDefaults;
+const viem_1 = require("viem");
+const sources_1 = require("../subgraph/sources");
+const AAVEGOTCHI_DIAMOND_MAPPED_WRITE_ABI = (0, viem_1.parseAbi)([
+    "function addGotchiLending(uint32,uint96,uint32,uint8[3],address,address,uint32,address[],uint256)",
+    "function agreeGotchiLending(uint32,uint32,uint96,uint32,uint8[3])",
+    "function batchDropClaimXPDrop(bytes32[],address[],uint256[][],bytes32[][],uint256[][],uint256[][])",
+    "function batchExecuteERC1155Listing((uint256,address,uint256,uint256,uint256,address)[])",
+    "function cancelERC1155Listing(uint256)",
+    "function cancelERC721Listing(uint256)",
+    "function cancelGotchiLending(uint32)",
+    "function claimAavegotchi(uint256,uint256)",
+    "function claimAndEndGotchiLending(uint32)",
+    "function createWhitelist(string,address[])",
+    "function decreaseAndDestroy(uint256,uint256)",
+    "function equipDelegatedWearables(uint256,uint16[16],uint256[16])",
+    "function openPortals(uint256[])",
+    "function spendSkillPoints(uint256,int16[4])",
+    "function transferEscrow(uint256,address,address,uint256)",
+    "function updateERC1155ListingPriceAndQuantity(uint256,uint256,uint256)",
+    "function updateWhitelist(uint32,address[])",
+    "function useConsumables(uint256,uint256[],uint256[])",
+]);
+const GBM_MAPPED_WRITE_ABI = (0, viem_1.parseAbi)([
+    "function buyNow(uint256)",
+    "function cancelAuction(uint256)",
+    "function commitBid(uint256,uint256,uint256,address,uint256,uint256,bytes)",
+    "function createAuction((uint80,uint80,uint56,uint8,bytes4,uint256,uint96,uint96),address,uint256)",
+    "function swapAndBuyNow((address,uint256,uint256,uint256,address,uint256))",
+    "function swapAndCommitBid((address,uint256,uint256,uint256,address,uint256,uint256,uint256,address,uint256,uint256,bytes))",
+]);
+const FORGE_MAPPED_WRITE_ABI = (0, viem_1.parseAbi)([
+    "function claimForgeQueueItems(uint256[])",
+    "function forgeWearables(uint256[],uint256[],uint40[])",
+    "function reduceQueueTime(uint256[],uint40[])",
+    "function smeltWearables(uint256[],uint256[])",
+]);
+const GLTR_STAKING_MAPPED_WRITE_ABI = (0, viem_1.parseAbi)(["function batchHarvest(uint256[])"]);
+const WRAP_MAPPED_WRITE_ABI = (0, viem_1.parseAbi)(["function enterWithUnderlying(uint256)", "function leaveToUnderlying(uint256)"]);
+const GHST_STAKING_MAPPED_WRITE_ABI = (0, viem_1.parseAbi)(["function withdrawFromPool(address,uint256)"]);
+const SOCKET_VAULT_MAPPED_WRITE_ABI = (0, viem_1.parseAbi)(["function bridge(address,uint256,uint256,address,bytes,bytes)"]);
+const MERKLE_DISTRIBUTOR_MAPPED_WRITE_ABI = (0, viem_1.parseAbi)(["function claim(uint256,bytes32[])"]);
+const GOTCHI_POINTS_MAPPED_WRITE_ABI = (0, viem_1.parseAbi)(["function convertAlchemica(address,uint256,uint256,uint256,uint256)"]);
+const ERC20_MAPPED_WRITE_ABI = (0, viem_1.parseAbi)(["function approve(address,uint256)"]);
+const ERC1155_MAPPED_WRITE_ABI = (0, viem_1.parseAbi)([
+    "function safeTransferFrom(address,address,uint256,uint256,bytes)",
+    "function setApprovalForAll(address,bool)",
+]);
+const MAPPED_WRITE_DEFAULTS = {
+    "lending create": {
+        address: sources_1.BASE_AAVEGOTCHI_DIAMOND,
+        abi: AAVEGOTCHI_DIAMOND_MAPPED_WRITE_ABI,
+        source: "base.aavegotchi-diamond",
+    },
+    "lending agree": {
+        address: sources_1.BASE_AAVEGOTCHI_DIAMOND,
+        abi: AAVEGOTCHI_DIAMOND_MAPPED_WRITE_ABI,
+        source: "base.aavegotchi-diamond",
+    },
+    "token approve": {
+        abi: ERC20_MAPPED_WRITE_ABI,
+        source: "canonical.erc20",
+    },
+    "gotchi xp claim-batch": {
+        address: sources_1.BASE_AAVEGOTCHI_DIAMOND,
+        abi: AAVEGOTCHI_DIAMOND_MAPPED_WRITE_ABI,
+        source: "base.aavegotchi-diamond",
+    },
+    "baazaar listing batch-execute": {
+        address: sources_1.BASE_AAVEGOTCHI_DIAMOND,
+        abi: AAVEGOTCHI_DIAMOND_MAPPED_WRITE_ABI,
+        source: "base.aavegotchi-diamond",
+    },
+    "realm harvest batch": {
+        address: sources_1.BASE_GLTR_STAKING,
+        abi: GLTR_STAKING_MAPPED_WRITE_ABI,
+        source: "base.gltr-staking",
+    },
+    "token bridge": {
+        abi: SOCKET_VAULT_MAPPED_WRITE_ABI,
+        source: "canonical.socket-vault",
+    },
+    "baazaar buy-now": {
+        address: sources_1.BASE_GBM_DIAMOND,
+        abi: GBM_MAPPED_WRITE_ABI,
+        source: "base.gbm-diamond",
+    },
+    "auction buy-now": {
+        address: sources_1.BASE_GBM_DIAMOND,
+        abi: GBM_MAPPED_WRITE_ABI,
+        source: "base.gbm-diamond",
+    },
+    "auction cancel": {
+        address: sources_1.BASE_GBM_DIAMOND,
+        abi: GBM_MAPPED_WRITE_ABI,
+        source: "base.gbm-diamond",
+    },
+    "baazaar cancel-erc1155": {
+        address: sources_1.BASE_AAVEGOTCHI_DIAMOND,
+        abi: AAVEGOTCHI_DIAMOND_MAPPED_WRITE_ABI,
+        source: "base.aavegotchi-diamond",
+    },
+    "baazaar cancel-erc721": {
+        address: sources_1.BASE_AAVEGOTCHI_DIAMOND,
+        abi: AAVEGOTCHI_DIAMOND_MAPPED_WRITE_ABI,
+        source: "base.aavegotchi-diamond",
+    },
+    "lending cancel": {
+        address: sources_1.BASE_AAVEGOTCHI_DIAMOND,
+        abi: AAVEGOTCHI_DIAMOND_MAPPED_WRITE_ABI,
+        source: "base.aavegotchi-diamond",
+    },
+    "forge claim": {
+        address: sources_1.BASE_MERKLE_DISTRIBUTOR,
+        abi: MERKLE_DISTRIBUTOR_MAPPED_WRITE_ABI,
+        source: "base.merkle-distributor",
+    },
+    "portal claim": {
+        address: sources_1.BASE_AAVEGOTCHI_DIAMOND,
+        abi: AAVEGOTCHI_DIAMOND_MAPPED_WRITE_ABI,
+        source: "base.aavegotchi-diamond",
+    },
+    "lending claim-end": {
+        address: sources_1.BASE_AAVEGOTCHI_DIAMOND,
+        abi: AAVEGOTCHI_DIAMOND_MAPPED_WRITE_ABI,
+        source: "base.aavegotchi-diamond",
+    },
+    "forge queue claim": {
+        address: sources_1.BASE_FORGE_DIAMOND,
+        abi: FORGE_MAPPED_WRITE_ABI,
+        source: "base.forge-diamond",
+    },
+    "auction bid": {
+        address: sources_1.BASE_GBM_DIAMOND,
+        abi: GBM_MAPPED_WRITE_ABI,
+        source: "base.gbm-diamond",
+    },
+    "gotchi-points convert-alchemica": {
+        abi: GOTCHI_POINTS_MAPPED_WRITE_ABI,
+        source: "canonical.gotchi-points",
+    },
+    "auction create": {
+        address: sources_1.BASE_GBM_DIAMOND,
+        abi: GBM_MAPPED_WRITE_ABI,
+        source: "base.gbm-diamond",
+    },
+    "lending whitelist create": {
+        address: sources_1.BASE_AAVEGOTCHI_DIAMOND,
+        abi: AAVEGOTCHI_DIAMOND_MAPPED_WRITE_ABI,
+        source: "base.aavegotchi-diamond",
+    },
+    "staking unstake-destroy": {
+        address: sources_1.BASE_AAVEGOTCHI_DIAMOND,
+        abi: AAVEGOTCHI_DIAMOND_MAPPED_WRITE_ABI,
+        source: "base.aavegotchi-diamond",
+    },
+    "staking enter-underlying": {
+        abi: WRAP_MAPPED_WRITE_ABI,
+        source: "canonical.wrap",
+    },
+    "gotchi equip-delegated": {
+        address: sources_1.BASE_AAVEGOTCHI_DIAMOND,
+        abi: AAVEGOTCHI_DIAMOND_MAPPED_WRITE_ABI,
+        source: "base.aavegotchi-diamond",
+    },
+    "forge craft": {
+        address: sources_1.BASE_FORGE_DIAMOND,
+        abi: FORGE_MAPPED_WRITE_ABI,
+        source: "base.forge-diamond",
+    },
+    "staking leave-underlying": {
+        abi: WRAP_MAPPED_WRITE_ABI,
+        source: "canonical.wrap",
+    },
+    "portal open": {
+        address: sources_1.BASE_AAVEGOTCHI_DIAMOND,
+        abi: AAVEGOTCHI_DIAMOND_MAPPED_WRITE_ABI,
+        source: "base.aavegotchi-diamond",
+    },
+    "forge speedup": {
+        address: sources_1.BASE_FORGE_DIAMOND,
+        abi: FORGE_MAPPED_WRITE_ABI,
+        source: "base.forge-diamond",
+    },
+    "inventory transfer": {
+        abi: ERC1155_MAPPED_WRITE_ABI,
+        source: "canonical.erc1155",
+    },
+    "token set-approval-for-all": {
+        abi: ERC1155_MAPPED_WRITE_ABI,
+        source: "canonical.erc1155",
+    },
+    "forge smelt": {
+        address: sources_1.BASE_FORGE_DIAMOND,
+        abi: FORGE_MAPPED_WRITE_ABI,
+        source: "base.forge-diamond",
+    },
+    "gotchi spend-skill-points": {
+        address: sources_1.BASE_AAVEGOTCHI_DIAMOND,
+        abi: AAVEGOTCHI_DIAMOND_MAPPED_WRITE_ABI,
+        source: "base.aavegotchi-diamond",
+    },
+    "baazaar swap-buy-now": {
+        address: sources_1.BASE_GBM_DIAMOND,
+        abi: GBM_MAPPED_WRITE_ABI,
+        source: "base.gbm-diamond",
+    },
+    "auction swap-bid": {
+        address: sources_1.BASE_GBM_DIAMOND,
+        abi: GBM_MAPPED_WRITE_ABI,
+        source: "base.gbm-diamond",
+    },
+    "lending transfer-escrow": {
+        address: sources_1.BASE_AAVEGOTCHI_DIAMOND,
+        abi: AAVEGOTCHI_DIAMOND_MAPPED_WRITE_ABI,
+        source: "base.aavegotchi-diamond",
+    },
+    "baazaar update-erc1155": {
+        address: sources_1.BASE_AAVEGOTCHI_DIAMOND,
+        abi: AAVEGOTCHI_DIAMOND_MAPPED_WRITE_ABI,
+        source: "base.aavegotchi-diamond",
+    },
+    "lending whitelist update": {
+        address: sources_1.BASE_AAVEGOTCHI_DIAMOND,
+        abi: AAVEGOTCHI_DIAMOND_MAPPED_WRITE_ABI,
+        source: "base.aavegotchi-diamond",
+    },
+    "gotchi feed": {
+        address: sources_1.BASE_AAVEGOTCHI_DIAMOND,
+        abi: AAVEGOTCHI_DIAMOND_MAPPED_WRITE_ABI,
+        source: "base.aavegotchi-diamond",
+    },
+    "staking withdraw-pool": {
+        abi: GHST_STAKING_MAPPED_WRITE_ABI,
+        source: "canonical.ghst-staking",
+    },
+};
+function getMappedWriteDefaults(commandPath) {
+    return MAPPED_WRITE_DEFAULTS[commandPath.join(" ")];
+}

package/dist/commands/mapped.js

@@ -6,6 +6,7 @@ exports.listMappedCommandsForRoot = listMappedCommandsForRoot;
 exports.getMappedCommandEntries = getMappedCommandEntries;
 exports.runMappedDomainCommand = runMappedDomainCommand;
 const errors_1 = require("../errors");
+const mapped_defaults_1 = require("./mapped-defaults");
 const onchain_1 = require("./onchain");
 const MAPPED_WRITE_COMMANDS = {
     "lending create": "addGotchiLending",
@@ -71,9 +72,21 @@ async function runMappedDomainCommand(ctx) {
             availableForRoot: candidates,
         });
     }
-    const result = await (0, onchain_1.runOnchainSendWithFunction)(ctx, method, key);
+    const defaults = (0, mapped_defaults_1.getMappedWriteDefaults)(ctx.commandPath);
+    const result = await (0, onchain_1.runOnchainSendWithFunction)(ctx, method, key, {
+        abi: defaults?.abi,
+        address: defaults?.address,
+        source: defaults?.source,
+    });
     return {
         mappedMethod: method,
+        defaults: defaults
+            ? {
+                source: defaults.source,
+                address: defaults.address || null,
+                abi: defaults.abi ? "available" : "none",
+            }
+            : null,
         result,
     };
 }

package/dist/commands/onchain.js

@@ -9,6 +9,7 @@ const abi_1 = require("../abi");
 const chains_1 = require("../chains");
 const config_1 = require("../config");
 const errors_1 = require("../errors");
+const profile_env_1 = require("../profile-env");
 const rpc_1 = require("../rpc");
 const tx_engine_1 = require("../tx-engine");
 function requireFlag(value, name) {
@@ -102,16 +103,38 @@ async function runOnchainCallCommand(ctx) {
         result: decoded,
     };
 }
-async function runOnchainSendWithFunction(ctx, forcedFunctionName, commandOverride) {
+async function runOnchainSendWithFunction(ctx, forcedFunctionName, commandOverride, defaults) {
     const config = (0, config_1.loadConfig)();
     const profileName = (0, args_1.getFlagString)(ctx.args.flags, "profile") || ctx.globals.profile;
     const profile = (0, config_1.getProfileOrThrow)(config, profileName);
     const policy = (0, config_1.getPolicyOrThrow)(config, profile.policy);
+    const environment = (0, profile_env_1.applyProfileEnvironment)(profile);
     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 = (0, abi_1.parseAbiFile)(abiFile);
-    const address = parseAddress((0, args_1.getFlagString)(ctx.args.flags, "address"), "--address");
+    const abiFile = (0, args_1.getFlagString)(ctx.args.flags, "abi-file");
+    const abi = abiFile
+        ? (0, abi_1.parseAbiFile)(abiFile)
+        : defaults?.abi ||
+            (() => {
+                throw new errors_1.CliError("MISSING_ARGUMENT", "--abi-file is required.", 2, {
+                    command: commandOverride || ctx.commandPath.join(" "),
+                    hint: forcedFunctionName
+                        ? "This mapped command has no built-in ABI metadata yet. Provide --abi-file."
+                        : "Provide --abi-file <path>.",
+                });
+            })();
+    const addressInput = (0, args_1.getFlagString)(ctx.args.flags, "address");
+    const address = addressInput
+        ? parseAddress(addressInput, "--address")
+        : defaults?.address ||
+            (() => {
+                throw new errors_1.CliError("MISSING_ARGUMENT", "--address is required.", 2, {
+                    command: commandOverride || ctx.commandPath.join(" "),
+                    hint: forcedFunctionName
+                        ? "This mapped command has no built-in contract address yet. Provide --address."
+                        : "Provide --address <0x...>.",
+                });
+            })();
     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"));
     const valueWei = parseValueWei((0, args_1.getFlagString)(ctx.args.flags, "value-wei"));
@@ -160,6 +183,12 @@ async function runOnchainSendWithFunction(ctx, forcedFunctionName, commandOverri
         address,
         functionName,
         args,
+        defaults: {
+            abi: abiFile ? "flag" : defaults?.abi ? "mapped-default" : "none",
+            address: addressInput ? "flag" : defaults?.address ? "mapped-default" : "none",
+            source: defaults?.source || null,
+        },
+        environment,
         result,
     };
 }

package/dist/commands/profile.js

@@ -21,6 +21,7 @@ async function runProfileListCommand() {
         rpcUrl: profile.rpcUrl,
         policy: profile.policy,
         signerType: profile.signer.type,
+        envFile: profile.envFile || null,
         active: config.activeProfile === profile.name,
         updatedAt: profile.updatedAt,
     }));

package/dist/commands/signer.js

@@ -9,12 +9,14 @@ const chains_1 = require("../chains");
 const config_1 = require("../config");
 const errors_1 = require("../errors");
 const keychain_1 = require("../keychain");
+const profile_env_1 = require("../profile-env");
 const rpc_1 = require("../rpc");
 const signer_1 = require("../signer");
 async function runSignerCheckCommand(ctx) {
     const config = (0, config_1.loadConfig)();
     const profileName = (0, args_1.getFlagString)(ctx.args.flags, "profile") || ctx.globals.profile;
     const profile = (0, config_1.getProfileOrThrow)(config, profileName);
+    const environment = (0, profile_env_1.applyProfileEnvironment)(profile);
     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 preflight = await (0, rpc_1.runRpcPreflight)(chain, rpcUrl);
@@ -22,6 +24,7 @@ async function runSignerCheckCommand(ctx) {
     return {
         profile: profile.name,
         chainId: chain.chainId,
+        environment,
         signer: runtime.summary,
     };
 }

package/dist/commands/tx.js

@@ -8,6 +8,7 @@ const args_1 = require("../args");
 const chains_1 = require("../chains");
 const config_1 = require("../config");
 const errors_1 = require("../errors");
+const profile_env_1 = require("../profile-env");
 const tx_engine_1 = require("../tx-engine");
 function parseNoncePolicy(value) {
     if (!value) {
@@ -65,6 +66,7 @@ async function runTxSendCommand(ctx) {
     const requestedProfile = (0, args_1.getFlagString)(ctx.args.flags, "profile") || ctx.globals.profile;
     const profile = (0, config_1.getProfileOrThrow)(config, requestedProfile);
     const policy = (0, config_1.getPolicyOrThrow)(config, profile.policy);
+    const environment = (0, profile_env_1.applyProfileEnvironment)(profile);
     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 to = requireHexAddress((0, args_1.getFlagString)(ctx.args.flags, "to"), "--to");
@@ -105,6 +107,7 @@ async function runTxSendCommand(ctx) {
         profile: profile.name,
         policy: policy.name,
         chainId: chain.chainId,
+        environment,
         ...result,
     };
 }

package/dist/output.js

@@ -7,6 +7,7 @@ exports.outputHelp = outputHelp;
 const args_1 = require("./args");
 const abi_1 = require("./abi");
 const command_catalog_1 = require("./command-catalog");
+const mapped_defaults_1 = require("./commands/mapped-defaults");
 const mapped_1 = require("./commands/mapped");
 const stubs_1 = require("./commands/stubs");
 function stringifyWithBigInt(input) {
@@ -59,6 +60,7 @@ Power-user commands:
 Subgraph wrappers:
   baazaar listing get|active|mine
   auction get|active|mine|bids|bids-mine
+  auction bid|bid-unbid
 
 Domain namespaces:
   gotchi, portal, wearables, items, inventory, baazaar, auction, lending, staking, gotchi-points, realm, alchemica, forge, token
@@ -83,7 +85,7 @@ Examples:
 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]
+  ag bootstrap --profile <name> [--chain <base|base-sepolia|id>] [--rpc-url <url>] [--signer <config>] [--env-file <path>] [--policy <name>] [--skip-signer-check] [--json]
 
 Required:
   --profile <name>
@@ -280,6 +282,8 @@ Usage:
   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 bid --auction-id <auctionId> --amount-ghst <amount> [--dry-run] [--auto-approve] [--json]
+  ag auction bid-unbid --amount-ghst <amount> --max-total-ghst <amount> [--dry-run] [--auto-approve] [--json]
   ag auction <mapped-write> --help
 `,
     "auction get": `
@@ -301,6 +305,24 @@ Usage:
     "auction bids-mine": `
 Usage:
   ag auction bids-mine --bidder <0x...> [--first <n>] [--skip <n>] [--json]
+`,
+    "auction bid": `
+Usage:
+  ag auction bid --auction-id <auctionId> (--amount-ghst <amount> | --amount-wei <wei>) [--require-unbid] [--expected-highest-bid-ghst <amount> | --expected-highest-bid-wei <wei>] [--auto-approve] [--auto-approve-max-ghst <amount> | --auto-approve-max-wei <wei>] [--nonce-policy <safe|replace|manual>] [--nonce <n>] [--dry-run] [--wait] [--timeout-ms <ms>] [--idempotency-key <key>] [--json]
+
+Notes:
+  - Resolves GBM diamond + ABI internally (no manual ABI/address flags).
+  - Runs preflight checks (auction state, min bid, GHST balance, GHST allowance).
+  - Rechecks auction state immediately before submit to prevent stale-state sends.
+  - --dry-run with --auto-approve simulates approval and skips bid simulation because allowance state is unchanged on-chain.
+`,
+    "auction bid-unbid": `
+Usage:
+  ag auction bid-unbid (--amount-ghst <amount> | --amount-wei <wei>) (--max-total-ghst <amount> | --max-total-wei <wei>) [--first <n>] [--skip <n>] [--auto-approve] [--dry-run] [--wait] [--timeout-ms <ms>] [--idempotency-key <key>] [--json]
+
+Behavior:
+  - Scans active auctions, selects unbid auctions, and skips those above your target amount.
+  - Emits per-auction status plus clear skip reasons in one JSON report.
 `,
 };
 function buildDomainRootHelp(root) {
@@ -320,6 +342,7 @@ function buildMappedCommandHelp(commandPath, flags) {
     if (!method) {
         return "";
     }
+    const defaults = (0, mapped_defaults_1.getMappedWriteDefaults)(commandPath);
     const abiFile = (0, args_1.getFlagString)(flags, "abi-file");
     const signatureLines = [];
     const inputLines = [];
@@ -342,24 +365,76 @@ function buildMappedCommandHelp(commandPath, flags) {
             signatureLines.push(`Could not inspect ABI file '${abiFile}': ${message}`);
         }
     }
+    else if (defaults?.abi) {
+        const entries = (0, abi_1.getAbiFunctionEntries)(defaults.abi, method);
+        if (entries.length === 0) {
+            signatureLines.push("Built-in ABI defaults are available, but no matching function entry was found.");
+        }
+        else {
+            for (const entry of entries) {
+                signatureLines.push((0, abi_1.formatAbiFunctionSignature)(entry));
+                inputLines.push(...(0, abi_1.formatAbiFunctionInputs)(entry));
+            }
+        }
+    }
     else {
         signatureLines.push("Pass --abi-file <path> with --help to print exact ABI-derived signature and input names.");
     }
+    const requiredFlags = ["--args-json", "--profile (or active profile)"];
+    const optionalOverrides = [];
+    if (!defaults?.abi) {
+        requiredFlags.unshift("--abi-file");
+    }
+    else {
+        optionalOverrides.push("--abi-file (override built-in ABI)");
+    }
+    if (!defaults?.address) {
+        requiredFlags.unshift("--address");
+    }
+    else {
+        optionalOverrides.push("--address (override default)");
+    }
+    const usageParts = [`ag ${command}`, "--profile <name>"];
+    if (!defaults?.abi) {
+        usageParts.push("--abi-file <path>");
+    }
+    if (!defaults?.address) {
+        usageParts.push("--address <0x...>");
+    }
+    usageParts.push("--args-json '[...]'", "[--value-wei <wei>]", "[--nonce-policy <safe|replace|manual>]", "[--nonce <n>]", "[--dry-run]", "[--wait]", "[--json]");
+    const usage = `  ${usageParts.join(" ")}`;
+    const defaultLines = [
+        defaults?.address ? `address: ${defaults.address}` : "address: none",
+        defaults?.abi ? "abi: available" : "abi: none",
+        `source: ${defaults?.source || "none"}`,
+    ];
+    const dryRunParts = [`ag ${command}`, "--profile prod"];
+    if (!defaults?.abi) {
+        dryRunParts.push("--abi-file ./abi.json");
+    }
+    if (!defaults?.address) {
+        dryRunParts.push("--address 0xabc...");
+    }
+    dryRunParts.push("--args-json '[<arg0>,<arg1>]'", "--dry-run", "--json");
+    const dryRunExample = `  ${dryRunParts.join(" ")}`;
     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]
+${usage}
 
 Mapped to onchain function:
   ${method}
 
 Required flags:
-  --abi-file
-  --address
-  --args-json
-  --profile (or active profile)
+${toLines(requiredFlags)}
+
+Mapped defaults:
+${toLines(defaultLines)}
+
+Optional overrides:
+${toLines(optionalOverrides)}
 
 Dry-run example:
-  ag ${command} --profile prod --abi-file ./abi.json --address 0xabc... --args-json '[<arg0>,<arg1>]' --dry-run --json
+${dryRunExample}
 
 ABI signature info:
 ${toLines(signatureLines)}
@@ -387,14 +462,14 @@ function buildHelpText(commandPath = [], flags = {}) {
     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();
     }
+    const mappedHelp = buildMappedCommandHelp(target, flags);
+    if (mappedHelp) {
+        return mappedHelp.trim();
+    }
     if (target.length === 1 && (0, stubs_1.isDomainStubRoot)(target[0])) {
         return buildDomainRootHelp(target[0]).trim();
     }