Tài khoản

Tất cả dữ liệu trên mạng Solana được lưu trữ trong các tài khoản. Bạn có thể coi mạng Solana như một cơ sở dữ liệu công khai với một bảng Tài khoản duy nhất. Mối quan hệ giữa một tài khoản và địa chỉ của nó tương tự như một cặp khóa-giá trị, trong đó khóa là địa chỉ và giá trị là tài khoản.

Mỗi tài khoản đều có cùng cấu trúc cơ bản và có thể được xác định vị trí bằng địa chỉ của nó.

Sơ đồ 3 tài khoản và địa chỉ của chúng. Bao gồm định nghĩa cấu trúc tài khoản.Sơ đồ 3 tài khoản và địa chỉ của chúng. Bao gồm định nghĩa cấu trúc tài khoản.

Địa chỉ tài khoản

Địa chỉ tài khoản là một ID duy nhất 32-byte được sử dụng để xác định vị trí tài khoản trên blockchain Solana. Địa chỉ tài khoản thường được hiển thị dưới dạng chuỗi mã hóa base58. Hầu hết các tài khoản sử dụng khóa công khai Ed25519 làm địa chỉ, nhưng điều này không bắt buộc, vì Solana cũng hỗ trợ địa chỉ dẫn xuất từ chương trình.

Một tài khoản với địa chỉ khóa công khai được mã hóa base58Một tài khoản với địa chỉ khóa công khai được mã hóa base58

Khóa công khai

Ví dụ dưới đây minh họa cách sử dụng SDK Solana để tạo một keypair.

import { generateKeyPairSigner } from "@solana/kit";
// Kit does not enable extractable private keys
const keypairSigner = await generateKeyPairSigner();
console.log(keypairSigner);
Console
Click to execute the code.

Program Derived Address

Program Derived Address (PDA) là một địa chỉ được tạo ra một cách xác định bằng cách sử dụng ID của một chương trình và một hoặc nhiều đầu vào tùy chọn (seeds). Ví dụ dưới đây minh họa cách sử dụng SDK Solana để tạo một Program Derived Address.

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}`);
Console
Click to execute the code.

Cấu trúc tài khoản

Mỗi Account có kích thước tối đa là 10MiB và chứa các thông tin sau:

  • lamports: Số lượng lamports trong tài khoản
  • data: Dữ liệu của tài khoản
  • owner: ID của chương trình sở hữu tài khoản
  • executable: Chỉ ra liệu tài khoản có chứa mã nhị phân có thể thực thi hay không
  • rent_epoch: Trường epoch rent đã không còn được sử dụng
Account
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,
}

Lamports

Số dư tài khoản tính bằng lamport.

Mỗi tài khoản phải có số dư lamport tối thiểu, được gọi là rent, cho phép dữ liệu của nó được lưu trữ trên chuỗi. Rent tỷ lệ thuận với kích thước của tài khoản.

Mặc dù số dư này được gọi là rent, nhưng nó hoạt động giống như một khoản đặt cọc hơn, vì toàn bộ số dư có thể được thu hồi khi tài khoản bị đóng. (Tên "rent" xuất phát từ trường rent epoch hiện đã không còn được sử dụng.)

(Xem công thức tính số dư tối thiểu và các hằng số áp dụng.)

Dữ liệu

Trường này thường được gọi là "dữ liệu tài khoản". Dữ liệu trong trường này được coi là tùy ý vì nó có thể chứa bất kỳ chuỗi byte nào. Mỗi chương trình định nghĩa cấu trúc của dữ liệu được lưu trữ trong trường này.

  • Program accounts: Trường này chứa mã chương trình thực thi hoặc địa chỉ của program data account lưu trữ mã chương trình thực thi.
  • Data accounts: Trường này thường lưu trữ dữ liệu trạng thái, dùng để đọc.

Đọc dữ liệu từ một tài khoản Solana bao gồm hai bước:

  1. Lấy tài khoản bằng cách sử dụng địa chỉ của nó
  2. Giải mã trường dữ liệu của tài khoản từ các byte thô thành cấu trúc dữ liệu thích hợp, theo định nghĩa của chương trình sở hữu tài khoản.

Chủ sở hữu

Trường này chứa ID chương trình của chủ sở hữu tài khoản.

Mỗi tài khoản Solana có một chương trình được chỉ định làm chủ sở hữu. Chủ sở hữu tài khoản là chương trình duy nhất có thể thay đổi dữ liệu của tài khoản hoặc trừ lamports, theo chỉ dẫn của chương trình.

(Trong trường hợp program account, chủ sở hữu là loader program của nó.)

Có thể thực thi

Trường này chỉ ra liệu một tài khoản có phải là tài khoản program hay tài khoản dữ liệu

  • Nếu true: Tài khoản là tài khoản program
  • Nếu false: Tài khoản là tài khoản dữ liệu

Epoch thuê

Trường rent_epoch đã bị loại bỏ.

Trong quá khứ, trường này theo dõi khi nào một tài khoản cần phải trả rent. Tuy nhiên, cơ chế thu rent này đã bị loại bỏ.

Lamports

Số dư tài khoản tính bằng lamport.

Mỗi tài khoản phải có số dư lamport tối thiểu, được gọi là rent, cho phép dữ liệu của nó được lưu trữ trên chuỗi. Rent tỷ lệ thuận với kích thước của tài khoản.

Mặc dù số dư này được gọi là rent, nhưng nó hoạt động giống như một khoản đặt cọc hơn, vì toàn bộ số dư có thể được thu hồi khi tài khoản bị đóng. (Tên "rent" xuất phát từ trường rent epoch hiện đã không còn được sử dụng.)

(Xem công thức tính số dư tối thiểu và các hằng số áp dụng.)

Dữ liệu

Trường này thường được gọi là "dữ liệu tài khoản". Dữ liệu trong trường này được coi là tùy ý vì nó có thể chứa bất kỳ chuỗi byte nào. Mỗi chương trình định nghĩa cấu trúc của dữ liệu được lưu trữ trong trường này.

  • Program accounts: Trường này chứa mã chương trình thực thi hoặc địa chỉ của program data account lưu trữ mã chương trình thực thi.
  • Data accounts: Trường này thường lưu trữ dữ liệu trạng thái, dùng để đọc.

Đọc dữ liệu từ một tài khoản Solana bao gồm hai bước:

  1. Lấy tài khoản bằng cách sử dụng địa chỉ của nó
  2. Giải mã trường dữ liệu của tài khoản từ các byte thô thành cấu trúc dữ liệu thích hợp, theo định nghĩa của chương trình sở hữu tài khoản.

Chủ sở hữu

Trường này chứa ID chương trình của chủ sở hữu tài khoản.

Mỗi tài khoản Solana có một chương trình được chỉ định làm chủ sở hữu. Chủ sở hữu tài khoản là chương trình duy nhất có thể thay đổi dữ liệu của tài khoản hoặc trừ lamports, theo chỉ dẫn của chương trình.

(Trong trường hợp program account, chủ sở hữu là loader program của nó.)

Có thể thực thi

Trường này chỉ ra liệu một tài khoản có phải là tài khoản program hay tài khoản dữ liệu

  • Nếu true: Tài khoản là tài khoản program
  • Nếu false: Tài khoản là tài khoản dữ liệu

Epoch thuê

Trường rent_epoch đã bị loại bỏ.

Trong quá khứ, trường này theo dõi khi nào một tài khoản cần phải trả rent. Tuy nhiên, cơ chế thu rent này đã bị loại bỏ.

Account Examples
// Example Token Mint Account
Account {
lamports: 1461600,
data.len: 82,
owner: TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb,
executable: false,
rent_epoch: 0,
data: 010000001e213c90625a7e643d9555bb01b6c3fe6416d7afd523ce8c7ddd9b923ceafb9d00000000000000000901010000001e213c90625a7e643d9555bb01b6,
}
// Example Token Program Account
Account {
lamports: 4513200894,
data.len: 134080,
owner: BPFLoader2111111111111111111111111111111111,
executable: true,
rent_epoch: 18446744073709551615,
data: 7f454c460201010000000000000000000300f70001000000d8f90000000000004000000000000000800902000000000000000000400038000400400009000800,
}

Các loại tài khoản

Có hai loại tài khoản cơ bản:

Sự phân tách này có nghĩa là mã thực thi của một chương trình và trạng thái của nó được lưu trữ trong các tài khoản riêng biệt. (Tương tự như các hệ điều hành, thường có các tệp riêng biệt cho chương trình và dữ liệu của chúng.)

Tài khoản program

Mỗi chương trình đều thuộc sở hữu của một chương trình tải, được sử dụng để triển khai và quản lý tài khoản. Khi một chương trình mới được triển khai, một tài khoản được tạo ra để lưu trữ mã có thể thực thi của nó. Đây được gọi là tài khoản program. (Để đơn giản, bạn có thể coi tài khoản program chính là bản thân chương trình.)

Trong sơ đồ dưới đây, bạn có thể thấy một chương trình tải được sử dụng để triển khai một tài khoản program. Trường data của tài khoản program chứa mã chương trình có thể thực thi.

Sơ đồ của một tài khoản program, 4 thành phần của nó và chương trình tải của nó.Sơ đồ của một tài khoản program, 4 thành phần của nó và chương trình tải của nó.

Tài khoản dữ liệu program

Các chương trình được triển khai bằng loader-v3 không chứa mã chương trình trong trường data của chúng. Thay vào đó, trường data của chúng trỏ đến một tài khoản dữ liệu program riêng biệt, chứa mã chương trình. (Xem sơ đồ bên dưới.)

Một program account với dữ liệu. Dữ liệu trỏ đến một program data account riêng biệtMột program account với dữ liệu. Dữ liệu trỏ đến một program data account riêng biệt

Trong quá trình triển khai hoặc nâng cấp chương trình, các tài khoản đệm được sử dụng để tạm thời lưu trữ quá trình tải lên.

Ví dụ dưới đây lấy thông tin tài khoản Token Program. Lưu ý rằng trường executable được đặt thành true, cho biết tài khoản này là một chương trình.

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);
Console
Click to execute the code.

Tài khoản dữ liệu

Tài khoản dữ liệu không chứa mã thực thi. Thay vào đó, chúng lưu trữ thông tin.

Tài khoản trạng thái chương trình

Các chương trình sử dụng tài khoản dữ liệu để duy trì trạng thái của chúng. Để làm điều này, trước tiên họ phải tạo một tài khoản dữ liệu mới. Quá trình tạo tài khoản trạng thái chương trình thường được trừu tượng hóa, nhưng việc hiểu quy trình cơ bản là hữu ích.

Để quản lý trạng thái của mình, một chương trình mới phải:

  1. Gọi System Program để tạo một tài khoản. (System Program sau đó chuyển quyền sở hữu cho chương trình mới.)
  2. Khởi tạo dữ liệu tài khoản, như được định nghĩa bởi các hướng dẫn của nó.

Sơ đồ của một tài khoản dữ liệu thuộc sở hữu của một program accountSơ đồ của một tài khoản dữ liệu thuộc sở hữu của một program account

Ví dụ dưới đây tạo và lấy thông tin một tài khoản Token Mint thuộc sở hữu của chương trình 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);
Console
Click to execute the code.

Tài khoản hệ thống

Không phải tất cả các tài khoản đều được gán một chủ sở hữu mới sau khi được tạo bởi System Program. Các tài khoản thuộc sở hữu của System Program được gọi là tài khoản hệ thống. Tất cả các tài khoản ví đều là tài khoản hệ thống, điều này cho phép chúng thanh toán phí giao dịch.

Một ví thuộc sở hữu của System Program chứa 1.000.000 lamportsMột ví thuộc sở hữu của System Program chứa 1.000.000 lamports

Khi SOL được gửi đến một địa chỉ mới lần đầu tiên, một tài khoản được tạo tại địa chỉ đó thuộc sở hữu của System Program.

Trong ví dụ dưới đây, một keypair mới được tạo và được cấp SOL. Sau khi chạy mã, bạn có thể thấy địa chỉ của owner của tài khoản là 11111111111111111111111111111111 (tức System Program).

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);
Console
Click to execute the code.

Tài khoản Sysvar

Tài khoản Sysvar tồn tại tại các địa chỉ được xác định trước và cung cấp quyền truy cập vào dữ liệu trạng thái của cụm. Chúng cập nhật động với dữ liệu về cụm mạng. Xem danh sách đầy đủ các Tài khoản Sysvar.

Ví dụ dưới đây lấy và giải mã dữ liệu từ tài khoản 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);
Console
Click to execute the code.

Is this page helpful?

Quản lý bởi

© 2025 Solana Foundation.
Đã đăng ký bản quyền.
Kết nối
Tài khoản | Solana