Chamar Solana a partir da EVM
Chame programas da Solana a partir de Solidity via a CPI da Rome e precompilações auxiliares.
Os precompiles da Rome permitem que contratos Solidity chamem programas Solana diretamente. Este guia cobre a mecânica.
Pré-requisitos
As interfaces Solidity da Rome do repositório público
rome-solidityrepo (instalado do GitHub, não do npm — veja Implante Solidity) — as interfaces de precompile ficam emcontracts/interface.solUm contrato da Rome implantado (veja Implante Solidity)
Vincule cada interface ao seu endereço de precompile:
import {ICrossProgramInvocation, ISystemProgram, IHelperProgram}
from "@rome-protocol/rome-solidity/contracts/interface.sol";
ICrossProgramInvocation constant CpiProgram = ICrossProgramInvocation(0xFF00000000000000000000000000000000000008);
ISystemProgram constant SystemProgram = ISystemProgram(0xFF00000000000000000000000000000000000007);
IHelperProgram constant Helper = IHelperProgram(0xFF00000000000000000000000000000000000009);O precompile CpiProgram
CpiProgram (0xFF…08) despacha CPI (invoke / invoke_signed) mais atalhos de leitura entre estados (account_info, account_data_at, account_u64_at, account_lamports, pdas_batch_derive):
// Chame um programa Solana
CpiProgram.invoke(programId, accounts, instructionData);
// Chamada com assinatura PDA: o PDA de autoridade externa do seu contrato assina, mais um
// sub-PDA com sal para cada entrada em `salts` (a Rome deriva ["EXTERNAL_AUTHORITY", contract, salt])
CpiProgram.invoke_signed(programId, accounts, data, salts);Transferir lamports
Para transferências simples de lamports e SPL, use o precompile HelperProgram — não é necessário montar CPI manualmente. Um contrato que o chama age como ele mesmo: as transferências abaixo movem os próprios lamports e tokens do contrato (o PDA de autoridade externa dele assina), não os do usuário. Para um contrato retirar os tokens SPL de um usuário para uma conta de token que ele controla e saber de quem eles são, o usuário concede uma delegação SPL. Um ERC-20 transfer ou transferFrom para um contrato apenas credita o ledger de escrow do wrapper e não dá ao contrato nenhuma conta de token da qual gastar — veja Integrar um programa Solana.
transfer_spl tem várias sobrecargas (incluindo uma variante de delegado para transferFrom fluxos); veja interface.sol. No caminho em cache, use ISplCached (0xff…05) / IAssociatedSplCached (0xff…06) em vez disso — um contrato usa um único caminho de forma consistente, e apenas o caminho legado pode invoke um programa personalizado (veja Integrar um programa Solana).
Lendo dados da conta
Leia os dados de qualquer conta Solana usando os atalhos de leitura do precompile CpiProgram:
Derivação de PDA
Encontre Endereços Derivados de Programa a partir do Solidity via o precompile System:
Conversão para Base58
Converta entre bytes32 e base58 (o formato de endereço da Solana):
Chamando programas personalizados da Solana
Para chamar qualquer programa Solana, você mesmo monta a lista de contas e os dados da instrução:
Restrições principais
Todas as contas devem ser declaradas antecipadamente. A transação Solana deve incluir todas as contas que a CPI tocará — a descoberta dinâmica de contas dentro da CPI não é possível.
Limite de profundidade de CPI: 4 níveis. Rome EVM → seu alvo → a chamada do alvo → mais uma. Planeje a profundidade da sua chamada.
Os pubkeys da Solana são
bytes32, não endereços Ethereum de 20 bytes.Os dados da instrução são bytes brutos no formato que o programa alvo espera (normalmente Borsh, little-endian).
O que vem a seguir
Integrar um programa Solana — a identidade Solana do usuário, assinando como ela, a regra de um único caminho e o provisionamento de contas para um programa real do outro lado
Referência de precompile — cada seletor em cada precompile
Chamar EVM a partir da Solana — o inverso: conduza contratos EVM a partir de uma carteira Solana
Interoperação de Tokens — como os tokens ERC-20 e SPL funcionam juntos
Restrições — profundidade de CPI e outras limitações
Atualizado
Isto foi útil?