hyperliquid-prime 0.1.0

package/dist/cli/program.js

@@ -0,0 +1,232 @@
+import { Command } from "commander";
+import { createContext } from "./context.js";
+import { output, formatTable } from "./output.js";
+async function withClient(program, action) {
+    const opts = program.opts();
+    const hp = await createContext(opts);
+    try {
+        await action(hp, opts);
+    }
+    finally {
+        await hp.disconnect();
+    }
+}
+function parseSide(side) {
+    const normalized = side.toLowerCase();
+    if (normalized === "buy" || normalized === "sell") {
+        return normalized;
+    }
+    throw new Error(`Invalid side "${side}". Expected "buy" or "sell".`);
+}
+function parsePositiveNumber(raw, label) {
+    const value = Number(raw);
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new Error(`Invalid ${label} "${raw}". Expected a positive number.`);
+    }
+    return value;
+}
+function parsePositiveInt(raw, label) {
+    const value = Number(raw);
+    if (!Number.isInteger(value) || value <= 0) {
+        throw new Error(`Invalid ${label} "${raw}". Expected a positive integer.`);
+    }
+    return value;
+}
+export function createProgram() {
+    const program = new Command();
+    program
+        .name("hp")
+        .description("Hyperliquid Prime CLI — unified HIP-3 market trading")
+        .version("0.1.0")
+        .option("--testnet", "Use Hyperliquid testnet", false)
+        .option("--key <hex>", "Private key (hex) for trading")
+        .option("--key-env <name>", "Environment variable for private key (recommended)", "HP_PRIVATE_KEY")
+        .option("--log-level <level>", "Log level", "warn")
+        .option("--json", "Output as JSON", false)
+        .option("--no-builder-fee", "Disable builder fee");
+    program
+        .command("markets")
+        .description("Show all HIP-3 markets for an asset")
+        .argument("<asset>", "Base asset symbol (e.g. ETH)")
+        .action(async (asset) => withClient(program, async (hp, opts) => {
+        const markets = hp.getMarkets(asset);
+        if (opts.json) {
+            output(markets, true);
+            return;
+        }
+        if (markets.length === 0) {
+            console.log(`No markets found for ${asset}`);
+            return;
+        }
+        const table = formatTable(["Coin", "Dex", "Collateral", "Native", "Funding", "OI", "Mark"], markets.map((m) => [
+            m.coin,
+            m.dexName,
+            m.collateral,
+            m.isNative ? "yes" : "no",
+            m.funding ?? "-",
+            m.openInterest ?? "-",
+            m.markPrice ?? "-",
+        ]));
+        console.log(table);
+    }));
+    program
+        .command("book")
+        .description("Show aggregated orderbook for an asset")
+        .argument("<asset>", "Base asset symbol")
+        .option("-d, --depth <n>", "Number of levels", "5")
+        .action(async (asset, cmdOpts) => withClient(program, async (hp, opts) => {
+        const depth = parsePositiveInt(cmdOpts.depth, "depth");
+        const book = await hp.getAggregatedBook(asset);
+        if (opts.json) {
+            output(book, true);
+            return;
+        }
+        console.log(`\nAggregated Book: ${asset}`);
+        console.log("=".repeat(60));
+        console.log("\nAsks (best first):");
+        const asks = book.asks.slice(0, depth).reverse();
+        for (const level of asks) {
+            const sources = level.sources
+                .map((s) => `${s.coin}:${s.sz.toFixed(4)}`)
+                .join(", ");
+            console.log(`  ${level.px.toFixed(2)}  |  ${level.sz.toFixed(4)}  [${sources}]`);
+        }
+        console.log("  --- mid ---");
+        console.log("Bids (best first):");
+        const bids = book.bids.slice(0, depth);
+        for (const level of bids) {
+            const sources = level.sources
+                .map((s) => `${s.coin}:${s.sz.toFixed(4)}`)
+                .join(", ");
+            console.log(`  ${level.px.toFixed(2)}  |  ${level.sz.toFixed(4)}  [${sources}]`);
+        }
+    }));
+    program
+        .command("funding")
+        .description("Compare funding rates across markets")
+        .argument("<asset>", "Base asset symbol")
+        .action(async (asset) => withClient(program, async (hp, opts) => {
+        const comparison = await hp.getFundingComparison(asset);
+        if (opts.json) {
+            output(comparison, true);
+            return;
+        }
+        console.log(`\nFunding Comparison: ${asset}`);
+        console.log("=".repeat(60));
+        const table = formatTable(["Coin", "Dex", "Collateral", "Funding Rate", "OI", "Mark"], comparison.markets.map((m) => [
+            m.coin,
+            m.dexName,
+            m.collateral,
+            (m.fundingRate * 100).toFixed(6) + "%",
+            m.openInterest.toFixed(2),
+            m.markPrice.toFixed(2),
+        ]));
+        console.log(table);
+        console.log(`\nBest for LONG:  ${comparison.bestForLong}`);
+        console.log(`Best for SHORT: ${comparison.bestForShort}`);
+    }));
+    program
+        .command("quote")
+        .description("Get a routing quote (does not execute)")
+        .argument("<asset>", "Base asset symbol")
+        .argument("<side>", "buy or sell")
+        .argument("<size>", "Size in base asset units")
+        .action(async (asset, sideRaw, sizeRaw) => withClient(program, async (hp, opts) => {
+        const side = parseSide(sideRaw);
+        const size = parsePositiveNumber(sizeRaw, "size");
+        const quote = await hp.quote(asset, side, size);
+        if (opts.json) {
+            output(quote, true);
+            return;
+        }
+        console.log(`\nQuote: ${side.toUpperCase()} ${size} ${asset}`);
+        console.log("=".repeat(60));
+        console.log(`Selected Market:  ${quote.selectedMarket.coin}`);
+        console.log(`Dex:              ${quote.selectedMarket.dexName}`);
+        console.log(`Collateral:       ${quote.selectedMarket.collateral}`);
+        console.log(`Est. Avg Price:   ${quote.estimatedAvgPrice.toFixed(4)}`);
+        console.log(`Est. Impact:      ${quote.estimatedPriceImpact.toFixed(2)} bps`);
+        console.log(`Funding Rate:     ${(quote.estimatedFundingRate * 100).toFixed(6)}%`);
+        if (quote.warnings && quote.warnings.length > 0) {
+            console.log("\nWarnings:");
+            for (const warning of quote.warnings) {
+                console.log(`  - ${warning}`);
+            }
+        }
+        console.log(`\nAlternatives considered: ${quote.alternativesConsidered.length}`);
+        for (const alt of quote.alternativesConsidered) {
+            const marker = alt.market.coin === quote.selectedMarket.coin ? " <-- BEST" : "";
+            console.log(`  ${alt.market.coin}: score=${alt.totalScore.toFixed(2)} impact=${alt.priceImpact.toFixed(2)}bps${alt.reason ? ` (${alt.reason})` : ""}${marker}`);
+        }
+    }));
+    program
+        .command("long")
+        .description("Open a long position via best market")
+        .argument("<asset>", "Base asset symbol")
+        .argument("<size>", "Size in base asset units")
+        .action(async (asset, sizeRaw) => withClient(program, async (hp, opts) => {
+        const size = parsePositiveNumber(sizeRaw, "size");
+        const receipt = await hp.long(asset, size);
+        if (opts.json) {
+            output(receipt, true);
+            return;
+        }
+        console.log(receipt.success
+            ? `LONG ${size} ${asset} via ${receipt.market.coin}: filled ${receipt.filledSize} @ ${receipt.avgPrice}`
+            : `FAILED: ${receipt.error}`);
+    }));
+    program
+        .command("short")
+        .description("Open a short position via best market")
+        .argument("<asset>", "Base asset symbol")
+        .argument("<size>", "Size in base asset units")
+        .action(async (asset, sizeRaw) => withClient(program, async (hp, opts) => {
+        const size = parsePositiveNumber(sizeRaw, "size");
+        const receipt = await hp.short(asset, size);
+        if (opts.json) {
+            output(receipt, true);
+            return;
+        }
+        console.log(receipt.success
+            ? `SHORT ${size} ${asset} via ${receipt.market.coin}: filled ${receipt.filledSize} @ ${receipt.avgPrice}`
+            : `FAILED: ${receipt.error}`);
+    }));
+    program
+        .command("positions")
+        .description("Show all positions (unified view)")
+        .action(async () => withClient(program, async (hp, opts) => {
+        const grouped = await hp.getGroupedPositions();
+        if (opts.json) {
+            output(Object.fromEntries(grouped), true);
+            return;
+        }
+        if (grouped.size === 0) {
+            console.log("No open positions");
+            return;
+        }
+        for (const [asset, positions] of grouped) {
+            console.log(`\n${asset}:`);
+            for (const pos of positions) {
+                console.log(`  ${pos.side.toUpperCase()} ${pos.size.toFixed(4)} @ ${pos.entryPrice.toFixed(2)} | mark: ${pos.markPrice.toFixed(2)} | PnL: ${pos.unrealizedPnl.toFixed(2)} | lev: ${pos.leverage}x | via ${pos.coin}`);
+            }
+        }
+    }));
+    program
+        .command("balance")
+        .description("Show account balance")
+        .action(async () => withClient(program, async (hp, opts) => {
+        const balance = await hp.getBalance();
+        if (opts.json) {
+            output(balance, true);
+            return;
+        }
+        console.log(`\nAccount Balance`);
+        console.log("=".repeat(40));
+        console.log(`Account Value:    ${balance.accountValue}`);
+        console.log(`Margin Used:      ${balance.totalMarginUsed}`);
+        console.log(`Notional Pos:     ${balance.totalNtlPos}`);
+        console.log(`Raw USD:          ${balance.totalRawUsd}`);
+    }));
+    return program;
+}
+//# sourceMappingURL=program.js.map

package/dist/cli/program.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.js","sourceRoot":"","sources":["../../src/cli/program.ts"],"names":[],"mappings":"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"}

package/dist/collateral/manager.d.ts

@@ -0,0 +1,45 @@
+import type { HLProvider } from "../provider/provider.js";
+import type { Logger } from "../logging/logger.js";
+import type { SplitAllocation } from "../router/types.js";
+import type { CollateralPlan, CollateralReceipt } from "./types.js";
+/**
+ * CollateralManager handles two concerns:
+ * 1. Estimation (read-only): What collateral swaps are needed and how much will they cost?
+ * 2. Execution (writes): Perform the actual swaps and enable DEX abstraction.
+ *
+ * When DEX abstraction is enabled on Hyperliquid:
+ *   - USDC-collateral DEXs pull from the perp USDC balance automatically
+ *   - Non-USDC DEXs pull from the user's spot balance of that token
+ *
+ * So the flow for non-USDC collateral is:
+ *   1. usdClassTransfer: move USDC from perp → spot
+ *   2. Spot order: swap USDC → target token (e.g., USDH)
+ *   3. DEX abstraction handles the rest
+ */
+export declare class CollateralManager {
+    private provider;
+    private simulator;
+    private logger;
+    constructor(provider: HLProvider, logger: Logger);
+    /**
+     * Estimate collateral requirements for a set of split allocations.
+     * This is read-only — no orders or transfers are made.
+     */
+    estimateRequirements(allocations: SplitAllocation[], userAddress: string): Promise<CollateralPlan>;
+    /**
+     * Estimate the cost in basis points to swap fromToken to toToken on the spot market.
+     * Uses the spot L2Book to simulate the swap.
+     */
+    estimateSwapCost(_fromToken: string, toToken: string, amount: number): Promise<number>;
+    /**
+     * Execute collateral preparation: enable abstraction, perform swaps.
+     * Call this before placing split orders.
+     */
+    prepare(plan: CollateralPlan, _userAddress: string): Promise<CollateralReceipt>;
+    /**
+     * Compute weighted average swap cost across all requirements,
+     * weighted by the proportion of each token's allocation.
+     */
+    private weightedSwapCost;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/collateral/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/collateral/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,KAAK,EAEV,cAAc,EACd,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;GAaG;AACH,qBAAa,iBAAiB;IAK1B,OAAO,CAAC,QAAQ;IAJlB,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,MAAM,CAAS;gBAGb,QAAQ,EAAE,UAAU,EAC5B,MAAM,EAAE,MAAM;IAMhB;;;OAGG;IACG,oBAAoB,CACxB,WAAW,EAAE,eAAe,EAAE,EAC9B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,cAAc,CAAC;IAkF1B;;;OAGG;IACG,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC;IA2BlB;;;OAGG;IACG,OAAO,CACX,IAAI,EAAE,cAAc,EACpB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,iBAAiB,CAAC;IAuH7B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;CAmBzB"}

package/dist/collateral/manager.js

@@ -0,0 +1,252 @@
+import { FillSimulator } from "../router/simulator.js";
+/**
+ * CollateralManager handles two concerns:
+ * 1. Estimation (read-only): What collateral swaps are needed and how much will they cost?
+ * 2. Execution (writes): Perform the actual swaps and enable DEX abstraction.
+ *
+ * When DEX abstraction is enabled on Hyperliquid:
+ *   - USDC-collateral DEXs pull from the perp USDC balance automatically
+ *   - Non-USDC DEXs pull from the user's spot balance of that token
+ *
+ * So the flow for non-USDC collateral is:
+ *   1. usdClassTransfer: move USDC from perp → spot
+ *   2. Spot order: swap USDC → target token (e.g., USDH)
+ *   3. DEX abstraction handles the rest
+ */
+export class CollateralManager {
+    provider;
+    simulator;
+    logger;
+    constructor(provider, logger) {
+        this.provider = provider;
+        this.simulator = new FillSimulator();
+        this.logger = logger.child({ module: "collateral" });
+    }
+    /**
+     * Estimate collateral requirements for a set of split allocations.
+     * This is read-only — no orders or transfers are made.
+     */
+    async estimateRequirements(allocations, userAddress) {
+        // Get user's current spot balances
+        const spotState = await this.provider.spotClearinghouseState(userAddress);
+        const balanceMap = new Map();
+        for (const b of spotState.balances) {
+            balanceMap.set(b.coin, parseFloat(b.total));
+        }
+        // Get perp balance (USDC is the perp native collateral)
+        const perpState = await this.provider.clearinghouseState(userAddress);
+        const perpUsdcBalance = parseFloat(perpState.marginSummary.accountValue);
+        // Group allocations by collateral type
+        const collateralNeeds = new Map();
+        for (const alloc of allocations) {
+            const token = alloc.market.collateral;
+            const amount = alloc.estimatedCost; // USD value needed
+            collateralNeeds.set(token, (collateralNeeds.get(token) ?? 0) + amount);
+        }
+        const requirements = [];
+        let swapsNeeded = false;
+        const swapShortfalls = new Map();
+        const tokenBalances = new Map();
+        for (const [token, amountNeeded] of collateralNeeds) {
+            if (token === "USDC") {
+                // USDC comes from perp balance automatically via abstraction
+                requirements.push({
+                    token,
+                    amountNeeded,
+                    currentBalance: perpUsdcBalance,
+                    shortfall: 0, // Abstraction handles USDC automatically
+                    swapFrom: "USDC",
+                    estimatedSwapCostBps: 0,
+                });
+                continue;
+            }
+            // Non-USDC: needs to be in spot balance
+            const currentBalance = balanceMap.get(token) ?? 0;
+            const shortfall = Math.max(0, amountNeeded - currentBalance);
+            tokenBalances.set(token, currentBalance);
+            if (shortfall > 0) {
+                swapsNeeded = true;
+                swapShortfalls.set(token, shortfall);
+            }
+        }
+        const swapCostMap = new Map();
+        await Promise.all([...swapShortfalls.entries()].map(async ([token, shortfall]) => {
+            const swapCostBps = await this.estimateSwapCost("USDC", token, shortfall);
+            swapCostMap.set(token, swapCostBps);
+        }));
+        for (const [token, amountNeeded] of collateralNeeds) {
+            if (token === "USDC")
+                continue;
+            const currentBalance = tokenBalances.get(token) ?? 0;
+            const shortfall = Math.max(0, amountNeeded - currentBalance);
+            requirements.push({
+                token,
+                amountNeeded,
+                currentBalance,
+                shortfall,
+                swapFrom: "USDC",
+                estimatedSwapCostBps: swapCostMap.get(token) ?? 0,
+            });
+        }
+        const totalSwapCostBps = this.weightedSwapCost(requirements, allocations);
+        return {
+            requirements,
+            totalSwapCostBps,
+            swapsNeeded,
+            abstractionEnabled: false, // Will be checked during prepare()
+        };
+    }
+    /**
+     * Estimate the cost in basis points to swap fromToken to toToken on the spot market.
+     * Uses the spot L2Book to simulate the swap.
+     */
+    async estimateSwapCost(_fromToken, toToken, amount) {
+        try {
+            // Fetch the spot book for the target token
+            // On Hyperliquid, stablecoin pairs typically use @{index} format
+            // For now, try the token name directly
+            const book = await this.provider.l2Book(toToken);
+            if (book.levels[0].length === 0 && book.levels[1].length === 0) {
+                // No spot book available — return conservative default
+                return 50;
+            }
+            // Simulate buying `amount` worth of toToken on the spot market
+            // Since stablecoins trade near $1, amount ≈ size
+            const sim = this.simulator.simulate(book, "buy", amount);
+            if (!sim) {
+                return 100; // Insufficient spot depth
+            }
+            return sim.priceImpactBps;
+        }
+        catch {
+            // Spot book not available — return conservative estimate
+            this.logger.debug({ toToken, amount }, "Spot book unavailable, using default swap cost");
+            return 50;
+        }
+    }
+    /**
+     * Execute collateral preparation: enable abstraction, perform swaps.
+     * Call this before placing split orders.
+     */
+    async prepare(plan, _userAddress) {
+        const swapsExecuted = [];
+        let abstractionWasEnabled = false;
+        try {
+            // Step 1: Enable DEX abstraction if not already enabled
+            if (!plan.abstractionEnabled) {
+                this.logger.info("Enabling DEX abstraction");
+                await this.provider.setDexAbstraction(true);
+                abstractionWasEnabled = true;
+            }
+            const spotMeta = await this.provider.spotMeta();
+            const tokenByName = new Map(spotMeta.tokens.map((token) => [token.name, token]));
+            const pairByTokenIndex = new Map();
+            for (const pair of spotMeta.universe) {
+                for (const tokenIndex of pair.tokens) {
+                    if (!pairByTokenIndex.has(tokenIndex)) {
+                        pairByTokenIndex.set(tokenIndex, pair);
+                    }
+                }
+            }
+            // Step 2: Execute swaps for each requirement with shortfall
+            for (const req of plan.requirements) {
+                if (req.shortfall <= 0 || req.token === "USDC")
+                    continue;
+                // Move USDC from perp → spot
+                const transferAmount = req.shortfall * 1.01; // 1% buffer for slippage
+                this.logger.info({ amount: transferAmount, token: req.token }, "Transferring USDC to spot for swap");
+                await this.provider.usdClassTransfer(transferAmount, false);
+                // Place spot order to swap USDC → target token
+                // Spot orders use the same provider.placeOrder with spot asset indices
+                const spotBook = await this.provider.l2Book(req.token);
+                if (spotBook.levels[1].length === 0) {
+                    return {
+                        success: false,
+                        swapsExecuted,
+                        abstractionWasEnabled,
+                        error: `No spot liquidity for ${req.token}`,
+                    };
+                }
+                // Use best ask with slippage for limit price
+                const bestAsk = parseFloat(spotBook.levels[1][0].px);
+                const limitPrice = (bestAsk * 1.005).toFixed(6); // 0.5% slippage on swap
+                const spotToken = tokenByName.get(req.token);
+                if (!spotToken) {
+                    return {
+                        success: false,
+                        swapsExecuted,
+                        abstractionWasEnabled,
+                        error: `Spot token ${req.token} not found in spotMeta`,
+                    };
+                }
+                // Spot asset index = 10000 + 2 * pair_index for the base token
+                // Find the pair that has this token
+                const pair = pairByTokenIndex.get(spotToken.index);
+                if (!pair) {
+                    return {
+                        success: false,
+                        swapsExecuted,
+                        abstractionWasEnabled,
+                        error: `No spot pair found for ${req.token}`,
+                    };
+                }
+                const spotAssetIndex = 10000 + 2 * pair.index;
+                this.logger.info({ token: req.token, size: req.shortfall, limitPrice, spotAssetIndex }, "Placing spot swap order");
+                const result = await this.provider.placeOrder({
+                    assetIndex: spotAssetIndex,
+                    isBuy: true,
+                    price: limitPrice,
+                    size: req.shortfall.toString(),
+                    reduceOnly: false,
+                    orderType: { limit: { tif: "Ioc" } },
+                });
+                const status = result.statuses[0];
+                let filled = "0";
+                if (status && typeof status === "object" && "filled" in status) {
+                    filled = status.filled.totalSz;
+                }
+                swapsExecuted.push({
+                    from: req.swapFrom,
+                    to: req.token,
+                    amount: req.shortfall.toString(),
+                    filled,
+                });
+            }
+            return {
+                success: true,
+                swapsExecuted,
+                abstractionWasEnabled,
+            };
+        }
+        catch (error) {
+            this.logger.error({ error }, "Collateral preparation failed");
+            return {
+                success: false,
+                swapsExecuted,
+                abstractionWasEnabled,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    /**
+     * Compute weighted average swap cost across all requirements,
+     * weighted by the proportion of each token's allocation.
+     */
+    weightedSwapCost(requirements, allocations) {
+        const totalCost = allocations.reduce((sum, a) => sum + a.estimatedCost, 0);
+        if (totalCost === 0)
+            return 0;
+        let weightedSum = 0;
+        for (const req of requirements) {
+            if (req.shortfall <= 0)
+                continue;
+            const tokenAllocCost = allocations
+                .filter((a) => a.market.collateral === req.token)
+                .reduce((sum, a) => sum + a.estimatedCost, 0);
+            const weight = tokenAllocCost / totalCost;
+            weightedSum += req.estimatedSwapCostBps * weight;
+        }
+        return weightedSum;
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/collateral/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/collateral/manager.ts"],"names":[],"mappings":"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"}

package/dist/collateral/types.d.ts

@@ -0,0 +1,26 @@
+export interface CollateralRequirement {
+    token: string;
+    amountNeeded: number;
+    currentBalance: number;
+    shortfall: number;
+    swapFrom: string;
+    estimatedSwapCostBps: number;
+}
+export interface CollateralPlan {
+    requirements: CollateralRequirement[];
+    totalSwapCostBps: number;
+    swapsNeeded: boolean;
+    abstractionEnabled: boolean;
+}
+export interface CollateralReceipt {
+    success: boolean;
+    swapsExecuted: {
+        from: string;
+        to: string;
+        amount: string;
+        filled: string;
+    }[];
+    abstractionWasEnabled: boolean;
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/collateral/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,qBAAqB,EAAE,CAAC;IACtC,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;IACrB,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE;QACb,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;KAChB,EAAE,CAAC;IACJ,qBAAqB,EAAE,OAAO,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/collateral/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/collateral/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/collateral/types.ts"],"names":[],"mappings":""}

package/dist/config.d.ts

@@ -0,0 +1,31 @@
+/** Builder fee configuration. */
+export interface BuilderConfig {
+    /** Builder address (0x-prefixed). */
+    address: `0x${string}`;
+    /** Fee in basis points. 1 bps = 0.01%. Max 10 bps (0.1%) for perps. */
+    feeBps: number;
+}
+/** @internal SDK default builder fee configuration. */
+export declare const DEFAULT_BUILDER: BuilderConfig;
+export interface HyperliquidPrimeConfig {
+    /** Hex private key. Required for trading, optional for read-only. */
+    privateKey?: `0x${string}`;
+    /** User's wallet address. Derived from privateKey if not provided. */
+    walletAddress?: string;
+    /** Use testnet. Default: false. */
+    testnet?: boolean;
+    /** Default slippage for market orders. Default: 0.01 (1%). */
+    defaultSlippage?: number;
+    /** Log level. Default: "info". */
+    logLevel?: "debug" | "info" | "warn" | "error" | "silent";
+    /** Pretty-print logs. Default: false. */
+    prettyLogs?: boolean;
+    /**
+     * Builder fee configuration.
+     * - Default (undefined): SDK author's address with 1 bps fee.
+     * - null: Disable builder fees entirely.
+     * - BuilderConfig: Custom builder address and fee.
+     */
+    builder?: BuilderConfig | null;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,OAAO,EAAE,KAAK,MAAM,EAAE,CAAC;IACvB,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,uDAAuD;AACvD,eAAO,MAAM,eAAe,EAAE,aAG7B,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACrC,qEAAqE;IACrE,UAAU,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;IAE3B,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,mCAAmC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAE1D,yCAAyC;IACzC,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;CAChC"}

package/dist/config.js

@@ -0,0 +1,6 @@
+/** @internal SDK default builder fee configuration. */
+export const DEFAULT_BUILDER = {
+    address: "0x34411c9d3c312e6ECb32C079AA0F34B572Dddc37",
+    feeBps: 1,
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAQA,uDAAuD;AACvD,MAAM,CAAC,MAAM,eAAe,GAAkB;IAC5C,OAAO,EAAE,4CAA4C;IACrD,MAAM,EAAE,CAAC;CACV,CAAC"}