Взаимодействие токенов

Rome EVM связывает ERC-20 токены и SPL токены через модель единого состояния. На этой странице объясняется, как токены работают одновременно в EVM и Solana.

Модель единого состояния

В отличие от традиционных мостов, Rome не блокирует токены в одной сети и не выпускает их обёрнутые копии в другой. Вместо этого ERC-20 токены в Rome EVM являются прозрачными обёртками над базовыми SPL token accounts в Solana.

┌──────────────────────────────────┐
│ Rome EVM                         │
│                                  │
│   ERC-20 "rUSDC"                 │
│   ┌────────────────────────┐     │
│   │ balanceOf(user)        │─────┼──► читает напрямую из SPL ATA
│   │ transfer(to, amount)   │─────┼──► выполняет SPL transfer через precompile
│   │ totalSupply()          │─────┼──► читает объём выпуска SPL mint
│   └────────────────────────┘     │
│                                  │
└──────────────────────────────────┘
                 │
                 │ одни и те же базовые данные
                 ↓
┌──────────────────────────────────┐
│ Solana                           │
│                                  │
│   SPL Token Account (ATA)        │
│   Владелец: PDA пользователя     │
│   Mint: USDC (нативный Circle)   │
│   Количество: 1000000 (= 1 USDC) │
│                                  │
└──────────────────────────────────┘

Что это означает:

• Нет задержки моста — баланс ERC-20 ЯВЛЯЕТСЯ балансом SPL

• Нет фрагментации ликвидности — DeFi с обеих сторон видит одни и те же токены

• Нет риска моста — нет отдельного эскроу, который можно эксплуатировать

ERC20SPL: контракт-обёртка

SPL_ERC20 — это стандартный контракт-обёртка, предоставляющий полный интерфейс ERC-20 поверх SPL token mint:

import {SPL_ERC20} from "@rome-protocol/solidity-sdk/contracts/token/ERC20SPL.sol";

// Обёртка читает балансы из SPL ATA пользователя
uint256 balance = wrapper.balanceOf(userAddress);

// Переводы выполняются через precompile SPL Token
wrapper.transfer(recipient, amount);

Как это работает на низком уровне:

• balanceOf() → выводит ATA пользователя (Associated Token Account) → считывает баланс из Solana

• transfer() → вызывает precompile SPL Token (0xff...05) → перемещает токены в Solana

• approve() / allowance() → использует хранилище EVM (стандартный шаблон ERC-20), поскольку SPL нативно не поддерживает allowance в стиле EVM

• totalSupply() → читает данные из аккаунта SPL mint

ERC20SPLFactory

Фабричный контракт развёртывает обёртки для любого SPL токена:

import {ERC20SPLFactory} from "@rome-protocol/solidity-sdk/contracts/token/ERC20SPLFactory.sol";

ERC20SPLFactory factory = ERC20SPLFactory(0xfd21da046c282e1d36cc45e46d9599cff5742f2b);

// Развернуть обёртку для SPL mint (загружает имя/символ из метаданных Metaplex)
address wrapper = factory.add_spl_token_with_metadata(splMintPubkey);

// Или указать имя/символ вручную
address wrapper = factory.add_spl_token_no_metadata(splMintPubkey, "USD Coin", "USDC");

Адрес фабрики (devnet): 0xfd21da046c282e1d36cc45e46d9599cff5742f2b

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

Реестр токенов обеспечивает управляемую администратором регистрацию одобренных SPL токенов с кроссчейн-метаданными:

import {TokenRegistry, TokenOrigin} from "@rome-protocol/solidity-sdk/contracts/token/TokenRegistry.sol";

// Зарегистрировать нативный SPL токен
registry.registerToken(
    splMint,
    TokenOrigin.NativeSPL,
    bytes32(0),   // нет внешнего адреса
    0             // нет внешней сети
);

// Зарегистрировать токен, обёрнутый через Wormhole, с кроссчейн-метаданными
registry.registerToken(
    wormholeMint,
    TokenOrigin.WormholeWrapped,
    externalTokenAddress,  // исходный токен в исходной сети
    2                       // ID сети Wormhole для Ethereum
);

Реестр гарантирует, что каждый актив сопоставляется с одним каноническим SPL mint, предотвращая фрагментацию ликвидности из-за нескольких представлений USDC.

Поток депозита / вывода

Депозит SPL → EVM

1. Пользователь переводит SPL токены в vault моста

2. Мост создаёт ATA пользователя в Rome EVM (если он не существует)

3. Обёртка ERC-20 становится активной — пользователь видит баланс в MetaMask

Вывод EVM → SPL

1. Пользователь вызывает precompile Withdraw (0x42...16) в Rome EVM

2. Precompile выполняет SPL transfer из PDA пользователя обратно в его Solana-кошелёк

3. SPL токены появляются в Solana-кошельке пользователя

Вычисление PDA

Каждому EVM-адресу соответствует Solana PDA, владеющий его токен-аккаунтами:

import {RomeEVMAccount} from "@rome-protocol/solidity-sdk/contracts/core/RomeEVMAccount.sol";

// Получить Solana PDA для EVM-адреса
bytes32 userPda = RomeEVMAccount.pda(msg.sender);

// Получить ATA пользователя для конкретного mint
bytes32 ata = AssociatedSplToken.create_associated_token_account(userPda, mintPubkey);

Ключевые шаблоны

Чтение SPL-балансов из Solidity

// Прочитать исходное состояние SPL token account
ISplToken.Account memory account = SplToken.account_state(tokenAccountPubkey);
uint64 balance = account.amount;
uint8 decimals = SplToken.decimals_eq(mintPubkey, 9); // проверить decimals

Перевод токенов через SPL precompile

// Прямой SPL transfer (более низкий уровень, чем обёртка ERC-20)
SplToken.transfer(recipientAta, mintPubkey, amount);

Газовый токен

У каждой сети Rome EVM есть собственный газовый токен — любой SPL токен, выбранный при регистрации сети:

• RSOL — газовый токен по умолчанию (обёрнутый SOL)

• Пользовательские токены — любой SPL токен, цена которого определяется через пул Meteora DAMM V1

Газовые токены — это ERC-20 представления SPL токенов. Transfer Hooks НЕ срабатывают при внутренних платежах газа в EVM.

Ограничения

• Суммы SPL токенов имеют тип uint64 — максимальное значение 18,446,744,073,709,551,615

• Количество decimals по умолчанию для новых SPL mint: 9

• Символы обёрток ERC-20 должны быть глобально уникальны в пределах одной фабрики

• Allowance используют хранилище EVM (а не делегатов Solana)

Что дальше

• Transfer Hooks — логика EVM в Token-2022 transfer hooks

• Руководство по обёртыванию токенов — разверните собственную обёртку ERC-20

• Адреса контрактов — адреса развёрнутых фабрик