Como lançar um token na Elysium e negociá-lo na Hyperliquid

A Elysium é a Layer 2 da Kinetiq para a Hyperliquid, e sua mainnet entrou no ar em 9 de novembro. É uma chain EVM com blocos de 100 ms, que usa HYPE como gas e liquida no HyperEVM. Um token da Elysium pode ser negociado nos próprios order books da Hyperliquid. Este guia percorre o caminho completo. Você faz o deploy de um ERC-20 na Elysium com Foundry e nosso RPC da Elysium, espelha o token no HyperEVM e depois executa a listagem no HyperCore, que o coloca em um order book spot contra USDC.

O deploy e o espelhamento são baratos e permissionless, embora o primeiro mint do espelho precise aguardar um período de contestação de cerca de 5,5 dias. A listagem no HyperCore é uma cerimônia única do emissor na Hyperliquid e começa com um leilão de ticker cujo preço nunca cai abaixo de 500 HYPE. Depois dessa cerimônia, tudo fica aberto a qualquer detentor, que pode mover o token entre a Elysium, o HyperEVM e o HyperCore pelas bridges.

O que você precisa saber sobre a Elysium antes do lançamento?

A Elysium é uma chain Arbitrum Orbit construída pela Kinetiq que liquida no HyperEVM e roda co-localizada com o HyperCore. O HyperCore é a camada de exchange da Hyperliquid, onde ficam seus order books de spot e de perpétuos. O HyperEVM é o ambiente EVM que roda ao lado dele, na mesma L1 da Hyperliquid. Nosso post sobre como estamos apostando tudo na Hyperliquid explica como as duas partes se encaixam, e nosso guia de trading na Elysium cobre a própria chain em mais detalhes, desde por que a Hyperliquid precisa de uma L2 até os apps que estão sendo lançados nela.

O HyperEVM limita a própria capacidade de propósito. Seus blocos pequenos carregam 3M de gas a cada segundo, com 30M de gas apenas nos blocos grandes de um minuto. A Kinetiq construiu a Elysium para cargas de trabalho que precisam de mais, como market makers que atualizam cotações várias vezes por segundo. Ela mira 300 Mgas/s (milhões de gas por segundo) de execução, cerca de duas ordens de grandeza a mais que o HyperEVM, e mantém o HYPE como o único token de que você precisa para transacionar.

Os blocos da Elysium são blocos canônicos de verdade, então latest e os recibos de transação têm o significado de sempre, sem camada de pré-confirmação por cima. Solidity, Foundry, Hardhat e viem funcionam sem alterações. A Kinetiq também destinou 25% das taxas do sequenciador aos builders cujos apps geram atividade na chain.

Somos o principal provedor de RPC da Elysium, e a documentação da Kinetiq nos lista como o provedor de infraestrutura recomendado para a Elysium. Nossa página de RPC da Elysium e nosso quickstart da API da Elysium trazem os endpoints da mainnet. Dois detalhes do nosso FAQ da API da Elysium poupam tempo de depuração:

• O export elysiumTestnet em viem/chains é outra chain. Ele pertence a um projeto sem relação com este, então defina você mesmo a Elysium da Kinetiq com defineChain.
• Uma transferência simples de HYPE custa um pouco mais de 21.000 de gas. As chains Arbitrum adicionam uma pequena quantia pelos dados da chain pai, então um limite de gas fixado em 21000 no código falha com intrinsic gas too low.

Como um token vai da Elysium a um order book do HyperCore?

Um token faz dois saltos de bridge, e cada salto tem sua própria configuração:

A bridge de espelhamento não exige nenhum código no seu token. Ela bloqueia o original na Elysium em uma carteira de custódia e faz o mint de um espelho 1:1 no HyperEVM, então o supply do espelho é sempre igual ao que está bloqueado.

O HyperCore vincula cada token spot a um único contrato EVM, e quem faz o deploy precisa provar que controla esse contrato. Um contrato implantado diretamente a partir de uma carteira prova isso com o nonce do deploy. O seu espelho é implantado pela factory da bridge, então essa verificação não funciona para ele. Uma carteira de depósito resolve isso, seguindo o padrão que a Circle usa para vincular o USDC. Ela mantém o espelho em custódia, grava o seu endereço de assinatura no slot de storage que o HyperCore lê para contratos implantados por factories e se torna o contrato ao qual o HyperCore se vincula.

Três escolhas nesse caminho não podem ser desfeitas, então defina-as antes de gastar qualquer coisa. São elas os decimais do token no HyperCore (fixados quando você vence o ticker), o seu supply de genesis e o vínculo entre o token do HyperCore e a carteira de depósito.

Como fazer o deploy do token na Elysium?

Você precisa de três coisas antes de tocar na chain:

• Um endpoint da Elysium. Crie um app no dashboard da Alchemy e selecione Elysium.
• HYPE na Elysium. O HYPE chega 1:1 do HyperEVM pela bridge da Kinetiq como gas nativo, sem nenhum token wrapped no meio.
• Foundry. Todos os comandos abaixo usam forge e cast, e a mesma chave de deployer assina na Elysium, no HyperEVM e no HyperCore.

A bridge de espelhamento aceita qualquer ERC-20 padrão com três propriedades. Ele precisa expor name(), symbol() e decimals(), porque é por esses metadados que a bridge pareia o token com o seu espelho. Os metadados nunca devem mudar. As transferências também precisam mover exatamente o valor solicitado, o que exclui tokens fee-on-transfer e de rebase. Um ERC-20 simples da OpenZeppelin atende às três. Nosso guia sobre tokens ERC-20 em Solidity cobre o que cada função faz.

Planeje desde já o supply de acordo com os limites do HyperCore. O HyperCore armazena saldos como inteiros de 64 bits e permite no máximo 8 decimais de wei, o que limita um token com 8 decimais a cerca de 184 bilhões de unidades inteiras. Um supply fixo de um bilhão cabe com folga:

O ERC-20 da OpenZeppelin define o nome e o símbolo uma única vez no construtor e, sem função de mint, o supply fica fixo no deploy. Salve o contrato como src/ExampleToken.sol e faça o deploy:

cast wallet import guarda a chave em um keystore criptografado, e --account a desbloqueia no momento da assinatura, então a chave bruta nunca aparece no histórico do shell. Nosso guia de token na Robinhood Chain usa o mesmo fluxo em outra chain Arbitrum Orbit.

Para ver a cadência de blocos por conta própria, assine novos blocos pelo endpoint WebSocket. Nessa cadência, o polling via HTTP pula blocos entre uma consulta e outra, então use aqui a URL WebSocket:

Defina ELYSIUM_WSS como a URL wss://elysium-mainnet.g.alchemy.com/v2/ com a sua chave. Você pode consultar o seu token e as transações dele no explorador da Elysium.

Como espelhar o token no HyperEVM?

A bridge de espelhamento tem duas partes. Uma carteira de custódia na Elysium guarda os tokens bloqueados, e somente a bridge faz o mint e a queima de um ERC-20 espelho no HyperEVM. A configuração é permissionless e exige uma transação em cada chain, em qualquer ordem. Os endereços abaixo são os da mainnet da Elysium, retirados da página de endereços de contratos da Kinetiq. Confira-os lá antes de enviar fundos:

A transação no HyperEVM faz o deploy do espelho nesse endereço e registra o par na bridge nas duas chains. Ela paga em HYPE por duas mensagens de entrega para a Elysium, e o valor que você envia precisa ser exatamente igual à soma dos dois orçamentos de mensagem. A Kinetiq recomenda oferecer o dobro do preço de gas atual da Elysium, com mínimo de 0,5 gwei, para que as duas mensagens sejam executadas assim que chegarem. Qualquer excedente é reembolsado para o seu endereço na Elysium:

Passe exatamente o nome, o símbolo e os decimais atuais do token. A factory aceita quaisquer metadados, mas só o espelho que corresponde ao seu token pode receber supply, e um espelho divergente fica vazio para sempre. As duas mensagens normalmente chegam à Elysium em até um minuto. Se uma delas não for executada, rode de novo o mesmo registro com os mesmos argumentos para reenviar as duas.

A partir daqui, a bridge fica aberta a todos os detentores. Para mover tokens, aprove a carteira de custódia na Elysium e envie-os pelo router. O router recebe o endereço do espelho como argumento de token nas duas direções:

O bloqueio acontece na hora. O espelho pode ser resgatado no HyperEVM depois que termina o período de contestação da Elysium, que é a janela de espera das mensagens que saem de um optimistic rollup e dura cerca de 5,5 dias na mainnet. Qualquer pessoa pode fazer o resgate, e a bridge da Kinetiq mostra a transferência como resgatável quando ela estiver pronta. Planeje o primeiro mint do espelho em torno dessa espera. Depois que o resgate for confirmado, leia o supply do espelho com a Alchemy CLI:

A volta é mais rápida. Queimar o espelho no HyperEVM libera o original na Elysium, normalmente em até um minuto.

Integradores que listam o espelho devem verificá-lo pela factory em vez de confiar apenas no endereço. A verificação da Kinetiq combina duas leituras. elysiumTokenOf(mirror) na factory de espelhos precisa retornar o token original, e o supply do espelho precisa ser maior que zero, o que um espelho divergente nunca alcança.

Como listar o token em um order book spot do HyperCore?

A listagem é uma cerimônia do emissor no HyperCore com cinco partes. Você compra um ticker, cria a carteira de depósito, executa o genesis, vincula o token à carteira e registra o par spot. O guia de deploy spot da Kinetiq documenta a cerimônia completa. Só o endereço que vence o ticker pode assinar as ações no HyperCore, e não há allowlist nem revisão entre a compra do ticker e um order book no ar. Na prática, a cerimônia leva dias, porque o leilão segue o próprio cronograma.

Quanto custa o leilão do ticker?

Os tickers são vendidos em um leilão holandês de 31 horas. O preço cai de forma linear até um piso de 500 HYPE, e cada novo leilão abre com o dobro do preço da venda anterior, ou no piso, se o último leilão não teve venda. A documentação da Hyperliquid pede que quem faz o deploy ensaie antes o deploy exato na testnet, porque o pagamento do leilão não é reembolsado se um deploy travar.

As ações no HyperCore abaixo usam o SDK Python da Hyperliquid e assinam com o mesmo keystore do Foundry usado nas transações EVM:

Nossa HyperCore Data API, agora em acesso antecipado, fornece o mesmo estado do leilão.

Quando o preço estiver aceitável, compre o ticker. Essa chamada fixa de vez a especificação de decimais no HyperCore. O exemplo usa 8 decimais de wei e 2 decimais de tamanho, o que atende à regra do HyperCore de que os decimais de wei sejam pelo menos os decimais de tamanho mais 5. O teto do lance está em unidades do HyperCore, nas quais o HYPE tem 8 decimais:

Como a carteira de depósito, o genesis e o vínculo se encaixam?

Crie a carteira de depósito no HyperEVM enquanto o ticker ainda não está vinculado. O último argumento é o endereço que vai assinar o vínculo, que a carteira grava no slot de storage verificado pelo HyperCore:

O genesis cria todo o supply do token no HyperCore. Para um token via bridge, tudo vai para o endereço de sistema do token, um endereço reservado do HyperCore formado por 0x20 seguido do índice do ticker. O supply só sai do endereço de sistema quando alguém deposita tokens espelho em custódia, então o supply circulante no HyperCore sempre corresponde ao que a carteira de depósito guarda. O genesis só pode ser executado uma vez. Um token via bridge também desativa a Hyperliquidity, a estratégia do HIP-2 que abastece um book novo com ordens operadas pelo protocolo:

O vínculo consiste em duas ações no HyperCore, uma solicitação que indica a carteira de depósito e uma finalização assinada pelo endereço gravado nela. O offset de decimais é a diferença entre os 18 decimais do ERC-20 e os 8 do token no HyperCore. O SDK não tem helper para essas ações, então assine-as e envie-as diretamente. O vínculo é permanente:

A partir daqui, os depósitos já funcionam, mesmo antes de o token ter um order book.

Como abrir o order book?

Registrar o par spot contra USDC (índice de token 0) e depois registrar a Hyperliquidity cria o mercado. A segunda chamada é obrigatória mesmo com a Hyperliquidity desativada e, nesse caso, não posiciona nenhuma ordem e apenas define o preço de abertura:

Agora os detentores podem mover tokens para o HyperCore. Eles aprovam a carteira de depósito para o espelho e chamam deposit com o spot do HyperCore como destino. Com 18 decimais na EVM e 8 no HyperCore, os valores precisam ser múltiplos de 10^10 unidades base, e valores em tokens inteiros sempre são:

O HyperCore credita o saldo no próximo bloco. Para voltar, basta uma ação sendAsset para o endereço de sistema, que paga o espelho a partir da custódia no HyperEVM. Com a Hyperliquidity desativada, o book novo começa vazio. Sua equipe ou um market maker precisa fazer cotações nele, usando o ID de ativo spot 10000 + SPOT_INDEX nas ordens.

Um agente de programação pode fazer isso por você?

A maior parte do lado EVM pode ser automatizada com scripts. Um agente pode fazer o deploy do token, configurar o espelho e levar o supply pela bridge com Foundry, e depois confirmar cada etapa com a Alchemy CLI. Todo comando da CLI aceita --json --no-interactive, para que o agente consiga interpretar a saída. Se o seu agente trabalha com skills ou MCP em vez de um shell, as Agent Skills e o Alchemy MCP server cobrem as mesmas leituras. Use -n hyperliquid-mainnet para leituras no HyperEVM e aponte o Foundry para o seu endpoint da Elysium em tudo o que acontece na Elysium.

Deixe a assinatura da cerimônia no HyperCore com uma pessoa. Ela gasta pelo menos 500 HYPE no leilão e fixa os decimais, o supply e o vínculo de forma permanente, então um agente deve preparar essas ações e uma pessoa deve assiná-las. Um prompt para o lado EVM:

Comece a construir na Elysium

Crie um app no dashboard da Alchemy, selecione Elysium e você terá endpoints de RPC e WebSocket da mainnet em poucos minutos. Sem contratos, sem lista de espera, sem compromisso mínimo. Equipes que constroem na Elysium também podem solicitar créditos pelo programa de créditos da Alchemy para a Elysium. Adicione o HyperEVM da Hyperliquid ao mesmo app para a etapa do espelho e solicite acesso antecipado ao HyperCore para fazer streaming do order book em que o seu token vai chegar.