Modelo de cuenta de Solana

En Solana, todos los datos se almacenan en lo que se llaman "cuentas". Puedes pensar en los datos en Solana como una base de datos pública con una única tabla "Cuentas", donde cada entrada en esta tabla es una "cuenta". Cada cuenta de Solana comparte el mismo tipo de Cuenta base.

Cuentas Cuentas

Puntos clave

Las cuentas pueden almacenar hasta 10MiB de datos, que contienen código de programa ejecutable o estado del programa.
Las cuentas requieren un depósito de rent en lamports (SOL) que es proporcional a la cantidad de datos almacenados, y puedes recuperarlo completamente cuando cierras la cuenta.
Cada cuenta tiene un propietario de programa. Solo el programa que posee una cuenta puede cambiar sus datos o deducir su saldo de lamports. Pero cualquiera puede aumentar el saldo.
Cuentas sysvar son cuentas especiales que almacenan el estado del clúster de la red.
Cuentas de programa almacenan el código ejecutable de los contratos inteligentes.
Cuentas de datos son creadas por programas para almacenar y gestionar el estado del programa.

Cuenta

Cada cuenta en Solana tiene una dirección única de 32 bytes, a menudo mostrada como una cadena codificada en base58 (por ejemplo, 14grJpemFaf88c8tiVb77W7TYg2W3ir6pfkKz3YjhhZ5).

La relación entre la cuenta y su dirección funciona como un par clave-valor, donde la dirección es la clave para localizar los datos correspondientes en la cadena de la cuenta. La dirección de la cuenta actúa como el "ID único" para cada entrada en la tabla "Cuentas".

Dirección de cuenta

La mayoría de las cuentas de Solana utilizan una clave pública Ed25519 como su dirección.

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

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

ConsolePowered by Mirror

Click to execute the code.

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

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

ConsolePowered by Mirror

Click to execute the code.

Output

No output yet

Aunque las claves públicas se utilizan comúnmente como direcciones de cuenta, Solana también admite una función llamada Direcciones derivadas de programa (PDAs). Las PDAs son direcciones especiales que puedes derivar de manera determinista a partir de un ID de programa y entradas opcionales (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}`);

ConsolePowered by Mirror

Click to execute the code.

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

ConsolePowered by Mirror

Click to execute the code.

Output

No output yet

Tipo de cuenta

Las cuentas tienen un tamaño máximo de 10MiB y todas las cuentas en Solana comparten el mismo tipo base Account.

Tipo de cuenta

Cada cuenta en Solana tiene los siguientes campos:

data: Un array de bytes que almacena datos arbitrarios para una cuenta. Para cuentas no ejecutables, esto a menudo almacena el estado que se pretende leer. Para cuentas de programa (contratos inteligentes), contiene el código de programa ejecutable. El campo de datos es comúnmente llamado "datos de cuenta".
executable: Esta bandera muestra si una cuenta es un programa.
lamports: El saldo de la cuenta en lamports, la unidad más pequeña de SOL (1 SOL = 1 billón de lamports).
owner: El ID del programa (clave pública) del programa que posee esta cuenta. Solo el programa propietario puede cambiar los datos de la cuenta o deducir su saldo de lamports.
rent_epoch: Un campo heredado de cuando Solana tenía un mecanismo que periódicamente deducía lamports de las cuentas. Aunque este campo todavía existe en el tipo Account, ya no se utiliza desde que la recolección de rent fue descontinuada.

Base Account Type

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

ConsolePowered by Mirror

Click to execute the code.

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

ConsolePowered by Mirror

Click to execute the code.

Output

No output yet

Rent

Para almacenar datos en la cadena, las cuentas también deben mantener un saldo de lamport (SOL) que sea proporcional a la cantidad de datos almacenados en la cuenta (en bytes). Este saldo se llama "rent", pero funciona más como un depósito porque puedes recuperar el monto completo cuando cierras una cuenta. Puedes encontrar el cálculo aquí usando estas constantes.

El término "rent" proviene de un mecanismo obsoleto que deducía regularmente lamports de las cuentas que caían por debajo del umbral de rent. Este mecanismo ya no está activo.

Propietario del programa

En Solana, los "contratos inteligentes" se llaman programas. La propiedad del programa es una parte clave del Modelo de Cuenta de Solana. Cada cuenta tiene un programa designado como su propietario. Solo el programa propietario puede:

Cambiar el campo data de la cuenta
Deducir lamports del saldo de la cuenta

Programa del sistema

Por defecto, todas las cuentas nuevas pertenecen al Programa del Sistema. El Programa del Sistema realiza algunas funciones clave:

Creación de nuevas cuentas: Solo el Programa del Sistema puede crear nuevas cuentas.
Asignación de espacio: Establece la capacidad en bytes para el campo de datos de cada cuenta.
Transferencia / Asignación de propiedad del programa: Una vez que el Programa del Sistema crea una cuenta, puede reasignar el propietario del programa designado a una cuenta de programa diferente. Así es como los programas personalizados toman posesión de las nuevas cuentas creadas por el Programa del Sistema.

Todas las cuentas de "billetera" en Solana son simplemente cuentas propiedad del Programa del Sistema. El saldo de lamport en estas cuentas muestra la cantidad de SOL que posee la billetera. Solo las cuentas propiedad del Programa del Sistema pueden pagar tarifas de transacción.

Cuenta del sistema

Cuentas Sysvar

Las cuentas Sysvar son cuentas especiales en direcciones predefinidas que proporcionan acceso a datos del estado del clúster. Estas cuentas se actualizan dinámicamente con datos sobre el clúster de la red. Puedes encontrar la lista completa de cuentas Sysvar aquí.

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

ConsolePowered by Mirror

Click to execute the code.

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

ConsolePowered by Mirror

Click to execute the code.

Output

No output yet

Cuenta de programa

Desplegar un programa de Solana crea una cuenta de programa ejecutable. La cuenta del programa almacena el código ejecutable del programa.

Las cuentas de programa son propiedad de un Programa cargador.

Cuenta de programa

Para simplificar, puedes tratar la cuenta del programa como el programa en sí. Cuando invocas las instrucciones de un programa, especificas la dirección de la cuenta del programa (comúnmente llamada "ID del 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);

ConsolePowered by Mirror

Click to execute the code.

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

ConsolePowered by Mirror

Click to execute the code.

Output

No output yet

Cuando despliegas un programa de Solana, se almacena en una cuenta de programa. Las cuentas de programa son propiedad de un Programa cargador. Hay varias versiones del cargador, pero todas excepto loader-v3 almacenan el código ejecutable directamente en la cuenta del programa. Loader-v3 almacena el código ejecutable en una "cuenta de datos del programa" separada y la cuenta del programa solo apunta a esta. Cuando despliegas un nuevo programa, la CLI de Solana usa la última versión del cargador por defecto.

Cuenta buffer

Loader-v3 tiene un tipo de cuenta especial para almacenar temporalmente la carga de un programa durante el despliegue o redespliegue/actualizaciones. En loader-v4, todavía hay buffers, pero son simplemente cuentas de programa normales.

Cuenta de datos del programa

Loader-v3 funciona de manera diferente a todos los demás programas BPF Loader. La cuenta del programa solo contiene la dirección de una cuenta de datos del programa, que almacena el código ejecutable real:

Cuenta de datos del programa

No confundas estas cuentas de datos del programa con las cuentas de datos de los programas (ver más abajo).

Cuenta de datos

En Solana, el código ejecutable de un programa se almacena en una cuenta diferente a la del estado del programa. Esto es similar a cómo los sistemas operativos típicamente tienen archivos separados para los programas y sus datos.

Para mantener el estado, los programas definen instrucciones para crear cuentas separadas que ellos poseen. Cada una de estas cuentas tiene su propia dirección única y puede almacenar cualquier dato arbitrario definido por el programa.

Cuenta de datos

Ten en cuenta que solo el Programa del Sistema puede crear nuevas cuentas. Una vez que el Programa del Sistema crea una cuenta, puede transferir o asignar la propiedad de la nueva cuenta a otro programa.

En otras palabras, crear una cuenta de datos para un programa personalizado requiere dos pasos:

Invocar al Programa del Sistema para crear una cuenta, luego transferir la propiedad al programa personalizado
Invocar al programa personalizado, que ahora posee la cuenta, para inicializar los datos de la cuenta según lo definido por la instrucción del programa

Este proceso de creación de cuentas a menudo se abstrae como un solo paso, pero es útil entender el proceso subyacente.

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

ConsolePowered by Mirror

Click to execute the code.

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

ConsolePowered by Mirror

Click to execute the code.

Output

No output yet

Tabla de Contenidos