Token Deployment

TokenInfo (12+ fields):
  spots                       -- list of spot pair IDs for this token
  deploy_time                 -- timestamp of token deployment
  deploy_gas_wei              -- gas paid for deployment (in wei)
  evm_contract                -- linked EVM contract address (if any)
  full_name                   -- human-readable token name
  seeded_usdc                 -- USDC seeded into hyperliquidity
  non_circulating_users       -- addresses excluded from circulating supply
  deployer_trading_fee_share  -- deployer's share of trading fees
  frozen_users                -- set of frozen user addresses
  szDecimals                  -- size decimal precision
  weiDecimals                 -- wei decimal precision

TokenGenesis:
  userAndWei          -- list of (address, amount) for user allocations
  existingTokenAndWei -- existing token balances to honor
  blacklistUsers      -- addresses to exclude from distribution
  maxSupply           -- total supply cap

registerHyperliquidity:
  tokens              -- token pair
  startPx             -- initial price for seeded orders
  orderSz             -- size per seeded order
  nOrders             -- number of orders to place
  nSeededLevels       -- number of price levels to seed
  address             -- HLP vault address
  evmExtraWeiDecimals -- extra precision for EVM amounts

spot_to_range                -- price range per spot pair
ensure_order_bucket_guard    -- rate limiter for order placement
order_ntl                    -- target notional per order
max_px                       -- maximum price for seeded orders
ema                          -- exponential moving average tracker
system_address               -- HLP system address

GasAuction:
  bucket_guard   -- rate limiter
  start_gas_wei  -- starting (highest) gas price
  end_gas_wei    -- ending (lowest) gas price (null = no floor)
  + decay parameters (decay_duration, n_samples)

GasAuctionDetails:
  startTimeSeconds  -- Unix timestamp when auction started
  durationSeconds   -- total auction duration (typically 111,600s = 31 hours)
  startGas          -- starting gas price (e.g., "1000.0" for perps)
  currentGas        -- current gas price (decaying)
  endGas            -- floor price (null = decays to zero)

GasAuctionChange:
  EnableAndRestart -- start or restart an auction

VoteGlobalAction::DeployGasAuctionChange -- validator vote on auction changes

Hip3Schema (9 fields):
  full_name                           -- display name string
  oracle_updater                      -- oracle price feed address
  fee_recipient                       -- trading fee recipient address
  override_fee_recipient              -- optional override for fee routing
  asset_to_oi_cap                     -- per-asset open interest caps
  sub_deployers                       -- list of authorized sub-deployer addresses
  deployer_fee_scale                  -- fee multiplier for deployer share
  last_deployer_fee_scale_change_time -- timestamp of last fee scale change
  + state (Na | UserDisabled | ValidatorDisabled)

Hip3Limits:
  last_settlement_time                  -- last settlement timestamp
  disabled_state                        -- Na | UserDisabled | ValidatorDisabled
  total_oi_cap                          -- total open interest cap
  oi_sz_cap_per_perp                    -- per-perp OI size cap
  max_transfer_ntl                      -- max notional per transfer
  daily_px_range                        -- allowed daily price range
  max_n_users_with_positions            -- max concurrent users with positions

Hip3SetSubDeployerInput:
  variant  -- which sub-deployer action
  allowed  -- what operations are permitted

Hip3GrowthMode          -- enum controlling market scaling
Hip3CrossMarginTradingMode:
  half_life             -- decay half-life
  max_slippage          -- maximum allowed slippage

Hip3BackstopLiquidatorParams (3 fields):
  Configures backstop behavior for thin markets

Hip3BackstopLiquidatorMode:
  Controls whether backstop liquidation is active

perpDeploy:
  asset           -- asset index
  dex             -- DEX identifier
  schema          -- Hip3Schema
  oraclePxs       -- oracle price feeds
  markPxs         -- mark price configuration
  externalPerpPxs -- external perp price feeds
  marginTable     -- margin tier configuration
  feeRecipient    -- fee destination
  subDeployers    -- authorized sub-deployers
  scale           -- fee scale
  displayName     -- market display name

DeployerTradingFeeShare:
  Configurable via setDeployerTradingFeeShare
  deployer_fee_scale -- fee multiplier
  last_deployer_fee_scale_change_time -- timestamp of last change

TwapWireSerde (6 fields):
  a  -- asset (perp/spot coin index)
  b  -- is_buy (bool)
  m  -- minutes (total duration, max 1,440 = 24 hours)
  t  -- total_sz (total order size)
  s  -- max_slippage (max allowed slippage per slice)
  r  -- reduce_only (bool)

TwapState:
  twap_id         -- monotonic ID (from global counter)
  next_slice_time -- timestamp of next scheduled slice
  executed_sz     -- cumulative size filled
  executed_ntl    -- cumulative notional filled
  slice_number    -- current slice index (0-based)
  running_heap    -- position in the scheduler's priority queue

TwapSchedule (7 fields):
  Total duration, number of slices, slice timing
  size_increment per slice
  randomize flag -- jitters slice timing to reduce predictability

TwapSlice:
  resting_sz  -- size resting after partial fill
  orig_sz     -- original slice size
  tif         -- time-in-force (IOC for slices)
  BookOrder   -- standard book order

TwapCancelAction:
  a       -- asset
  twap_id -- the TWAP order to cancel

TwapCancelStatus:
  success -- cancellation succeeded
  status  -- OrderStatus (filled, totalSz, avgPx, activated, terminated)