Μοντέλο Λογαριασμού Solana

Στο Solana, όλα τα δεδομένα αποθηκεύονται σε αυτό που ονομάζεται "accounts" (λογαριασμοί). Μπορείτε να σκεφτείτε τα δεδομένα στο Solana ως μια δημόσια βάση δεδομένων με έναν μόνο πίνακα "Accounts", όπου κάθε εγγραφή σε αυτόν τον πίνακα είναι ένας "account". Κάθε λογαριασμός Solana μοιράζεται τον ίδιο βασικό τύπο Account.

Λογαριασμοί

Βασικά Σημεία

• Οι λογαριασμοί μπορούν να αποθηκεύσουν έως και 10MiB δεδομένων, τα οποία περιέχουν είτε εκτελέσιμο κώδικα προγράμματος είτε κατάσταση προγράμματος.
• Οι λογαριασμοί απαιτούν μια κατάθεση rent σε lamports (SOL) που είναι ανάλογη με την ποσότητα των αποθηκευμένων δεδομένων, και μπορείτε να την ανακτήσετε πλήρως όταν κλείσετε τον λογαριασμό.
• Κάθε λογαριασμός έχει έναν ιδιοκτήτη προγράμματος. Μόνο το πρόγραμμα που κατέχει έναν λογαριασμό μπορεί να αλλάξει τα δεδομένα του ή να αφαιρέσει το υπόλοιπο lamport. Αλλά οποιοσδήποτε μπορεί να αυξήσει το υπόλοιπο.
• Λογαριασμοί Sysvar είναι ειδικοί λογαριασμοί που αποθηκεύουν την κατάσταση του δικτύου cluster.
• Λογαριασμοί προγράμματος αποθηκεύουν τον εκτελέσιμο κώδικα των έξυπνων συμβολαίων.
• Λογαριασμοί δεδομένων δημιουργούνται από προγράμματα για την αποθήκευση και διαχείριση της κατάστασης του προγράμματος.

Λογαριασμός

Κάθε λογαριασμός στο Solana έχει μια μοναδική διεύθυνση 32-byte, που συχνά εμφανίζεται ως κωδικοποιημένη συμβολοσειρά base58 (π.χ. vines1vzrYbzLMRdu58ou5XTby4qAqVRLmqo6NmXEyxm).

Η σχέση μεταξύ του λογαριασμού και της διεύθυνσής του λειτουργεί σαν ζεύγος κλειδιού-τιμής, όπου η διεύθυνση είναι το κλειδί για τον εντοπισμό των αντίστοιχων on-chain δεδομένων του λογαριασμού. Η διεύθυνση του λογαριασμού λειτουργεί ως "μοναδικό αναγνωριστικό" για κάθε εγγραφή στον πίνακα "Accounts".

Διεύθυνση Λογαριασμού

Οι περισσότεροι λογαριασμοί Solana χρησιμοποιούν ένα δημόσιο κλειδί Ed25519 ως τη διεύθυνσή τους.

import { generateKeyPairSigner } from "@solana/kit";

// Kit does not enable extractable private keys
const keypairSigner = await generateKeyPairSigner();
console.log(keypairSigner);

import { generateKeyPairSigner } from "@solana/kit";

// Kit does not enable extractable private keys
const keypairSigner = await generateKeyPairSigner();
console.log(keypairSigner);

Ενώ τα δημόσια κλειδιά χρησιμοποιούνται συνήθως ως διευθύνσεις λογαριασμών, το Solana υποστηρίζει επίσης ένα χαρακτηριστικό που ονομάζεται Program Derived Addresses (PDAs). Τα PDAs είναι ειδικές διευθύνσεις που μπορείτε να παράγετε με προκαθορισμένο τρόπο από ένα αναγνωριστικό προγράμματος και προαιρετικές εισόδους (seeds).

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}`);

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}`);

Τύπος Λογαριασμού

Οι λογαριασμοί έχουν μέγιστο μέγεθος 10MiB και κάθε λογαριασμός στο Solana μοιράζεται τον ίδιο βασικό τύπο Account.

Τύπος Λογαριασμού

Κάθε λογαριασμός στο Solana έχει τα ακόλουθα πεδία:

• data: Ένας πίνακας byte που αποθηκεύει αυθαίρετα δεδομένα για έναν λογαριασμό. Για μη εκτελέσιμους λογαριασμούς, αυτό συχνά αποθηκεύει την κατάσταση που προορίζεται για ανάγνωση. Για λογαριασμούς προγραμμάτων (έξυπνα συμβόλαια), αυτό περιέχει τον εκτελέσιμο κώδικα του προγράμματος. Το πεδίο δεδομένων συνήθως ονομάζεται "δεδομένα λογαριασμού".
• executable: Αυτή η σημαία δείχνει αν ένας λογαριασμός είναι πρόγραμμα.
• lamports: Το υπόλοιπο του λογαριασμού σε lamport, τη μικρότερη μονάδα του SOL (1 SOL = 1 δισεκατομμύριο lamport).
• owner: Το αναγνωριστικό προγράμματος (δημόσιο κλειδί) του προγράμματος που κατέχει αυτόν τον λογαριασμό. Μόνο το πρόγραμμα ιδιοκτήτης μπορεί να αλλάξει τα δεδομένα του λογαριασμού ή να αφαιρέσει το υπόλοιπο των lamport.
• rent_epoch: Ένα παλαιό πεδίο από την εποχή που το Solana είχε έναν μηχανισμό που αφαιρούσε περιοδικά lamport από τους λογαριασμούς. Ενώ αυτό το πεδίο εξακολουθεί να υπάρχει στον τύπο Account, δεν χρησιμοποιείται πλέον αφού η συλλογή rent καταργήθηκε.

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

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);

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);

Rent

Για την αποθήκευση δεδομένων στην αλυσίδα, οι λογαριασμοί πρέπει επίσης να διατηρούν ένα υπόλοιπο lamport (SOL) που είναι ανάλογο με την ποσότητα των δεδομένων που αποθηκεύονται στον λογαριασμό (σε bytes). Αυτό το υπόλοιπο ονομάζεται "rent", αλλά λειτουργεί περισσότερο σαν κατάθεση επειδή μπορείτε να ανακτήσετε το πλήρες ποσό όταν κλείσετε έναν λογαριασμό. Μπορείτε να βρείτε τον υπολογισμό εδώ χρησιμοποιώντας αυτές τις σταθερές.

Ο όρος "rent" προέρχεται από έναν παρωχημένο μηχανισμό που αφαιρούσε τακτικά lamports από λογαριασμούς που έπεφταν κάτω από το όριο του rent. Αυτός ο μηχανισμός δεν είναι πλέον ενεργός.

Ιδιοκτήτης προγράμματος

Στο Solana, τα "έξυπνα συμβόλαια" ονομάζονται προγράμματα. Η ιδιοκτησία προγράμματος είναι ένα βασικό μέρος του Μοντέλου Λογαριασμών Solana. Κάθε λογαριασμός έχει έναν καθορισμένο πρόγραμμα ως ιδιοκτήτη του. Μόνο το πρόγραμμα ιδιοκτήτης μπορεί:

• Να αλλάξει το πεδίο data του λογαριασμού
• Να αφαιρέσει lamports από το υπόλοιπο του λογαριασμού

Πρόγραμμα συστήματος

Από προεπιλογή, όλοι οι νέοι λογαριασμοί ανήκουν στο Πρόγραμμα Συστήματος. Το Πρόγραμμα Συστήματος κάνει μερικά βασικά πράγματα:

• Δημιουργία νέου λογαριασμού: Μόνο το Πρόγραμμα Συστήματος μπορεί να δημιουργήσει νέους λογαριασμούς.
• Κατανομή χώρου: Ορίζει τη χωρητικότητα σε bytes για το πεδίο δεδομένων κάθε λογαριασμού.
• Μεταφορά / Ανάθεση ιδιοκτησίας προγράμματος: Μόλις το Πρόγραμμα Συστήματος δημιουργήσει έναν λογαριασμό, μπορεί να επανεκχωρήσει τον καθορισμένο ιδιοκτήτη προγράμματος σε διαφορετικό λογαριασμό προγράμματος. Έτσι τα προσαρμοσμένα προγράμματα αποκτούν την ιδιοκτησία νέων λογαριασμών που δημιουργούνται από το Πρόγραμμα Συστήματος.

Όλοι οι λογαριασμοί "πορτοφολιού" στο Solana είναι απλώς λογαριασμοί που ανήκουν στο Πρόγραμμα Συστήματος. Το υπόλοιπο lamport σε αυτούς τους λογαριασμούς δείχνει την ποσότητα SOL που κατέχει το πορτοφόλι. Μόνο οι λογαριασμοί που ανήκουν στο Πρόγραμμα Συστήματος μπορούν να πληρώσουν τέλη συναλλαγών.

Λογαριασμός Συστήματος

Λογαριασμοί Sysvar

Οι λογαριασμοί Sysvar είναι ειδικοί λογαριασμοί σε προκαθορισμένες διευθύνσεις που παρέχουν πρόσβαση σε δεδομένα κατάστασης του συμπλέγματος. Αυτοί οι λογαριασμοί ενημερώνονται δυναμικά με δεδομένα σχετικά με το δίκτυο του συμπλέγματος. Μπορείτε να βρείτε την πλήρη λίστα των Λογαριασμών Sysvar εδώ.

import { Address, createSolanaRpc } from "@solana/kit";

const rpc = createSolanaRpc("https://api.mainnet-beta.solana.com");

const SYSVAR_CLOCK_ADDRESS =
  "SysvarC1ock11111111111111111111111111111111" as Address;

const accountInfo = await rpc
  .getAccountInfo(SYSVAR_CLOCK_ADDRESS, { encoding: "base64" })
  .send();
console.log(accountInfo);

import { Address, createSolanaRpc } from "@solana/kit";

const rpc = createSolanaRpc("https://api.mainnet-beta.solana.com");

const SYSVAR_CLOCK_ADDRESS =
  "SysvarC1ock11111111111111111111111111111111" as Address;

const accountInfo = await rpc
  .getAccountInfo(SYSVAR_CLOCK_ADDRESS, { encoding: "base64" })
  .send();
console.log(accountInfo);

Λογαριασμός Προγράμματος

Η ανάπτυξη ενός προγράμματος Solana δημιουργεί έναν εκτελέσιμο λογαριασμό προγράμματος. Ο λογαριασμός προγράμματος αποθηκεύει τον εκτελέσιμο κώδικα του προγράμματος.

Οι λογαριασμοί προγραμμάτων ανήκουν σε ένα Πρόγραμμα Φορτωτή.

Λογαριασμός Προγράμματος

Για απλότητα, μπορείτε να αντιμετωπίσετε τον λογαριασμό προγράμματος ως το ίδιο το πρόγραμμα. Όταν επικαλείστε τις οδηγίες ενός προγράμματος, καθορίζετε τη διεύθυνση του λογαριασμού προγράμματος (συνήθως αποκαλείται "Program ID").

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);

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);

Λογαριασμός Buffer

Ο loader-v3 έχει έναν ειδικό τύπο λογαριασμού για την προσωρινή σταδιακή μεταφόρτωση ενός προγράμματος κατά την ανάπτυξη ή επανανάπτυξη/αναβαθμίσεις. Στον loader-v4, εξακολουθούν να υπάρχουν buffers, αλλά είναι απλώς κανονικοί λογαριασμοί προγραμμάτων.

Λογαριασμός Δεδομένων Προγράμματος

Ο loader-v3 λειτουργεί διαφορετικά από όλα τα άλλα προγράμματα BPF Loader. Ο λογαριασμός προγράμματος περιέχει μόνο τη διεύθυνση ενός λογαριασμού δεδομένων προγράμματος, ο οποίος αποθηκεύει τον πραγματικό εκτελέσιμο κώδικα:

Λογαριασμός Δεδομένων Προγράμματος

Μην συγχέετε αυτούς τους λογαριασμούς δεδομένων προγράμματος με τους λογαριασμούς δεδομένων των προγραμμάτων (δείτε παρακάτω).

Λογαριασμός Δεδομένων

Στο Solana, ο εκτελέσιμος κώδικας ενός προγράμματος αποθηκεύεται σε διαφορετικό λογαριασμό από την κατάσταση του προγράμματος. Αυτό είναι παρόμοιο με τον τρόπο που τα λειτουργικά συστήματα συνήθως έχουν ξεχωριστά αρχεία για τα προγράμματα και τα δεδομένα τους.

Για να διατηρήσουν την κατάσταση, τα προγράμματα ορίζουν οδηγίες για τη δημιουργία ξεχωριστών λογαριασμών που τους ανήκουν. Κάθε ένας από αυτούς τους λογαριασμούς έχει τη δική του μοναδική διεύθυνση και μπορεί να αποθηκεύσει οποιαδήποτε αυθαίρετα δεδομένα που ορίζονται από το πρόγραμμα.

Λογαριασμός Δεδομένων

Σημειώστε ότι μόνο το System Program μπορεί να δημιουργήσει νέους λογαριασμούς. Μόλις το System Program δημιουργήσει έναν λογαριασμό, μπορεί στη συνέχεια να μεταφέρει ή να αναθέσει την ιδιοκτησία του νέου λογαριασμού σε άλλο πρόγραμμα.

Με άλλα λόγια, η δημιουργία ενός λογαριασμού δεδομένων για ένα προσαρμοσμένο πρόγραμμα απαιτεί δύο βήματα:

1. Επίκληση του System Program για τη δημιουργία ενός λογαριασμού, και στη συνέχεια μεταφορά της ιδιοκτησίας στο προσαρμοσμένο πρόγραμμα
2. Επίκληση του προσαρμοσμένου προγράμματος, το οποίο τώρα κατέχει τον λογαριασμό, για την αρχικοποίηση των δεδομένων του λογαριασμού όπως ορίζεται από την οδηγία του προγράμματος

Αυτή η διαδικασία δημιουργίας λογαριασμού συχνά αφαιρείται ως ένα μόνο βήμα, αλλά είναι χρήσιμο να κατανοήσετε την υποκείμενη διαδικασία.

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
} from "@solana-program/token-2022";

// Create Connection, local validator in this example
const rpc = createSolanaRpc("http://127.0.0.1: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);

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
} from "@solana-program/token-2022";

// Create Connection, local validator in this example
const rpc = createSolanaRpc("http://127.0.0.1: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);