{
  "as_of_utc": "2026-10-03T23:39:47.476554+00:00",
  "answer_to_scope_question": "The existing HyperEVM model addresses EVM settlement gas. A generic separate-HyperCore paragraph does not fully model the native outcome-market alternative. Add a separate closing-notional fee scenario, outside the gas-cost ranking, with the bounded mainnet evidence below.",
  "status": "Implementable conditional planning model; current native outcome fees independently observed. Not a measured Polymarket migration cost or a complete lifecycle fee quote.",
  "primary_sources": [
    {
      "url": "https://hyperliquid.gitbook.io/hyperliquid-docs/trading/fees",
      "supports": "Outcome opening/closing/settling fee eligibility; no maker rebates; account tier schedules."
    },
    {
      "url": "https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/hip-4-deployer-actions",
      "supports": "Deployer scale formula and split, template/activation rules and deployment limits. Page is labeled testnet-only, so quoted numerical limits are not certified mainnet limits."
    },
    {
      "url": "https://hyperliquid.gitbook.io/hyperliquid-docs/hyperliquid-improvement-proposals-hips/hip-4-outcome-markets",
      "supports": "Native outcome mechanics and old initial-testing zero-fee statement; that zero-fee statement conflicts with current observed fee-paying mainnet fills."
    },
    {
      "url": "https://hyperliquid.gitbook.io/hyperliquid-docs/trading/builder-codes",
      "supports": "Approved builder charges, fee units, account requirements and caps; outcome deployer page gives additional outcome-specific behavior."
    },
    {
      "url": "https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint",
      "supports": "Read-only user fills, total fee including any builderFee, user fee fields."
    },
    {
      "url": "https://api.hyperliquid.xyz/info",
      "supports": "Retained live mainnet outcomeMeta, recentTrades, per-fill fees and account fee rates."
    }
  ],
  "live_mainnet_metadata": {
    "retrieved_at": "2026-10-03T23:32:27.769939+00:00",
    "outcomes_returned": 305,
    "questions_returned": 29,
    "deployer_venues": [
      "skew",
      "out",
      "txyz"
    ],
    "global_feeScale": "1.0",
    "observed_deployer_scale_for_validated_market": "1.0",
    "quote_token_for_validated_market": "USDC",
    "source": "evidence/hypercore-sources/outcomeMeta.json",
    "interpretation": "Metadata is a current inventory snapshot, not order throughput, sustained capacity or a statement that all deployment options are permissionless for every account."
  },
  "mainnet_fill_validations": [
    {
      "role": "taker",
      "asset": "#14730",
      "time_utc": "2026-10-03T17:50:04.941000+00:00",
      "hash": "0xedd51ac4f553e692ef4e0445c410510203a000aa90570564919dc617b457c07d",
      "crossed": true,
      "direction": "Sell",
      "quote_notional_exact": "60.238530",
      "fee_quote_actual": "0.08096058",
      "fee_token": "USDC",
      "builder_fee_field": null,
      "account_spot_rate_fraction": "0.0007",
      "active_referral_discount": "0.04",
      "observed_deployer_scale": "1.0",
      "predicted_fee_before_per_fill_rounding": "0.080960584320",
      "absolute_rounding_difference": "4.320E-9",
      "observed_effective_bps": "13.4399992828510257471422360406205131499722851802658531009970",
      "fee_source": "sports-seller-fees.json"
    },
    {
      "role": "maker",
      "asset": "#14730",
      "time_utc": "2026-10-03T17:34:48.275000+00:00",
      "hash": "0x02807c161bd2463e03fa0445c3debf0201a200fbb6d56510a6492768dad62028",
      "crossed": false,
      "direction": "Sell",
      "quote_notional_exact": "16.447590",
      "fee_quote_actual": "0.01263174",
      "fee_token": "USDC",
      "builder_fee_field": null,
      "account_spot_rate_fraction": "0.0004",
      "active_referral_discount": "0.04",
      "observed_deployer_scale": "1.0",
      "predicted_fee_before_per_fill_rounding": "0.012631749120",
      "absolute_rounding_difference": "9.120E-9",
      "observed_effective_bps": "7.67999445511470069475224029781870778636870204084610572126372",
      "fee_source": "sports-maker-fees.json"
    }
  ],
  "opening_validation": {
    "source_files": [
      "native-fill-side-0.json",
      "native-fill-side-1.json"
    ],
    "observation": "A native dual-book match with both participants buying complementary tokens has zero fee on each recorded fill; the fee-paying sports-market sell paired with an opening buy has a zero-fee buyer. Opening notional must not be indiscriminately charged closing rates."
  },
  "calculator": {
    "title": "HyperCore / HIP-4 trader fee scenario",
    "unit": "Fee-paying closing quote notional; output in quote-token units. USD requires a separately stated quote/USD price.",
    "inputs": {
      "closing_quote_notional": "N >= 0, counted once per fee-paying party",
      "closing_maker_notional_share": "m in [0,1], share of fee-paying notional provided by closing makers, not every market maker trade",
      "base_maker_bps": "rM from the account reference tier, clamp below zero to zero; outcome maker rebates are unavailable",
      "base_taker_bps": "rT from the account reference tier",
      "active_referral_discount": "r in [0,1]",
      "deployer_scale": "d in [0,10] in documented deployment model; d=1 observed in validated mainnet market",
      "builder_eligible_quote_notional": "NB, independently specified notional eligible for an approved builder code",
      "builder_bps": "b, only when explicitly approved and charged",
      "quote_USD_price": "Optional conversion mark, not assumed parity by the native-quote calculator"
    },
    "formula": "B = N * (m * max(rM,0) + (1-m) * rT) * (1-r) / 10000; protocol = B * max(d,1); deployer = B*d; builder = NB*b/10000; trader_total = protocol + deployer + builder.",
    "rate_provenance": "The 4/7 bps reference is the tier-0 spot schedule with no staking discount, not the perp schedule. Two observed USDC outcome closing fills match live userSpotAddRate/userSpotCrossRate, referral discount and d=1 to below 1e-8 quote units. General mapping for other quote tokens, global feeScale values or account modes is not independently validated.",
    "default_scenario": {
      "closing_quote_notional": "1000000",
      "maker_fraction": "0.5",
      "maker_base_bps": "4",
      "taker_base_bps": "7",
      "referral_discount": "0",
      "deployer_scale": "1",
      "builder_eligible_quote_notional": "0",
      "builder_bps": "0",
      "quote_USD_if_shown": "1 (scenario parity assumption, not a fetched USDC mark)",
      "outputs": {
        "base_fee_quote": "550.0",
        "protocol_fee_quote": "550.0",
        "deployer_fee_quote": "550.0",
        "builder_fee_quote": "0",
        "trader_total_quote": "1100.0",
        "trader_total_USD_scenario": "1100.0"
      }
    },
    "per_party_rules": [
      "Mint/opening trades contribute no protocol fee-paying closing notional. Builder charges may differ and remain separately input.",
      "A normal closing sell against an opening buy contributes the seller's price*size only.",
      "When both participants close complementary shares, include each closing party's own price*size in its maker/taker group; do not simply charge both sides of every trade.",
      "Settlement payouts are a separate lifecycle fee base; this minimal closing-trade calculator does not quote settlement fees."
    ],
    "sensitivity": [
      "At d=0 the reference scenario charges550 quote units, all protocol.",
      "At d=1 it charges1100 quote units:550 protocol and550 deployer.",
      "At d=3 it charges3300 quote units:1650 protocol and1650 deployer."
    ],
    "validation": "Decimal calculator checked for d=0, d=1, zero notional and clamped maker rebates. Per-fill currency rounding is not modeled in aggregate projections.",
    "reproducer": "python3 evidence/hypercore_fee_calculator.py --quote-usd 1"
  },
  "deployment_facts": {
    "documented": "HIP-4 deployer page specifies validator-approved templates, separate staking requirement, Standard account mode, no deployment gas, permanent deactivation after at least183 days and no active outcomes; it lists10 active outcomes and50 deployments/day on testnet.",
    "mainnet_caution": "The page is explicitly labeled testnet-only. Live mainnet already exposes three deployer venues and more than10 outcomes per venue. Do not use testnet10/50 caps or a zero deployment charge as a verified full mainnet deployment budget.",
    "required_mainnet_stake_HYPE": null,
    "verified_mainnet_activation_or_deployment_fee": null,
    "verified_mainnet_deployer_limits": null,
    "not_applicable": "Do not substitute HIP-3 perpetual-market stake, listing auctions or funding into a HIP-4 outcome budget."
  },
  "builder_caution": "The older HIP-4 overview describes sell-side builder codes; the newer deployer page also allows quote-token builder charges on buy orders on a best-effort basis. The calculator therefore takes independently eligible builder notional instead of assuming all buys are builder-free.",
  "payer_and_comparison_boundary": "These are charges paid by traders. Deployer or builder components can be application revenue, not application expenditure. The EVM comparison contains blockchain gas, excluding Polymarket trading fees, so this output must not be inserted as a like-for-like gas-cost bar.",
  "excluded_and_unknown": [
    "Final settlement fees and exact payout mix",
    "Mainnet deployer stake amount, capital cost and unverified deployment charges",
    "Oracle operation, resolution disputes and legal/entity ownership",
    "Onboarding, withdrawals, bridges, liquidity and market-making capital",
    "API/rate-limit engineering and end-to-end workload throughput",
    "Actual monthly Polymarket closing notional, maker/taker closing mix and destination architecture"
  ],
  "no_transaction_count_notional_conversion": "No relationship is assumed between21 maker matches,8 Polygon transactions or September call count and closing quote notional.",
  "recommended_site_copy": "HyperCore is a native market architecture. This scenario estimates trader charges on closing notional; deployer and builder shares may be app revenue. It excludes gas comparison, deployment capital and settlement costs. Current mainnet outcome sells charge fees; the older zero-fee testing note is not a current production quote."
}
