Cette page a été traduite automatiquement. La version anglaise fait référence. Lire en anglais →
Aller au contenu principal

Architecture

Hypercall utilise un modèle d'exécution hybride : un appariement hors chaîne pour la vitesse, avec un règlement et une gestion des comptes on-chain pour la sécurité.

Architecture backendMarché d'options unique, sources d'ordres multiplesAutres routeursIntégrations supplémentairesFrontend HypercallInterface MM/Pro + MobileOrdres / AnnulationsSDK Hypercall / passerelle API• Auth / Clés• Ordre + Annulation• Données marché + flux risqueCouche options HypercallHors-chaîneCarnet& AppariementÉvaluation /Surfaces volMoteur risqueIM/MM, liquidationsRèglement /Sync étatOraclePrix indicesTWAP règlementExposition delta /flux couvertureHyper EVMCouche règlementHIP-3 PerpsLieu couverture deltaHyperCoreInfrastructure couche de baseIntégration livePartenaires supplémentaires

Frontières de confiance​

Hors chaîne (backend Hypercall)​

Responsabilités :

  • Appariement et exécution des ordres
  • Gestion du carnet d'ordres
  • Contrôles de marge pré-négociation, y compris le contrôle du portefeuille effectué avant chaque ordre sur perpétuel
  • Orchestration des liquidations
  • Données de marché et valorisation
  • Flux WebSocket

Hypothèse de confiance : vous faites confiance à l'opérateur pour tout ce qui précède. Voir Modèle de confiance.

On-chain (smart contracts)​

Responsabilités :

  • Propriété des comptes et contrôle par le manager
  • Dépôts et retraits
  • Commandes RSM (opérations de gestion des risques)
  • Tokens d'options (contrats OptionRegistry et OptionToken)
  • Approbation du builder pour les ordres sur perpétuels (approveZeroFeeBuilder exécuté une seule fois depuis votre Account)

Hypothèse de confiance : les opérations on-chain sont enregistrées sur Hyperliquid et ne peuvent pas être modifiées par le seul opérateur. Qui peut mettre à niveau les contrats est traité dans Modèle de confiance.

Flux d'exécution des ordres​

1. Soumission de l'ordre​

Action de l'utilisateur : soumettre un ordre via POST /order avec une signature EIP-712.

Validation par le backend :

  • Vérification de la signature (EIP-712)
  • Contrôles de marge pré-négociation (fondés sur des scénarios)
  • Admission de l'ordre (palier, échéance, limites de débit)

Résultat : l'ordre est accepté (ACKED) et mis en file d'attente pour l'appariement, ou rejeté avec un motif.

2. Appariement des ordres​

Processus : les ordres sont appariés dans le carnet d'ordres selon la priorité prix-temps.

Exécution : lorsque des ordres se croisent, des exécutions sont créées et les positions sont mises à jour dans l'état du moteur. Chaque changement d'état est écrit dans le journal durable du moteur avant d'être acquitté, et les tables de la base de données sont dérivées de ce journal.

Pas on-chain : les appariements individuels d'options ne sont pas enregistrés on-chain.

3. Mise à jour des positions​

Processus : les positions sur options et la trésorerie sont suivies dans l'état du moteur et mises à jour en temps réel. Les positions sur perpétuels résident dans le registre HyperCore de votre compte sur Hyperliquid.

Accès utilisateur : consultez vos positions via GET /portfolio ou le canal WebSocket portfolio.

4. Règlement​

Règlement à l'échéance : les options sont réglées en espèces à l'échéance, sur la base d'un prix de règlement dérivé de l'oracle Hyperliquid. Le moteur enregistre le prix de règlement dans son journal, calcule la valeur intrinsèque de chaque position, met à jour les soldes de trésorerie et clôture les positions.

Pour les heures d'échéance par sous-jacent, le mode de calcul du prix de règlement et ce qui se passe lorsque les données sont insuffisantes, consultez Règlement et Oracles.

Gestion des comptes​

Création de compte​

Processus : le portefeuille manager appelle createAccount sur la Factory avec un petit dépôt de création en HYPE. L'application s'en charge pour vous lorsque vous activez les perpétuels ou la Portfolio Margin. Consultez Onboarding (contrats).

Manager : chaque Account possède un manager (un EOA) qui le contrôle et peut autoriser des portefeuilles API à signer des ordres et des annulations.

Dépôts et retraits​

Dépôts :

  • USDC : envoyés sur HyperEVM au contrat Exchange (depositUsdcFor), qui les transfère vers le solde HyperCore de l'Exchange. Hypercall les crédite dès que le dépôt HyperCore est observé.
  • ERC20 d'options : déposés via le contrat Exchange, qui les brûle et crédite la position.

Retraits :

  • Doivent passer le contrôle de marge de Hypercall (marge suffisante après le retrait)
  • Signés par votre portefeuille. Les retraits USDC standard sont versés sur HyperCore depuis le solde de l'Exchange via une directive RSM. Les retraits en Portfolio Margin sont un envoi signé par le manager depuis votre Account sur HyperCore.

Frontière de confiance : les dépôts et retraits sont on-chain et vérifiables.

Liquidation​

Lorsque les fonds propres d'un compte passent sous son exigence de marge de maintenance, le compte entre en pré-liquidation :

  • Les ordres qui augmentent le risque sont bloqués ; les ordres de clôture restent autorisés.
  • Le liquidateur exécute des ordres de liquidation partielle pour rétablir la marge, avec un bonus de liquidateur qui augmente au fil du temps.
  • Si le compte ne s'est pas rétabli dans la fenêtre d'escalade, il passe en liquidation totale, exécutée par le moteur Hypercall.

Consultez Liquidation pour tous les détails.

Intégration Hyperliquid​

Perpétuels​

Hypercall achemine les ordres sur perpétuels vers Hyperliquid, y compris les marchés HIP-3 du dex xyz. Chaque ordre sur perpétuel est d'abord contrôlé par rapport à l'ensemble de votre compte en portfolio margin. Ensuite, deux routes sont possibles. L'application utilise le TEE par défaut, la route smart contract étant disponible comme paramètre avancé ; les clients API choisissent une route selon l'endpoint qu'ils appellent :

Route smart contract (paramètre avancé dans l'application) : vous signez l'ordre → le moteur de Hypercall le contrôle par rapport à l'ensemble de votre compte en portfolio margin → l'ordre passe on-chain via le contrat de votre compte vers HyperCore → Hyperliquid l'apparie

Route TEE (par défaut dans l'application, sur option via l'API) : vous signez l'ordre → le moteur le contrôle → une enclave sécurisée (TEE) détenant la clé de trading Hyperliquid de votre compte signe l'ordre natif → Hyperliquid l'apparie

Seuls les ordres de la route TEE passent par l'enclave. Ces ordres portent l'adresse de builder de Hypercall : le compte approuve donc le builder une seule fois (Activer le trading), et l'enclave ne signe que les ordres, annulations et changements de levier approuvés par le moteur. Consultez Perpétuels sur Hypercall.

Cas d'usage :

  • Couverture en delta des positions sur options
  • Marge croisée : les positions sur perpétuels sont prises en compte dans la portfolio margin

Marge croisée​

Les positions sur perpétuels HyperCore sont incluses dans les calculs de portfolio margin, et l'exigence retenue est la plus élevée entre le résultat de la portfolio margin et la marge propre à Hyperliquid. La Portfolio Margin est ouverte à tous les comptes ; consultez Onboarding en Portfolio Margin.

Commandes RSM​

RSM : la machine à états répliquée du moteur. Lorsque l'état du moteur exige une action on-chain (un crédit, un retrait, une étape de liquidation ou un ordre de recouvrement), le signataire RSM signe une directive et le séquenceur de Hypercall la soumet. Le règlement des options à l'échéance n'est pas une directive RSM : il est appliqué à la trésorerie dans l'état du moteur. Ce que chaque directive peut faire est détaillé dans Directives RSM.

Ce que vous pouvez vérifier​

On-chain (vérifiable)​

  • Propriété du compte (adresse du manager)
  • Dépôts et retraits
  • Ordres Hyperliquid et positions sur perpétuels (sur Hyperliquid)
  • Commandes RSM (exécution on-chain)

Hors chaîne (confiance requise)​

  • Équité de l'appariement des ordres
  • Calculs de marge
  • Calcul du prix de règlement (les données de l'oracle Hyperliquid sont publiques)
  • Exactitude du suivi des positions
  • Exactitude des données de marché
  • Moment de déclenchement des liquidations

Modèle de confiance​

Le Mainnet Alpha est opéré par Hypercall. Vous faites confiance à Hypercall pour apparier les ordres équitablement (priorité prix-temps), ingérer des données de marché exactes, calculer correctement la marge et les prix de règlement, déclencher les liquidations à temps, n'émettre que des directives RSM correctes et réagir aux incidents. Rien de tout cela n'est encore vérifiable cryptographiquement ; l'appariement hors chaîne gagne en vitesse au prix de cette confiance. La chaîne impose le reste : la propriété des comptes, les dépôts et les retraits sont on-chain, un Account n'exécute que les directives signées par son manager, l'un de ses API wallets ou le signataire RSM enregistré, et les contrats limitent les directives RSM aux crédits, aux retraits, à l'état de liquidation et à des actions de recouvrement encadrées. Les ordres sur perpétuels de la route TEE (par défaut dans l'application) sont signés à l'intérieur d'une enclave attestée qui n'accepte que les ordres approuvés par le moteur. Le signataire RSM, le séquenceur et les clés d'administration et de mise à niveau des contrats sont contrôlés par l'opérateur, et une mise à niveau d'Account s'applique à tous les Accounts. Les pouvoirs, rôles et adresses exacts figurent dans Confiance et permissions. La feuille de route de décentralisation du RSM précisera comment les engagements d'état, les rôles de signataire, les procédures de contestation et les contrôles de l'opérateur deviendront vérifiables ; le Mainnet Alpha est une première phase encadrée, pas le modèle de confiance définitif.

Voir aussi :

Dernière mise à jour le