openbroker 1.3.2 → 1.5.0

package/dist/core/config.d.ts

@@ -0,0 +1,22 @@
+import type { OpenBrokerConfig } from './types.js';
+export declare const GLOBAL_CONFIG_DIR: string;
+export declare const GLOBAL_ENV_PATH: string;
+export declare const LOCAL_ENV_PATH: string;
+export declare const PROJECT_ROOT: string;
+export declare const OPEN_BROKER_BUILDER_ADDRESS = "0xbb67021fA3e62ab4DA985bb5a55c5c1884381068";
+/**
+ * Ensure the global config directory exists
+ */
+export declare function ensureConfigDir(): string;
+/**
+ * Get the path where config was loaded from, or where it should be saved
+ */
+export declare function getConfigPath(): string;
+export declare function loadConfig(): OpenBrokerConfig;
+/**
+ * Check if the current config is read-only (no trading capability)
+ */
+export declare function isConfigured(): boolean;
+export declare function getNetwork(): 'mainnet' | 'testnet';
+export declare function isMainnet(): boolean;
+//# sourceMappingURL=config.d.ts.map

package/dist/core/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../scripts/core/config.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAOnD,eAAO,MAAM,iBAAiB,QAAiC,CAAC;AAChE,eAAO,MAAM,eAAe,QAAkC,CAAC;AAG/D,eAAO,MAAM,cAAc,QAA2B,CAAC;AAGvD,eAAO,MAAM,YAAY,QAAwC,CAAC;AAMlE,eAAO,MAAM,2BAA2B,+CAA+C,CAAC;AA0DxF;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAKxC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,UAAU,IAAI,gBAAgB,CAyD7C;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED,wBAAgB,UAAU,IAAI,SAAS,GAAG,SAAS,CAGlD;AAED,wBAAgB,SAAS,IAAI,OAAO,CAEnC"}

package/dist/core/config.js

@@ -0,0 +1,143 @@
+// Configuration loader for Open Broker
+import { config as loadDotenv } from 'dotenv';
+import { resolve, join } from 'path';
+import { existsSync, mkdirSync } from 'fs';
+import { homedir } from 'os';
+import { privateKeyToAccount } from 'viem/accounts';
+// Config locations (in order of priority)
+// 1. Environment variables (always checked first by process.env)
+// 2. Local .env in current working directory
+// 3. Global config at ~/.openbroker/.env
+export const GLOBAL_CONFIG_DIR = join(homedir(), '.openbroker');
+export const GLOBAL_ENV_PATH = join(GLOBAL_CONFIG_DIR, '.env');
+// Use OPENBROKER_CWD if set (from CLI wrapper), otherwise use process.cwd()
+const userCwd = process.env.OPENBROKER_CWD || process.cwd();
+export const LOCAL_ENV_PATH = resolve(userCwd, '.env');
+// Package root (for reference, not config loading)
+export const PROJECT_ROOT = resolve(import.meta.dirname, '../..');
+const MAINNET_URL = 'https://api.hyperliquid.xyz';
+const TESTNET_URL = 'https://api.hyperliquid-testnet.xyz';
+// Open Broker builder address - receives builder fees on all trades
+export const OPEN_BROKER_BUILDER_ADDRESS = '0xbb67021fA3e62ab4DA985bb5a55c5c1884381068';
+// Default read-only key (for info commands that don't need authentication)
+// This is a valid but essentially useless private key
+const DEFAULT_READ_ONLY_KEY = '0x0000000000000000000000000000000000000000000000000000000000000001';
+// Track if we've shown the read-only warning
+let readOnlyWarningShown = false;
+/**
+ * Find and load the config file from multiple locations
+ * Priority: env vars > local .env > global ~/.openbroker/.env > project .env
+ */
+function loadEnvFile() {
+    const verbose = process.env.VERBOSE === '1' || process.env.VERBOSE === 'true';
+    process.env.DOTENV_CONFIG_QUIET = 'true';
+    // Explicit config path via -c / --config (highest priority — overrides shell env vars)
+    const explicitPath = process.env.OPENBROKER_CONFIG;
+    if (explicitPath) {
+        if (existsSync(explicitPath)) {
+            loadDotenv({ path: explicitPath, override: true });
+            if (verbose) {
+                console.log(`[DEBUG] Loaded config from -c flag: ${explicitPath}`);
+            }
+            return explicitPath;
+        }
+        console.error(`Config file not found: ${explicitPath}`);
+        process.exit(1);
+    }
+    // Check locations in order of priority
+    const locations = [
+        { path: LOCAL_ENV_PATH, name: 'local (.env)' },
+        { path: GLOBAL_ENV_PATH, name: 'global (~/.openbroker/.env)' },
+    ];
+    for (const { path, name } of locations) {
+        if (existsSync(path)) {
+            const result = loadDotenv({ path });
+            if (verbose) {
+                console.log(`[DEBUG] Loaded config from ${name}: ${path}`);
+            }
+            return path;
+        }
+    }
+    if (verbose) {
+        console.log('[DEBUG] No config file found in any location');
+        console.log('[DEBUG] Run "openbroker setup" to configure');
+    }
+    return null;
+}
+// Load config on module import
+const loadedConfigPath = loadEnvFile();
+/**
+ * Ensure the global config directory exists
+ */
+export function ensureConfigDir() {
+    if (!existsSync(GLOBAL_CONFIG_DIR)) {
+        mkdirSync(GLOBAL_CONFIG_DIR, { recursive: true, mode: 0o700 });
+    }
+    return GLOBAL_CONFIG_DIR;
+}
+/**
+ * Get the path where config was loaded from, or where it should be saved
+ */
+export function getConfigPath() {
+    return loadedConfigPath || GLOBAL_ENV_PATH;
+}
+export function loadConfig() {
+    let privateKey = process.env.HYPERLIQUID_PRIVATE_KEY;
+    let isReadOnly = false;
+    if (!privateKey) {
+        // Use default read-only key for info commands
+        privateKey = DEFAULT_READ_ONLY_KEY;
+        isReadOnly = true;
+        // Show warning once
+        if (!readOnlyWarningShown) {
+            readOnlyWarningShown = true;
+            console.error('\x1b[33m⚠️  Not configured for trading. Run "openbroker setup" to enable trades.\x1b[0m\n');
+        }
+    }
+    if (!privateKey.startsWith('0x') || privateKey.length !== 66) {
+        throw new Error('HYPERLIQUID_PRIVATE_KEY must be a 64-character hex string with 0x prefix');
+    }
+    const network = process.env.HYPERLIQUID_NETWORK || 'mainnet';
+    const baseUrl = network === 'testnet' ? TESTNET_URL : MAINNET_URL;
+    // Builder fee is hardcoded — set by OpenBroker, not configurable by users
+    const builderAddress = OPEN_BROKER_BUILDER_ADDRESS.toLowerCase();
+    const builderFee = 10; // 10 tenths-of-bps = 1 bps = 0.01%
+    const slippageBps = parseInt(process.env.SLIPPAGE_BPS || '50', 10); // default 0.5%
+    // Derive the wallet address from private key
+    const wallet = privateKeyToAccount(privateKey);
+    const walletAddress = wallet.address.toLowerCase();
+    // Account address can be different if using an API wallet
+    const accountAddress = process.env.HYPERLIQUID_ACCOUNT_ADDRESS?.toLowerCase();
+    // Determine if this is an API wallet setup
+    const isApiWallet = accountAddress !== undefined && accountAddress !== walletAddress;
+    // Vault address — only for vault trading (ERC4626 contracts / native vaults via CoreWriter).
+    // Standard API wallets (approved via approveAgent) do NOT need this.
+    const vaultAddress = process.env.HYPERLIQUID_VAULT_ADDRESS?.toLowerCase();
+    const verbose = process.env.VERBOSE === '1' || process.env.VERBOSE === 'true';
+    return {
+        baseUrl,
+        privateKey: privateKey,
+        walletAddress,
+        accountAddress: accountAddress || walletAddress,
+        isApiWallet,
+        isReadOnly,
+        builderAddress,
+        builderFee,
+        slippageBps,
+        vaultAddress,
+        verbose,
+    };
+}
+/**
+ * Check if the current config is read-only (no trading capability)
+ */
+export function isConfigured() {
+    return !!process.env.HYPERLIQUID_PRIVATE_KEY;
+}
+export function getNetwork() {
+    const network = process.env.HYPERLIQUID_NETWORK || 'mainnet';
+    return network === 'testnet' ? 'testnet' : 'mainnet';
+}
+export function isMainnet() {
+    return getNetwork() === 'mainnet';
+}

package/dist/core/types.d.ts

@@ -0,0 +1,228 @@
+export interface OpenBrokerConfig {
+    baseUrl: string;
+    privateKey: `0x${string}`;
+    walletAddress: string;
+    accountAddress: string;
+    isApiWallet: boolean;
+    isReadOnly: boolean;
+    builderAddress: string;
+    builderFee: number;
+    slippageBps: number;
+    vaultAddress?: string;
+    verbose: boolean;
+}
+export interface BuilderInfo {
+    b: string;
+    f: number;
+}
+export type OrderType = {
+    limit: {
+        tif: 'Gtc' | 'Ioc' | 'Alo';
+    };
+} | {
+    trigger: {
+        triggerPx: string;
+        isMarket: boolean;
+        tpsl: 'tp' | 'sl';
+    };
+};
+export interface OrderRequest {
+    coin: string;
+    is_buy: boolean;
+    sz: number;
+    limit_px: number;
+    order_type: OrderType;
+    reduce_only?: boolean;
+    cloid?: string;
+}
+export interface OrderWire {
+    a: number;
+    b: boolean;
+    p: string;
+    s: string;
+    r: boolean;
+    t: OrderType;
+    c?: string;
+}
+export interface OrderResponse {
+    status: 'ok' | 'err';
+    response?: {
+        type: 'order';
+        data: {
+            statuses: Array<{
+                resting?: {
+                    oid: number;
+                };
+                filled?: {
+                    totalSz: string;
+                    avgPx: string;
+                    oid: number;
+                };
+                error?: string;
+                [key: string]: unknown;
+            }>;
+        };
+    } | string;
+    error?: string;
+}
+export interface CancelRequest {
+    coin: string;
+    oid: number;
+}
+export interface CancelResponse {
+    status: 'ok' | 'err';
+    response?: {
+        type: 'cancel';
+        data: {
+            statuses: string[];
+        };
+    };
+}
+export interface AssetMeta {
+    name: string;
+    szDecimals: number;
+    maxLeverage: number;
+    onlyIsolated?: boolean;
+    isDelisted?: boolean;
+    marginTableId?: number;
+    [key: string]: unknown;
+}
+export interface AssetCtx {
+    funding: string;
+    openInterest: string;
+    prevDayPx: string;
+    dayNtlVlm: string;
+    premium: string | null;
+    oraclePx: string;
+    markPx: string;
+    midPx?: string | null;
+    impactPxs?: [string, string] | string[] | null;
+    dayBaseVlm?: string;
+    [key: string]: unknown;
+}
+export interface Meta {
+    universe: AssetMeta[];
+}
+export interface MetaAndAssetCtxs {
+    meta: Meta;
+    assetCtxs: AssetCtx[];
+}
+export interface OutcomeSideSpec {
+    name: string;
+    token?: number;
+}
+export interface OutcomeMetaEntry {
+    outcome: number;
+    name: string;
+    description: string;
+    sideSpecs: OutcomeSideSpec[];
+}
+export interface OutcomeQuestion {
+    question: number;
+    name: string;
+    description: string;
+    fallbackOutcome: number;
+    namedOutcomes: number[];
+    settledNamedOutcomes?: number[];
+}
+export interface OutcomeMetaResponse {
+    outcomes: OutcomeMetaEntry[];
+    questions?: OutcomeQuestion[];
+}
+export interface OutcomeMarket {
+    outcome: number;
+    name: string;
+    description: string;
+    parsedDescription: Record<string, string>;
+    sides: Array<{
+        side: 0 | 1;
+        name: string;
+        encoding: number;
+        coin: string;
+        tokenName: string;
+        assetId: number;
+        token?: number;
+        szDecimals?: number;
+        midPx?: string;
+        markPx?: string;
+        prevDayPx?: string;
+        dayNtlVlm?: string;
+    }>;
+    question?: OutcomeQuestion;
+}
+export interface Position {
+    coin: string;
+    /**
+     * Canonical Hyperliquid asset index (native: meta index; HIP-3:
+     * 100000 + perp_dex_index*10000 + index_in_meta). Stamped by `getUserStateAll`
+     * so consumers can key positions by a unique integer rather than the coin string
+     * (whose HIP-3 prefix may differ between endpoints). Undefined if unresolvable.
+     */
+    assetId?: number;
+    szi: string;
+    entryPx: string;
+    positionValue: string;
+    unrealizedPnl: string;
+    returnOnEquity: string;
+    liquidationPx: string | null;
+    leverage: {
+        type: 'cross' | 'isolated';
+        value: number;
+        rawUsd?: string;
+    };
+    marginUsed: string;
+    maxLeverage: number;
+}
+export interface AssetPosition {
+    position: Position;
+    type: 'oneWay';
+}
+export interface MarginSummary {
+    accountValue: string;
+    totalNtlPos: string;
+    totalRawUsd: string;
+    totalMarginUsed: string;
+    withdrawable: string;
+}
+export interface ClearinghouseState {
+    assetPositions: AssetPosition[];
+    crossMarginSummary: MarginSummary;
+    marginSummary: MarginSummary;
+    crossMaintenanceMarginUsed: string;
+}
+export interface FundingInfo {
+    coin: string;
+    fundingRate: string;
+    annualizedRate: number;
+    premium: string;
+    openInterest: string;
+    markPx: string;
+    oraclePx: string;
+}
+export interface OpenOrder {
+    coin: string;
+    oid: number;
+    cloid?: string;
+    side: 'B' | 'A';
+    sz: string;
+    limitPx: string;
+    orderType: string;
+    origSz: string;
+    timestamp: number;
+}
+export interface InfoRequest {
+    type: string;
+    user?: string;
+    [key: string]: unknown;
+}
+export interface ExchangeRequest {
+    action: Record<string, unknown>;
+    nonce: number;
+    signature: {
+        r: string;
+        s: string;
+        v: number;
+    };
+    vaultAddress?: string | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../scripts/core/types.ts"],"names":[],"mappings":"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"}

package/dist/core/types.js

@@ -0,0 +1,2 @@
+// Hyperliquid API Types for Open Broker
+export {};

package/dist/core/utils.d.ts

@@ -0,0 +1,61 @@
+import type { OrderWire, OrderRequest } from './types.js';
+/**
+ * Round price to 5 significant figures and appropriate decimals
+ * Perps: max 6 decimals, Spot: max 8 decimals
+ */
+export declare function roundPrice(price: number, szDecimals: number, isSpot?: boolean): string;
+/**
+ * Round size to asset's szDecimals
+ */
+export declare function roundSize(size: number, szDecimals: number): string;
+/**
+ * Calculate slippage-adjusted price for market orders
+ */
+export declare function getSlippagePrice(midPrice: number, isBuy: boolean, slippageBps: number): number;
+/**
+ * Convert order request to wire format
+ */
+export declare function orderToWire(order: OrderRequest, assetIndex: number, szDecimals: number): OrderWire;
+/**
+ * Get current timestamp in milliseconds
+ */
+export declare function getTimestampMs(): number;
+/**
+ * Format USD amount for display
+ */
+export declare function formatUsd(amount: number | string): string;
+/**
+ * Format percentage for display
+ */
+export declare function formatPercent(value: number | string, decimals?: number): string;
+/**
+ * Format funding rate (hourly to annualized)
+ */
+export declare function annualizeFundingRate(hourlyRate: number | string): number;
+/**
+ * Parse CLI arguments into key-value pairs
+ */
+export declare function parseArgs(args: string[]): Record<string, string | boolean>;
+/**
+ * Normalize a coin name: uppercase the asset, keep dex prefix lowercase.
+ * "eth" → "ETH", "xyz:cl" → "xyz:CL", "xyz:CL" → "xyz:CL"
+ */
+export declare function normalizeCoin(coin: string): string;
+/**
+ * Sleep for specified milliseconds
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Generate a random client order ID
+ */
+export declare function generateCloid(): string;
+/**
+ * Check if builder fee is approved and print warning if not
+ * Returns true if approved, false if not
+ */
+export declare function checkBuilderFeeApproval(client: {
+    getMaxBuilderFee: () => Promise<string | null>;
+    builderAddress: string;
+    isTestnet: boolean;
+}): Promise<boolean>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/core/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../scripts/core/utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAa,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAErE;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAE,OAAe,GAAG,MAAM,CAM7F;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EACd,WAAW,EAAE,MAAM,GAClB,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,YAAY,EACnB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,SAAS,CAeX;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAQzD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,CAGlF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAGxE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAmB1E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAOtC;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE;IAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,GACrG,OAAO,CAAC,OAAO,CAAC,CAYlB"}

package/dist/core/utils.js

@@ -0,0 +1,142 @@
+// Utility functions for Open Broker
+/**
+ * Round price to 5 significant figures and appropriate decimals
+ * Perps: max 6 decimals, Spot: max 8 decimals
+ */
+export function roundPrice(price, szDecimals, isSpot = false) {
+    // Round to 5 significant figures first
+    const sigFigs = parseFloat(price.toPrecision(5));
+    // Then round to max decimals (6 for perps - szDecimals adjustment, 8 for spot)
+    const maxDecimals = isSpot ? 8 : Math.max(0, 6 - szDecimals);
+    return sigFigs.toFixed(maxDecimals);
+}
+/**
+ * Round size to asset's szDecimals
+ */
+export function roundSize(size, szDecimals) {
+    return size.toFixed(szDecimals);
+}
+/**
+ * Calculate slippage-adjusted price for market orders
+ */
+export function getSlippagePrice(midPrice, isBuy, slippageBps) {
+    const slippageMultiplier = slippageBps / 10000;
+    return isBuy
+        ? midPrice * (1 + slippageMultiplier)
+        : midPrice * (1 - slippageMultiplier);
+}
+/**
+ * Convert order request to wire format
+ */
+export function orderToWire(order, assetIndex, szDecimals) {
+    const wire = {
+        a: assetIndex,
+        b: order.is_buy,
+        p: roundPrice(order.limit_px, szDecimals),
+        s: roundSize(order.sz, szDecimals),
+        r: order.reduce_only ?? false,
+        t: order.order_type,
+    };
+    if (order.cloid) {
+        wire.c = order.cloid;
+    }
+    return wire;
+}
+/**
+ * Get current timestamp in milliseconds
+ */
+export function getTimestampMs() {
+    return Date.now();
+}
+/**
+ * Format USD amount for display
+ */
+export function formatUsd(amount) {
+    const num = typeof amount === 'string' ? parseFloat(amount) : amount;
+    return new Intl.NumberFormat('en-US', {
+        style: 'currency',
+        currency: 'USD',
+        minimumFractionDigits: 2,
+        maximumFractionDigits: 2,
+    }).format(num);
+}
+/**
+ * Format percentage for display
+ */
+export function formatPercent(value, decimals = 2) {
+    const num = typeof value === 'string' ? parseFloat(value) : value;
+    return `${(num * 100).toFixed(decimals)}%`;
+}
+/**
+ * Format funding rate (hourly to annualized)
+ */
+export function annualizeFundingRate(hourlyRate) {
+    const rate = typeof hourlyRate === 'string' ? parseFloat(hourlyRate) : hourlyRate;
+    return rate * 8760; // 24 * 365 hours
+}
+/**
+ * Parse CLI arguments into key-value pairs
+ */
+export function parseArgs(args) {
+    const result = {};
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg.startsWith('--')) {
+            const key = arg.slice(2);
+            const nextArg = args[i + 1];
+            if (nextArg && !nextArg.startsWith('--')) {
+                result[key] = nextArg;
+                i++;
+            }
+            else {
+                result[key] = true;
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Normalize a coin name: uppercase the asset, keep dex prefix lowercase.
+ * "eth" → "ETH", "xyz:cl" → "xyz:CL", "xyz:CL" → "xyz:CL"
+ */
+export function normalizeCoin(coin) {
+    const colonIdx = coin.indexOf(':');
+    if (colonIdx >= 0) {
+        return coin.slice(0, colonIdx).toLowerCase() + ':' + coin.slice(colonIdx + 1).toUpperCase();
+    }
+    return coin.toUpperCase();
+}
+/**
+ * Sleep for specified milliseconds
+ */
+export function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/**
+ * Generate a random client order ID
+ */
+export function generateCloid() {
+    const chars = 'abcdefghijklmnopqrstuvwxyz0123456789';
+    let result = '';
+    for (let i = 0; i < 16; i++) {
+        result += chars.charAt(Math.floor(Math.random() * chars.length));
+    }
+    return result;
+}
+/**
+ * Check if builder fee is approved and print warning if not
+ * Returns true if approved, false if not
+ */
+export async function checkBuilderFeeApproval(client) {
+    // Skip builder fee check on testnet — builder may not have balance
+    if (client.isTestnet)
+        return true;
+    const approval = await client.getMaxBuilderFee();
+    if (!approval) {
+        console.log('⚠️  Builder fee not approved!');
+        console.log(`   Run: npx tsx scripts/setup/approve-builder.ts`);
+        console.log(`   Builder: ${client.builderAddress}\n`);
+        return false;
+    }
+    return true;
+}