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

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

Λογαριασμοί

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

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

Λογαριασμός

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

Η σχέση μεταξύ του λογαριασμού και της διεύθυνσής του λειτουργεί σαν ζεύγος κλειδιού-τιμής, όπου η διεύθυνση είναι το κλειδί για τον εντοπισμό των αντίστοιχων 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 υποστηρίζει επίσης ένα χαρακτηριστικό που ονομάζεται Διευθύνσεις Παραγόμενες από Προγράμματα (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 έχει τα ακόλουθα πεδία.

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

pub struct Account {
    /// lamports in the account
    pub lamports: u64,
}

// Example Token Mint Account
Account {
    lamports: 1461600,
}

// Example Token Program Account
Account {
    lamports: 4513200894,
}

Rent

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

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

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

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

• Αλλαγή του πεδίου data του λογαριασμού
• Αφαίρεση lamports από το υπόλοιπο του λογαριασμού

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

System Program

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

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

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

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

Στο παρακάτω παράδειγμα, δημιουργείται ένα νέο keypair και χρηματοδοτείται με SOL. Εκτελέστε τον κώδικα για να δείτε το αποτέλεσμα. Σημειώστε ότι το πεδίο owner του λογαριασμού είναι το System Program με τη διεύθυνση 11111111111111111111111111111111.

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

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

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

Το παρακάτω παράδειγμα δείχνει πώς να ανακτήσετε και να αποσειριοποιήσετε τα δεδομένα από τον λογαριασμό Sysvar Clock.

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

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

Program Account

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

Program Account

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

Το παρακάτω παράδειγμα ανακτά τον Token Program account για να δείξει ότι οι program accounts έχουν τον ίδιο βασικό τύπο Account, εκτός από το πεδίο executable που είναι ορισμένο ως true. Επειδή οι program accounts περιέχουν εκτελέσιμο κώδικα στο πεδίο δεδομένων τους, δεν αποσειριοποιούμε τα δεδομένα.

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, αλλά είναι απλώς κανονικοί program accounts.

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

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

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

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

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

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

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

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

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

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

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

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

Το ακόλουθο παράδειγμα δείχνει πώς να δημιουργήσετε και να ανακτήσετε έναν λογαριασμό 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 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);

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