Parameters
Protocol-tunable parameters and their bounds, the leverage ceiling, and fixed constants.
A vault has three kinds of settings. Twelve economic parameters can be tuned by the protocol within hard bounds. The leverage ceiling is fixed at deployment. Everything else is a constant. USDC amounts use 6 decimals.
Protocol-tunable
The protocol calls proposeParameters(p), then applyParameters() once
ADMIN_DELAY (one day) has passed. proposeParameters checks the bounds below,
so a proposal outside them reverts with InvalidParameters. A new proposal
replaces the pending one and restarts the delay. applyParameters checkpoints
the borrow index before the new borrowBpsPerDay takes effect.
| Parameter | Bound | Testnet |
|---|---|---|
leverageTiers[3] | Open interest caps strictly increase; leverage from 1 to LEVERAGE_CEILING, never increasing | 20x, 10x, and 5x at $100, $200, and above (ceiling 20) |
maintenanceMarginBps | 10 to 2,500, and at most half the initial margin at tier 0 | 250 |
liquidationPenaltyBps | Below maintenanceMarginBps | 100 |
spreadBps | At most 100 | 5 |
tradeFeeBps | At most 100, and spread plus fee above 0 | 5 |
maxUnhedgedUsdc | $10 to $10M | $100 |
maxPositionNotionalUsdc | $10 to $10M | $1,000 |
maxOpenInterestMultiple | 1 to 20 | 10 |
minInsuranceBufferUsdc | Above 0 | $10 |
borrowBpsPerDay | At most 100 | 5 |
liquidatorShareBps | At most 5,000, and penalty × (1 − share) at least spread plus fee | 2,000 |
minLiquidatorRewardUsdc | Below $10 divided by tier-0 leverage, the smallest possible margin | $0.10 |
The bound on liquidatorShareBps makes self-liquidation more expensive than
closing while equity covers the penalty. The bound on minLiquidatorRewardUsdc
keeps the reward floor below the smallest margin, so it cannot be farmed by
opening and liquidating tiny positions.
Leverage ceiling
LEVERAGE_CEILING is immutable. It is set at deployment to between 1 and the
smaller of 50 and HyperCore's maximum leverage for the asset, read from
perpAssetInfo. No parameter change can raise a tier above it, so a thin market
stays at low leverage for the vault's lifetime.
Constants
| Constant | Value | Purpose |
|---|---|---|
REQUEST_EXPIRY_BLOCKS | 2 | A request executes in block N+1 or N+2 |
MIN_HOLD_TIME | 10 seconds | Minimum time before a close, unless liquidatable |
MAX_BATCH | 100 | Maximum request ids per execute |
HEDGE_COOLDOWN | 2 seconds | Minimum time between hedge() calls |
HEDGE_SLIPPAGE_BPS | 50 | Hedge IOC limit price distance from the mark |
MAX_HEDGE_ORDER_USDC | $250,000 | Largest single hedge order |
TARGET_CORE_LEVERAGE | 3 | Leverage the HyperCore margin is sized for |
CORE_MARGIN_FLOOR_USDC | $10 | Added to the required HyperCore margin |
REBALANCE_HYSTERESIS_USDC | $10 | Band above required margin before rebalanceCoreMargin acts |
MIN_BRIDGE_USDC | $10 | Smallest bridgeSpotUsdcToEvm transfer |
ADMIN_DELAY | 1 day | Delay on parameter changes and insurance withdrawals |
HEDGE_SLIPPAGE_BPS, MAX_HEDGE_ORDER_USDC, TARGET_CORE_LEVERAGE,
CORE_MARGIN_FLOOR_USDC, and MIN_BRIDGE_USDC are internal, so they have no
getter. The minimum order notional is $10.
Protocol powers
The protocol acts through a multisig, and its powers are narrow:
pause()andunpause(), which stop and resume opens only;proposeParametersandapplyParameters, within the bounds above;proposeInsuranceWithdrawal(to, amount)andapplyInsuranceWithdrawal(), which cannot take more than the buffer or free USDC, and must keep the equity floor.
The protocol cannot move user margin, claimable balances, or locked collateral, and cannot change a position.
Continue with the vault reference for every entry point.