Bridge de Chiliz Chain para Solana
Implante um OFT Adapter na Chiliz Chain e um Native OFT na Solana usando LayerZero v2 para fazer bridge de tokens da Chiliz Chain para a rede Solana.
Para fazer bridge de um token existente da Chiliz Chain para a Solana, você precisa escrever e implantar dois smart contracts separados: um OFT Adapter na cadeia onde o token já existe (Chiliz Chain) e um Native OFT na cadeia de destino (Solana).
Observe que o LayerZero fornece seu próprio QuickStart para contratos OFT:
Pré-requisitos
Este guia exige o seguinte:
Um endereço de contrato de token na Chiliz Chain. Você não precisa ser o proprietário.
Uma carteira Web3 para cada cadeia (o MetaMask não suporta cadeias não-EVM):
Para a Chiliz Chain: carteira MetaMask com a configuração RPC da Chiliz Chain.
Para a Solana: carteira Solflare com configuração da Solana Mainnet. Aqui está o guia de configuração deles.
Tokens de gas suficientes em cada cadeia para pagar pelos deploys dos contratos e pelas taxas de gas do envio de mensagens.
Na Chiliz Chain: tokens CHZ.
Na Solana: tokens SOL.
Etapa 1: Desenvolvimento dos Contratos
Preparando o OFTAdapter na Chiliz Chain
O contrato OFTAdapter age como um cofre para o seu token existente. Quando os usuários fazem bridge de seus tokens para fora da Chiliz Chain, este contrato bloqueia os tokens ERC-20 originais.
Crie um novo arquivo chamado ChilizTokenAdapter.sol na pasta de contratos do seu projeto:
Preparando e Implantando o OFT na Solana
Ao contrário da Chiliz Chain, a Solana não usa a Ethereum Virtual Machine (EVM) ou a linguagem Solidity. Os smart contracts da Solana (chamados de "Programs") são escritos em Rust.
Para fazer bridge do seu token, você precisa implantar um programa OFT na Solana. Quando este programa recebe uma mensagem verificada do seu OFTAdapter implantado na Chiliz, ele mintará o token SPL correspondente na carteira Solana do usuário.
O LayerZero fornece um exemplo Anchor pronto para uso para que você não precise escrever a lógica de bridge em Rust do zero.
1. Clone o exemplo OFT Solana do LayerZero:
2. Compile o programa Rust
Isso também gerará seu Program ID único da Solana (equivalente a um endereço de contrato na EVM):
Após a conclusão da compilação, o Anchor gerará um novo par de chaves em target/deploy/oft_solana-keypair.json.\ Você pode recuperar seu novo Program ID executando:
3. Implante na Solana Mainnet
Certifique-se de que sua CLI Solana esteja configurada para a Mainnet e que sua carteira local tenha SOL suficiente para o deploy e o rent de armazenamento.\ Não se esqueça de atualizar o arquivo Anchor.toml e a macro declare_id! em lib.rs com este novo Program ID antes do deploy.
4. Inicialize o OFT e o SPL Mint
Na Solana, a lógica de um token e seu ledger são separados. Você deve inicializar uma nova Conta Mint (o Token SPL) e atribuir ao seu programa OFT recém-implantado como a Mint Authority. Isso garante que apenas a bridge LayerZero possa mintar novos tokens na Solana.
O SDK LayerZero fornece tarefas Hardhat/TypeScript para lidar com essa inicialização diretamente da linha de comando. No seu projeto oft-solana, configure seu Endpoint LayerZero para Solana (30168) e execute o script de inicialização:
Uma vez que esta transação de inicialização seja confirmada na blockchain Solana, seu programa OFT nativo está totalmente configurado e pronto para ser conectado ao OFTAdapter da Chiliz!
Etapa 2: Configuração do LayerZero
Com o seu Adapter da Chiliz implantado e seu programa OFT da Solana inicializado, você deve agora configurar a conexão entre eles. É aqui que a diferença entre redes EVM e não-EVM se torna muito visível.
As mensagens cross-chain do LayerZero exigem que todos os endereços de peer sejam formatados como bytes32. Felizmente, o tooling Hardhat V2 do LayerZero lida automaticamente com a conversão de Base58 para Bytes32, desde que você defina os endpoints corretamente na sua configuração.
O Simple Config Generator é a forma recomendada de gerar a configuração de wiring, pois automatiza o wiring bidirecional e aplica configurações de segurança recomendadas.
Crie ou atualize seu arquivo layerzero.config.ts na raiz do seu projeto Hardhat:
A tarefa de wire do LayerZero lerá isso, decodificará a string Base58, preencherá para 32 bytes e a passará com segurança para a função setPeer do OFTAdapter da Chiliz.
Etapa 3: Fluxo de Deploy
Com seus contratos escritos e seu layerzero.config.ts preparado, é hora de implantar o OFTAdapter da Chiliz. Como você já compilou e implantou o programa OFT nativo da Solana usando Anchor na Etapa 1, esta etapa se concentra em implantar o lado EVM da bridge usando Hardhat.
Implantando o Contrato OFTAdapter da Chiliz
No seu projeto Hardhat, crie um script de deploy no diretório deploy/ chamado 01_deploy_chiliz_solana_adapter.ts. Este script passa o endereço do seu token existente e o endereço do Endpoint V2 da Chiliz (EID) para o construtor.
Implantando o OFTAdapter da Chiliz
Execute o seguinte comando no terminal para implantar o Adapter EVM:
Após o deploy, o Hardhat salvará o endereço do contrato Chiliz na pasta deployments/.
Neste ponto, você tem contratos ativos na Chiliz Chain (EVM) e na Solana (SVM), mas eles ainda não confiam um no outro. Hora de apresentá-los!
Etapa 4: Wiring e Peering
Para permitir que seu contrato OFTAdapter e programa OFT se comuniquem, você deve "conectá-los" como peers confiáveis.
Como estamos fazendo bridge entre duas Virtual Machines completamente diferentes (EVM e SVM), a configuração requer atenção especial.
Para garantir que o Executor tenha Compute Units e Lamports suficientes para mintar tokens e criar ATAs na Solana, você deve definir esses limites no arquivo layerzero.config.ts antes do wiring.
Execute o comando de wire automatizado no terminal:
Isso preparará as 6 transações de configuração necessárias:
setSendLibrary: Atribui a MessageLib para pacotes de saída.setReceiveLibrary: Atribui a MessageLib para pacotes de entrada.setConfig: Configura os DVNs e o Executor.setConfig: Configura os DVNs para verificação de entrada.setEnforcedOptions: Garante parâmetros de execução consistentes (crucial para garantir que o usuário pague antecipadamente o suficiente para cobrir os Compute Units e o rent de Lamport da Solana).setPeer: Vincula o EID da Solana ao seu Program ID Base58 de destino.
O toolbox LayerZero V2 automatiza o trabalho pesado: decodificará o endereço Solana em Base58, preencherá para o formato bytes32 EVM necessário e enviará as transações setPeer e setEnforcedOptions para ambas as cadeias.
Após a confirmação das transações de wiring, sua bridge EVM para Solana estará ativa e com permissões seguras.
Seu token está oficialmente pronto para cruzar a fronteira EVM/SVM!
Etapa 5: Operação e Testes
Com o seu Adapter da Chiliz implantado, o OFT nativo da Solana inicializado e os dois devidamente conectados, seu token está oficialmente pronto para cruzar a fronteira EVM/SVM. A etapa final é executar e monitorar uma transferência de teste da Chiliz Chain para a Solana.
1) Enviando a Mensagem Cross-Chain para a Solana
O toolbox LayerZero V2 inclui uma tarefa Hardhat para enviar transferências OFT diretamente da linha de comando.
Ao contrário das transferências EVM para EVM onde o destino é uma string hexadecimal padrão, seu destino aqui é um endereço de carteira Solana em Base58. A CLI LayerZero lida com a conversão de Base58 para Bytes32 no payload da mensagem automaticamente.
Execute o seguinte comando no terminal:
2) Rastreando o Pacote no LayerZero Scan
Como fazer bridge para a Solana envolve a tradução entre dois mecanismos de consenso completamente diferentes e aguardar a finalidade da SVM, um atraso assíncrono é normal.
Para rastrear essa jornada em tempo real, clique no link LayerZero Scan que aparece na saída da CLI.
Saiba mais sobre essa ferramenta aqui:
Tradução de Decimais
O OFT Nativo da Solana terá automaticamente escalado o payload de 6 decimais vindo da bridge para os 9 decimais SPL padrão, de modo que sua carteira Solana receba exatamente 10 tokens completos.
4) Solução de Problemas em Mensagens Travadas
Se sua transação estiver marcada como confirmada na Chiliz, mas falhar na execução da Solana, a causa mais comum é um erro de Lamports insuficientes ou Compute Units insuficientes.
Se a carteira Solana de destino ainda não tinha uma Associated Token Account (ATA) para o seu token específico, o Executor LayerZero teve que pagar a taxa de "isenção de rent" da Solana para criá-la.
Se o parâmetro
value(Lamports) nas suasenforcedOptionsestava muito baixo para cobrir esse rent, ou se ogas(Compute Units) era insuficiente, o Executor se recusará a pagar do próprio bolso e a mensagem ficará parada.Solução: Você não perde seus tokens. Você pode empurrar manualmente uma mensagem travada pela UI do LayerZero Scan. Conecte sua carteira Solana, clique no botão "Force Resume" ou "Execute" no block explorer e pague a taxa de destino local (Compute Units + ATA Rent em $SOL) você mesmo para finalizar a mintagem.
Atualizado
Isto foi útil?