{
  "name": "Hashpower market semantics",
  "description": "Agent-facing market rules (units, margin, trading, settlement, oracle reading) sourced from the contracts repos' /docs at build time. Same prose that feeds GitBook.",
  "generatedAt": "2026-09-16T15:08:43.258Z",
  "ref": "dev",
  "documents": [
    {
      "slug": "oracle-reading",
      "title": "Hashprice Oracle",
      "topic": "oracle",
      "blurb": "How to read hashprice on-chain (AggregatorV3 / latestRoundData) and the PH/s·day unit.",
      "path": "/semantics/oracle-reading.md",
      "htmlPath": "/build/rules/oracle-reading/",
      "repo": "hashprice-oracle",
      "sourcePath": "README.md",
      "ref": "dev",
      "githubUrl": "https://github.com/Lumerin-protocol/hashprice-oracle/blob/dev/README.md"
    },
    {
      "slug": "collateral-and-accounts",
      "title": "Collateral & Accounts",
      "topic": "collateral",
      "blurb": "Unified CollateralVault: deposit, withdraw, free margin, and the shared account model.",
      "path": "/semantics/collateral-and-accounts.md",
      "htmlPath": "/build/rules/collateral-and-accounts/",
      "repo": "derivatives-marketplace",
      "sourcePath": "docs/gitbook/02.Collateral-and-Accounts.md",
      "ref": "dev",
      "githubUrl": "https://github.com/Lumerin-protocol/derivatives-marketplace/blob/dev/docs/gitbook/02.Collateral-and-Accounts.md"
    },
    {
      "slug": "perps-trading",
      "title": "Trading Guide",
      "topic": "trading",
      "blurb": "Perps order API (createOrder / simulateOrder) and QUANTITY_DECIMALS scaling.",
      "path": "/semantics/perps-trading.md",
      "htmlPath": "/build/rules/perps-trading/",
      "repo": "derivatives-marketplace",
      "sourcePath": "docs/gitbook/03.Trading-Guide.md",
      "ref": "dev",
      "githubUrl": "https://github.com/Lumerin-protocol/derivatives-marketplace/blob/dev/docs/gitbook/03.Trading-Guide.md"
    },
    {
      "slug": "perps-positions-and-funding",
      "title": "Positions & Funding",
      "topic": "trading",
      "blurb": "Mark/index price, PnL, and funding formulas for perpetual positions.",
      "path": "/semantics/perps-positions-and-funding.md",
      "htmlPath": "/build/rules/perps-positions-and-funding/",
      "repo": "derivatives-marketplace",
      "sourcePath": "docs/gitbook/04.Positions-and-Funding.md",
      "ref": "dev",
      "githubUrl": "https://github.com/Lumerin-protocol/derivatives-marketplace/blob/dev/docs/gitbook/04.Positions-and-Funding.md"
    },
    {
      "slug": "perps-margin-and-liquidation",
      "title": "Margin & Liquidation",
      "topic": "margin",
      "blurb": "Initial/maintenance margin, portfolio PME, and liquidation triggers for perps.",
      "path": "/semantics/perps-margin-and-liquidation.md",
      "htmlPath": "/build/rules/perps-margin-and-liquidation/",
      "repo": "derivatives-marketplace",
      "sourcePath": "docs/gitbook/05.Margin-and-Liquidation.md",
      "ref": "dev",
      "githubUrl": "https://github.com/Lumerin-protocol/derivatives-marketplace/blob/dev/docs/gitbook/05.Margin-and-Liquidation.md"
    },
    {
      "slug": "futures-contract-specs",
      "title": "Contract Specifications",
      "topic": "units",
      "blurb": "Futures contract unit, tick size, PnL, and settlement surface.",
      "path": "/semantics/futures-contract-specs.md",
      "htmlPath": "/build/rules/futures-contract-specs/",
      "repo": "futures-marketplace",
      "sourcePath": "docs/gitbook/02.Contract-Specifications.md",
      "ref": "dev",
      "githubUrl": "https://github.com/Lumerin-protocol/futures-marketplace/blob/dev/docs/gitbook/02.Contract-Specifications.md"
    },
    {
      "slug": "futures-margin",
      "title": "Margin System",
      "topic": "margin",
      "blurb": "Futures margin types, PME coupling, and liquidation rules.",
      "path": "/semantics/futures-margin.md",
      "htmlPath": "/build/rules/futures-margin/",
      "repo": "futures-marketplace",
      "sourcePath": "docs/gitbook/03.Margin-System.md",
      "ref": "dev",
      "githubUrl": "https://github.com/Lumerin-protocol/futures-marketplace/blob/dev/docs/gitbook/03.Margin-System.md"
    },
    {
      "slug": "futures-trading",
      "title": "Trading Guide",
      "topic": "trading",
      "blurb": "Futures order placement (signed qty, GTC/IOC/FOK) and prerequisites.",
      "path": "/semantics/futures-trading.md",
      "htmlPath": "/build/rules/futures-trading/",
      "repo": "futures-marketplace",
      "sourcePath": "docs/gitbook/04.Trading-Guide.md",
      "ref": "dev",
      "githubUrl": "https://github.com/Lumerin-protocol/futures-marketplace/blob/dev/docs/gitbook/04.Trading-Guide.md"
    },
    {
      "slug": "futures-delivery-settlement",
      "title": "Settlement",
      "topic": "settlement",
      "blurb": "Cash settlement lifecycle for dated futures contracts.",
      "path": "/semantics/futures-delivery-settlement.md",
      "htmlPath": "/build/rules/futures-delivery-settlement/",
      "repo": "futures-marketplace",
      "sourcePath": "docs/gitbook/05.Delivery-Settlement.md",
      "ref": "dev",
      "githubUrl": "https://github.com/Lumerin-protocol/futures-marketplace/blob/dev/docs/gitbook/05.Delivery-Settlement.md"
    }
  ]
}