الحسابات

يتم تخزين جميع البيانات على شبكة سولانا في حسابات. يمكنك التفكير في شبكة سولانا كقاعدة بيانات عامة تحتوي على جدول حسابات واحد. العلاقة بين الحساب وعنوانه تشبه زوج المفتاح والقيمة، حيث يكون المفتاح هو العنوان والقيمة هي الحساب.

يمتلك كل حساب نفس البنية الأساسية ويمكن تحديد موقعه باستخدام عنوانه.

رسم توضيحي لـ 3 حسابات وعناوينها. يتضمن تعريف بنية الحساب.رسم توضيحي لـ 3 حسابات وعناوينها. يتضمن تعريف بنية الحساب.

عنوان الحساب

عنوان الحساب هو معرّف فريد مكون من 32 بايت يُستخدم لتحديد موقع الحساب على بلوكتشين سولانا. غالبًا ما يتم عرض عناوين الحسابات كسلاسل مشفرة بنظام base58. تستخدم معظم الحسابات مفتاح عام من نوع Ed25519 كعنوان لها، ولكن هذا ليس مطلوبًا، حيث تدعم سولانا أيضًا العناوين المشتقة من البرامج.

حساب مع عنوان المفتاح العام المشفر بنظام base58حساب مع عنوان المفتاح العام المشفر بنظام base58

المفتاح العام

يوضح المثال أدناه كيفية استخدام مجموعة تطوير برمجيات سولانا لإنشاء keypair. يتضمن Keypair ما يلي:

  • مفتاح عام يعمل كعنوان الحساب
  • مفتاح خاص يُستخدم لتوقيع المعاملات
import { generateKeyPairSigner } from "@solana/kit";
// Kit does not enable extractable private keys
const keypairSigner = await generateKeyPairSigner();
console.log(keypairSigner);
Console
Click to execute the code.

Program Derived Address

Program Derived Address (PDA) هو عنوان يتم اشتقاقه بشكل حتمي باستخدام معرّف البرنامج ومدخلات اختيارية واحدة أو أكثر (البذور). يوضح المثال أدناه كيفية استخدام مجموعة تطوير برمجيات سولانا لإنشاء Program Derived Address.

import { Address, getProgramDerivedAddress } from "@solana/kit";
const programAddress = "11111111111111111111111111111111" as Address;
const seeds = ["helloWorld"];
const [pda, bump] = await getProgramDerivedAddress({
programAddress,
seeds
});
console.log(`PDA: ${pda}`);
console.log(`Bump: ${bump}`);
Console
Click to execute the code.

بنية الحساب

كل Account له حجم أقصى يبلغ 10MiB ويحتوي على المعلومات التالية:

  • lamports: عدد وحدات lamport في الحساب
  • data: بيانات الحساب
  • owner: معرّف البرنامج الذي يملك الحساب
  • executable: يشير إلى ما إذا كان الحساب يحتوي على ملف ثنائي قابل للتنفيذ
  • rent_epoch: حقل rent epoch المهمل
Account
pub struct Account {
/// lamports in the account
pub lamports: u64,
/// data held in this account
#[cfg_attr(feature = "serde", serde(with = "serde_bytes"))]
pub data: Vec<u8>,
/// the program that owns this account. If executable, the program that loads this account.
pub owner: Pubkey,
/// this account's data contains a loaded program (and is now read-only)
pub executable: bool,
/// the epoch at which this account will next owe rent
pub rent_epoch: Epoch,
}

وحدات Lamports

رصيد الحساب بوحدات lamport.

يجب أن يكون لكل حساب حد أدنى من رصيد lamport، يسمى rent، مما يسمح بتخزين بياناته على السلسلة. يتناسب rent مع حجم الحساب.

على الرغم من أن هذا الرصيد يسمى rent، إلا أنه يعمل أكثر مثل وديعة، حيث يمكن استرداد الرصيد الكامل عند إغلاق الحساب. (يأتي اسم "rent" من حقل rent epoch الذي تم إلغاؤه الآن.)

(انظر الحد الأدنى للرصيد صيغة و الثوابت المطبقة.)

البيانات

يشار إلى هذا الحقل عادةً باسم "بيانات الحساب". تعتبر data في هذا الحقل اعتباطية حيث يمكن أن تحتوي على أي تسلسل من البايتات. كل برنامج يحدد بنية البيانات المخزنة في هذا الحقل.

  • program account: يحتوي هذا الحقل إما على رمز البرنامج القابل للتنفيذ أو عنوان حساب بيانات البرنامج الذي يخزن رمز البرنامج القابل للتنفيذ.
  • حسابات البيانات: يخزن هذا الحقل عمومًا بيانات الحالة، المقصود قراءتها.

تتضمن قراءة البيانات من حساب سولانا خطوتين:

  1. جلب الحساب باستخدام عنوانه
  2. فك تشفير حقل data الخاص بالحساب من البايتات الخام إلى بنية البيانات المناسبة، كما هو محدد من قبل البرنامج الذي يملك الحساب.

المالك

يحتوي هذا الحقل على معرف البرنامج لمالك الحساب.

كل حساب في سولانا لديه برنامج معين كمالك له. مالك الحساب هو البرنامج الوحيد الذي يمكنه تغيير data الخاصة بالحساب أو خصم لامبورتس، كما هو موضح في تعليمات البرنامج.

(في حالة program account، يكون المالك هو برنامج التحميل الخاص به.)

قابل للتنفيذ

يشير هذا الحقل إلى ما إذا كان الحساب هو program account أو حساب بيانات

  • إذا كان true: فالحساب هو program account
  • إذا كان false: فالحساب هو حساب بيانات

فترة الإيجار

حقل rent_epoch مهمل.

في الماضي، كان هذا الحقل يتتبع متى سيحتاج الحساب إلى دفع rent. ومع ذلك، تم إهمال آلية تحصيل الإيجار هذه منذ ذلك الحين.

وحدات Lamports

رصيد الحساب بوحدات lamport.

يجب أن يكون لكل حساب حد أدنى من رصيد lamport، يسمى rent، مما يسمح بتخزين بياناته على السلسلة. يتناسب rent مع حجم الحساب.

على الرغم من أن هذا الرصيد يسمى rent، إلا أنه يعمل أكثر مثل وديعة، حيث يمكن استرداد الرصيد الكامل عند إغلاق الحساب. (يأتي اسم "rent" من حقل rent epoch الذي تم إلغاؤه الآن.)

(انظر الحد الأدنى للرصيد صيغة و الثوابت المطبقة.)

البيانات

يشار إلى هذا الحقل عادةً باسم "بيانات الحساب". تعتبر data في هذا الحقل اعتباطية حيث يمكن أن تحتوي على أي تسلسل من البايتات. كل برنامج يحدد بنية البيانات المخزنة في هذا الحقل.

  • program account: يحتوي هذا الحقل إما على رمز البرنامج القابل للتنفيذ أو عنوان حساب بيانات البرنامج الذي يخزن رمز البرنامج القابل للتنفيذ.
  • حسابات البيانات: يخزن هذا الحقل عمومًا بيانات الحالة، المقصود قراءتها.

تتضمن قراءة البيانات من حساب سولانا خطوتين:

  1. جلب الحساب باستخدام عنوانه
  2. فك تشفير حقل data الخاص بالحساب من البايتات الخام إلى بنية البيانات المناسبة، كما هو محدد من قبل البرنامج الذي يملك الحساب.

المالك

يحتوي هذا الحقل على معرف البرنامج لمالك الحساب.

كل حساب في سولانا لديه برنامج معين كمالك له. مالك الحساب هو البرنامج الوحيد الذي يمكنه تغيير data الخاصة بالحساب أو خصم لامبورتس، كما هو موضح في تعليمات البرنامج.

(في حالة program account، يكون المالك هو برنامج التحميل الخاص به.)

قابل للتنفيذ

يشير هذا الحقل إلى ما إذا كان الحساب هو program account أو حساب بيانات

  • إذا كان true: فالحساب هو program account
  • إذا كان false: فالحساب هو حساب بيانات

فترة الإيجار

حقل rent_epoch مهمل.

في الماضي، كان هذا الحقل يتتبع متى سيحتاج الحساب إلى دفع rent. ومع ذلك، تم إهمال آلية تحصيل الإيجار هذه منذ ذلك الحين.

Account Examples
// Example Token Mint Account
Account {
lamports: 1461600,
data.len: 82,
owner: TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb,
executable: false,
rent_epoch: 0,
data: 010000001e213c90625a7e643d9555bb01b6c3fe6416d7afd523ce8c7ddd9b923ceafb9d00000000000000000901010000001e213c90625a7e643d9555bb01b6,
}
// Example Token Program Account
Account {
lamports: 4513200894,
data.len: 134080,
owner: BPFLoader2111111111111111111111111111111111,
executable: true,
rent_epoch: 18446744073709551615,
data: 7f454c460201010000000000000000000300f70001000000d8f90000000000004000000000000000800902000000000000000000400038000400400009000800,
}

أنواع الحسابات

هناك فئتان أساسيتان تندرج تحتهما الحسابات:

هذا الفصل بين رمز البرنامج وحالته هو ميزة أساسية في نموذج حسابات سولانا. (مشابه لأنظمة التشغيل، التي عادة ما تحتوي على ملفات منفصلة للبرامج وبياناتها.)

حسابات البرامج

كل برنامج مملوك من قبل برنامج محمّل، الذي يُستخدم لنشر وإدارة الحساب. عندما يتم نشر برنامج جديد، يتم إنشاء حساب لتخزين رمزه القابل للتنفيذ. هذا ما يسمى بحساب البرنامج. (للتبسيط، يمكنك اعتبار حساب البرنامج هو البرنامج نفسه.)

في الرسم البياني أدناه، يمكنك رؤية استخدام برنامج محمّل لنشر حساب برنامج. يحتوي حقل data الخاص بحساب البرنامج على رمز البرنامج القابل للتنفيذ.

رسم توضيحي لحساب برنامج، ومكوناته الأربعة وبرنامج المحمّل الخاص به.رسم توضيحي لحساب برنامج، ومكوناته الأربعة وبرنامج المحمّل الخاص به.

حسابات بيانات البرامج

البرامج المنشورة باستخدام loader-v3 لا تحتوي على رمز البرنامج في حقل data الخاص بها. بدلاً من ذلك، يشير حقل data إلى حساب بيانات برنامج منفصل، يحتوي على رمز البرنامج. (انظر الرسم البياني أدناه.)

حساب برنامج مع بيانات. البيانات تشير إلى حساب بيانات برنامج منفصلحساب برنامج مع بيانات. البيانات تشير إلى حساب بيانات برنامج منفصل

أثناء نشر البرنامج أو الترقيات، تُستخدم حسابات المخزن المؤقت لتجهيز التحميل مؤقتًا.

المثال أدناه يجلب حساب Token Program. لاحظ أن حقل executable مضبوط على true، مما يشير إلى أن الحساب هو برنامج.

import { Address, createSolanaRpc } from "@solana/kit";
const rpc = createSolanaRpc("https://api.mainnet-beta.solana.com");
const programId = "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" as Address;
const accountInfo = await rpc
.getAccountInfo(programId, { encoding: "base64" })
.send();
console.log(accountInfo);
Console
Click to execute the code.

حسابات البيانات

لا تحتوي حسابات البيانات على رمز قابل للتنفيذ. بدلاً من ذلك، تقوم بتخزين المعلومات.

حساب حالة البرنامج

تستخدم البرامج حسابات البيانات للحفاظ على حالتها. للقيام بذلك، يجب عليها أولاً إنشاء حساب بيانات جديد. غالبًا ما يتم تجريد عملية إنشاء حساب حالة البرنامج، ولكن من المفيد فهم العملية الأساسية.

لإدارة حالته، يجب على البرنامج الجديد:

  1. استدعاء System Program لإنشاء حساب. (ثم ينقل System Program الملكية إلى البرنامج الجديد.)
  2. تهيئة بيانات الحساب، كما هو محدد في التعليمات الخاصة به.

رسم تخطيطي لحساب بيانات مملوك من قبل حساب برنامجرسم تخطيطي لحساب بيانات مملوك من قبل حساب برنامج

المثال أدناه ينشئ ويجلب حساب Token Mint مملوك من قبل برنامج Token 2022.

import {
airdropFactory,
appendTransactionMessageInstructions,
createSolanaRpc,
createSolanaRpcSubscriptions,
createTransactionMessage,
generateKeyPairSigner,
getSignatureFromTransaction,
lamports,
pipe,
sendAndConfirmTransactionFactory,
setTransactionMessageFeePayerSigner,
setTransactionMessageLifetimeUsingBlockhash,
signTransactionMessageWithSigners
} from "@solana/kit";
import { getCreateAccountInstruction } from "@solana-program/system";
import {
getInitializeMintInstruction,
getMintSize,
TOKEN_2022_PROGRAM_ADDRESS,
fetchMint
} from "@solana-program/token-2022";
// Create Connection, local validator in this example
const rpc = createSolanaRpc("http://localhost:8899");
const rpcSubscriptions = createSolanaRpcSubscriptions("ws://localhost:8900");
// Generate keypairs for fee payer
const feePayer = await generateKeyPairSigner();
// Fund fee payer
await airdropFactory({ rpc, rpcSubscriptions })({
recipientAddress: feePayer.address,
lamports: lamports(1_000_000_000n),
commitment: "confirmed"
});
// Generate keypair to use as address of mint
const mint = await generateKeyPairSigner();
// Get default mint account size (in bytes), no extensions enabled
const space = BigInt(getMintSize());
// Get minimum balance for rent exemption
const rent = await rpc.getMinimumBalanceForRentExemption(space).send();
// Instruction to create new account for mint (token 2022 program)
// Invokes the system program
const createAccountInstruction = getCreateAccountInstruction({
payer: feePayer,
newAccount: mint,
lamports: rent,
space,
programAddress: TOKEN_2022_PROGRAM_ADDRESS
});
// Instruction to initialize mint account data
// Invokes the token 2022 program
const initializeMintInstruction = getInitializeMintInstruction({
mint: mint.address,
decimals: 9,
mintAuthority: feePayer.address
});
const instructions = [createAccountInstruction, initializeMintInstruction];
// Get latest blockhash to include in transaction
const { value: latestBlockhash } = await rpc.getLatestBlockhash().send();
// Create transaction message
const transactionMessage = pipe(
createTransactionMessage({ version: 0 }), // Create transaction message
(tx) => setTransactionMessageFeePayerSigner(feePayer, tx), // Set fee payer
(tx) => setTransactionMessageLifetimeUsingBlockhash(latestBlockhash, tx), // Set transaction blockhash
(tx) => appendTransactionMessageInstructions(instructions, tx) // Append instructions
);
// Sign transaction message with required signers (fee payer and mint keypair)
const signedTransaction =
await signTransactionMessageWithSigners(transactionMessage);
// Send and confirm transaction
await sendAndConfirmTransactionFactory({ rpc, rpcSubscriptions })(
signedTransaction,
{ commitment: "confirmed" }
);
// Get transaction signature
const transactionSignature = getSignatureFromTransaction(signedTransaction);
console.log("Mint Address:", mint.address);
console.log("Transaction Signature:", transactionSignature);
const accountInfo = await rpc.getAccountInfo(mint.address).send();
console.log(accountInfo);
const mintAccount = await fetchMint(rpc, mint.address);
console.log(mintAccount);
Console
Click to execute the code.

حسابات النظام

ليست كل الحسابات يتم تعيين مالك جديد لها بعد إنشائها بواسطة System Program. تسمى الحسابات المملوكة من قبل System Program بحسابات النظام. جميع حسابات المحفظة هي حسابات نظام، مما يسمح لها بدفع رسوم المعاملات.

محفظة مملوكة من قبل System Program تحتوي على 1,000,000 لامبورتمحفظة مملوكة من قبل System Program تحتوي على 1,000,000 لامبورت

عندما يتم إرسال SOL إلى عنوان جديد لأول مرة، يتم إنشاء حساب في ذلك العنوان مملوك من قبل System Program.

في المثال أدناه، يتم إنشاء زوج مفاتيح جديد وتمويله بـ SOL. بعد تشغيل الكود، يمكنك رؤية أن عنوان مالك الحساب owner هو 11111111111111111111111111111111 (وهو System Program).

import {
airdropFactory,
createSolanaRpc,
createSolanaRpcSubscriptions,
generateKeyPairSigner,
lamports
} from "@solana/kit";
// Create a connection to Solana cluster
const rpc = createSolanaRpc("http://localhost:8899");
const rpcSubscriptions = createSolanaRpcSubscriptions("ws://localhost:8900");
// Generate a new keypair
const keypair = await generateKeyPairSigner();
console.log(`Public Key: ${keypair.address}`);
// Funding an address with SOL automatically creates an account
const signature = await airdropFactory({ rpc, rpcSubscriptions })({
recipientAddress: keypair.address,
lamports: lamports(1_000_000_000n),
commitment: "confirmed"
});
const accountInfo = await rpc.getAccountInfo(keypair.address).send();
console.log(accountInfo);
Console
Click to execute the code.

حسابات Sysvar

توجد حسابات Sysvar في عناوين محددة مسبقًا وتوفر الوصول إلى بيانات حالة المجموعة. يتم تحديثها ديناميكيًا ببيانات حول مجموعة الشبكة. راجع القائمة الكاملة لـ حسابات Sysvar.

المثال أدناه يجلب ويفك تشفير البيانات من حساب Sysvar Clock.

import { createSolanaRpc } from "@solana/kit";
import { fetchSysvarClock, SYSVAR_CLOCK_ADDRESS } from "@solana/sysvars";
const rpc = createSolanaRpc("https://api.mainnet-beta.solana.com");
const accountInfo = await rpc
.getAccountInfo(SYSVAR_CLOCK_ADDRESS, { encoding: "base64" })
.send();
console.log(accountInfo);
// Automatically fetch and deserialize the account data
const clock = await fetchSysvarClock(rpc);
console.log(clock);
Console
Click to execute the code.

Is this page helpful?

تدار بواسطة

© 2025 مؤسسة سولانا.
جميع الحقوق محفوظة.