Hesaplar

Solana ağındaki tüm veriler hesaplarda saklanır. Solana ağını, tek bir Hesaplar tablosuna sahip genel bir veritabanı olarak düşünebilirsiniz. Bir hesap ile adresi arasındaki ilişki, anahtarın adres ve değerin hesap olduğu bir anahtar-değer çiftine benzer.

Her hesap aynı temel yapıya sahiptir ve adresi kullanılarak bulunabilir.

Üç hesap ve adreslerini gösteren diyagram. Hesap yapısı tanımını içerir.Üç hesap ve adreslerini gösteren diyagram. Hesap yapısı tanımını içerir.

Hesap adresi

Hesabın adresi, Solana blok zincirinde hesabı bulmak için kullanılan 32 baytlık benzersiz bir kimliktir. Hesap adresleri genellikle base58 kodlanmış dizeler olarak gösterilir. Çoğu hesap adres olarak bir Ed25519 açık anahtar kullanır, ancak Solana aynı zamanda program derived address desteklediği için bu zorunlu değildir.

Base58 kodlanmış açık anahtar adresine sahip bir hesapBase58 kodlanmış açık anahtar adresine sahip bir hesap

Açık anahtar

Aşağıdaki örnek, Solana SDK'sını kullanarak bir keypair oluşturmayı göstermektedir. Bir Keypair şunları içerir:

  • Hesap adresi olarak hizmet veren bir açık anahtar
  • İşlemleri imzalamak için kullanılan bir özel anahtar
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

Bir Program Derived Address (PDA), bir program kimliği ve bir veya daha fazla isteğe bağlı girdi (seed) kullanılarak deterministik olarak türetilen bir adrestir. Aşağıdaki örnek, Solana SDK'sını kullanarak bir Program Derived Address oluşturmayı göstermektedir.

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.

Hesap yapısı

Her Account maksimum 10MiB boyutundadır ve aşağıdaki bilgileri içerir:

  • lamports: Hesaptaki lamport sayısı
  • data: Hesabın verisi
  • owner: Hesabın sahibi olan programın kimliği
  • executable: Hesabın çalıştırılabilir ikili dosya içerip içermediğini belirtir
  • rent_epoch: Kullanımdan kaldırılmış rent epoch alanı
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

Hesabın lamport cinsinden bakiyesi.

Her hesabın, verisinin zincir üzerinde depolanmasını sağlayan minimum bir lamport bakiyesine, yani rent adı verilen bir miktara sahip olması gerekir. Rent, hesabın boyutuyla orantılıdır.

Bu bakiye rent olarak adlandırılsa da, hesap kapatıldığında tam bakiye geri alınabildiği için daha çok bir depozito gibi çalışır. ("rent" adı, artık kullanımdan kaldırılmış olan rent epoch alanından gelmektedir.)

(Minimum bakiye formülüne ve geçerli sabitlere bakın.)

Veri

Bu alan genellikle "hesap verisi" olarak adlandırılır. Bu alandaki data herhangi bir bayt dizisi içerebileceği için keyfi olarak kabul edilir. Her program, bu alanda saklanan verinin yapısını kendisi tanımlar.

  • Program account: Bu alan ya çalıştırılabilir program kodunu ya da çalıştırılabilir program kodunu saklayan bir program veri hesabının adresini içerir.
  • Veri hesapları: Bu alan genellikle okunması amaçlanan durum verilerini saklar.

Bir Solana hesabından veri okumak iki adımdan oluşur:

  1. Hesabı adresi kullanarak getirmek
  2. Hesabın data alanını ham baytlardan, hesabın sahibi olan program tarafından tanımlanan uygun veri yapısına dönüştürmek.

Sahip

Bu alan, hesabın sahibinin program kimliğini içerir.

Her Solana hesabının sahibi olarak belirlenmiş bir programı vardır. Hesabın sahibi, programın talimatlarında belirtildiği gibi, hesabın data alanını değiştirebilen veya lamport düşebilen tek programdır.

(Bir program account durumunda, sahibi yükleyici programıdır.)

Çalıştırılabilir

Bu alan, bir hesabın program account mı yoksa veri hesabı mı olduğunu belirtir

  • Eğer true ise: Hesap bir program account'tır
  • Eğer false ise: Hesap bir veri hesabıdır

Rent epoch

rent_epoch alanı kullanımdan kaldırılmıştır.

Geçmişte, bu alan bir hesabın ne zaman rent ödemesi gerektiğini takip ediyordu. Ancak, bu rent toplama mekanizması artık kullanımdan kaldırılmıştır.

Lamports

Hesabın lamport cinsinden bakiyesi.

Her hesabın, verisinin zincir üzerinde depolanmasını sağlayan minimum bir lamport bakiyesine, yani rent adı verilen bir miktara sahip olması gerekir. Rent, hesabın boyutuyla orantılıdır.

Bu bakiye rent olarak adlandırılsa da, hesap kapatıldığında tam bakiye geri alınabildiği için daha çok bir depozito gibi çalışır. ("rent" adı, artık kullanımdan kaldırılmış olan rent epoch alanından gelmektedir.)

(Minimum bakiye formülüne ve geçerli sabitlere bakın.)

Veri

Bu alan genellikle "hesap verisi" olarak adlandırılır. Bu alandaki data herhangi bir bayt dizisi içerebileceği için keyfi olarak kabul edilir. Her program, bu alanda saklanan verinin yapısını kendisi tanımlar.

  • Program account: Bu alan ya çalıştırılabilir program kodunu ya da çalıştırılabilir program kodunu saklayan bir program veri hesabının adresini içerir.
  • Veri hesapları: Bu alan genellikle okunması amaçlanan durum verilerini saklar.

Bir Solana hesabından veri okumak iki adımdan oluşur:

  1. Hesabı adresi kullanarak getirmek
  2. Hesabın data alanını ham baytlardan, hesabın sahibi olan program tarafından tanımlanan uygun veri yapısına dönüştürmek.

Sahip

Bu alan, hesabın sahibinin program kimliğini içerir.

Her Solana hesabının sahibi olarak belirlenmiş bir programı vardır. Hesabın sahibi, programın talimatlarında belirtildiği gibi, hesabın data alanını değiştirebilen veya lamport düşebilen tek programdır.

(Bir program account durumunda, sahibi yükleyici programıdır.)

Çalıştırılabilir

Bu alan, bir hesabın program account mı yoksa veri hesabı mı olduğunu belirtir

  • Eğer true ise: Hesap bir program account'tır
  • Eğer false ise: Hesap bir veri hesabıdır

Rent epoch

rent_epoch alanı kullanımdan kaldırılmıştır.

Geçmişte, bu alan bir hesabın ne zaman rent ödemesi gerektiğini takip ediyordu. Ancak, bu rent toplama mekanizması artık kullanımdan kaldırılmıştır.

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,
}

Hesap türleri

Hesaplar iki temel kategoriye ayrılır:

Bir programın kodu ile durumunun ayrılması, Solana'nın hesap modelinin önemli bir özelliğidir. (İşletim sistemlerine benzer şekilde, genellikle programlar ve verileri için ayrı dosyalar bulunur.)

Program hesapları

Her program, hesabı dağıtmak ve yönetmek için kullanılan bir yükleyici program tarafından sahiplenilir. Yeni bir program dağıtıldığında, çalıştırılabilir kodunu depolamak için bir hesap oluşturulur. Buna program hesabı denir. (Basitlik açısından, program hesabını programın kendisi olarak düşünebilirsiniz.)

Aşağıdaki diyagramda, bir program hesabını dağıtmak için bir yükleyici programın kullanıldığını görebilirsiniz. Program hesabının data alanı, çalıştırılabilir program kodunu içerir.

Bir program hesabı, 4 bileşeni ve yükleyici programının diyagramı.Bir program hesabı, 4 bileşeni ve yükleyici programının diyagramı.

Program veri hesapları

Loader-v3 kullanılarak dağıtılan programlar, data alanlarında program kodu içermezler. Bunun yerine, data alanları, program kodunu içeren ayrı bir program veri hesabına işaret eder. (Aşağıdaki diyagrama bakın.)

Veriye sahip bir program hesabı. Veri, ayrı bir program veri hesabına işaret ederVeriye sahip bir program hesabı. Veri, ayrı bir program veri hesabına işaret eder

Program dağıtımı veya güncellemeleri sırasında, yüklemeyi geçici olarak hazırlamak için tampon hesaplar kullanılır.

Aşağıdaki örnek, Token Program hesabını getirir. executable alanının true olarak ayarlandığına dikkat edin, bu hesabın bir program olduğunu gösterir.

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.

Veri hesapları

Veri hesapları çalıştırılabilir kod içermez. Bunun yerine, bilgi depolarlar.

Program durum hesabı

Programlar durumlarını korumak için veri hesaplarını kullanır. Bunu yapmak için, önce yeni bir veri hesabı oluşturmaları gerekir. Program durum hesabı oluşturma süreci genellikle soyutlanmıştır, ancak altta yatan süreci anlamak faydalıdır.

Durumunu yönetmek için, yeni bir program şunları yapmalıdır:

  1. Bir hesap oluşturmak için System Program'ı çağırır. (System Program daha sonra sahipliği yeni programa aktarır.)
  2. Talimatlarında tanımlandığı şekilde hesap verilerini başlatır.

Bir program hesabı tarafından sahip olunan bir veri hesabının diyagramıBir program hesabı tarafından sahip olunan bir veri hesabının diyagramı

Aşağıdaki örnek, Token 2022 programı tarafından sahip olunan bir Token Mint hesabı oluşturur ve getirir.

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 hesapları

System Program tarafından oluşturulduktan sonra tüm hesaplara yeni bir sahip atanmaz. System Program'a ait hesaplara sistem hesapları denir. Tüm cüzdan hesapları, işlem ücretlerini ödemelerine olanak tanıyan sistem hesaplarıdır.

System Program tarafından sahip olunan ve 1.000.000 lamport içeren bir cüzdanSystem Program tarafından sahip olunan ve 1.000.000 lamport içeren bir cüzdan

SOL ilk kez yeni bir adrese gönderildiğinde, o adreste System Program'a ait bir hesap oluşturulur.

Aşağıdaki örnekte, yeni bir keypair oluşturulur ve SOL ile fonlanır. Kodu çalıştırdıktan sonra, hesabın owner adresinin 11111111111111111111111111111111 (System Program) olduğunu görebilirsiniz.

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 hesapları

Sysvar hesapları önceden tanımlanmış adreslerde bulunur ve küme durumu verilerine erişim sağlar. Ağ kümesi hakkındaki verilerle dinamik olarak güncellenir. Sysvar Hesapları tam listesine bakın.

Aşağıdaki örnek, Sysvar Clock hesabından veri alır ve deserialize eder.

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?

İçindekiler

Sayfayı Düzenle

Yönetici

© 2025 Solana Vakfı.
Tüm hakları saklıdır.
Bağlanın