Contratos

Mainnet Alpha

Estas son las direcciones actuales de los contratos de Hypercall Mainnet Alpha. El alcance del lanzamiento está intencionalmente limitado mientras la plataforma se expande.

Los componentes on-chain de Hypercall están desplegados en Hyperliquid L1 (HyperEVM). El sistema utiliza una arquitectura modular con contratos separados para la gestión de cuentas, el procesamiento de órdenes y el manejo de tokens de opciones.

Descripción General de la Arquitectura

Responsabilidades de los Contratos

Exchange

El Exchange es el punto de entrada principal y utiliza un patrón de proxy actualizable.

Responsabilidades:

• Crea las Accounts de usuario mediante el patrón BeaconProxy
• Custodia el USDC depositado en HyperCore (fondo de seguro + posiciones de opciones)
• Punto de entrada para el RSM Sequencer para acciones/solicitudes on-chain
• Maneja los depósitos y retiros de ERC20 de opciones (puente entre HyperEVM y el ledger del RSM)
• Rastrea y resuelve las subastas de liquidación completa
• Emite eventos con acciones ActionCaster sin procesar

Funciones Clave:

• createAccount() - Crea una nueva cuenta con el llamante como manager
• deposit(account, token, amount) - Deposita tokens en una cuenta
• addApiWallet(account, apiWallet) - Autoriza una API wallet para operar
• hlRequestOrder(...) - Coloca órdenes de perpetuos/spot en HyperLiquid mediante ActionCaster
• hlRequestCancel(...) - Cancela órdenes de HyperLiquid
• hlActionSendAsset(...) - Envía activos desde la Account a un destinatario
• hcActionWithdrawToken(...) - Retira tokens del Exchange a la Account
• hcActionWithdrawOption(...) - Retira opciones a un destinatario en HyperEVM
• rsmCommandRebalance(...) - Órdenes reduce-only iniciadas por el RSM
• rsmCommandRepay(...) - Repago de deuda iniciado por el RSM

Account

Cada usuario tiene su propio contrato Account (un BeaconProxy que apunta a una implementación compartida).

Responsabilidades:

• Custodia el colateral del lado de HyperCore para traders/MMs que usan activos distintos de USDC
• Tiene un único manager que puede agregar múltiples claves de agente
• Las claves de agente solo pueden firmar órdenes/cancelaciones; otras acciones requieren la firma del manager
• Punto de entrada para los managers para todas las acciones asociadas a la cuenta

Conceptos Clave:

• Manager: El propietario de la cuenta que puede autorizar agentes y firmar retiros
• Claves de Agente: Firmantes autorizados únicamente para la colocación/cancelación de órdenes
• API Wallets: Direcciones autorizadas que pueden enviar órdenes en nombre de la cuenta

Depósitos:

• Los ERC20 de opciones se depositan llamando a Exchange.deposit()
• Otros activos se transfieren a HyperCore usando el puente HyperEVM → HyperCore del activo
• Los depósitos de USDC en la "posición de USDC de opciones" se realizan mediante transferencia en HyperCore desde la Account al Exchange

Processor

El Processor maneja la verificación de firmas y la codificación de acciones.

Responsabilidades:

• Reconstruye las direcciones de los firmantes a partir de las firmas
• Codifica las acciones al formato ActionCaster
• Convierte montos en USD a HYPE para los cálculos de depósitos

Funciones Clave:

• hlRequestOrder(...) - Procesa solicitudes de órdenes
• hlRequestCancel(...) - Procesa solicitudes de cancelación
• hlActionSendAsset(...) - Procesa acciones de envío de activos
• rsmCommandRebalance(...) - Procesa comandos de rebalanceo del RSM
• rsmCommandRepay(...) - Procesa comandos de repago del RSM
• usdToHype(amountUsd) - Convierte USD a HYPE según el precio spot

Registry

El Registry gestiona el despliegue y la validación de los tokens de opciones.

Responsabilidades:

• Despliega tokens ERC20 de opciones
• Fuente de verdad para determinar si un ERC20 es un token de opción soportado
• Las direcciones en la lista blanca pueden desplegar nuevos tokens de opciones

Salvaguardas Futuras:

• Conjunto permitido de activos subyacentes
• Timestamps de vencimiento permitidos
• Granularidad de strikes permitida

Tipos de Acciones

Solicitudes de HyperLiquid

Solicitudes que interactúan con el libro de órdenes de HyperLiquid:

Acción	Firmante	Descripción
hlRequestOrder	Agente/API Wallet	Colocar órdenes de perpetuos/spot
hlRequestCancel	Agente/API Wallet	Cancelar órdenes por OID
hlRequestCancelByCloid	Agente/API Wallet	Cancelar órdenes por CLOID

Acciones del Manager

Acciones que requieren la firma del manager de la cuenta:

Acción	Descripción
hlActionSendAsset	Enviar activos desde la Account a un destinatario
hcActionWithdrawToken	Retirar tokens del Exchange a la Account
hcActionWithdrawOption	Retirar opciones a una dirección de HyperEVM

Comandos del RSM

Comandos firmados por el firmante del RSM (no se requiere consentimiento del manager):

Comando	Descripción
rsmCommandRebalance	Publicar órdenes reduce-only para aumentar el balance de USDC
rsmCommandRepay	Forzar la transferencia de USDC desde la Account al Exchange

Verificación de Firmas

• El Exchange verifica las firmas del firmante del RSM
• La Account verifica las firmas del manager y de los agentes
• Los comandos del RSM se transmiten sin la firma del manager (el firmante del RSM es de confianza)

Subastas de Liquidación

Cuando una cuenta queda subcolateralizada:

1. El RSM Sequencer activa una subasta de liquidación completa
2. Cualquiera puede ofertar suministrando el monto de USDC solicitado
3. El ganador se convierte en el nuevo manager de la Account
4. El RSM Sequencer puede detener subastas en curso si las condiciones cambian

Direcciones Desplegadas

Mainnet Alpha

Contrato	Dirección	Descripción
Exchange	0xE6b7FaA216cabb2b38B392f577C9c826378b2240	Contrato principal del exchange
Exchange Implementation	0xeEf31f6c8F2EFABba61C99d9efBEf4e6429024Cf	Implementación del Exchange detrás del proxy
Account Implementation	0xa8E861eAE5Bc47beDcF4896C7c5c676f563F5f1C	Implementación de Account
Account Beacon	0x1b96D6a48d1fB34dC45953697414656D2851Ca93	Beacon de Account
Fetcher	0x8654912Eae1554662665C13EeD4f1D8A4b028aDB	Contrato auxiliar de lectura
Option Token Implementation	0x6D0C7a116f9561A8De692c23c4C11682738ed206	Implementación del token de opción
Option Token Beacon	0xfb320352B25Dba7f139EA9Bf8966891CCa12dC35	Beacon del token de opción
Factory	0x2CeeAC2E032e4cCb05FF744619BfAb8cC75efE1b	Factory de cuentas
Router	0xF41FF41B6F007dE851ACc9F43Bd2f597Da741E2D	Contrato auxiliar de fondeo y enrutamiento
Option Registry	0x8C8efdd5F78C25215d03c8BbD5D1f6f0F1BB0598	Registro de tokens de opciones
Option Registry Implementation	0xF222421a93df1086E329503723b3cC4c30546C46	Implementación del registro de opciones detrás del proxy

Configuración de Mainnet

Parámetro	Dirección o Valor	Descripción
USDC	0xb88339CB7199b77E23DB6E890353E22632Ba630f	USDC de HyperEVM utilizado por Hypercall
Core Deposit	0x6B9E773128f453f5c2C60935Ee2DE2CBc5390A24	Contrato auxiliar de depósitos en HyperCore
RSM Signer	0x502E7fAbF34E84EeB115C34FE947b79A94dF886E	Firmante del RSM actual controlado por el operador
Sequencer	0x56a2924217C91EB4d6989Cf4C7b4dF03020E8944	Sequencer actual
Legacy Sequencer	0x8640A393730Fa671CF1C71CF5fcD2F8E299C44f7	Sequencer legacy

Código Fuente

El código fuente de los contratos estará disponible después de completar la auditoría.

Relacionado

• Firma EIP-712 - Formatos de mensajes y firma
• Autorización de Agentes - Configuración de API wallets
• Onboarding - Creación de cuentas y depósitos
• Autenticación de la API - Firma de solicitudes