A corrente de passos
Seis passos separam um dólar que está em outra rede de uma posição na Hyperliquid.
- O USDC chega ao HyperCore. Ele é emitido de forma nativa na L1 da Hyperliquid, e o Cross-Chain Transfer Protocol da Circle o traz de Arbitrum.
- Ele é creditado no seu endereço. Os depósitos são creditados primeiro no saldo de margem cruzada desse endereço, na câmara de compensação dos perpétuos.
- Você assina uma ordem. Um mercado, um lado, um tamanho, um preço e uma alavancagem, assinados pela chave da conta ou por uma carteira de API que ela aprovou.
- A ordem entra no livro daquele ativo, em um preço múltiplo do tick, e casa por preço e hora de chegada.
- A execução muda a sua posição na câmara de compensação, e o funding é liquidado a cada hora enquanto a posição seguir aberta.
- Um saque é uma assinatura só na Hyperliquid: os validadores assinam e mandam o pedido ao contrato da ponte.
Colocar dólares para dentro
O USDC é emitido de forma nativa na L1 da Hyperliquid, e o caminho a partir de Arbitrum é o protocolo da própria Circle, que a Circle documenta. A ponte antiga de Arbitrum está obsoleta: a documentação diz que ela guarda hoje menos de 10 % do USDC em circulação no HyperCore.
Vale conhecer a mecânica da ponte antiga, porque a maioria dos guias ainda descreve ela. O USDC enviado a ela é creditado em menos de um minuto no endereço que enviou, o depósito mínimo é de 5 USDC, e a documentação diz sem rodeios que um valor menor não é creditado e se perde para sempre.
O que chega cai no saldo de margem cruzada, onde sustenta todas as posições abertas nesse modo. Uma posição abre em margem cruzada por padrão; a margem isolada é uma escolha que você faz posição por posição.
Uma ordem no livro
O livro de ofertas funciona no essencial como o de uma exchange centralizada, e é inteiramente onchain. Um preço precisa ser um múltiplo inteiro do tick e um tamanho um múltiplo inteiro do lote, e as ordens casam por preço e hora de chegada.
A margem é conferida duas vezes. É conferida quando uma ordem nova é aberta, e de novo no lado que estava parado no livro na hora do casamento de cada ordem, para que o sistema de margem fique coerente mesmo que o preço oráculo tenha andado depois de a ordem parada ser colocada.
A própria rede sabe o que é uma ordem. Dentro de um bloco, as ações são separadas em três grupos: primeiro as que não mandam nenhuma ordem GTC ou IOC a nenhum livro, depois os cancelamentos, depois as que mandam ao menos uma ordem GTC ou IOC, e cada grupo guarda a ordem que o proponente do bloco deu. Um bloco costuma levar um ou dois lotes de ações do consenso.
Com que rapidez ela responde
De ponta a ponta, medido do envio de um pedido ao recebimento de uma resposta confirmada, a documentação dá uma mediana de 0,2 segundo e 0,9 segundo no percentil 99, para uma ordem enviada de um cliente colocado geograficamente ao lado. A mainnet aguenta cerca de 200.000 ordens por segundo, e a documentação diz que o gargalo é a execução, mais do que o consenso.
Duas consequências para tudo o que é automático. Uma decisão é confirmada bem abaixo de um segundo, então um programa não precisa adivinhar se a ordem dele chegou; e um programa longe de um servidor de API é limitado pela própria rede antes de ser limitado pela blockchain.
Assinaturas, carteiras de API e nonces
Cada ação é assinada. Além da chave da própria conta, uma conta principal pode aprovar carteiras de API, que a documentação também chama de carteiras de agente, para assinarem pela conta ou pelas subcontas dela. Uma conta pode ter uma carteira aprovada sem nome e até três com nome, com dois agentes com nome a mais por subconta, e um vencimento definido com valid_until pode ir no máximo a 180 dias.
Uma carteira de API assina, e não faz mais nada. Os dados de uma conta são consultados com o endereço real da conta, e a documentação nomeia como armadilha comum consultar o endereço do agente: ele devolve um resultado vazio, não um erro.
Os nonces não são os de Ethereum, porque um livro de ofertas não pode esperar uma transação por vez. A Hyperliquid guarda os 100 nonces mais altos por assinante; uma ação nova precisa levar um nonce acima do menor desse conjunto e nunca usado antes, e dentro dos dois dias antes e do dia depois do horário do bloco dela.
O estado dos nonces de uma carteira de API pode ser podado: quando ela é descadastrada pela aprovação de uma nova, quando vence, ou quando a conta que a cadastrou fica sem fundos. A documentação avisa que ações assinadas antes podem então ser repetidas. Gere uma carteira de API nova em vez de ressuscitar um endereço antigo.
Tirar dólares
Um saque começa com uma assinatura na Hyperliquid e não pede nenhuma transação sua na outra rede: os validadores assinam e mandam o pedido ao contrato da ponte. A documentação dá uma taxa de US$ 1 no momento em que foi escrita, e cerca de cinco minutos para finalizar.
O que pode mandar esse pedido importa mais do que o tempo que ele leva. Uma carteira de API aprovada não pode: medido na mainnet em 28 de setembro de 2026 com uma chave de agente nova, withdraw3, usdSend, spotSend, sendAsset e usdClassTransfer foram todos recusados no assinante, enquanto os mesmos pedidos assinados pela própria conta encontraram um erro de saldo.
É por isso que dá para entregar uma chave a um agente. A chave que opera e a chave que move o dinheiro são duas chaves diferentes.