Περίληψη
Οι λογαριασμοί προγράμματος περιέχουν εκτελέσιμο κώδικα sBPF. Οι λογαριασμοί δεδομένων αποθηκεύουν κατάσταση, που ανήκει σε προγράμματα. Οι λογαριασμοί συστήματος ανήκουν στο System Program. Τα sysvars παρέχουν κατάσταση σε επίπεδο συστάδας προσβάσιμη σε προκαθορισμένες διευθύνσεις.
Το πεδίο executable καθορίζει την
κατηγορία ενός λογαριασμού:
- Λογαριασμοί προγράμματος:
executable=true. Περιέχει εκτελέσιμο κώδικα. - Λογαριασμοί δεδομένων:
executable=false. Αποθηκεύει κατάσταση ή δεδομένα χρήστη.
Αυτός ο διαχωρισμός του κώδικα από την μεταβλητή κατάσταση σημαίνει ότι ένα πρόγραμμα αναπτύσσεται μία φορά και μπορεί να διαχειριστεί οποιονδήποτε αριθμό λογαριασμών δεδομένων.
Λογαριασμοί προγράμματος
Ένας λογαριασμός προγράμματος αποθηκεύει εκτελέσιμο κώδικα. Κάθε λογαριασμός προγράμματος ανήκει σε ένα πρόγραμμα φόρτωσης. Όταν ένα πρόγραμμα αναπτύσσεται, το runtime δημιουργεί έναν λογαριασμό προγράμματος για να αποθηκεύσει τον bytecode του.
Διάγραμμα ενός λογαριασμού προγράμματος, των 4 συστατικών του και του προγράμματος φόρτωσής του.
Λογαριασμοί δεδομένων προγράμματος
Τα προγράμματα που αναπτύσσονται χρησιμοποιώντας το loader-v3 (δείτε
Προγράμματα φόρτωσης)
δεν αποθηκεύουν εκτελέσιμο bytecode στο δικό τους πεδίο data. Αντίθετα, το
data τους δείχνει σε έναν ξεχωριστό λογαριασμό δεδομένων προγράμματος που
περιέχει τον κώδικα του προγράμματος. (Δείτε το παρακάτω διάγραμμα.)
Ένας λογαριασμός προγράμματος με δεδομένα. Τα δεδομένα δείχνουν σε έναν ξεχωριστό λογαριασμό δεδομένων προγράμματος
Κατά την ανάπτυξη ή αναβάθμιση προγράμματος, οι λογαριασμοί buffer χρησιμοποιούνται για προσωρινή σταδιοποίηση της μεταφόρτωσης.
Το παρακάτω παράδειγμα ανακτά τον λογαριασμό Token Program. Το πεδίο
executable είναι true, επιβεβαιώνοντας ότι είναι λογαριασμός προγράμματος.
import { Address, generateKeyPairSigner } from "@solana/kit";import { createClient } from "@solana/kit-client-rpc";const feePayer = await generateKeyPairSigner();const client = createClient({url: "https://api.mainnet.solana.com",payer: feePayer});const programId = "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" as Address;const accountInfo = await client.rpc.getAccountInfo(programId, { encoding: "base64" }).send();console.log(accountInfo);
Λογαριασμοί δεδομένων
Οι λογαριασμοί δεδομένων δεν περιέχουν εκτελέσιμο κώδικα. Αποθηκεύουν την κατάσταση που ορίζεται από το πρόγραμμα.
Λογαριασμός κατάστασης προγράμματος
Τα προγράμματα αποθηκεύουν την κατάστασή τους σε λογαριασμούς δεδομένων. Η δημιουργία ενός λογαριασμού κατάστασης προγράμματος περιλαμβάνει δύο βήματα:
- Κλήση του System Program για τη δημιουργία του λογαριασμού. Το System Program μεταφέρει την κυριότητα στο καθορισμένο πρόγραμμα.
- Το πρόγραμμα που κατέχει τον λογαριασμό αρχικοποιεί το πεδίο
dataτου λογαριασμού σύμφωνα με τις οδηγίες του.
Διάγραμμα λογαριασμού δεδομένων που ανήκει σε program account
Το παρακάτω παράδειγμα δημιουργεί και ανακτά έναν λογαριασμό Token Mint που ανήκει στο πρόγραμμα Token 2022.
import { generateKeyPairSigner } from "@solana/kit";import { createLocalClient } from "@solana/kit-client-rpc";import { systemProgram } from "@solana-program/system";import {getInitializeMintInstruction,getMintSize,TOKEN_2022_PROGRAM_ADDRESS,fetchMint} from "@solana-program/token-2022";const client = await createLocalClient().use(systemProgram());// 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 client.rpc.getMinimumBalanceForRentExemption(space).send();const transactionSignature = await client.sendTransaction([client.system.instructions.createAccount({newAccount: mint,lamports: rent,space,programAddress: TOKEN_2022_PROGRAM_ADDRESS}),getInitializeMintInstruction({mint: mint.address,decimals: 9,mintAuthority: client.payer.address})]);console.log("Mint Address:", mint.address);console.log("Transaction Signature:", transactionSignature.context.signature);const accountInfo = await client.rpc.getAccountInfo(mint.address).send();console.log(accountInfo);const mintAccount = await fetchMint(client.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 { generateKeyPairSigner, lamports } from "@solana/kit";import { createLocalClient } from "@solana/kit-client-rpc";const client = await createLocalClient();// Generate a new keypairconst keypair = await generateKeyPairSigner();console.log(`Public Key: ${keypair.address}`);// Funding an address with SOL automatically creates an accountconst signature = await client.airdrop(keypair.address,lamports(1_000_000_000n));const accountInfo = await client.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 { generateKeyPairSigner } from "@solana/kit";import { createClient } from "@solana/kit-client-rpc";import { fetchSysvarClock, SYSVAR_CLOCK_ADDRESS } from "@solana/sysvars";const feePayer = await generateKeyPairSigner();const client = createClient({url: "https://api.mainnet.solana.com",payer: feePayer});const accountInfo = await client.rpc.getAccountInfo(SYSVAR_CLOCK_ADDRESS, { encoding: "base64" }).send();console.log(accountInfo);// Automatically fetch and deserialize the account dataconst clock = await fetchSysvarClock(client.rpc);console.log(clock);
Is this page helpful?