Esta página foi traduzida automaticamente. O original em inglês é a versão canônica. Ler em inglês →
Pular para o conteúdo principal

Arquitetura

A Hypercall usa um modelo de execução híbrido: casamento de ordens off-chain para velocidade, com liquidação e gestão de contas on-chain para segurança.

Arquitetura BackendMercado de Opções Único, Múltiplas Fontes de OrdemOutros RoteadoresIntegrações adicionaisFrontend HypercallUI MM/Pro + MobileOrdens / CancelamentosGateway SDK / API Hypercall• Auth / Chaves• Ordem + Cancelar• Dados de mercado + stream de riscoCamada de Opções HypercallOff-chainOrderbooke MatchingPricing /Superfícies VolEngine de RiscoIM/MM, liquidaçõesLiquidação /State SyncOraclePreços de índiceTWAP de liquidaçãoExposição delta /fluxos de hedgingHyper EVMCamada de liquidaçãoHIP-3 PerpsVenue de delta hedgingHyperCoreInfraestrutura da camada baseIntegração ao vivoParceiros adicionais

Limites de confiança​

Off-chain (backend da Hypercall)​

Responsabilidades:

  • Casamento e execução de ordens
  • Gestão do livro de ofertas
  • Verificações de margem pré-negociação, incluindo a verificação de portfólio antes de cada ordem de perpétuo
  • Orquestração de liquidações
  • Dados de mercado e precificação
  • Streams via WebSocket

Premissa de confiança: você confia no operador para tudo o que está acima. Veja Modelo de confiança.

On-chain (smart contracts)​

Responsabilidades:

  • Propriedade da conta e controle pelo manager
  • Depósitos e saques
  • Comandos do RSM (operações de gestão de risco)
  • Tokens de opção (contratos OptionRegistry e OptionToken)
  • Aprovação do builder para ordens de perpétuo (approveZeroFeeBuilder feito uma única vez a partir da sua Account)

Premissa de confiança: as operações on-chain ficam registradas na Hyperliquid e não podem ser alteradas apenas pelo operador. Quem pode fazer upgrade dos contratos está descrito em Modelo de confiança.

Fluxo de execução de ordens​

1. Envio da ordem​

Ação do usuário: enviar a ordem via POST /order com assinatura EIP-712.

Validação no backend:

  • Verificação da assinatura (EIP-712)
  • Verificações de margem pré-negociação (baseadas em cenários)
  • Admissão da ordem (tier, vencimento, limites de taxa de requisições)

Resultado: a ordem é aceita (ACKED) e entra na fila para casamento, ou é rejeitada com o motivo.

2. Casamento de ordens​

Processo: as ordens são casadas no livro de ofertas por prioridade preço-tempo.

Execução: quando as ordens se casam, são gerados fills e as posições são atualizadas no estado do engine. Toda mudança de estado é gravada no journal durável do engine antes de ser confirmada, e as tabelas do banco de dados são derivadas desse journal.

Não fica on-chain: os casamentos individuais de opções não são registrados on-chain.

3. Atualização de posições​

Processo: as posições em opções e o caixa são acompanhados no estado do engine e atualizados em tempo real. As posições em perpétuos ficam no ledger HyperCore da sua conta na Hyperliquid.

Acesso do usuário: consulte as posições via GET /portfolio ou pelo canal portfolio do WebSocket.

4. Liquidação (settlement)​

Liquidação no vencimento: as opções são liquidadas em dinheiro no vencimento, contra um preço de liquidação derivado do oráculo da Hyperliquid. O engine registra o preço de liquidação no seu journal, calcula o valor intrínseco de cada posição, atualiza os saldos de caixa e encerra as posições.

Para os horários de vencimento por ativo subjacente, como o preço de liquidação é calculado e o que acontece quando há poucos dados, veja Liquidação e Oráculos.

Gestão de contas​

Criação de conta​

Processo: a carteira manager chama createAccount na Factory com um pequeno depósito de criação em HYPE. O app faz isso por você quando você ativa perpétuos ou o Portfolio Margin. Veja Onboarding (contratos).

Manager: cada Account tem um manager (uma EOA) que a controla e pode autorizar carteiras de API a assinar ordens e cancelamentos.

Depósitos e saques​

Depósitos:

  • USDC: enviado na HyperEVM para o contrato Exchange (depositUsdcFor), que faz a ponte para o saldo HyperCore da Exchange. A Hypercall credita o valor assim que o depósito na HyperCore é observado.
  • ERC20s de opções: depositados através do contrato Exchange, que os queima e credita a posição.

Saques:

  • Precisam passar pela verificação de margem da Hypercall (margem suficiente após o saque)
  • Assinados pela sua carteira. Saques padrão de USDC são pagos na HyperCore a partir do saldo da Exchange, por meio de uma diretiva do RSM. Saques no Portfolio Margin são um envio assinado pelo manager a partir da sua Account na HyperCore.

Limite de confiança: depósitos e saques são on-chain e verificáveis.

Liquidação​

Quando o patrimônio de uma conta cai abaixo do seu requisito de manutenção, ela entra em pré-liquidação:

  • Ordens que aumentam o risco são bloqueadas; ordens de fechamento continuam permitidas.
  • O liquidante executa ordens de liquidação parcial para restaurar a margem, com um bônus de liquidante que aumenta ao longo do tempo.
  • Se a conta não se recuperar dentro da janela de escalonamento, ela passa para a liquidação total, executada pelo engine da Hypercall.

Veja Liquidação para todos os detalhes.

Integração com a Hyperliquid​

Perpétuos​

A Hypercall roteia ordens de perpétuos para a Hyperliquid, incluindo mercados HIP-3 na dex xyz. Toda ordem de perpétuo é primeiro verificada contra toda a sua conta de portfolio margin. Depois disso, há duas rotas. O app usa TEE por padrão, com a rota de smart contract como configuração avançada; clientes de API escolhem a rota pelo endpoint que chamam:

Rota de smart contract (configuração avançada no app): você assina a ordem → o engine da Hypercall verifica a ordem contra toda a sua conta de portfolio margin → a ordem vai on-chain através do contrato da sua conta até a HyperCore → a Hyperliquid casa a ordem

Rota TEE (padrão no app, opt-in via API): você assina a ordem → o engine verifica a ordem → um enclave seguro (TEE) que guarda a chave de trading da sua conta na Hyperliquid assina a ordem nativa → a Hyperliquid casa a ordem

Só as ordens da rota TEE passam pelo enclave. Essas ordens levam o endereço de builder da Hypercall, então a conta aprova o builder uma única vez (Ativar trading), e o enclave assina apenas ordens, cancelamentos e mudanças de alavancagem aprovados pelo engine. Veja Perpétuos na Hypercall.

Casos de uso:

  • Hedge de delta de posições em opções
  • Margem cruzada: posições em perpétuos contam para o portfolio margin

Margem cruzada​

As posições em perpétuos na HyperCore entram nos cálculos de portfolio margin, e o requisito é o maior entre o resultado do portfolio margin e a margem da própria Hyperliquid. O Portfolio Margin está aberto a todas as contas; veja Onboarding no Portfolio Margin.

Comandos do RSM​

RSM: a máquina de estados replicada do engine. Quando o estado do engine exige uma ação on-chain (um crédito, um saque, uma etapa de liquidação ou uma ordem de recuperação), o assinante do RSM assina uma diretiva e o sequenciador da Hypercall a envia. A liquidação de opções no vencimento não é uma diretiva do RSM: ela é aplicada ao caixa no estado do engine. O que cada diretiva pode fazer está listado em Diretivas RSM.

O que você pode verificar​

On-chain (verificável)​

  • Propriedade da conta (endereço do manager)
  • Depósitos e saques
  • Ordens e posições em perpétuos na Hyperliquid (na Hyperliquid)
  • Comandos do RSM (execução on-chain)

Off-chain (exige confiança)​

  • Justiça no casamento de ordens
  • Cálculos de margem
  • Cálculo do preço de liquidação (os inputs do oráculo da Hyperliquid são públicos)
  • Precisão no acompanhamento de posições
  • Precisão dos dados de mercado
  • Momento de disparo das liquidações

Modelo de confiança​

A Mainnet Alpha é operada pela Hypercall. Você confia na Hypercall para casar ordens de forma justa (prioridade preço-tempo), ingerir dados de mercado precisos, calcular corretamente a margem e os preços de liquidação, disparar liquidações no tempo certo, emitir apenas diretivas RSM corretas e responder a incidentes. Nada disso é verificável criptograficamente ainda; o casamento de ordens off-chain ganha velocidade ao custo dessa confiança. A blockchain garante o resto: a propriedade da conta, os depósitos e os saques são on-chain, uma Account só executa diretivas assinadas pelo seu manager, por uma das suas API wallets ou pelo assinante registrado do RSM, e os contratos limitam as diretivas RSM a créditos, saques, estado de liquidação e ações de recuperação restritas. Ordens de perpétuos na rota TEE (o padrão no app) são assinadas dentro de um enclave atestado que aceita apenas ordens aprovadas pelo engine. O assinante do RSM, o sequenciador e as chaves de admin e de upgrade dos contratos são controlados pelo operador, e um upgrade da Account se aplica a todas as Accounts. Poderes, papéis e endereços exatos estão em Confiança e Permissões. O roadmap de descentralização do RSM vai definir como os compromissos de estado, os papéis de assinante, os caminhos de disputa e os controles do operador se tornam verificáveis; a Mainnet Alpha é a primeira fase, com restrições, e não o modelo de confiança final.

Veja também:

Última atualização em