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 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 hesap
Açık anahtar
Aşağıdaki örnek, bir keypair oluşturmak için Solana SDK'nın nasıl kullanılacağını göstermektedir.
import { generateKeyPairSigner } from "@solana/kit";// Kit does not enable extractable private keysconst keypairSigner = await generateKeyPairSigner();console.log(keypairSigner);
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, bir program derived address oluşturmak için Solana SDK'nın nasıl kullanılacağını 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}`);
Hesap yapısı
Her
Account
maksimum
10MiB
boyutundadır ve aşağıdaki bilgileri içerir:
lamports: Hesaptaki lamport sayısıdata: Hesabın verisiowner: Hesabın sahibi olan programın kimliğiexecutable: Hesabın çalıştırılabilir ikili dosya içerip içermediğini gösterirrent_epoch: Kullanımdan kaldırılmış rent epoch alanı
pub struct Account {/// lamports in the accountpub 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 rentpub rent_epoch: Epoch,}
Lamport'lar
Hesabın lamport cinsinden bakiyesi.
Her hesabın, verilerinin zincir üzerinde saklanmasını sağlayan minimum bir lamport bakiyesine, yani rent adı verilen bir bakiyeye sahip olması gerekir. Rent, hesabın boyutuyla orantılıdır.
Bu bakiye "rent" olarak adlandırılsa da, hesap kapatıldığında tüm 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 verilerin yapısını kendisi tanımlar.
- Program account'ları: Bu alan, ya çalıştırılabilir program kodunu ya da çalıştırılabilir program kodunu saklayan bir program data account adresini içerir.
- Veri hesapları: Bu alan genellikle okunmak üzere durum verilerini saklar.
Bir Solana hesabından veri okumak iki adımdan oluşur:
- Hesabı adresi kullanarak getirmek
- Hesabın
dataalanı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 ID'sini 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'ları
düşebilen tek programdır.
(Bir program account söz konusu olduğunda, sahibi loader program olur.)
Çalıştırılabilir
Bu alan, bir hesabın program account mı yoksa data account mı olduğunu belirtir
- Eğer
true: Hesap bir program account'tır - Eğer
false: Hesap bir data account'tı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 ederdi. Ancak, bu rent toplama mekanizması artık kullanımdan kaldırılmıştır.
Hesap türleri
Hesaplar iki temel kategoriye ayrılır:
- Program account'ları: Çalıştırılabilir kod içeren hesaplar
- Data account'ları: Çalıştırılabilir kod içermeyen hesaplar
Bu ayrım, bir programın çalıştırılabilir kodu ve durumunun ayrı hesaplarda saklandığı anlamına gelir. (İşletim sistemlerine benzer şekilde, genellikle programlar ve verileri için ayrı dosyalara sahiptir.)
Program account'ları
Her program, hesabı dağıtmak ve yönetmek için kullanılan bir loader 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 account denir. (Basitlik açısından, program account'ı programın kendisi olarak düşünebilirsiniz.)
Aşağıdaki diyagramda, bir program account'ı dağıtmak için bir loader program'ın
kullanıldığını görebilirsiniz. Program account'ın data alanı, çalıştırılabilir
program kodunu içerir.
Bir program account'ın, 4 bileşeninin ve loader program'ının diyagramı.
Program data account'ları
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 data account'a işaret eder. (Aşağıdaki diyagrama bakın.)
Veriye sahip bir program hesabı. Veri, ayrı bir program veri hesabına işaret eder
Program dağıtımı veya güncellemeleri sırasında, buffer hesapları yüklemeyi geçici olarak hazırlamak için 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);
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:
- Bir hesap oluşturmak için System Program'ı çağırın. (System Program daha sonra sahipliği yeni programa aktarır.)
- Talimatlarında tanımlandığı şekilde hesap verilerini başlatın.
Bir program hesabı tarafından sahiplenilen bir veri hesabının diyagramı
Aşağıdaki örnek, Token 2022 programı tarafından sahiplenilen 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 exampleconst rpc = createSolanaRpc("http://localhost:8899");const rpcSubscriptions = createSolanaRpcSubscriptions("ws://localhost:8900");// Generate keypairs for fee payerconst feePayer = await generateKeyPairSigner();// Fund fee payerawait airdropFactory({ rpc, rpcSubscriptions })({recipientAddress: feePayer.address,lamports: lamports(1_000_000_000n),commitment: "confirmed"});// Generate keypair to use as address of mintconst mint = await generateKeyPairSigner();// Get default mint account size (in bytes), no extensions enabledconst space = BigInt(getMintSize());// Get minimum balance for rent exemptionconst rent = await rpc.getMinimumBalanceForRentExemption(space).send();// Instruction to create new account for mint (token 2022 program)// Invokes the system programconst createAccountInstruction = getCreateAccountInstruction({payer: feePayer,newAccount: mint,lamports: rent,space,programAddress: TOKEN_2022_PROGRAM_ADDRESS});// Instruction to initialize mint account data// Invokes the token 2022 programconst initializeMintInstruction = getInitializeMintInstruction({mint: mint.address,decimals: 9,mintAuthority: feePayer.address});const instructions = [createAccountInstruction, initializeMintInstruction];// Get latest blockhash to include in transactionconst { value: latestBlockhash } = await rpc.getLatestBlockhash().send();// Create transaction messageconst 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 transactionawait sendAndConfirmTransactionFactory({ rpc, rpcSubscriptions })(signedTransaction,{ commitment: "confirmed" });// Get transaction signatureconst 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);
System hesapları
System Program tarafından oluşturulduktan sonra tüm hesaplara yeni bir sahip atanmaz. System Program tarafından sahiplenilen hesaplara system hesapları denir. Tüm cüzdan hesapları system hesaplarıdır, bu da onların işlem ücretlerini ödemelerine olanak tanır.
System Program tarafından sahiplenilen ve 1.000.000 lamport içeren bir cüzdan
SOL ilk kez yeni bir adrese gönderildiğinde, o adreste System Program tarafından sahiplenilen 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 clusterconst rpc = createSolanaRpc("http://localhost:8899");const rpcSubscriptions = createSolanaRpcSubscriptions("ws://localhost:8900");// Generate a new keypairconst keypair = await generateKeyPairSigner();console.log(`Public Key: ${keypair.address}`);// Funding an address with SOL automatically creates an accountconst 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);
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 dataconst clock = await fetchSysvarClock(rpc);console.log(clock);
Is this page helpful?