> ## Documentation Index
> Fetch the complete documentation index at: https://sidiorresearchlabs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# HyperPax Perps

> Network-operated synthetic perpetual futures protocol with Diamond facets, oracle pricing, funding, vaults, and liquidation support

## Overview

HyperPax Perps is the public protocol name for the network-operated Sidiora Perpetual Protocol. It provides synthetic perpetual futures on Paxeer Network using a Diamond proxy with 19 facets and shared `AppStorage`.

> [card] Synthetic Perpetuals
>
> Trade long or short exposure with one net position per market per user.

> [card] Protocol-Funded Liquidity
>
> Liquidity is protocol-funded. There are no external LP deposits.

> [card] Continuous Funding
>
> Funding accrues per second without a separate funding settler keeper.

## Architecture

| Group | Facets |
| - | - |
| Core | `DiamondCutFacet`, `DiamondLoupeFacet`, `OwnershipFacet`, `AccessControlFacet`, `PausableFacet` |
| Vault and collateral | `VaultFactoryFacet`, `CentralVaultFacet`, `CollateralFacet` |
| Trading engine | `PositionFacet`, `OrderBookFacet`, `LiquidationFacet`, `FundingRateFacet` |
| Pricing | `OracleFacet`, `VirtualAMMFacet`, `PriceFeedFacet` |
| Support | `MarketRegistryFacet`, `InsuranceFundFacet`, `QuoterFacet`, `EventEmitterFacet` |

## Trading model

| Component | Behavior |
| - | - |
| Position model | Net mode; one direction per market per user |
| Price precision | 18-decimal fixed point |
| Leverage precision | 18-decimal fixed point |
| Market IDs | Sequential `uint256` starting from `0` |
| Position IDs | Sequential `uint256` starting from `1` |
| Events | Emitted from the Diamond address |

## Production addresses

| Contract | Address |
| - | - |
| Diamond proxy | `0xeA65FE02665852c615774A3041DFE6f00fb77537` |
| UserVault implementation | `0x4195155D92451a47bF76987315DaEE499f1D7352` |

## Facet addresses

| Facet | Address |
| - | - |
| DiamondCutFacet | `0x8af7E829E2061Cb2353CCce3cf99b00e6ca4DC3B` |
| DiamondLoupeFacet | `0x425Bcb17F3e3679fC5fE001d3707BDC3ED76c3a1` |
| OwnershipFacet | `0xDD0C64553e792120B04727b9Eb2e97c8cd67F387` |
| PositionFacet | `0x6bf3722414b240A2503a512A84f54Ee161fa148e` |
| OrderBookFacet | `0x719B8f35701ff1050EB0Bb87E418Bb321Cc0e979` |
| LiquidationFacet | `0x661320835387532aFDEc3F243B0A328BF42d7cA7` |
| FundingRateFacet | `0x669077515193401ac30984a9d2314903ACcAc25f` |
| OracleFacet | `0xd21135802D8eFD6c00d6332e262A7B2c75d5bF69` |
| VirtualAMMFacet | `0x5c869AC52dd91958E7dd98e570aaeFE6FD6864B5` |
| PriceFeedFacet | `0x08E967408a4Ee268FF11ab116BfE1D95F2484c61` |
| AccessControlFacet | `0x71E10DB0c468BF682EA744F11C4A29b10E18FDEd` |
| PausableFacet | `0xDc72b3dC885C5b8816456FcF9EFda7aD5625ABf8` |
| VaultFactoryFacet | `0x54F4D455a8f47dFD2C6f252d0EdEEdDFfEe252B4` |
| CentralVaultFacet | `0xE4410832468F0Ec655f26b0f22C1f6864628Ea21` |
| CollateralFacet | `0x26D0BEE6F9249dD3d098288a74f7b026929dD6BD` |
| MarketRegistryFacet | `0x819904c316dd0B8259d4486B446A057922F24116` |

## Oracle integration

HyperPax Perps uses oracle pricing for market valuation, funding, liquidations, and quote simulation. Protocol docs should link developers to:

* [x/paxoracle](https://sidiorresearchlabs.mintlify.site/protocol/modules/paxoracle.md) for validator price submissions
* [PaxSpot precompiles](https://sidiorresearchlabs.mintlify.site/paxspot/precompiles.md) for shared OROB, batch clearing, and PoFQ primitives

## Developer usage

Use the Diamond proxy as the contract address for user-facing facet calls.

```typescript theme={null}
const hyperpaxPerpsDiamond = '0xeA65FE02665852c615774A3041DFE6f00fb77537'
```

All facet events are emitted from the Diamond address, so indexers should subscribe to the Diamond proxy rather than individual facet implementation addresses.

## Related protocols

* [HyperPax DEX](https://sidiorresearchlabs.mintlify.site/sidiora/dex.md)
* [Sidiora.fun](https://sidiorresearchlabs.mintlify.site/sidiora/fun.md)
* [Sidiora.ag](https://sidiorresearchlabs.mintlify.site/sidiora/ag.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.