Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.paxeer.app/llms.txt

Use this file to discover all available pages before exploring further.

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.

Synthetic Perpetuals

Trade long or short exposure with one net position per market per user.

Protocol-Funded Liquidity

Liquidity is protocol-funded. There are no external LP deposits.

Continuous Funding

Funding accrues per second without a separate funding settler keeper.

Architecture

GroupFacets
CoreDiamondCutFacet, DiamondLoupeFacet, OwnershipFacet, AccessControlFacet, PausableFacet
Vault and collateralVaultFactoryFacet, CentralVaultFacet, CollateralFacet
Trading enginePositionFacet, OrderBookFacet, LiquidationFacet, FundingRateFacet
PricingOracleFacet, VirtualAMMFacet, PriceFeedFacet
SupportMarketRegistryFacet, InsuranceFundFacet, QuoterFacet, EventEmitterFacet

Trading model

ComponentBehavior
Position modelNet mode; one direction per market per user
Price precision18-decimal fixed point
Leverage precision18-decimal fixed point
Market IDsSequential uint256 starting from 0
Position IDsSequential uint256 starting from 1
EventsEmitted from the Diamond address

Production addresses

ContractAddress
Diamond proxy0xeA65FE02665852c615774A3041DFE6f00fb77537
UserVault implementation0x4195155D92451a47bF76987315DaEE499f1D7352

Facet addresses

FacetAddress
DiamondCutFacet0x8af7E829E2061Cb2353CCce3cf99b00e6ca4DC3B
DiamondLoupeFacet0x425Bcb17F3e3679fC5fE001d3707BDC3ED76c3a1
OwnershipFacet0xDD0C64553e792120B04727b9Eb2e97c8cd67F387
PositionFacet0x6bf3722414b240A2503a512A84f54Ee161fa148e
OrderBookFacet0x719B8f35701ff1050EB0Bb87E418Bb321Cc0e979
LiquidationFacet0x661320835387532aFDEc3F243B0A328BF42d7cA7
FundingRateFacet0x669077515193401ac30984a9d2314903ACcAc25f
OracleFacet0xd21135802D8eFD6c00d6332e262A7B2c75d5bF69
VirtualAMMFacet0x5c869AC52dd91958E7dd98e570aaeFE6FD6864B5
PriceFeedFacet0x08E967408a4Ee268FF11ab116BfE1D95F2484c61
AccessControlFacet0x71E10DB0c468BF682EA744F11C4A29b10E18FDEd
PausableFacet0xDc72b3dC885C5b8816456FcF9EFda7aD5625ABf8
VaultFactoryFacet0x54F4D455a8f47dFD2C6f252d0EdEEdDFfEe252B4
CentralVaultFacet0xE4410832468F0Ec655f26b0f22C1f6864628Ea21
CollateralFacet0x26D0BEE6F9249dD3d098288a74f7b026929dD6BD
MarketRegistryFacet0x819904c316dd0B8259d4486B446A057922F24116

Oracle integration

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

Developer usage

Use the Diamond proxy as the contract address for user-facing facet calls.
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.