Cuentas

Todos los datos en la red Solana se almacenan en cuentas. Puedes pensar en la red Solana como una base de datos pública con una única tabla de Cuentas. La relación entre una cuenta y su dirección es similar a la de un par clave-valor (key-value), donde la clave es la dirección y el valor es la cuenta.

Cada cuenta tiene la misma estructura básica y puede ser localizada usando su dirección.

Diagrama de 3 cuentas y sus direcciones. Incluye la definición de la estructura de cuenta.Diagrama de 3 cuentas y sus direcciones. Incluye la definición de la estructura de cuenta.

Dirección de cuenta

La dirección de la cuenta es un ID único de 32 bytes utilizado para localizar la cuenta en la cadena de bloques Solana. Las direcciones de cuenta a menudo se muestran como cadenas codificadas en base58. La mayoría de las cuentas utilizan una clave pública Ed25519 como su dirección, pero esto no es obligatorio, ya que Solana también admite direcciones derivadas de programas.

Una cuenta con su dirección de clave pública codificada en base58Una cuenta con su dirección de clave pública codificada en base58

Clave pública

El ejemplo a continuación demuestra cómo usar el SDK de Solana para crear un 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.

Dirección derivada de programa

Una dirección derivada de programa (PDA) es una dirección que se deriva determinísticamente utilizando un ID de programa y una o más entradas opcionales (semillas). El ejemplo a continuación demuestra cómo usar el SDK de Solana para crear una 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.

Estructura de cuenta

Cada Account tiene un tamaño máximo de 10MiB y contiene la siguiente información:

  • lamports: El número de lamports en la cuenta
  • data: Los datos de la cuenta
  • owner: El ID del programa que posee la cuenta
  • executable: Indica si la cuenta contiene un binario ejecutable
  • rent_epoch: El campo obsoleto epoch de alquiler
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

El saldo de la cuenta en lamports.

Cada cuenta debe tener un saldo mínimo de lamports, llamado rent, que permite que sus datos se almacenen en la cadena. El rent es proporcional al tamaño de la cuenta.

Aunque este saldo se llama rent, funciona más como un depósito, ya que el saldo completo puede recuperarse cuando se cierra la cuenta. (El nombre "rent" proviene del campo rent epoch ahora obsoleto.)

(Consulta la fórmula del saldo mínimo y las constantes aplicables.)

Datos

Este campo se conoce comúnmente como "datos de la cuenta". Los data en este campo se consideran arbitrarios ya que pueden contener cualquier secuencia de bytes. Cada programa define la estructura de los datos almacenados en este campo.

  • Program accounts: Este campo contiene código de programa ejecutable o la dirección de una cuenta de datos del programa que almacena el código de programa ejecutable.
  • Cuentas de datos: Este campo generalmente almacena datos de estado, destinados a ser leídos.

La lectura de datos de una cuenta de Solana implica dos pasos:

  1. Obtener la cuenta usando su dirección
  2. Deserializar el campo data de la cuenta desde bytes sin procesar a la estructura de datos apropiada, según lo definido por el programa que posee la cuenta.

Propietario

Este campo contiene el ID del programa propietario de la cuenta.

Cada cuenta de Solana tiene un programa designado como su propietario. El propietario de la cuenta es el único programa que puede cambiar los data de la cuenta o deducir lamports, según lo indicado por las instrucciones del programa.

(En el caso de un program account, el propietario es su programa cargador.)

Ejecutable

Este campo indica si una cuenta es una program account o una cuenta de datos

  • Si true: La cuenta es un program account
  • Si false: La cuenta es una cuenta de datos

Época de rent

El campo rent_epoch está obsoleto.

En el pasado, este campo rastreaba cuándo una cuenta necesitaría pagar rent. Sin embargo, este mecanismo de cobro de rent ha sido obsoleto desde entonces.

Lamports

El saldo de la cuenta en lamports.

Cada cuenta debe tener un saldo mínimo de lamports, llamado rent, que permite que sus datos se almacenen en la cadena. El rent es proporcional al tamaño de la cuenta.

Aunque este saldo se llama rent, funciona más como un depósito, ya que el saldo completo puede recuperarse cuando se cierra la cuenta. (El nombre "rent" proviene del campo rent epoch ahora obsoleto.)

(Consulta la fórmula del saldo mínimo y las constantes aplicables.)

Datos

Este campo se conoce comúnmente como "datos de la cuenta". Los data en este campo se consideran arbitrarios ya que pueden contener cualquier secuencia de bytes. Cada programa define la estructura de los datos almacenados en este campo.

  • Program accounts: Este campo contiene código de programa ejecutable o la dirección de una cuenta de datos del programa que almacena el código de programa ejecutable.
  • Cuentas de datos: Este campo generalmente almacena datos de estado, destinados a ser leídos.

La lectura de datos de una cuenta de Solana implica dos pasos:

  1. Obtener la cuenta usando su dirección
  2. Deserializar el campo data de la cuenta desde bytes sin procesar a la estructura de datos apropiada, según lo definido por el programa que posee la cuenta.

Propietario

Este campo contiene el ID del programa propietario de la cuenta.

Cada cuenta de Solana tiene un programa designado como su propietario. El propietario de la cuenta es el único programa que puede cambiar los data de la cuenta o deducir lamports, según lo indicado por las instrucciones del programa.

(En el caso de un program account, el propietario es su programa cargador.)

Ejecutable

Este campo indica si una cuenta es una program account o una cuenta de datos

  • Si true: La cuenta es un program account
  • Si false: La cuenta es una cuenta de datos

Época de rent

El campo rent_epoch está obsoleto.

En el pasado, este campo rastreaba cuándo una cuenta necesitaría pagar rent. Sin embargo, este mecanismo de cobro de rent ha sido obsoleto desde entonces.

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

Tipos de cuentas

Hay dos categorías básicas en las que se dividen las cuentas:

Esta separación significa que el código ejecutable de un programa y su estado se almacenan en cuentas separadas. (Similar a los sistemas operativos, que típicamente tienen archivos separados para programas y sus datos.)

Program accounts

Cada programa es propiedad de un programa cargador, que se utiliza para implementar y gestionar la cuenta. Cuando se implementa un nuevo programa, se crea una cuenta para almacenar su código ejecutable. Esto se llama program account. (Para simplificar, puedes considerar el program account como el programa en sí mismo.)

En el diagrama a continuación, puedes ver que se utiliza un programa cargador para implementar un program account. El campo data del program account contiene el código ejecutable del programa.

Diagrama de un program account, sus 4 componentes y su programa cargador.Diagrama de un program account, sus 4 componentes y su programa cargador.

Cuentas de datos del programa

Los programas implementados usando loader-v3 no contienen código de programa en su campo data. En su lugar, su data apunta a una cuenta de datos del programa separada, que contiene el código del programa. (Ver el diagrama a continuación.)

Una cuenta de programa con datos. Los datos apuntan a una cuenta de datos de programa separadaUna cuenta de programa con datos. Los datos apuntan a una cuenta de datos de programa separada

Durante la implementación o actualización de programas, se utilizan cuentas buffer para almacenar temporalmente la carga.

El ejemplo a continuación obtiene la cuenta del Token Program. Observa que el campo executable está configurado como true, lo que indica que la cuenta es un programa.

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.

Cuentas de datos

Las cuentas de datos no contienen código ejecutable. En su lugar, almacenan información.

Cuenta de estado del programa

Los programas utilizan cuentas de datos para mantener su estado. Para hacerlo, primero deben crear una nueva cuenta de datos. El proceso de creación de una cuenta de estado del programa a menudo está abstraído, pero es útil entender el proceso subyacente.

Para gestionar su estado, un nuevo programa debe:

  1. Invocar al System Program para crear una cuenta. (El System Program luego transfiere la propiedad al nuevo programa.)
  2. Inicializar los datos de la cuenta, según lo definido por sus instrucciones.

Diagrama de una cuenta de datos propiedad de una cuenta de programaDiagrama de una cuenta de datos propiedad de una cuenta de programa

El ejemplo a continuación crea y obtiene una cuenta Token Mint propiedad del programa 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.

Cuentas del sistema

No todas las cuentas reciben un nuevo propietario después de ser creadas por el System Program. Las cuentas propiedad del System Program se denominan cuentas del sistema. Todas las cuentas de billetera son cuentas del sistema, lo que les permite pagar tarifas de transacción.

Una billetera propiedad del System Program que contiene 1.000.000 de lamportsUna billetera propiedad del System Program que contiene 1.000.000 de lamports

Cuando se envía SOL a una nueva dirección por primera vez, se crea una cuenta en esa dirección propiedad del System Program.

En el ejemplo a continuación, se genera un nuevo keypair y se financia con SOL. Después de ejecutar el código, puedes ver que la dirección del owner de la cuenta es 11111111111111111111111111111111 (el 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.

Cuentas Sysvar

Las cuentas Sysvar existen en direcciones predefinidas y proporcionan acceso a datos del estado del clúster. Se actualizan dinámicamente con datos sobre el clúster de la red. Consulta la lista completa de Cuentas Sysvar.

El ejemplo a continuación obtiene y deserializa datos de la cuenta 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?

Tabla de Contenidos

Editar Página

Gestionado por

© 2025 Fundación Solana.
Todos los derechos reservados.
Conéctate