Вызов Solana из EVM

Вызывайте программы Solana из Solidity через CPI и вспомогательные пре-компилы Rome.

Предкомпилированные контракты Rome позволяют контрактам Solidity напрямую вызывать программы Solana. В этом руководстве рассматриваются механизмы.

Требования

• Интерфейсы Rome Solidity из публичного rome-solidity репозитория (публикация в npm ожидается) — интерфейсы предкомпиляции находятся в contracts/interface.sol

• Развернутый контракт Rome (см. Развертывание Solidity)

Привяжите каждый интерфейс к его адресу предкомпиляции:

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);

Предкомпиляция CpiProgram

CpiProgram (0xFF…08) выполняет CPI (invoke / invoke_signed) а также сокращенные способы чтения состояния (account_info, account_data_at, account_u64_at, account_lamports, pdas_batch_derive):

// Вызов программы Solana
CpiProgram.invoke(programId, accounts, instructionData);

// Вызов с подписью PDA (ваш контракт подписывает как PDA)
CpiProgram.invoke_signed(programId, accounts, data, seeds);

Перевод lamports

Для простых переводов SOL/lamports и SPL из PDA вызывающей стороны используйте предкомпиляцию HelperProgram — вручную собирать CPI не требуется:

contract Transfers {
    IHelperProgram constant Helper = IHelperProgram(0xFF00000000000000000000000000000000000009);

    // Перевести lamports на PDA адреса EVM
    function transferSol(address to, uint64 lamports) external {
        Helper.transfer_lamports(to, lamports);
    }

    // Перевести SPL-токен из PDA вызывающей стороны
    function transferSpl(address to, uint64 tokens, bytes32 mint) external {
        Helper.transfer_spl(to, tokens, mint);
    }

    // Создать ATA вызывающей стороны для mint
    function createAta(bytes32 mint) external {
        Helper.create_ata(msg.sender, mint);
    }
}

transfer_spl имеет несколько перегрузок (включая вариант delegate для transferFrom потоков); см. interface.sol. В кэшированном варианте используйте ISplCached (0xff…05) / IAssociatedSplCached (0xff…06) вместо этого — контракт должен последовательно использовать один вариант.

Чтение данных аккаунта

Читайте данные любого аккаунта Solana с помощью сокращенных способов чтения CpiProgram:

(
    uint64 lamports,
    bytes32 owner,
    bool isSigner,
    bool isWritable,
    bool executable,
    bytes memory data
) = CpiProgram.account_info(accountPubkey);

Получение PDA

Находите Program Derived Address из Solidity через предкомпиляцию System:

ISystemProgram.Seed[] memory seeds = new ISystemProgram.Seed[](2);
seeds[0] = ISystemProgram.Seed("my-program-seed");
seeds[1] = ISystemProgram.Seed(abi.encodePacked(someValue));

(bytes32 pda, uint8 bump) = SystemProgram.find_program_address(targetProgramId, seeds);

Преобразование Base58

Преобразование между bytes32 и base58 (формат адресов Solana):

bytes memory base58Str = SystemProgram.bytes32_to_base58(pubkey);
bytes32 pubkey = SystemProgram.base58_to_bytes32(base58Bytes);

Вызов пользовательских программ Solana

Чтобы вызвать любую программу Solana, самостоятельно сформируйте список аккаунтов и данные инструкции:

contract CustomCPI {
    ICrossProgramInvocation constant CpiProgram = ICrossProgramInvocation(0xFF00000000000000000000000000000000000008);
    bytes32 constant MY_PROGRAM = 0x0000000000000000000000000000000000000000000000000000000000000000; // your Solana program ID

    function callMyProgram(bytes32 account1, bytes32 account2, bytes calldata ixData) external {
        ICrossProgramInvocation.AccountMeta[] memory accounts = new ICrossProgramInvocation.AccountMeta[](2);
        accounts[0] = ICrossProgramInvocation.AccountMeta(account1, false, true);
        accounts[1] = ICrossProgramInvocation.AccountMeta(account2, false, false);

        CpiProgram.invoke(MY_PROGRAM, accounts, ixData);
    }
}

Ключевые ограничения

1. Все аккаунты должны быть объявлены заранее. Транзакция Solana должна включать каждый аккаунт, к которому обратится CPI — динамическое обнаружение аккаунтов внутри CPI невозможно.

2. Ограничение глубины CPI: 4 уровня. Rome EVM → ваша цель → вызов цели → еще один уровень. Планируйте глубину вызовов.

3. Pubkey Solana — это bytes32, не 20-байтные адреса Ethereum.

4. Данные инструкции — это необработанные байты в формате, который ожидает целевая программа (обычно Borsh, little-endian).

Что дальше

• Посмотрите это в реальном приложении — rome-dex (двухканальный AMM), cardo (маршруты CPI в Meteora / Marinade / Mango / Jupiter), и aerarium вызывать Solana из Solidity в рабочей среде.

• Вызов EVM из Solana — обратный сценарий: управлять контрактами EVM из кошелька Solana

• Совместимость токенов — как взаимодействуют токены ERC-20 и SPL

• Ограничения — глубина CPI и другие ограничения