perp-cli 0.14.3 → 0.16.0

package/dist/commands/funds.js

@@ -7,7 +7,10 @@ import { registerFundsBridgeCommands } from "./bridge.js";
 import { registerFundsRebalanceCommands } from "./rebalance.js";
 import { PerpError, isConnectFailure, isDefiniteOrderFailure, isTransportFailure, orderOutcomeUnknown, parsePositiveDecimal } from "../errors.js";
 import { cliCredentialOptsFrom, requireMasterWallet } from "../config.js";
-import { getVenue, requireCapabilities, READ_ONLY_CREDENTIALS } from "../exchanges/venue.js";
+import { getVenue, requireCapabilities, roleUnsupported, READ_ONLY_CREDENTIALS } from "../exchanges/venue.js";
+import { RISEX_APP_URL, RISEX_FUNDS_APP_ONLY } from "../exchanges/venues/risex.js";
+import { VARIATIONAL_READ_ONLY_REMEDIATION } from "../exchanges/venues/variational.js";
+import { EXTENDED_READ_ONLY_REMEDIATION } from "../exchanges/venues/extended.js";
 import { unsupported } from "../exchanges/trading-v2.js";
 import { registerOnchainFundsCommands } from "./funds-onchain.js";
 import { QFEX_BANKER_NETWORK, QFEX_WITHDRAW_DISABLED, QFEX_WITHDRAW_ENABLED, QFEX_WITHDRAW_NETWORK } from "../exchanges/venues/qfex.js";
@@ -857,6 +860,34 @@ export function registerFundsCommands(program, getAdapter, isJson, getNetwork, g
             throw err;
         }
     });
+    supportsDryRun(faucet.command("risex"))
+        .description("[testnet tooling] Get the RISEx testnet faucet's 1000 test USDC (once per wallet; also registers the account; refused on mainnet; supports --dry-run). Refused while RISEx is read-only (trading in a later release)")
+        .action(async () => {
+        // Gated with RISEx trading (read-only release): the faucet is a venue write.
+        const risexDef = getVenue("risex");
+        if (!risexDef.roles.includes("trading"))
+            throw roleUnsupported(risexDef, "faucet");
+        const network = getNetwork();
+        if (network !== "testnet") {
+            throw unsupported("RISEx", `the test-USDC faucet on ${network}`, "the faucet exists only on testnet", "Run on testnet: perp -n testnet funds faucet risex");
+        }
+        const adapter = await getAdapterForExchange("risex");
+        const { RisexAdapter } = await import("../exchanges/risex/adapter.js");
+        if (!(adapter instanceof RisexAdapter))
+            throw new Error("risex venue did not produce a RisexAdapter");
+        const account = adapter.accountAddress();
+        if (isDryRun()) {
+            return printFundsPlan({ action: "deposit", venue: "risex", network, asset: "USDC (test)", amount: "1000", method: "testnet faucet POST /v1/account/deposit", account });
+        }
+        const res = await adapter.testnetFaucet();
+        logExecution({ type: "bridge", exchange: "risex", symbol: "USDC", side: "deposit", size: "1000", status: "success", dryRun: false, meta: { action: "faucet", network, account } });
+        if (isJson())
+            return printJson(jsonOk({ ...res, account, amount: "1000", network, method: "faucet" }));
+        console.log(chalk.green(`\n  RISEx testnet faucet: 1000 test USDC requested for ${account}`));
+        if (res.txHash !== null)
+            console.log(`  Tx: ${res.txHash}`);
+        console.log();
+    });
     // ═══════════════════════════════════════════════════════
     //  WITHDRAW
     // ═══════════════════════════════════════════════════════
@@ -1049,7 +1080,7 @@ export function registerFundsCommands(program, getAdapter, isJson, getNetwork, g
             throw err;
         }
     });
-    // ── Arcus — uniform surface (design §13.1): same <amount> + --to,
+    // ── Arcus — uniform surface: same <amount> + --to,
     //    same jsonOk(result), global --dry-run plans without sending. ──
     // 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.
@@ -1059,6 +1090,42 @@ export function registerFundsCommands(program, getAdapter, isJson, getNetwork, g
         .action(async () => {
         throw unsupported("Ondo Perps", "withdraw", "the Ondo Perps API does not allow withdrawals", "Withdraw from the Ondo Perps web app");
     });
+    // RISEx: deposits / withdrawals are app-only (owner decision). The commands stay so the refusal
+    // is explicit — also under --dry-run, before any credential or request.
+    supportsDryRun(withdraw.command("risex [amount]"))
+        .description(`Not available: RISEx withdrawals are done in the RISEx app (${RISEX_APP_URL}) — refused, also with --dry-run`)
+        .option("--to <address>", "Ignored — perp-cli does not move RISEx funds")
+        .action(async () => {
+        throw unsupported("risex", "withdraw", RISEX_FUNDS_APP_ONLY.reason, RISEX_FUNDS_APP_ONLY.remediation);
+    });
+    // TxFlow: market data only (unofficial read-only API).
+    supportsDryRun(withdraw.command("txflow [amount]"))
+        .description("Not available: TxFlow is market data only in perp-cli (unofficial read-only API) — refused")
+        .option("--to <address>", "Ignored")
+        .action(async () => {
+        throw roleUnsupported(getVenue("txflow"), "withdraw");
+    });
+    // Variational: read-only (market data) in perp-cli; no public trading API yet.
+    supportsDryRun(withdraw.command("variational [amount]"))
+        .description("Not available: Variational is read-only (market data) in perp-cli — refused")
+        .option("--to <address>", "Ignored")
+        .action(async () => {
+        throw roleUnsupported(getVenue("variational"), "withdraw");
+    });
+    // GRVT: read-only (market data) in this version.
+    supportsDryRun(withdraw.command("grvt [amount]"))
+        .description("Not available: GRVT is read-only (market data) in this version — refused, also with --dry-run")
+        .option("--to <address>", "Ignored")
+        .action(async () => {
+        throw roleUnsupported(getVenue("grvt"), "withdraw");
+    });
+    // Extended: market data only in this version.
+    supportsDryRun(withdraw.command("extended [amount]"))
+        .description("Not available: Extended is market data only in this version — refused, also with --dry-run")
+        .option("--to <address>", "Ignored")
+        .action(async () => {
+        throw roleUnsupported(getVenue("extended"), "withdraw");
+    });
     for (const venueId of ["arcus"]) {
         const def = getVenue(venueId);
         const asset = withdrawAssetOf(def);
@@ -1128,7 +1195,7 @@ export function registerFundsCommands(program, getAdapter, isJson, getNetwork, g
             }
         });
     }
-    // ── QFEX (design §14.6, §14.12 #8) — custodial; deposit = address display, withdraw = banker POST
+    // ── QFEX — custodial; deposit = address display, withdraw = banker POST
     //    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) => {
@@ -1206,6 +1273,31 @@ export function registerFundsCommands(program, getAdapter, isJson, getNetwork, g
             throw err;
         }
     });
+    supportsDryRun(deposit.command("risex [amount]"))
+        .description(`Not available: RISEx deposits are done in the RISEx app (${RISEX_APP_URL}) — refused, also with --dry-run`)
+        .action(async () => {
+        throw unsupported("risex", "deposit", RISEX_FUNDS_APP_ONLY.reason, RISEX_FUNDS_APP_ONLY.remediation);
+    });
+    supportsDryRun(deposit.command("txflow [amount]"))
+        .description("Not available: TxFlow is market data only in perp-cli (unofficial read-only API) — refused")
+        .action(async () => {
+        throw roleUnsupported(getVenue("txflow"), "deposit");
+    });
+    supportsDryRun(deposit.command("variational [amount]"))
+        .description("Not available: Variational is read-only (market data) in perp-cli — refused")
+        .action(async () => {
+        throw roleUnsupported(getVenue("variational"), "deposit");
+    });
+    supportsDryRun(deposit.command("grvt [amount]"))
+        .description("Not available: GRVT is read-only (market data) in this version — refused, also with --dry-run")
+        .action(async () => {
+        throw roleUnsupported(getVenue("grvt"), "deposit");
+    });
+    supportsDryRun(deposit.command("extended [amount]"))
+        .description("Not available: Extended is market data only in this version — refused, also with --dry-run")
+        .action(async () => {
+        throw roleUnsupported(getVenue("extended"), "deposit");
+    });
     supportsDryRun(deposit.command("qfex"))
         .description("Show the QFEX deposit address for USDC on Arbitrum One (perp-cli sends nothing — transfer from your own wallet; supports --dry-run)")
         // --chain, not --network: the root -n/--network (mainnet | testnet) would swallow a subcommand --network.
@@ -1258,6 +1350,14 @@ export function registerFundsCommands(program, getAdapter, isJson, getNetwork, g
         if (isNaN(amountNum) || amountNum <= 0)
             throw new Error("Invalid amount");
         const exchangeOpt = program.opts().exchange;
+        // -e names a venue this command cannot move funds on: refuse instead of transferring on Hyperliquid.
+        if (exchangeOpt !== undefined) {
+            const def = getVenue(exchangeOpt);
+            if (!def.roles.includes("account"))
+                throw roleUnsupported(def, "transfer");
+            if (def.id === "risex")
+                throw unsupported("risex", "transfer", RISEX_FUNDS_APP_ONLY.reason, RISEX_FUNDS_APP_ONLY.remediation);
+        }
         if (exchangeOpt !== undefined && getVenue(exchangeOpt).id === "qfex") {
             if (isDryRun()) {
                 return printFundsPlan({ action: "transfer", venue: "qfex", network: getNetwork(), asset: "USDC", amount, from: opts.from ?? "the key's account", destination });
@@ -1349,6 +1449,11 @@ export function registerFundsCommands(program, getAdapter, isJson, getNetwork, g
                     qfex: { chain: "Arbitrum", token: "USDC", min: null, method: "address display only: perp funds deposit qfex, then send USDC from your wallet" },
                     aster: { chain: "BNB Chain (default) / Arbitrum", token: "USDT (default) / USDC", min: null, gas: "BNB / Arbitrum ETH", method: "approve + vault depositFor(token, forAddress, amount, broker 1) (mainnet only)", command: "perp funds deposit aster <amount> [--chain bsc|arbitrum] [--asset USDT|USDC]" },
                     ondo: { chain: "Arbitrum (default) / Ethereum", token: "USDC", min: null, gas: "ETH", method: "USDC transfer to the account's funding address (mainnet only)", command: "perp funds deposit ondo <amount> [--chain arbitrum|ethereum] [--probe <amount>]" },
+                    risex: { supported: false, note: `${RISEX_FUNDS_APP_ONLY.reason} — ${RISEX_FUNDS_APP_ONLY.remediation}`, testnet: getVenue("risex").roles.includes("trading") ? "perp -n testnet funds faucet risex (1000 test USDC, once)" : null },
+                    txflow: { supported: false, note: "TxFlow is market data only in perp-cli (unofficial read-only API)" },
+                    variational: { supported: false, note: VARIATIONAL_READ_ONLY_REMEDIATION },
+                    grvt: { supported: false, note: "GRVT is read-only (market data) in this version; trading is planned for a later release" },
+                    extended: { supported: false, note: EXTENDED_READ_ONLY_REMEDIATION },
                 },
                 withdraw: {
                     pacifica: { chain: "Solana", token: "USDC", speed: "~10s", fee: "none" },
@@ -1360,6 +1465,11 @@ export function registerFundsCommands(program, getAdapter, isJson, getNetwork, g
                         ? { 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>" },
+                    risex: { supported: false, note: `${RISEX_FUNDS_APP_ONLY.reason} — ${RISEX_FUNDS_APP_ONLY.remediation}` },
+                    txflow: { supported: false, note: "TxFlow is market data only in perp-cli (unofficial read-only API)" },
+                    variational: { supported: false, note: VARIATIONAL_READ_ONLY_REMEDIATION },
+                    grvt: { supported: false, note: "GRVT is read-only (market data) in this version; trading is planned for a later release" },
+                    extended: { supported: false, note: EXTENDED_READ_ONLY_REMEDIATION },
                     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" },
                 },
             }));

package/dist/commands/init.d.ts

@@ -47,7 +47,7 @@ export interface SetupSettingsChange {
 export declare function applySetupSettings(change: SetupSettingsChange): Settings;
 /** Real follow-up commands for the configured venues (all exist in this CLI). */
 export declare function nextStepCommands(venues: VenueId[], network: Network): string[];
-/** Plain-language slippage explanation (design §13.2, §13.10 #3). */
+/** Plain-language slippage explanation. */
 export declare function slippageExplanation(venues: VenueId[]): string[];
 export type AgentStepResult = {
     venue: VenueId;

package/dist/commands/init.js

@@ -9,8 +9,9 @@ import { PerpError, classifyError } from "../errors.js";
 import { jsonOk, jsonError, printJson } from "../utils.js";
 import { resolvePassphrase } from "../agent-wallet/passphrase.js";
 import { loadOws } from "../signer/ows-loader.js";
-import { getVenue, listVenuesWithRole, networkConfig, tryResolveVenueId } from "../exchanges/venue.js";
+import { getVenue, listVenuesWithRole, networkConfig, roleUnsupported, tryResolveVenueId } from "../exchanges/venue.js";
 import "../exchanges/venues/index.js";
+import { VARIATIONAL_READ_ONLY_REMEDIATION } from "../exchanges/venues/variational.js";
 import { maxDefaultSlippageBps, parseSlippageSettingBps } from "../exchanges/slippage.js";
 import { agentApproveUnsupportedReason, approveVenueAgent, assertLighterSlot, isLighterFamilyVenue, deprecatedPassphraseOption, printApproveOutcome, promptHidden, verifyVenueAgent, warnDeprecatedPassphrase, } from "./agent.js";
 import { importOwsWallet } from "./wallet.js";
@@ -127,7 +128,11 @@ export function setupVenues() {
 /** Resolve one venue id/alias for setup: must be a trading venue with an environment on `network`. */
 export function resolveSetupVenue(input, network) {
     const id = tryResolveVenueId(input.trim());
-    if (id === null || !getVenue(id).roles.includes("trading")) {
+    // A registered venue without the trading role (release-gated RISEx, market-data-only TxFlow /
+    // Variational / GRVT) is a capability refusal, not an unknown name.
+    if (id !== null && !getVenue(id).roles.includes("trading"))
+        throw roleUnsupported(getVenue(id), "setup");
+    if (id === null) {
         throw new PerpError("INVALID_PARAMS", `Unknown trading venue "${input}"`, {
             remediation: `Use one of: ${setupVenues().map(v => v.id).join(", ")}`,
         });
@@ -177,7 +182,7 @@ export function applySetupSettings(change) {
 }
 /** Agent names already registered for `venue` on `network` in settings. */
 function registeredAgentNames(venue, network) {
-    if (venue === "ondo" || venue === "arcus" || venue === "qfex") {
+    if (venue === "ondo" || venue === "arcus" || venue === "qfex" || venue === "risex") {
         const map = loadSettings().agents?.[venue];
         return map ? Object.values(map).filter(m => m.network === network).map(m => m.agentName) : [];
     }
@@ -186,11 +191,11 @@ function registeredAgentNames(venue, network) {
 function rotateHint(venue) {
     if (venue === "qfex")
         return "perp wallet agent import qfex --replace";
-    return venue === "ondo" || venue === "arcus"
+    return venue === "ondo" || venue === "arcus" || venue === "risex"
         ? `perp wallet agent approve ${venue} --rotate`
         : `perp wallet agent rotate ${venue}`;
 }
-/** Why the wizard cannot register an agent for `venue` on `network`; null when it can (uniform wording, design §13.6). */
+/** Why the wizard cannot register an agent for `venue` on `network`; null when it can (uniform wording). */
 function approveBlocker(venue, network) {
     const reason = agentApproveUnsupportedReason(venue, network, "approve");
     return reason === null ? null : `${getVenue(venue).displayName} agent management on ${network} not supported — ${reason}`;
@@ -215,7 +220,7 @@ export function nextStepCommands(venues, network) {
     cmds.push("perp settings show");
     return cmds;
 }
-/** Plain-language slippage explanation (design §13.2, §13.10 #3). */
+/** Plain-language slippage explanation. */
 export function slippageExplanation(venues) {
     const lines = [
         "Market orders are sent as immediate-or-cancel (IOC) limit orders. The limit price is the",
@@ -260,6 +265,19 @@ function signingSummary(p, master) {
             return ["No signature. Your Ondo API key is stored encrypted in ~/.perp/ondo-agents/ and checked with one read-only account request."];
         case "qfex":
             return ["No signature. Your QFEX API key is stored encrypted in ~/.perp/qfex-agents/ and checked with read-only requests."];
+        case "risex":
+            return [
+                `EIP-712 RegisterSigner signed by master EVM ${master.evm} (+ VerifySigner by the new signer): registers a session signer (${expiry}).`,
+                `Then the new signer signs DisablePermission for every permission except trading, and ${master.evm} sends those transactions ON-CHAIN on RISE chain (needs RISE-chain ETH for gas): the signer can trade but never move funds, and only the master could re-enable a permission.`,
+            ];
+        case "txflow":
+            return ["Nothing — TxFlow is market data only (unofficial read-only API)."];
+        case "variational":
+            return [`Nothing — ${VARIATIONAL_READ_ONLY_REMEDIATION}.`];
+        case "grvt":
+            return ["Nothing — GRVT is read-only (market data) in this version; trading is planned for a later release."];
+        case "extended":
+            return ["Nothing — Extended is read-only (market data) in this version; trading is planned for a later release."];
     }
 }
 function failed(venue, err) {
@@ -944,7 +962,9 @@ export async function runNonInteractiveSetup(opts) {
         let defaultVenue = null;
         if (defaultRaw !== undefined) {
             const id = tryResolveVenueId(defaultRaw);
-            if (id === null || !getVenue(id).roles.includes("trading")) {
+            if (id !== null && !getVenue(id).roles.includes("trading"))
+                throw roleUnsupported(getVenue(id), "setup");
+            if (id === null) {
                 throw new PerpError("INVALID_PARAMS", `Invalid --default-venue "${defaultRaw}"`, {
                     remediation: `Use one of: ${(venues.length > 0 ? venues : setupVenues().map(v => v.id)).join(", ")}`,
                 });

package/dist/commands/manage.js

@@ -99,9 +99,17 @@ export function registerWalletManageCommands(parent, getAdapter, isJson, getPaci
         .description("Create a new vault (lake)")
         .option("--manager <address>", "Manager address (omit to create a fresh vault with no manager)")
         .option("--nickname <name>", "Display name for the vault")
-        .option("--initial-deposit <amount>", "Seed deposit in USDC from the creator")
+        .option("--initial-deposit <amount>", "Seed deposit in USDC from the creator (master-signed only: refused with an agent key)")
         .action(async (opts) => {
         const a = await pac();
+        // A seed deposit moves funds into a vault like `vault deposit`: master-signed only (an agent
+        // key must not be able to fund a vault it names the manager of).
+        if (opts.initialDeposit !== undefined && a.activeSignerTier !== "master" && a.activeSignerTier !== "pk") {
+            throw new PerpError("NO_SIGNER_AVAILABLE", "A vault seed deposit (--initial-deposit) must be signed by the master wallet, not the agent key", {
+                exchange: "pacifica",
+                remediation: "Re-run with --no-agent (master wallet), or create the vault without --initial-deposit and deposit with: perp -e pacifica vault deposit <vault> <amount>",
+            });
+        }
         const result = await a.sdk.createLake({
             manager: opts.manager === undefined ? null : opts.manager,
             nickname: opts.nickname === undefined ? null : opts.nickname,
@@ -112,26 +120,20 @@ export function registerWalletManageCommands(parent, getAdapter, isJson, getPaci
         console.log(chalk.green(`\n  Vault created.\n`));
         console.log(JSON.stringify(result, null, 2));
     });
-    lake
-        .command("deposit <lake> <amount>")
-        .description("Deposit USDC into a vault (<lake> = vault address)")
-        .action(async (lakeAddress, amount) => {
-        const a = await pac();
-        const result = await a.sdk.depositToLake({ lake: lakeAddress, amount: parsePositiveDecimal(amount, "deposit amount") }, a.publicKey, a.signer);
-        if (isJson())
-            return printJson(jsonOk(result));
-        console.log(chalk.green(`\n  Deposited $${amount} to vault ${lakeAddress}.\n`));
-    });
-    lake
-        .command("withdraw <lake> <shares>")
-        .description("Redeem vault shares (<lake> = vault address, <shares> = number of shares, not USDC)")
-        .action(async (lakeAddress, shares) => {
-        const a = await pac();
-        const result = await a.sdk.withdrawFromLake({ lake: lakeAddress, shares: parsePositiveDecimal(shares, "shares") }, a.publicKey, a.signer);
-        if (isJson())
-            return printJson(jsonOk(result));
-        console.log(chalk.green(`\n  Redeemed ${shares} shares from vault ${lakeAddress}.\n`));
-    });
+    // deposit / withdraw moved to the validated path (`perp -e pacifica vault deposit|withdraw`):
+    // nickname / address resolution, documented limits, --dry-run, unknown-outcome handling, and a
+    // master-only vault deposit. These stubs refuse before any key is loaded or anything is signed.
+    for (const [sub, args, target] of [["deposit", "<lake> <amount>", "vault deposit <vault> <amount>"], ["withdraw", "<lake> <shares>", "vault withdraw <vault> <shares>|--all"]]) {
+        lake
+            .command(`${sub} ${args}`)
+            .description(`Moved: use perp -e pacifica ${target} (validated, supports --dry-run)`)
+            .action(() => {
+            throw new PerpError("INVALID_PARAMS", `wallet manage lake ${sub} was replaced by: perp -e pacifica ${target}`, {
+                exchange: "pacifica",
+                remediation: `Run: perp -e pacifica --dry-run ${target} — then without --dry-run (nothing was signed or sent)`,
+            });
+        });
+    }
     // Pacifica builder-OWNER tools. A user's builder approval / revoke / status is
     // `perp wallet builder approve|revoke|status <venue>` (settings builder.<venue>).
     const builder = manage.command("builder").description("Pacifica builder-owner tools (overview, trades, leaderboard, update-fee). Approve / revoke / status: perp wallet builder");

package/dist/commands/market.d.ts

@@ -1,6 +1,54 @@
 import { Command } from "commander";
 import type { ExchangeAdapter } from "../exchanges/index.js";
 import "../exchanges/venues/index.js";
+/**
+ * Venues of the multi-venue `market list|prices` (no -e): every venue with the marketData role
+ * and a (public) adapter — market-data-only venues (TxFlow, Variational, GRVT, Extended) included.
+ * They were left out in 0.15.0 because the list was the account-role venues.
+ */
+export declare const MARKET_DATA_VENUES: import("../exchanges/venue-types.js").VenueId[];
+/**
+ * `--limit` / `-l` / `--depth`: a positive integer, the same rule on every venue (parseInt took
+ * "abc" as NaN and "-5" as a negative slice). Anything else → INVALID_PARAMS before any request.
+ */
+export declare function parsePositiveIntArg(raw: string, flag: string): number;
+/**
+ * Most order-book levels per side each venue serves (measured live 2026-10-19; the request size
+ * where the venue takes one): one rule for every venue — `--depth` above it is INVALID_PARAMS
+ * naming the max, never clamped or silently short. Absent = the full book (Extended).
+ */
+export declare const BOOK_DEPTH_MAX: Readonly<Record<string, number>>;
+export declare function assertBookDepth(venue: string, depth: number): void;
+/**
+ * `--start` / `--end`: unix ms (digits) or an ISO-8601 date / time (`Date.parse`; "2026-10-18" is
+ * UTC midnight). parseInt("2026-10-18") read 2026 ms. Non-finite → INVALID_PARAMS.
+ */
+export declare function parseTimeArg(raw: string, flag: string): number;
+/**
+ * Bare market symbol of a CLI argument as `market info` matches it against getMarkets() rows:
+ * "btc-perp" → "BTC", Extended "BTC-USD" / "TSLA_24_5-USD" → "BTC" / "TSLA", TxFlow "BTC-USDC" → "BTC"
+ * (book / funding resolve these through the venue; info read the raw argument and missed them).
+ * HIP-3 "xyz:XYZ100" keeps its prefix.
+ */
+export declare function bareSymbolOf(arg: string): string;
+/**
+ * History order, one rule for every venue: trades and funding history newest first, candles
+ * oldest first (Aster / QFEX answered funding oldest first, GRVT trades oldest first). A stable
+ * copy — the adapter's array (and its non-enumerable tape metadata) is left as is.
+ */
+export declare function newestFirst<T extends {
+    time: number;
+}>(rows: readonly T[]): T[];
+export declare function notTradableReason(m: {
+    tradable?: boolean;
+    status?: string | null;
+}): string | null;
 export declare function registerMarketCommands(program: Command, getAdapter: () => Promise<ExchangeAdapter>, isJson: () => boolean, getAdapterForExchange?: (exchange: string) => Promise<ExchangeAdapter>, 
 /** Credentialed adapter of the selected venue — for market data the venue serves only to an authenticated account. */
 getAccountAdapter?: () => Promise<ExchangeAdapter>): void;
+/**
+ * Why a listed market is not tradable, from the row's `status` when the venue states it (QFEX
+ * "nonUsdQuote", Ondo "closed" / "reduceOnly"); the generic off-hours text only when it does not.
+ * null = tradable or no tradability flag.
+ */
+export declare function notTradableNote(m: object): string | null;