Rome SDK

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

Два SDK

У Rome есть два SDK, предназначенные для разных задач:

Solidity SDK (@rome-protocol/solidity-sdk)

Для разработчиков на Solidity. Предоставляет интерфейсы precompile, обёртки ERC-20/SPL, вычисление PDA и утилиты CPI. Устанавливается через npm и импортируется в ваши контракты Solidity.

npm install @rome-protocol/solidity-sdk

import {SplToken, CpiProgram, SystemProgram} from "@rome-protocol/solidity-sdk/contracts/core/Precompiles.sol";
import {SPL_ERC20} from "@rome-protocol/solidity-sdk/contracts/token/ERC20SPL.sol";
import {RomeEVMAccount} from "@rome-protocol/solidity-sdk/contracts/core/RomeEVMAccount.sol";

Rust SDK (rome-sdk)

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

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

Интерфейсы precompile

Предварительно привязанные константы-одиночки для всех precompile Rome:

// Доступны глобально после импорта
ISplToken constant SplToken;                    // 0xff...05
IAssociatedSplToken constant AssociatedSplToken; // 0xff...06
ISystemProgram constant SystemProgram;           // 0xff...07
ICrossProgramInvocation constant CpiProgram;     // 0xff...08
IWithdraw constant Withdraw;                     // 0x42...16

Операции с SPL Token

// Чтение состояния аккаунта токена
ISplToken.Account memory acc = SplToken.account_state(tokenAccountPubkey);
uint64 balance = acc.amount;
bytes32 owner = acc.owner;

// Перевод токенов
SplToken.transfer(recipientAta, mintPubkey, amount);

// Инициализация нового аккаунта токена
SplToken.initialize_account3(newAccount, mintPubkey, ownerPubkey);

Вычисление 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 Token

// Развернуть обёртку для любого SPL mint
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);

Реестр токенов

TokenRegistry registry = TokenRegistry(REGISTRY_ADDRESS);

// Регистрация с кроссчейн-метаданными
registry.registerToken(splMint, TokenOrigin.WormholeWrapped, externalAddr, chainId);

// Поиск по внешнему токену
TokenEntry memory entry = registry.getTokenByExternal(2, ethUsdcAddress);

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

import {Convert} from "@rome-protocol/solidity-sdk/contracts/core/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/solidity-sdk/contracts/programs/metadata/MplTokenMetadataLib.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 — это рабочее пространство из 9 crate:

Crate	Назначение
rome-sdk	Основной API: Rome struct, config, типы транзакций (RheaTx, RemusTx, RomulusTx)
rome-evm-client	Клиент EVM rollup, TxBuilder, ResourceFactory, интеграция с эмулятором
rome-solana	Solana tower, RPC-клиент, батчинг и отслеживание транзакций
rome-geth	Интеграция с OP-Geth Engine API для построения блоков
rome-utils	Утилиты RLP, hex, JSON-RPC, аутентификации
rome-obs	Наблюдаемость OpenTelemetry (трейсы, метрики, логи)
rome-da	Слой доступности данных Celestia
rome-meteora	Адаптеры пулов Meteora DEX AMM для ценообразования газа
rome-meta-hook	Клиент маршрутизатора Token-2022 Transfer Hook

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

// Одна транзакция 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) и индексы аккаунтов holder для параллельной отправки транзакций:

let resource = resource_factory.get().await?;
let payer = resource.payer();       // Ключевая пара Solana
let holder = resource.holder();     // Индекс аккаунта holder
// Ресурс автоматически возвращается в пул при Drop

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

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

• Обёртки SPL Token и интерфейсы precompile

• Свопы Meteora DAMM v1 через CPI

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

• Хелперы System Program, десериализация Borsh

• ERC20SPL Factory + мостовые контракты

• Реестр токенов с кроссчейн-метаданными

В процессе

• JupiterRouter (интерфейс Solidity для свопов Jupiter)

• Клиент SDK маршрутизатора Meta-Hook

Планируется (этап 2)

Интерфейс	Протокол
IJupiter	Агрегатор DEX Jupiter
IDrift	Бессрочные контракты Drift
IKamino	Кредитование Kamino
IMeteora	Ликвидность Meteora
IOndoGM	RWA Ondo

Планируется (этап 3)

Интерфейс	Программа
IStakeProgram	Стейкинг Solana
IVoteProgram	Голосование Solana
ISlotHashes	Sysvar SlotHashes

Что дальше

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

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

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