تطوير البرامج بلغة Rust
يتم تطوير برامج سولانا بشكل أساسي باستخدام لغة البرمجة Rust. تركز هذه الصفحة على كتابة برامج سولانا بلغة Rust دون استخدام إطار عمل Anchor، وهو نهج يُشار إليه غالبًا باسم كتابة برامج "Rust الأصلية".
يوفر تطوير Rust الأصلي للمطورين تحكمًا مباشرًا في برامج سولانا الخاصة بهم. ومع ذلك، يتطلب هذا النهج المزيد من الإعداد اليدوي وكود التكرار مقارنة باستخدام إطار عمل Anchor. يُوصى بهذه الطريقة للمطورين الذين:
- يسعون للتحكم الدقيق في منطق البرنامج والتحسينات
- يرغبون في تعلم المفاهيم الأساسية قبل الانتقال إلى أطر العمل ذات المستوى الأعلى
بالنسبة للمبتدئين، نوصي بالبدء باستخدام إطار عمل Anchor. راجع قسم Anchor للحصول على مزيد من المعلومات.
المتطلبات الأساسية
للحصول على تعليمات التثبيت المفصلة، قم بزيارة صفحة التثبيت.
قبل أن تبدأ، تأكد من تثبيت ما يلي:
- Rust: لغة البرمجة لبناء برامج سولانا.
- Solana CLI: أداة سطر الأوامر لتطوير سولانا.
البدء
يغطي المثال أدناه الخطوات الأساسية لإنشاء برنامج سولانا الأول الخاص بك المكتوب بلغة Rust. سننشئ برنامجًا بسيطًا يطبع "Hello, world!" في سجل البرنامج.
إنشاء برنامج جديد
أولاً، قم بإنشاء مشروع Rust جديد باستخدام الأمر القياسي cargo new
مع الخيار
--lib
.
$cargo new hello_world --lib
انتقل إلى دليل المشروع. يجب أن ترى ملفات src/lib.rs
و Cargo.toml
الافتراضية
$cd hello_world
قم بتحديث حقل edition
في Cargo.toml
إلى 2021
. وإلا، قد تواجه خطأ عند
بناء البرنامج.
إضافة تبعية solana-program
بعد ذلك، أضف تبعية solana-program
. هذه هي الحد الأدنى من التبعيات المطلوبة
لبناء برنامج سولانا.
$cargo add solana-program@2.2.0
إضافة crate-type
بعد ذلك، أضف المقتطف التالي إلى Cargo.toml
.
[lib]crate-type = ["cdylib", "lib"]
إذا لم تقم بتضمين هذا التكوين، فلن يتم إنشاء دليل target/deploy
عند بناء
البرنامج.
يجب أن يبدو ملف Cargo.toml
الخاص بك كما يلي:
[package]name = "hello_world"version = "0.1.0"edition = "2021"[lib]crate-type = ["cdylib", "lib"][dependencies]solana-program = "2.2.0"
إضافة كود البرنامج
بعد ذلك، استبدل محتويات src/lib.rs
بالكود التالي. هذا هو الحد الأدنى من برنامج
سولانا الذي يطبع "Hello, world!" في سجل البرنامج عند استدعاء البرنامج.
يتم استخدام وحدة الماكرو msg!
في برامج سولانا لطباعة رسالة في سجل البرنامج.
use solana_program::{account_info::AccountInfo, entrypoint, entrypoint::ProgramResult, msg, pubkey::Pubkey,};entrypoint!(process_instruction);pub fn process_instruction(_program_id: &Pubkey,_accounts: &[AccountInfo],_instruction_data: &[u8],) -> ProgramResult {msg!("Hello, world!");Ok(())}
بناء البرنامج
بعد ذلك، قم ببناء البرنامج باستخدام أمر cargo build-sbf
.
$cargo build-sbf
ينشئ هذا الأمر دليل target/deploy
يحتوي على ملفين مهمين:
- ملف
.so
(مثلhello_world.so
): هذا هو برنامج سولانا المُجمّع الذي سيتم نشره على الشبكة كـ "عقد ذكي". - ملف keypair (مثل
hello_world-keypair.json
): يتم استخدام المفتاح العام لهذا الـ keypair كمعرف للبرنامج عند نشر البرنامج.
لعرض معرف البرنامج، قم بتشغيل الأمر التالي في الطرفية الخاصة بك. يقوم هذا الأمر بطباعة المفتاح العام للـ keypair في مسار الملف المحدد:
$solana address -k ./target/deploy/hello_world-keypair.json
مثال للمخرجات:
4Ujf5fXfLx2PAwRqcECCLtgDxHKPznoJpa43jUBxFfMz
إضافة تبعيات الاختبار
بعد ذلك، اختبر البرنامج باستخدام حزمة litesvm
. أضف التبعيات التالية إلى
Cargo.toml
.
$cargo add litesvm --dev$cargo add solana-sdk@2.2.0 --dev
اختبار البرنامج
أضف الاختبار التالي إلى src/lib.rs
، أسفل كود البرنامج. هذه وحدة اختبار تستدعي
برنامج مرحبا بالعالم.
use solana_program::{account_info::AccountInfo, entrypoint, entrypoint::ProgramResult, msg, pubkey::Pubkey,};entrypoint!(process_instruction);pub fn process_instruction(_program_id: &Pubkey,_accounts: &[AccountInfo],_instruction_data: &[u8],) -> ProgramResult {msg!("Hello, world!");Ok(())}#[cfg(test)]mod test {use litesvm::LiteSVM;use solana_sdk::{instruction::Instruction,message::Message,signature::{Keypair, Signer},transaction::Transaction,};#[test]fn test_hello_world() {// Create a new LiteSVM instancelet mut svm = LiteSVM::new();// Create a keypair for the transaction payerlet payer = Keypair::new();// Airdrop some lamports to the payersvm.airdrop(&payer.pubkey(), 1_000_000_000).unwrap();// Load our programlet program_keypair = Keypair::new();let program_id = program_keypair.pubkey();svm.add_program_from_file(program_id, "target/deploy/hello_world.so").unwrap();// Create instruction with no accounts and no datalet instruction = Instruction {program_id,accounts: vec![],data: vec![],};// Create transactionlet message = Message::new(&[instruction], Some(&payer.pubkey()));let transaction = Transaction::new(&[&payer], message, svm.latest_blockhash());// Send transaction and verify it succeedslet result = svm.send_transaction(transaction);assert!(result.is_ok(), "Transaction should succeed");let logs = result.unwrap().logs;println!("Logs: {logs:#?}");}}
قم بتشغيل الاختبار باستخدام أمر cargo test
. سيعرض سجل البرنامج "Hello,
world!".
$cargo test -- --no-capture
مثال للمخرجات:
running 1 testLogs: ["Program 9528phXNvdWp5kkR4rgpoeZvR8ZWT5THVywK95YRprkk invoke [1]","Program log: Hello, world!","Program 9528phXNvdWp5kkR4rgpoeZvR8ZWT5THVywK95YRprkk consumed 211 of 200000 compute units","Program 9528phXNvdWp5kkR4rgpoeZvR8ZWT5THVywK95YRprkk success",]test test::test_hello_world ... oktest result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.05s
نشر البرنامج
بعد ذلك، قم بنشر البرنامج. عند التطوير محليًا، يمكننا استخدام
solana-test-validator
.
أولاً، قم بتكوين واجهة سطر أوامر سولانا لاستخدام مجموعة سولانا المحلية.
$solana config set -ul
مثال للمخرجات:
Config File: /.config/solana/cli/config.ymlRPC URL: http://localhost:8899WebSocket URL: ws://localhost:8900/ (computed)Keypair Path: /.config/solana/id.jsonCommitment: confirmed
افتح نافذة طرفية جديدة وقم بتشغيل أمر solana-test-validators
لبدء المصادق
المحلي.
$solana-test-validator
أثناء تشغيل مصادق الاختبار، قم بتشغيل أمر solana program deploy
في نافذة طرفية
منفصلة لنشر البرنامج على المصادق المحلي.
$solana program deploy ./target/deploy/hello_world.so
مثال للمخرجات:
Program Id: 4Ujf5fXfLx2PAwRqcECCLtgDxHKPznoJpa43jUBxFfMzSignature:5osMiNMiDZGM7L1e2tPHxU8wdB8gwG8fDnXLg5G7SbhwFz4dHshYgAijk4wSQL5cXiu8z1MMou5kLadAQuHp7ybH
يمكنك فحص معرّف البرنامج وتوقيع المعاملة على مستكشف سولانا.
لاحظ أن المجموعة على مستكشف سولانا يجب أن تكون أيضًا localhost. خيار "عنوان
RPC المخصص" في مستكشف سولانا يكون افتراضيًا http://localhost:8899
.
إنشاء عميل مثال
بعد ذلك، سنوضح كيفية استدعاء البرنامج باستخدام عميل Rust.
أولاً قم بإنشاء دليل examples
وملف client.rs
.
$mkdir -p examples && touch examples/client.rs
أضف ما يلي إلى Cargo.toml
.
[[example]]name = "client"path = "examples/client.rs"
أضف تبعيات solana-client
و tokio
.
$cargo add solana-client@2.2.0 --dev$cargo add tokio --dev
إضافة العميل
أضف الكود التالي إلى examples/client.rs
. هذا نص برمجي لعميل Rust يقوم بتمويل
keypair جديد لدفع رسوم المعاملات ثم يستدعي برنامج مرحبا بالعالم.
use solana_client::rpc_client::RpcClient;use solana_sdk::{commitment_config::CommitmentConfig,instruction::Instruction,pubkey::Pubkey,signature::{Keypair, Signer},transaction::Transaction,};use std::str::FromStr;#[tokio::main]async fn main() {// Program ID (replace with your actual program ID)let program_id = Pubkey::from_str("4Ujf5fXfLx2PAwRqcECCLtgDxHKPznoJpa43jUBxFfMz").unwrap();// Connect to the Solana devnetlet rpc_url = String::from("http://localhost:8899");let client = RpcClient::new_with_commitment(rpc_url, CommitmentConfig::confirmed());// Generate a new keypair for the payerlet payer = Keypair::new();// Request airdroplet airdrop_amount = 1_000_000_000; // 1 SOLlet signature = client.request_airdrop(&payer.pubkey(), airdrop_amount).expect("Failed to request airdrop");// Wait for airdrop confirmationloop {let confirmed = client.confirm_transaction(&signature).unwrap();if confirmed {break;}}// Create the instructionlet instruction = Instruction::new_with_borsh(program_id,&(), // Empty instruction datavec![], // No accounts needed);// Add the instruction to new transactionlet mut transaction = Transaction::new_with_payer(&[instruction], Some(&payer.pubkey()));transaction.sign(&[&payer], client.get_latest_blockhash().unwrap());// Send and confirm the transactionmatch client.send_and_confirm_transaction(&transaction) {Ok(signature) => println!("Transaction Signature: {}", signature),Err(err) => eprintln!("Error sending transaction: {}", err),}}
استبدال معرّف البرنامج
قبل تشغيل كود العميل، استبدل معرّف البرنامج في مقتطف الكود بالمعرّف الخاص ببرنامجك.
يمكنك الحصول على معرّف برنامجك عن طريق تشغيل الأمر التالي.
$solana address -k ./target/deploy/hello_world-keypair.json
استدعاء البرنامج
قم بتشغيل نص العميل باستخدام الأمر التالي.
$cargo run --example client
مثال للمخرجات:
Transaction Signature: 54TWxKi3Jsi3UTeZbhLGUFX6JQH7TspRJjRRFZ8NFnwG5BXM9udxiX77bAACjKAS9fGnVeEazrXL4SfKrW7xZFYV
يمكنك فحص توقيع المعاملة على مستكشف سولانا (المجموعة المحلية) لرؤية "Hello, world!" في سجل البرنامج.
تحديث البرنامج
يمكن تحديث برامج سولانا عن طريق إعادة النشر إلى نفس معرف البرنامج. قم بتحديث
البرنامج في src/lib.rs
لطباعة "Hello, Solana!" بدلاً من "Hello, world!".
pub fn process_instruction(_program_id: &Pubkey,_accounts: &[AccountInfo],_instruction_data: &[u8],) -> ProgramResult {-msg!("Hello, world!");+msg!("Hello, Solana!");Ok(())}
قم بتشغيل الأمر cargo build-sbf
لإنشاء ملف .so
محدث.
$cargo build-sbf
اختبر البرنامج المحدث عن طريق تشغيل الأمر cargo test
.
$cargo test -- --no-capture
يجب أن ترى "Hello, Solana!" في سجل البرنامج.
running 1 testLogs: ["Program 5y8bHrnwfq2dLDgLn3WoTHb9dDuyorj9gyapW6aeyrpV invoke [1]","Program log: Hello, Solana!","Program 5y8bHrnwfq2dLDgLn3WoTHb9dDuyorj9gyapW6aeyrpV consumed 211 of 200000 compute units","Program 5y8bHrnwfq2dLDgLn3WoTHb9dDuyorj9gyapW6aeyrpV success",]test test::test_hello_world ... oktest result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.08s
إعادة نشر البرنامج
أعد نشر البرنامج باستخدام نفس الأمر solana program deploy
.
$solana program deploy ./target/deploy/hello_world.so
قم بتشغيل كود العميل مرة أخرى وافحص توقيع المعاملة على مستكشف سولانا لرؤية "Hello, Solana!" في سجل البرنامج.
$cargo run --example client
إغلاق البرنامج
يمكنك إغلاق برنامج سولانا الخاص بك لاسترداد عملات SOL المخصصة للحساب. إغلاق البرنامج هو إجراء لا رجعة فيه، لذا يجب القيام به بحذر.
لإغلاق البرنامج، استخدم الأمر solana program close <PROGRAM_ID>
. على سبيل
المثال:
$solana program close 4Ujf5fXfLx2PAwRqcECCLtgDxHKPznoJpa43jUBxFfMz --bypass-warning
مثال للمخرجات:
Closed Program Id 4Ujf5fXfLx2PAwRqcECCLtgDxHKPznoJpa43jUBxFfMz, 0.1350588 SOLreclaimed
لاحظ أنه بمجرد إغلاق البرنامج، لا يمكن إعادة استخدام معرّف البرنامج الخاص به. محاولة نشر برنامج بمعرّف برنامج تم إغلاقه مسبقًا ستؤدي إلى خطأ.
Error: Program 4Ujf5fXfLx2PAwRqcECCLtgDxHKPznoJpa43jUBxFfMz has been closed, usea new Program Id
إعادة نشر برنامج مغلق
إذا كنت بحاجة إلى إعادة نشر برنامج بنفس الشفرة المصدرية بعد إغلاق البرنامج، يجب عليك إنشاء معرّف برنامج جديد. لإنشاء keypair جديد للبرنامج، قم بتشغيل الأمر التالي:
$solana-keygen new -o ./target/deploy/hello_world-keypair.json --force
بدلاً من ذلك، يمكنك حذف ملف keypair الموجود (مثل
./target/deploy/hello_world-keypair.json
) وتشغيل cargo build-sbf
مرة أخرى،
والذي سيقوم بإنشاء ملف keypair جديد.
Is this page helpful?