Contratos

Mainnet Alpha

Estes são os endereços atuais dos contratos do Hypercall Mainnet Alpha. O escopo do lançamento é intencionalmente restrito enquanto a plataforma se expande.

Os componentes on-chain da Hypercall estão implantados na Hyperliquid L1 (HyperEVM). O sistema usa uma arquitetura modular com contratos separados para gerenciamento de contas, processamento de ordens e manuseio de tokens de opção.

Visão Geral da Arquitetura

Responsabilidades dos Contratos

Exchange

O Exchange é o ponto de entrada principal e usa um padrão de proxy atualizável.

Responsabilidades:

• Cria Accounts de usuários via padrão BeaconProxy
• Custodia o USDC depositado na HyperCore (fundo de seguro + posições de opções)
• Ponto de entrada para o RSM Sequencer para ações/requisições on-chain
• Gerencia depósitos e saques de ERC20 de opções (fazendo a ponte entre HyperEVM e o ledger do RSM)
• Rastreia e resolve leilões de liquidação total
• Emite eventos com ações brutas do ActionCaster

Funções Principais:

• createAccount() - Cria uma nova conta com o chamador como gerente
• deposit(account, token, amount) - Deposita tokens em uma conta
• addApiWallet(account, apiWallet) - Autoriza uma carteira de API para negociação
• hlRequestOrder(...) - Coloca ordens de perpétuos/spot na HyperLiquid via ActionCaster
• hlRequestCancel(...) - Cancela ordens na HyperLiquid
• hlActionSendAsset(...) - Envia ativos da Account para o destinatário
• hcActionWithdrawToken(...) - Saca tokens do Exchange para a Account
• hcActionWithdrawOption(...) - Saca opções para um destinatário na HyperEVM
• rsmCommandRebalance(...) - Ordens reduce-only iniciadas pelo RSM
• rsmCommandRepay(...) - Pagamento de dívida iniciado pelo RSM

Account

Cada usuário tem seu próprio contrato Account (BeaconProxy apontando para uma implementação compartilhada).

Responsabilidades:

• Custodia colateral no lado da HyperCore para traders/MMs que usam ativos que não sejam USDC
• Tem um único gerente que pode adicionar múltiplas chaves de agente
• Chaves de agente só podem assinar ordens/cancelamentos; outras ações exigem a assinatura do gerente
• Ponto de entrada para gerentes para todas as ações associadas à conta

Conceitos-Chave:

• Gerente: O dono da conta, que pode autorizar agentes e assinar saques
• Chaves de Agente: Signatários autorizados apenas para colocação/cancelamento de ordens
• Carteiras de API: Endereços autorizados que podem enviar ordens em nome da conta

Depósitos:

• ERC20s de opções são depositados chamando Exchange.deposit()
• Outros ativos são transferidos para a HyperCore usando a ponte HyperEVM → HyperCore do ativo
• Depósitos de USDC na "posição de USDC de Opções" são feitos via transferência na HyperCore da Account para o Exchange

Processor

O Processor lida com a verificação de assinaturas e a codificação de ações.

Responsabilidades:

• Reconstrói os endereços dos signatários a partir das assinaturas
• Codifica ações no formato do ActionCaster
• Converte valores em USD para HYPE para cálculos de depósito

Funções Principais:

• hlRequestOrder(...) - Processa requisições de ordens
• hlRequestCancel(...) - Processa requisições de cancelamento
• hlActionSendAsset(...) - Processa ações de envio de ativos
• rsmCommandRebalance(...) - Processa comandos de rebalanceamento do RSM
• rsmCommandRepay(...) - Processa comandos de pagamento do RSM
• usdToHype(amountUsd) - Converte USD para HYPE com base no preço spot

Registry

O Registry gerencia a implantação e a validação de tokens de opção.

Responsabilidades:

• Implanta tokens ERC20 de opções
• Fonte de verdade para "este ERC20 é um token de opção suportado"
• Endereços na whitelist podem implantar novos tokens de opção

Proteções Futuras:

• Conjunto permitido de ativos subjacentes
• Timestamps de vencimento permitidos
• Granularidade de strike permitida

Tipos de Ação

Requisições HyperLiquid

Requisições que interagem com o livro de ofertas da HyperLiquid:

Ação	Signatário	Descrição
hlRequestOrder	Agente/Carteira de API	Colocar ordens de perpétuos/spot
hlRequestCancel	Agente/Carteira de API	Cancelar ordens por OID
hlRequestCancelByCloid	Agente/Carteira de API	Cancelar ordens por CLOID

Ações do Gerente

Ações que exigem a assinatura do gerente da conta:

Ação	Descrição
hlActionSendAsset	Enviar ativos da Account para o destinatário
hcActionWithdrawToken	Sacar tokens do Exchange para a Account
hcActionWithdrawOption	Sacar opções para um endereço na HyperEVM

Comandos do RSM

Comandos assinados pelo signatário do RSM (não é necessário consentimento do gerente):

Comando	Descrição
rsmCommandRebalance	Postar ordens reduce-only para aumentar o saldo de USDC
rsmCommandRepay	Forçar transferência de USDC da Account para o Exchange

Verificação de Assinaturas

• O Exchange verifica assinaturas do signatário do RSM
• A Account verifica assinaturas de gerentes e agentes
• Comandos do RSM são passados sem assinatura do gerente (o signatário do RSM é confiável)

Leilões de Liquidação

Quando uma conta fica subcolateralizada:

1. O RSM Sequencer aciona um leilão de liquidação total
2. Qualquer pessoa pode dar lances fornecendo a quantia de USDC solicitada
3. O vencedor se torna o novo gerente da Account
4. O RSM Sequencer pode interromper leilões em andamento se as condições mudarem

Endereços Implantados

Mainnet Alpha

Contrato	Endereço	Descrição
Exchange	0xE6b7FaA216cabb2b38B392f577C9c826378b2240	Contrato principal do exchange
Exchange Implementation	0xeEf31f6c8F2EFABba61C99d9efBEf4e6429024Cf	Implementação do Exchange por trás do proxy
Account Implementation	0xa8E861eAE5Bc47beDcF4896C7c5c676f563F5f1C	Implementação da Account
Account Beacon	0x1b96D6a48d1fB34dC45953697414656D2851Ca93	Beacon da Account
Fetcher	0x8654912Eae1554662665C13EeD4f1D8A4b028aDB	Contrato auxiliar de leitura
Option Token Implementation	0x6D0C7a116f9561A8De692c23c4C11682738ed206	Implementação do token de opção
Option Token Beacon	0xfb320352B25Dba7f139EA9Bf8966891CCa12dC35	Beacon do token de opção
Factory	0x2CeeAC2E032e4cCb05FF744619BfAb8cC75efE1b	Factory de contas
Router	0xF41FF41B6F007dE851ACc9F43Bd2f597Da741E2D	Auxiliar de financiamento e roteamento
Option Registry	0x8C8efdd5F78C25215d03c8BbD5D1f6f0F1BB0598	Registro de tokens de opção
Option Registry Implementation	0xF222421a93df1086E329503723b3cC4c30546C46	Implementação do registro de opções por trás do proxy

Configuração da Mainnet

Parâmetro	Endereço ou Valor	Descrição
USDC	0xb88339CB7199b77E23DB6E890353E22632Ba630f	USDC na HyperEVM usado pela Hypercall
Core Deposit	0x6B9E773128f453f5c2C60935Ee2DE2CBc5390A24	Auxiliar de depósito na HyperCore
RSM Signer	0x502E7fAbF34E84EeB115C34FE947b79A94dF886E	Signatário atual do RSM controlado pelo operador
Sequencer	0x56a2924217C91EB4d6989Cf4C7b4dF03020E8944	Sequencer atual
Legacy Sequencer	0x8640A393730Fa671CF1C71CF5fcD2F8E299C44f7	Sequencer legado

Código-Fonte

O código-fonte dos contratos será disponibilizado após a conclusão da auditoria.

Relacionados

• Assinatura EIP-712 - Formatos de mensagem e assinatura
• Autorização de Agentes - Configuração de carteira de API
• Onboarding - Criação de conta e depósitos
• Autenticação de API - Assinatura de requisições