Rome SDK

Типизированные интерфейсы Solidity для вызова программ Solana из EVM-контрактов, а также Rust SDK, лежащий в основе внецепочечных сервисов Rome.

SDK Rome предоставляет типизированные интерфейсы Solidity для взаимодействия с программами Solana из смарт-контрактов EVM. Это набор инструментов разработчика для создания приложений с кросс-рантайм-архитектурой на Rome.

SDK

У Rome есть SDK для трех аудиторий — разработчиков приложений (TypeScript), разработчиков контрактов (Solidity) и инфраструктурных операторов (Rust).

SDK на TypeScript (@rome-protocol/sdk)

Для разработчиков dapp и frontend — SDK, с которого чаще всего начинают разработчики приложений. @rome-protocol/sdk оборачивает путь записи Rome, чтобы веб-приложение корректно отправляло транзакции Rome: submitRomeTx (корректный путь записи плюс обработка газа/комиссии), вывод PDA / ATA, CPI invoke / invoke_signed кодировщики, привязки precompile и /bridge подпуть. Установка из репозитория (публикация в npm ожидается):

npm install github:rome-protocol/rome-sdk-ts#v0.2.1

import { submitRomeTx } from '@rome-protocol/sdk';
// Отправка любой записи EVM Rome через корректный путь записи (обрабатывает кодирование газа/комиссии).

Публичные эталонные приложения — rome-dex и cardo — используют этот SDK.

Обе линии — один SDK. submitRomeTx — это линия EVM (MetaMask). Для линии Solana — кошелек Phantom/Solana, управляющий вашим приложением EVM — submitRomeTxSolanaLane повторяет это: пользователь подписывает транзакцию Solana, а Rome выполняет ее как транзакцию EVM от его производной идентичности, без ключа EVM. Средства перемещаются внутрь и наружу через buildFundLeg / buildSweepLeg как обертка ERC-20 (например, wUSDC), а не нативный msg.value — синтетический отправитель ничего не хранит в состоянии покоя — и первый синтетический автоматически создается при первом использовании. См. Создайте приложение с двумя линиями и Вызывайте EVM из Solana.

SDK на Solidity (@rome-protocol/rome-solidity)

Для разработчиков Solidity. Предоставляет интерфейсы precompile, обертки ERC-20/SPL, вывод PDA и утилиты CPI. Публикация в npm ожидается; сегодня вы используете это из публичного rome-solidity репозитория (зависимость git или скопированные файлы).

import {ISystemProgram, ICrossProgramInvocation, IHelperProgram, IWithdraw}
    from "@rome-protocol/rome-solidity/contracts/interface.sol";
import {SPL_ERC20} from "@rome-protocol/rome-solidity/contracts/erc20spl/erc20spl.sol";
import {RomeEVMAccount} from "@rome-protocol/rome-solidity/contracts/rome_evm_account.sol";

Rust SDK (rome-sdk)

Для инфраструктурных операторов. Рабочее пространство Rust, которое занимается композицией транзакций, взаимодействием с Solana, ценообразованием газа и индексированием блоков. Используется Proxy и Hercules.

Solidity SDK: что входит

Интерфейсы precompile

Привяжите интерфейс к его precompile-адресу:

ISystemProgram          constant System   = ISystemProgram(0xFF00000000000000000000000000000000000007);
ICrossProgramInvocation constant Cpi      = ICrossProgramInvocation(0xFF00000000000000000000000000000000000008);
IHelperProgram          constant Helper   = IHelperProgram(0xFF00000000000000000000000000000000000009);
IWithdraw               constant Withdraw = IWithdraw(0x4200000000000000000000000000000000000016);
// Кэшированный трек: ISplCached 0xff…05, IAssociatedSplCached 0xff…06, ISystemCached 0xff…04, IWithdrawCached 0xff…0b

Операции с токенами SPL

Используйте IHelperProgram (0xff…09) для примитивов SPL, подписанных user-PDA:

// Создать ATA вызывающего для mint
Helper.create_ata(user, mint);

// Перевести SPL из PDA вызывающего
Helper.transfer_spl(to, tokens, mint);

На кэшированном треке эквивалентные операции находятся в ISplCached (0xff…05) и IAssociatedSplCached (0xff…06). См. interface.sol для всех перегрузок; контракт последовательно использует один трек.

Вывод PDA

// Вывести Solana PDA пользователя
bytes32 userPda = RomeEVMAccount.pda(msg.sender);

// Вывод PDA с солью (для создания нескольких PDA на пользователя)
bytes32 pda = RomeEVMAccount.pda_with_salt(msg.sender, salt);

// Найти произвольный PDA
(bytes32 pda, uint8 bump) = SystemProgram.find_program_address(programId, seeds);

Вызов между программами

// Вызвать любую программу Solana
ICrossProgramInvocation.AccountMeta[] memory accounts = new ICrossProgramInvocation.AccountMeta[](2);
accounts[0] = ICrossProgramInvocation.AccountMeta(signerPda, true, true);
accounts[1] = ICrossProgramInvocation.AccountMeta(targetAccount, false, true);

CpiProgram.invoke(programId, accounts, instructionData);

// Вызов с подписанием PDA
CpiProgram.invoke_signed(programId, accounts, data, seeds);

// Прочитать данные аккаунта
(uint64 lamports, bytes32 owner, bool isSigner, bool isWritable, bool executable, bytes memory data)
    = CpiProgram.account_info(pubkey);

ERC-20 поверх токенов SPL

// Развернуть обертку для любого mint SPL
ERC20SPLFactory factory = ERC20SPLFactory(FACTORY_ADDRESS);
address wrapper = factory.add_spl_token_with_metadata(splMint);

// Использовать обертку как стандартный ERC-20
SPL_ERC20 token = SPL_ERC20(wrapper);
token.transfer(recipient, amount);
uint256 balance = token.balanceOf(user);

Десериализация Borsh

import {Convert} from "@rome-protocol/rome-solidity/contracts/convert.sol";

// Разобрать данные аккаунта Solana (формат Borsh little-endian)
(uint64 value, uint256 newOffset) = Convert.read_u64le(data, offset);
(bytes32 pubkey, uint256 newOffset2) = Convert.read_bytes32(data, offset);

Метаданные Metaplex

import {MplTokenMetadataLib} from "@rome-protocol/rome-solidity/contracts/mpl_token_metadata/lib.sol";

// Загрузить метаданные токена из Metaplex
MplTokenMetadataLib.Metadata memory meta = MplTokenMetadataLib.load_metadata(
    mintPubkey, mplProgramId, cpiAddress
);
string memory name = meta.name;
string memory symbol = meta.symbol;

Rust SDK: архитектура

Rust SDK — это рабочее пространство Cargo. Его основные crates:

Crate	Назначение
rome-sdk	Основной API: Rome структура, конфигурация, типы транзакций (RheaTx, RemusTx, RomulusTx)
rome-evm-client	клиент rollup EVM, TxBuilder, ResourceFactory, интеграция с эмулятором
rome-solana	Solana tower, RPC-клиент, пакетирование и отслеживание транзакций
rome-utils	утилиты RLP, hex, JSON-RPC, аутентификации
rome-obs	наблюдаемость OpenTelemetry (трейсы, метрики, логи)
rome-meteora	адаптеры пулов AMM Meteora DEX для ценообразования газа
rome-jito-bundler	сборщик bundle Jito для атомарной отправки нескольких транзакций

Типы транзакций

// Одиночная транзакция rollup
let rhea = RheaTx::new(signed_eth_tx);
let mut tx = rome.compose_rollup_tx(rhea).await?;
let sig = rome.send_and_confirm(&mut *tx).await?;

// Атомарная кросс-rollup транзакция
let remus = RemusTx::new(vec![tx1, tx2]);
let mut tx = rome.compose_cross_rollup_tx(remus).await?;

// Атомарная кроссчейн-транзакция (EVM + Solana)
let romulus = RomulusTx::new(eth_txs, sol_ixs);
let mut tx = rome.compose_cross_chain_tx(romulus, signers).await?;

Пулинг ресурсов

SDK объединяет пары ключей Solana (payer) и индексы аккаунтов-хранителей для параллельной отправки транзакций:

let resource = resource_factory.get().await?;
let payer = resource.payer();       // Solana keypair
let holder = resource.holder();     // Holder account index
// Ресурс автоматически возвращается в пул при Drop

Дорожная карта SDK

Реализовано и работает

• Обертки токенов SPL и интерфейсы precompile

• Обмены Meteora DAMM v1 через CPI

• Oracle Gateway V1 + V2 (Pyth Pull, Switchboard V3)

• Вспомогательные функции System Program, десериализация Borsh

• Фабрика ERC20SPL и bridge-контракты

Что дальше

• Развернуть Solidity — разверните свой первый контракт с помощью SDK

• Вызывать Solana из EVM — используйте CPI для взаимодействия с программами Solana

• Адреса контрактов — адреса развернутых контрактов SDK