Περίληψη
Οι λογαριασμοί προγράμματος περιέχουν εκτελέσιμο κώδικα sBPF. Οι λογαριασμοί δεδομένων αποθηκεύουν κατάσταση, που ανήκει σε προγράμματα. Οι λογαριασμοί συστήματος ανήκουν στο System Program. Τα sysvars παρέχουν κατάσταση σε επίπεδο συστάδας προσβάσιμη σε προκαθορισμένες διευθύνσεις.
Το πεδίο executable καθορίζει την
κατηγορία ενός λογαριασμού:
- Λογαριασμοί προγράμματος:
executable=true. Περιέχει εκτελέσιμο κώδικα. - Λογαριασμοί δεδομένων:
executable=false. Αποθηκεύει κατάσταση ή δεδομένα χρήστη.
Αυτός ο διαχωρισμός του κώδικα από την μεταβλητή κατάσταση σημαίνει ότι ένα πρόγραμμα αναπτύσσεται μία φορά και μπορεί να διαχειριστεί οποιονδήποτε αριθμό λογαριασμών δεδομένων.
Λογαριασμοί προγράμματος
Ένας λογαριασμός προγράμματος αποθηκεύει εκτελέσιμο κώδικα. Κάθε λογαριασμός προγράμματος ανήκει σε ένα πρόγραμμα φόρτωσης. Όταν ένα πρόγραμμα αναπτύσσεται, το runtime δημιουργεί έναν λογαριασμό προγράμματος για να αποθηκεύσει τον bytecode του.
Διάγραμμα ενός λογαριασμού προγράμματος, των 4 συστατικών του και του προγράμματος φόρτωσής του.
Λογαριασμοί δεδομένων προγράμματος
Τα προγράμματα που αναπτύσσονται χρησιμοποιώντας το loader-v3 (δείτε
Προγράμματα φόρτωσης)
δεν αποθηκεύουν εκτελέσιμο bytecode στο δικό τους πεδίο data. Αντίθετα, το
data τους δείχνει σε έναν ξεχωριστό λογαριασμό δεδομένων προγράμματος που
περιέχει τον κώδικα του προγράμματος. (Δείτε το παρακάτω διάγραμμα.)
Ένας λογαριασμός προγράμματος με δεδομένα. Τα δεδομένα δείχνουν σε έναν ξεχωριστό λογαριασμό δεδομένων προγράμματος
Κατά την ανάπτυξη ή αναβάθμιση προγράμματος, οι λογαριασμοί buffer χρησιμοποιούνται για προσωρινή σταδιοποίηση της μεταφόρτωσης.
Το παρακάτω παράδειγμα ανακτά τον λογαριασμό Token Program. Το πεδίο
executable είναι true, επιβεβαιώνοντας ότι είναι λογαριασμός προγράμματος.
import { Address, createSolanaRpc } from "@solana/kit";const rpc = createSolanaRpc("https://api.mainnet.solana.com");const programId = "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" as Address;const accountInfo = await rpc.getAccountInfo(programId, { encoding: "base64" }).send();console.log(accountInfo);
Λογαριασμοί δεδομένων
Οι λογαριασμοί δεδομένων δεν περιέχουν εκτελέσιμο κώδικα. Αποθηκεύουν την κατάσταση που ορίζεται από το πρόγραμμα.
Λογαριασμός κατάστασης προγράμματος
Τα προγράμματα αποθηκεύουν την κατάστασή τους σε λογαριασμούς δεδομένων. Η δημιουργία ενός λογαριασμού κατάστασης προγράμματος περιλαμβάνει δύο βήματα:
- Κλήση του System Program για τη δημιουργία του λογαριασμού. Το System Program μεταφέρει την κυριότητα στο καθορισμένο πρόγραμμα.
- Το πρόγραμμα που κατέχει τον λογαριασμό αρχικοποιεί το πεδίο
dataτου λογαριασμού σύμφωνα με τις οδηγίες του.
Διάγραμμα λογαριασμού δεδομένων που ανήκει σε program account
Το παρακάτω παράδειγμα δημιουργεί και ανακτά έναν λογαριασμό 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 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 Program μετά τη δημιουργία τους ονομάζονται λογαριασμοί συστήματος. Η αποστολή SOL σε μια νέα διεύθυνση για πρώτη φορά δημιουργεί έναν νέο λογαριασμό σε αυτή τη διεύθυνση που ανήκει στο System Program.
Όλοι οι λογαριασμοί πορτοφολιού είναι λογαριασμοί συστήματος. Ο πληρωτής των τελών σε μια συναλλαγή πρέπει να είναι λογαριασμός συστήματος, επειδή μόνο οι λογαριασμοί που ανήκουν στο System Program μπορούν να πληρώσουν τέλη συναλλαγών.
Ένα πορτοφόλι που ανήκει στο System Program και περιέχει 1.000.000 lamports
Το παρακάτω παράδειγμα δημιουργεί ένα νέο keypair, το χρηματοδοτεί με SOL και
ανακτά τον λογαριασμό. Το πεδίο owner είναι 11111111111111111111111111111111
(το System Program).
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
Οι λογαριασμοί Sysvar είναι ειδικοί λογαριασμοί σε προκαθορισμένες διευθύνσεις που παρέχουν πρόσβαση μόνο για ανάγνωση στα δεδομένα κατάστασης του cluster. Ενημερώνονται δυναμικά σε κάθε slot.
| Sysvar | Διεύθυνση | Σκοπός |
|---|---|---|
| Clock | SysvarC1ock11111111111111111111111111111111 | Τρέχον slot, epoch και χρονική σήμανση Unix |
| EpochSchedule | SysvarEpochSchedu1e111111111111111111111111 | Σταθερές προγραμματισμού epoch που ορίζονται στο genesis |
| EpochRewards | SysvarEpochRewards1111111111111111111111111 | Κατάσταση και πρόοδος διανομής ανταμοιβών epoch |
| Rent | SysvarRent111111111111111111111111111111111 | Τιμή rent και όριο απαλλαγής |
| SlotHashes | SysvarS1otHashes111111111111111111111111111 | Πιο πρόσφατα hashes των γονικών banks του slot |
| StakeHistory | SysvarStakeHistory1111111111111111111111111 | Ενεργοποιήσεις και απενεργοποιήσεις stake ανά epoch |
| LastRestartSlot | SysvarLastRestartS1ot1111111111111111111111 | Τελευταίο slot επανεκκίνησης cluster |
| Instructions | Sysvar1nstructions1111111111111111111111111 | Σειριοποιημένες οδηγίες της τρέχουσας συναλλαγής |
| SlotHistory | SysvarS1otHistory11111111111111111111111111 | Καταγραφή των slots που παράχθηκαν κατά τη διάρκεια του τελευταίου epoch |
Το παρακάτω παράδειγμα ανακτά και αποσειριοποιεί τον λογαριασμό Sysvar Clock.
import { createSolanaRpc } from "@solana/kit";import { fetchSysvarClock, SYSVAR_CLOCK_ADDRESS } from "@solana/sysvars";const rpc = createSolanaRpc("https://api.mainnet.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?