perp-cli 0.14.0 → 0.14.2

package/dist/commands/bot.js

@@ -162,17 +162,10 @@ export function registerStrategyCommands(program, getAdapter, getAdapterFor, isJ
         .option("--background", "Run in background (tmux)")
         .option("--headless", "Run without TUI dashboard")
         .option("--job-id <id>", "Job ID")
-        .action(async (opts) => {
-        const exchangeNames = opts.exchanges.split(",").map(e => e.trim());
-        const adapters = new Map();
-        for (const name of exchangeNames) {
-            try {
-                adapters.set(name, await getAdapterFor(name));
-            }
-            catch {
-                // skip unavailable
-            }
-        }
+        .action(async (opts, cmd) => {
+        const adapters = await loadBotVenueAdapters(opts.exchanges.split(",").map(e => e.trim()), cmd.getOptionValueSource("exchanges") === "cli", getAdapterFor);
+        // The strategy scans only the venues that loaded.
+        const exchangeNames = [...adapters.keys()];
         if (adapters.size < 2) {
             console.error(chalk.red("\n  Need at least 2 exchanges for arbitrage.\n"));
             return;
@@ -207,7 +200,8 @@ export function registerStrategyCommands(program, getAdapter, getAdapterFor, isJ
                 `strategy`, `quick-arb`,
                 `--min-spread`, opts.minSpread, `--close-spread`, opts.closeSpread,
                 `--size`, opts.size, `--max-positions`, opts.maxPositions,
-                `--exchanges`, opts.exchanges, `--interval`, opts.interval,
+                // The venues the parent loaded (a skipped default venue is not re-tried as "explicit").
+                `--exchanges`, exchangeNames.join(","), `--interval`, opts.interval,
                 `--max-drawdown`, opts.maxDrawdown,
             ];
             const job = startJob({
@@ -241,17 +235,10 @@ export function registerStrategyCommands(program, getAdapter, getAdapterFor, isJ
         .option("--background", "Run in background (tmux)")
         .option("--headless", "Run without TUI dashboard")
         .option("--job-id <id>", "Job ID")
-        .action(async (opts) => {
-        const exchangeNames = opts.exchanges.split(",").map(e => e.trim());
-        const adapters = new Map();
-        for (const name of exchangeNames) {
-            try {
-                adapters.set(name, await getAdapterFor(name));
-            }
-            catch {
-                // skip unavailable
-            }
-        }
+        .action(async (opts, cmd) => {
+        const adapters = await loadBotVenueAdapters(opts.exchanges.split(",").map(e => e.trim()), cmd.getOptionValueSource("exchanges") === "cli", getAdapterFor);
+        // The strategy trades only the venues that loaded.
+        const exchangeNames = [...adapters.keys()];
         if (adapters.size < 1) {
             console.error(chalk.red("\n  Need at least 1 exchange for delta-neutral.\n"));
             return;
@@ -287,7 +274,7 @@ export function registerStrategyCommands(program, getAdapter, getAdapterFor, isJ
                 `strategy`, `delta-neutral`,
                 `--min-rate`, opts.minRate, `--close-rate`, opts.closeRate,
                 `--size`, opts.size, `--max-positions`, opts.maxPositions,
-                `--leverage`, opts.leverage, `--exchanges`, opts.exchanges,
+                `--leverage`, opts.leverage, `--exchanges`, exchangeNames.join(","),
                 `--interval`, opts.interval, `--max-drawdown`, opts.maxDrawdown,
             ];
             const job = startJob({
@@ -355,15 +342,9 @@ export function registerStrategyCommands(program, getAdapter, getAdapterFor, isJ
             const built = preset.buildConfig("multi", sym);
             const config = opts.size !== undefined ? withPresetSize(built, opts.size) : built;
             const arbStrategy = config.strategy;
-            const adapters = new Map();
-            for (const exName of arbStrategy.exchanges) {
-                try {
-                    adapters.set(exName, await getAdapterFor(exName));
-                }
-                catch {
-                    // skip unavailable
-                }
-            }
+            // The preset's venue list is a default (not user-passed): a failing venue is skipped with a warning.
+            const adapters = await loadBotVenueAdapters(arbStrategy.exchanges, false, getAdapterFor);
+            arbStrategy.exchanges = [...adapters.keys()];
             if (adapters.size < 2) {
                 console.error(chalk.red("\n  Need at least 2 exchanges for arbitrage.\n"));
                 return;
@@ -756,6 +737,44 @@ export function registerStrategyCommands(program, getAdapter, getAdapterFor, isJ
     // Nested scripted plans: `perp strategy plan {validate|execute|example}`
     registerStrategyPlanCommands(bot, getAdapter, isJson);
 }
+/**
+ * Adapters for a multi-venue bot. An explicitly passed list (--exchanges on the command line)
+ * must load in full: a venue that fails refuses the start with a PerpError naming it. A default
+ * list skips a failing venue with a stderr warning naming it and the cause.
+ */
+export async function loadBotVenueAdapters(names, explicit, getAdapterFor) {
+    const adapters = new Map();
+    for (const name of names) {
+        try {
+            const a = await getAdapterFor(name);
+            // A venue without credentials gets a read-only adapter: it can neither trade nor report
+            // the bot's balances, so it is "not configured" — refused when listed explicitly.
+            if (a.isReadOnly === true) {
+                if (explicit) {
+                    throw new PerpError("NO_SIGNER_AVAILABLE", `--exchanges venue ${name} has no credentials configured`, {
+                        exchange: name, remediation: `Set it up (perp setup) or remove it from --exchanges`,
+                    });
+                }
+                process.stderr.write(`[info] ${name} not configured (no credentials) — the bot runs without it\n`);
+                continue;
+            }
+            adapters.set(name, a);
+        }
+        catch (e) {
+            if (e instanceof PerpError && e.structured.code === "NO_SIGNER_AVAILABLE" && explicit)
+                throw e;
+            const cause = e instanceof Error ? e.message : String(e);
+            if (explicit) {
+                throw new PerpError(e instanceof PerpError ? e.structured.code : "EXCHANGE_ERROR", `--exchanges venue ${name} could not be initialised: ${cause}`, {
+                    exchange: name,
+                    remediation: `Fix ${name}'s setup (credentials / network: perp -e ${name} portfolio), or remove it from --exchanges`,
+                });
+            }
+            process.stderr.write(`[warn] ${name} unavailable (${cause}) — the bot runs without it\n`);
+        }
+    }
+    return adapters;
+}
 function makeLog() {
     return (msg) => {
         const ts = new Date().toLocaleTimeString();
@@ -898,19 +917,10 @@ function registerRunSubcommands(parent, getAdapter, getAdapterFor, isJson) {
         .option("--rebalance-threshold <usd>", "Rebalance when available < this ($)", "100")
         .option("--max-drawdown <usd>", "Close all positions if total uPnL exceeds this loss ($)")
         .option("--job-id <id>", "Job ID (set automatically for background jobs)")
-        .action(async (opts) => {
+        .action(async (opts, cmd) => {
         const exchangeNames = opts.exchanges.split(",").map((e) => e.trim());
-        const adapters = new Map();
-        for (const name of exchangeNames) {
-            try {
-                const a = await getAdapterFor(name);
-                adapters.set(name, a);
-            }
-            catch {
-                if (!isJson())
-                    console.log(chalk.yellow(`  Skipping ${name} (no credentials)`));
-            }
-        }
+        // An explicitly listed venue that fails to load refuses the start; a default one is skipped with a warning.
+        const adapters = await loadBotVenueAdapters(exchangeNames, cmd.getOptionValueSource("exchanges") === "cli", getAdapterFor);
         if (adapters.size < 2) {
             console.error(chalk.red("Need at least 2 exchanges for arbitrage. Set credentials for 2+ exchanges."));
             process.exit(1);

package/dist/commands/funds-onchain.d.ts

@@ -1,5 +1,5 @@
 /**
- * `funds deposit aster|ondo`, `funds withdraw aster`, `funds address-book add ondo` — fund movements
+ * `funds deposit aster|ondo`, `funds withdraw aster` — fund movements
  * whose on-chain leg is signed by the OWS master wallet (src/evm-master-tx.ts).
  *
  * Every command: `--dry-run` prints the plan and returns before any key, adapter or network is

package/dist/commands/funds-onchain.js

@@ -1,5 +1,5 @@
 /**
- * `funds deposit aster|ondo`, `funds withdraw aster`, `funds address-book add ondo` — fund movements
+ * `funds deposit aster|ondo`, `funds withdraw aster` — fund movements
  * whose on-chain leg is signed by the OWS master wallet (src/evm-master-tx.ts).
  *
  * Every command: `--dry-run` prints the plan and returns before any key, adapter or network is
@@ -12,7 +12,7 @@ import { cliCredentialOptsFrom } from "../config.js";
 import { PerpError, parsePositiveDecimal } from "../errors.js";
 import { logExecution } from "../execution-log.js";
 import { unsupported } from "../exchanges/trading-v2.js";
-import { getVenue, networkConfig } from "../exchanges/venue.js";
+import { getVenue } from "../exchanges/venue.js";
 import { ASTER_FUNDS_CHAINS } from "../exchanges/venues/aster.js";
 import { ONDO_DEPOSIT_CHAINS } from "../exchanges/venues/ondo.js";
 import { jsonOk, printJson } from "../utils.js";
@@ -235,52 +235,15 @@ export function registerOnchainFundsCommands(ctx) {
         }
     });
     // ═══ Address book (Ondo withdrawal destinations) ═══
-    const addressBook = funds.command("address-book").description("Withdrawal address book (Ondo Perps only withdraws to listed addresses)");
-    supportsDryRun(addressBook.command("add <venue> <address>"))
-        .description("Add the master wallet's own address to the Ondo Perps withdrawal address book (SIWE challenge signed by the OWS master wallet; supports --dry-run)")
-        .option("--label <text>", "Label of the address book entry")
-        .action(async (venue, address, opts) => {
-        const def = getVenue(venue);
-        if (def.id !== "ondo") {
-            throw unsupported(def.displayName, "address-book", "only Ondo Perps has a withdrawal address book", "perp funds address-book add ondo <address>");
-        }
-        const net = getNetwork();
-        if (!/^0x[0-9a-fA-F]{40}$/.test(address))
-            throw new PerpError("INVALID_PARAMS", `"${address}" is not an EVM address`);
-        const plan = {
-            venue: "ondo", network: net, address, label: opts.label === undefined ? null : opts.label,
-            steps: "POST /v1/auth/erc-4361/address_book/get_challenge → personal_sign with the OWS master wallet → POST …/complete_challenge",
-        };
-        if (isDryRun()) {
-            if (isJson())
-                return printJson(jsonOk({ dryRun: true, sent: false, action: "address-book add", ...plan }));
-            console.log(chalk.yellow(`\n  [dry-run] Would add ${address} to the Ondo Perps address book (${net})`));
-            console.log(`  steps: ${plan.steps}`);
-            console.log(chalk.gray("  Nothing was signed or sent.\n"));
-            return;
-        }
-        const { loadMasterEvmSigner } = await import("../evm-master-tx.js");
-        const signer = await loadMasterEvmSigner("ondo", creds(), "Adding an Ondo address book entry");
-        if (signer.getAddress().toLowerCase() !== address.toLowerCase()) {
-            throw new PerpError("INVALID_PARAMS", `The CLI only adds the master wallet's own address (${signer.getAddress()}) to the Ondo address book; ${address} is a different address`, {
-                remediation: "Add other addresses in the Ondo Perps web app (Withdraw → address book)",
-            });
-        }
-        const { OndoAdapter } = await import("../exchanges/ondo/adapter.js");
-        const adapter = await getAdapterForExchange("ondo");
-        if (!(adapter instanceof OndoAdapter))
-            throw new Error("ondo venue did not produce an OndoAdapter");
-        const { addOndoAddressBookEntry } = await import("../exchanges/ondo/funds.js");
-        const res = await addOndoAddressBookEntry(adapter.restClient, {
-            wallet: signer.getAddress(), restUrl: networkConfig(def, net).restUrl, label: plan.label, signMessage: m => signer.signMessage(m),
-        });
-        if (isJson())
-            return printJson(jsonOk({ venue: "ondo", network: net, ...res }));
-        if (res.alreadyListed)
-            console.log(chalk.green(`\n  ${res.address} is already on the Ondo Perps address book.\n`));
-        else if (res.listed)
-            console.log(chalk.green(`\n  Added ${res.address} to the Ondo Perps address book.\n`));
-        else
-            console.log(chalk.yellow(`\n  Ondo accepted the challenge, but ${res.address} is not listed yet (a cooldown may apply). Check the Ondo Perps app before withdrawing.\n`));
+    // Ondo Perps withdrawals are web-app only (the API does not allow them), so an address-book
+    // entry made here would serve nothing. The command stays so the refusal is explicit.
+    const addressBook = funds.command("address-book").description("Not available: the Ondo Perps withdrawal address book is managed in the web app");
+    // Optional arguments: a bare `address-book add` gets the same explicit refusal, not a usage error.
+    supportsDryRun(addressBook.command("add [venue] [address]"))
+        .description("Not available: no venue offers a withdrawal address book over the CLI (Ondo Perps: web app only; refused, also with --dry-run)")
+        .option("--label <text>", "Ignored")
+        // Venue-neutral: no venue has a CLI address book, so the arguments are not even resolved.
+        .action(async () => {
+        throw unsupported("perp-cli", "address-book", "perp-cli has no withdrawal address book for any venue (Ondo Perps withdrawals are web-app only)", "Manage withdrawals and address books in the venue's web app");
     });
 }

package/dist/commands/funds.js

@@ -10,8 +10,7 @@ import { cliCredentialOptsFrom, requireMasterWallet } from "../config.js";
 import { getVenue, requireCapabilities, READ_ONLY_CREDENTIALS } from "../exchanges/venue.js";
 import { unsupported } from "../exchanges/trading-v2.js";
 import { registerOnchainFundsCommands } from "./funds-onchain.js";
-import { ONDO_WITHDRAW_NETWORK } from "../exchanges/venues/ondo.js";
-import { QFEX_BANKER_NETWORK, QFEX_WITHDRAW_NETWORK } from "../exchanges/venues/qfex.js";
+import { QFEX_BANKER_NETWORK, QFEX_WITHDRAW_DISABLED, QFEX_WITHDRAW_ENABLED, QFEX_WITHDRAW_NETWORK } from "../exchanges/venues/qfex.js";
 import { loadSettings } from "../settings.js";
 import { assertWithdrawAllowed, forgetWithdrawAttempt, recordWithdrawAttempt } from "../withdraw-gate.js";
 import "../exchanges/venues/index.js";
@@ -95,6 +94,13 @@ export function chainLabel(chain) {
         throw new Error(`no display label for chain "${chain}" (add it to CHAIN_LABELS)`);
     return label;
 }
+/** Circle forwarding fee per HL CCTP destination, from HL_CCTP_ROUTES (null = not published). */
+async function hlCctpFeeText() {
+    const { HL_CCTP_ROUTES } = await import("../exchanges/hyperliquid.js");
+    return Object.entries(HL_CCTP_ROUTES)
+        .map(([chain, r]) => `${chain}: ${r.forwardingFeeUsdc === null ? "fee not published" : `${r.forwardingFeeUsdc} USDC`}`)
+        .join(", ");
+}
 /** Withdraw asset declared by the venue definition (capabilities.withdrawAssets[0]). */
 function withdrawAssetOf(def) {
     const assets = requireCapabilities(def).withdrawAssets;
@@ -105,10 +111,9 @@ function withdrawAssetOf(def) {
 }
 /** Withdrawal chain of venues that settle off-chain and pay out on a public chain. */
 const OFFCHAIN_WITHDRAW_CHAIN = {
-    ondo: ONDO_WITHDRAW_NETWORK,
     qfex: QFEX_WITHDRAW_NETWORK,
 };
-/** Chain a venue's withdrawals arrive on (Ondo / QFEX settle off-chain and pay out on Ethereum / Arbitrum). */
+/** Chain a venue's withdrawals arrive on (QFEX settles off-chain and pays out on Arbitrum). */
 function withdrawChainOf(def, net) {
     const payout = OFFCHAIN_WITHDRAW_CHAIN[def.id];
     if (payout !== undefined)
@@ -1044,14 +1049,20 @@ export function registerFundsCommands(program, getAdapter, isJson, getNetwork, g
             throw err;
         }
     });
-    // ── Ondo Perps / Arcus — uniform surface (design §13.1): same <amount> + --to,
+    // ── Arcus — uniform surface (design §13.1): same <amount> + --to,
     //    same jsonOk(result), global --dry-run plans without sending. ──
-    for (const venueId of ["ondo", "arcus"]) {
+    // Ondo Perps: the API does not allow withdrawals (address-book destinations only; adding one is
+    // refused for API keys). The command stays so the refusal is explicit — also under --dry-run.
+    supportsDryRun(withdraw.command("ondo [amount]"))
+        .description("Not available: Ondo Perps withdrawals are web-app only (refused, also with --dry-run)")
+        .option("--to <address>", "Ignored — the API cannot withdraw")
+        .action(async () => {
+        throw unsupported("Ondo Perps", "withdraw", "the Ondo Perps API does not allow withdrawals", "Withdraw from the Ondo Perps web app");
+    });
+    for (const venueId of ["arcus"]) {
         const def = getVenue(venueId);
         const asset = withdrawAssetOf(def);
-        const toHelp = venueId === "ondo"
-            ? "Destination EVM address (required; must be on the Ondo address book — see: perp funds address-book add ondo <address>)"
-            : "Destination EVM address (must equal the Arcus account owner — the default)";
+        const toHelp = "Destination EVM address (must equal the Arcus account owner — the default)";
         supportsDryRun(withdraw.command(`${venueId} <amount>`))
             .description(`Withdraw ${asset} from ${def.displayName} to your ${chainLabel(withdrawChainOf(def, "mainnet"))} wallet (supports --dry-run)`)
             .option("--to <address>", toHelp)
@@ -1065,27 +1076,16 @@ export function registerFundsCommands(program, getAdapter, isJson, getNetwork, g
             const adapter = await getAdapterForExchange(venueId);
             if (!isWithdrawCapable(adapter))
                 throw new Error(`${def.id} adapter has no withdraw()`);
-            let destination;
-            if (venueId === "ondo") {
-                if (opts.to === undefined) {
-                    throw new PerpError("INVALID_PARAMS", "Ondo Perps withdraw needs a destination address (the API key has no owner address)", {
-                        remediation: `perp funds withdraw ondo ${amount} --to <0x address on your Ondo address book>`,
-                    });
-                }
-                destination = opts.to;
-            }
-            else {
-                const { ArcusAdapter } = await import("../exchanges/arcus/adapter.js");
-                if (!(adapter instanceof ArcusAdapter))
-                    throw new Error("arcus venue did not produce an ArcusAdapter");
-                const owner = adapter.withdrawDestination;
-                if (opts.to !== undefined && opts.to.toLowerCase() !== owner.toLowerCase()) {
-                    throw new PerpError("INVALID_PARAMS", `Arcus only withdraws to the account owner ${owner}`, {
-                        remediation: `Omit --to (defaults to ${owner})`,
-                    });
-                }
-                destination = owner;
+            const { ArcusAdapter } = await import("../exchanges/arcus/adapter.js");
+            if (!(adapter instanceof ArcusAdapter))
+                throw new Error("arcus venue did not produce an ArcusAdapter");
+            const owner = adapter.withdrawDestination;
+            if (opts.to !== undefined && opts.to.toLowerCase() !== owner.toLowerCase()) {
+                throw new PerpError("INVALID_PARAMS", `Arcus only withdraws to the account owner ${owner}`, {
+                    remediation: `Omit --to (defaults to ${owner})`,
+                });
             }
+            const destination = owner;
             const plan = { venue: def.id, network: net, asset, amount: String(amountNum), destination, chain };
             if (isDryRun()) {
                 logExecution({
@@ -1100,16 +1100,6 @@ export function registerFundsCommands(program, getAdapter, isJson, getNetwork, g
                 console.log(chalk.gray("  Nothing was sent.\n"));
                 return;
             }
-            if (venueId === "ondo") {
-                // Address-book preflight (read-only): Ondo refuses destinations that are not listed.
-                const { OndoAdapter } = await import("../exchanges/ondo/adapter.js");
-                if (!(adapter instanceof OndoAdapter))
-                    throw new Error("ondo venue did not produce an OndoAdapter");
-                const book = await adapter.addressBook();
-                if (!book.some(a => a.toLowerCase() === destination.toLowerCase())) {
-                    throw (await import("../exchanges/ondo/funds.js")).ondoAddressNotOnBook(destination, book);
-                }
-            }
             if (!isJson()) {
                 console.log(chalk.cyan(`\n  Withdrawing ${formatUsd(amountNum)} ${asset} from ${def.displayName}...\n`));
                 console.log(`  Destination: ${destination} (${chain})`);
@@ -1139,7 +1129,7 @@ export function registerFundsCommands(program, getAdapter, isJson, getNetwork, g
         });
     }
     // ── QFEX (design §14.6, §14.12 #8) — custodial; deposit = address display, withdraw = banker POST
-    //    gated by settings.withdraw.qfex inside QfexAdapter.withdraw(). ──
+    //    gated by settings.withdraw.qfex inside QfexAdapter.withdraw(); switched off (QFEX_WITHDRAW_ENABLED). ──
     /** QFEX adapter for the active network — the default imported key, or the one named by --agent. */
     const qfexAdapterFor = async (agentName) => {
         const { QfexAdapter: Cls } = await import("../exchanges/qfex/adapter.js");
@@ -1164,11 +1154,15 @@ export function registerFundsCommands(program, getAdapter, isJson, getNetwork, g
             throw new Error("qfex venue did not produce a QfexAdapter");
         return adapter;
     };
-    supportsDryRun(withdraw.command("qfex <amount>"))
-        .description("Withdraw USDC from QFEX to an allowlisted Arbitrum One address (needs settings withdraw.qfex and a key with the \"Deposit and withdraw\" permission; supports --dry-run)")
+    supportsDryRun(withdraw.command(QFEX_WITHDRAW_ENABLED ? "qfex <amount>" : "qfex [amount]"))
+        .description(QFEX_WITHDRAW_ENABLED
+        ? "Withdraw USDC from QFEX to an allowlisted Arbitrum One address (needs settings withdraw.qfex and a key with the \"Deposit and withdraw\" permission; supports --dry-run)"
+        : "Not available: QFEX withdrawals are disabled in perp-cli for now — use the QFEX web app (refused, also with --dry-run)")
         .option("--to <address>", "Destination EVM address on Arbitrum One (required; must be on the settings withdraw.qfex allowlist)")
         .option("--agent <name>", "Imported QFEX key to use (a key with the \"Deposit and withdraw\" permission, bound to the primary account)")
         .action(async (amount, opts) => {
+        if (!QFEX_WITHDRAW_ENABLED)
+            throw unsupported("QFEX", "withdraw", QFEX_WITHDRAW_DISABLED.reason, QFEX_WITHDRAW_DISABLED.remediation);
         const def = getVenue("qfex");
         const net = getNetwork();
         if (!/^\d+(\.\d+)?$/.test(amount) || !(Number(amount) > 0)) {
@@ -1247,7 +1241,7 @@ export function registerFundsCommands(program, getAdapter, isJson, getNetwork, g
         console.log(chalk.yellow(`\n  ${info.warning}`));
         console.log(chalk.gray("  perp-cli did not send anything — transfer from your own wallet or exchange.\n"));
     });
-    // ── Aster deposit / withdraw, Ondo deposit, Ondo address book (OWS-master on-chain legs) ──
+    // ── Aster deposit / withdraw, Ondo deposit (OWS-master on-chain legs; address book refused) ──
     registerOnchainFundsCommands({
         program, funds, deposit, withdraw, isJson, isDryRun, getNetwork, getAdapterForExchange,
         requireMaster, printFundsPlan, failStatus: fundsFailStatus,
@@ -1358,11 +1352,13 @@ export function registerFundsCommands(program, getAdapter, isJson, getNetwork, g
                 },
                 withdraw: {
                     pacifica: { chain: "Solana", token: "USDC", speed: "~10s", fee: "none" },
-                    hyperliquid: { chain: "Arbitrum", token: "USDC", speed: "minutes", fee: "$1" },
+                    hyperliquid: { chain: "Arbitrum (default) / Ethereum / Base", token: "USDC", speed: "minutes (CCTP attestation)", method: "CCTP (sendToEvmWithData)", fee: await hlCctpFeeText(), command: "perp funds withdraw hyperliquid <amount> [--chain arbitrum|ethereum|base]" },
                     lighter: { chain: "Ethereum L1", token: "USDC", speed: "~12 hours (standard), minutes (fast)", fee: "varies" },
                     "lighter-rh": { chain: "Robinhood Chain", token: "USDG", command: "perp -e lighter-rh funds withdraw lighter <amount>" },
-                    ondo: { chain: "Ethereum", token: "USDC", command: "perp funds withdraw ondo <amount> --to <address>", addressBook: "destination must be listed: perp funds address-book add ondo <master address>" },
-                    qfex: { chain: "Arbitrum", token: "USDC", command: "perp funds withdraw qfex <amount> --to <allowlisted address>", gate: "settings withdraw.qfex (allowlist, maxPerTx, maxPerDay)", note: "needs a key with the \"Deposit and withdraw\" permission (All accounts access)" },
+                    ondo: { supported: false, note: "the Ondo Perps API does not allow withdrawals — withdraw in the Ondo Perps web app" },
+                    qfex: QFEX_WITHDRAW_ENABLED
+                        ? { chain: chainLabel(QFEX_WITHDRAW_NETWORK), token: "USDC", command: "perp funds withdraw qfex <amount> --to <allowlisted address>", gate: "settings withdraw.qfex (allowlist, maxPerTx, maxPerDay)", note: "needs a key with the \"Deposit and withdraw\" permission" }
+                        : { supported: false, note: `${QFEX_WITHDRAW_DISABLED.reason} — ${QFEX_WITHDRAW_DISABLED.remediation}` },
                     arcus: { chain: "Robinhood Chain", token: "USDG", command: "perp funds withdraw arcus <amount>" },
                     aster: { chain: "BNB Chain (default) / Arbitrum", token: "USDT (default) / USDC", command: "perp funds withdraw aster <amount> [--chain bsc|arbitrum] [--asset USDT|USDC]", fee: "POST /fapi/v3/aster/user-withdraw-info (taken from the amount)", requires: "mainnet; API wallet approved with --can-withdraw --ip-whitelist; destination = the account's own address" },
                 },
@@ -1403,19 +1399,22 @@ export function registerFundsCommands(program, getAdapter, isJson, getNetwork, g
         console.log(chalk.white.bold("  Pacifica") + chalk.gray(" → Solana"));
         console.log(`  Speed: ~10s  |  Fee: none`);
         console.log(`  Command: ${chalk.green("perp funds withdraw pacifica <amount>")}`);
-        console.log(chalk.white.bold("\n  Hyperliquid") + chalk.gray(" → Arbitrum"));
-        console.log(`  Speed: minutes  |  Fee: ~$1`);
-        console.log(`  Command: ${chalk.green("perp -e hl funds withdraw hyperliquid <amount>")}`);
+        console.log(chalk.white.bold("\n  Hyperliquid") + chalk.gray(" → Arbitrum (default) / Ethereum / Base over CCTP"));
+        console.log(`  Fee: ${await hlCctpFeeText()}`);
+        console.log(`  Command: ${chalk.green("perp funds withdraw hyperliquid <amount> [--chain arbitrum|ethereum|base]")}`);
         console.log(chalk.white.bold("\n  Lighter") + chalk.gray(" → Ethereum L1"));
         console.log(`  Speed: ~12h (standard)  |  Fee: varies`);
         console.log(`  Command: ${chalk.green("perp -e lt funds withdraw lighter <amount>")}`);
         console.log(chalk.white.bold("\n  Lighter RH") + chalk.gray(" → Robinhood Chain (USDG)"));
         console.log(`  Command: ${chalk.green("perp -e lighter-rh funds withdraw lighter <amount>")}`);
-        console.log(chalk.white.bold("\n  Ondo Perps") + chalk.gray(" → Ethereum (USDC)"));
-        console.log(`  Command: ${chalk.green("perp funds withdraw ondo <amount> --to <address>")}`);
-        console.log(`  Address book: ${chalk.green("perp funds address-book add ondo <your master address>")}`);
+        console.log(chalk.white.bold("\n  Ondo Perps") + chalk.gray(" — not available over the API"));
+        console.log(chalk.gray("  Withdraw in the Ondo Perps web app."));
         console.log(chalk.white.bold("\n  Arcus") + chalk.gray(" → Robinhood Chain (USDG, to the account owner)"));
         console.log(`  Command: ${chalk.green("perp funds withdraw arcus <amount>")}`);
+        console.log(chalk.white.bold("\n  QFEX") + chalk.gray(QFEX_WITHDRAW_ENABLED ? ` → ${chainLabel(QFEX_WITHDRAW_NETWORK)} (USDC, allowlisted address)` : " — disabled in perp-cli for now"));
+        console.log(QFEX_WITHDRAW_ENABLED
+            ? `  Command: ${chalk.green("perp funds withdraw qfex <amount> --to <allowlisted address>")}`
+            : chalk.gray(`  ${QFEX_WITHDRAW_DISABLED.remediation}.`));
         console.log(chalk.white.bold("\n  Aster") + chalk.gray(" → BNB Chain / Arbitrum (USDT, to the account's own address; mainnet only)"));
         console.log(`  Needs an API wallet approved with --can-withdraw --ip-whitelist; fee from user-withdraw-info`);
         console.log(`  Command: ${chalk.green("perp funds withdraw aster <amount> [--chain bsc|arbitrum] [--asset USDT|USDC]")}`);