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 حزم تتعامل مع تركيب المعاملات، والتفاعل مع Solana، وتسعير الغاز، وفهرسة الكتل، وتنسيق الخدمات. تُستخدم بواسطة Proxy وHercules وRhea.

حزمة Solidity SDK: ما الذي تتضمنه

واجهات Precompile

ثوابت singleton مُهيأة مسبقًا لجميع عمليات 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

// اشتقاق PDA خاص بمستخدم على Solana
bytes32 userPda = RomeEVMAccount.pda(msg.sender);

// اشتقاق PDA مع salt (لإنشاء عدة PDAs لكل مستخدم)
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);

سجل الرموز

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 حزم:

الحزمة	الغرض
rome-sdk	واجهة API الأساسية: Rome بنية، إعدادات، وأنواع المعاملات (RheaTx, RemusTx, RomulusTx)
rome-evm-client	عميل تجميع EVM، TxBuilder، ResourceFactory، وتكامل المحاكي
rome-solana	برج Solana، عميل RPC، وتجزئة المعاملات وتتبعها
rome-geth	تكامل OP-Geth Engine API لبناء الكتل
rome-utils	أدوات RLP، hex، JSON-RPC، والمصادقة
rome-obs	إمكانية الرصد عبر OpenTelemetry (تتبعات، مقاييس، سجلات)
rome-da	طبقة توافر البيانات Celestia
rome-meteora	مهايئات مجمع AMM الخاص بـ Meteora DEX لتسعير الغاز
rome-meta-hook	عميل الموجّه الخاص بـ Token-2022 Transfer Hook

أنواع المعاملات

// معاملة تجميع واحدة
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?;

// معاملة ذرية عبر التجميعات
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?;

تجميع الموارد

تقوم الحزمة بتجميع أزواج مفاتيح Solana (الدافعين) وفهارس حسابات الحاملين لإرسال المعاملات بالتوازي:

let resource = resource_factory.get().await?;
let payer = resource.payer();       // زوج مفاتيح Solana
let holder = resource.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	مجمّع Jupiter DEX
IDrift	العقود الدائمة Drift
IKamino	إقراض Kamino
IMeteora	سيولة Meteora
IOndoGM	أصول العالم الحقيقي Ondo

مخطط له (المرحلة 3)

الواجهة	البرنامج
IStakeProgram	Solana Stake
IVoteProgram	Solana Vote
ISlotHashes	SlotHashes Sysvar

ما التالي

• نشر Solidity — انشر عقدك الأول باستخدام الحزمة

• استدعِ Solana من EVM — استخدم CPI للتفاعل مع برامج Solana

• عناوين العقود — عناوين عقود SDK المنشورة