Contas

Todos os dados na rede Solana são armazenados em contas. Você pode pensar na rede Solana como um banco de dados público com uma única tabela de Contas. A relação entre uma conta e seu endereço é semelhante à de um par chave-valor, onde a chave é o endereço e o valor é a conta.

Cada conta tem a mesma estrutura básica e pode ser localizada usando seu endereço.

Diagrama de 3 contas e seus endereços. Inclui a definição da estrutura da conta.Diagrama de 3 contas e seus endereços. Inclui a definição da estrutura da conta.

Endereço da conta

O endereço da conta é um ID único de 32 bytes usado para localizar a conta na blockchain Solana. Os endereços das contas são frequentemente mostrados como strings codificadas em base58. A maioria das contas usa uma chave pública Ed25519 como seu endereço, mas isso não é obrigatório, já que a Solana também suporta endereços derivados de programa.

Uma conta com seu endereço de chave pública codificado em base58Uma conta com seu endereço de chave pública codificado em base58

Chave pública

O exemplo abaixo demonstra como usar o SDK da Solana para criar um 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

Um Program Derived Address (PDA) é um endereço que é deterministicamente derivado usando um ID de programa e uma ou mais entradas opcionais (seeds). O exemplo abaixo demonstra como usar o SDK da Solana para criar um 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.

Estrutura da conta

Cada Account tem um tamanho máximo de 10MiB e contém as seguintes informações:

  • lamports: O número de lamports na conta
  • data: Os dados da conta
  • owner: O ID do programa que possui a conta
  • executable: Indica se a conta contém binário executável
  • rent_epoch: O campo rent epoch obsoleto
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

O saldo da conta em lamports.

Cada conta deve ter um saldo mínimo de lamports, chamado de rent, que permite que seus dados sejam armazenados na blockchain. O rent é proporcional ao tamanho da conta.

Embora este saldo seja chamado de rent, ele funciona mais como um depósito, já que o saldo completo pode ser recuperado quando a conta é fechada. (O nome "rent" vem do campo rent epoch agora obsoleto.)

(Veja a fórmula do saldo mínimo e as constantes aplicáveis.)

Dados

Este campo é comumente referido como "dados da conta". Os data neste campo são considerados arbitrários, pois podem conter qualquer sequência de bytes. Cada programa define a estrutura dos dados armazenados neste campo.

  • Program accounts: Este campo contém código de programa executável ou o endereço de uma program data account que armazena o código de programa executável.
  • Data accounts: Este campo geralmente armazena dados de estado, destinados a serem lidos.

A leitura de dados de uma conta Solana envolve duas etapas:

  1. Buscar a conta usando seu endereço
  2. Desserializar o campo data da conta de bytes brutos para a estrutura de dados apropriada, conforme definido pelo programa que possui a conta.

Proprietário

Este campo contém o ID do programa que é proprietário da conta.

Cada conta Solana tem um programa designado como seu proprietário. O proprietário da conta é o único programa que pode alterar os data da conta ou deduzir lamports, conforme indicado pelas instruções do programa.

(No caso de um program account, o proprietário é seu programa carregador.

Executável

Este campo indica se uma conta é uma conta de programa ou uma conta de dados

  • Se true: A conta é uma conta de programa
  • Se false: A conta é uma conta de dados

Época de aluguel

O campo rent_epoch está obsoleto.

No passado, este campo rastreava quando uma conta precisaria pagar rent. No entanto, este mecanismo de cobrança de rent foi descontinuado desde então.

Lamports

O saldo da conta em lamports.

Cada conta deve ter um saldo mínimo de lamports, chamado de rent, que permite que seus dados sejam armazenados na blockchain. O rent é proporcional ao tamanho da conta.

Embora este saldo seja chamado de rent, ele funciona mais como um depósito, já que o saldo completo pode ser recuperado quando a conta é fechada. (O nome "rent" vem do campo rent epoch agora obsoleto.)

(Veja a fórmula do saldo mínimo e as constantes aplicáveis.)

Dados

Este campo é comumente referido como "dados da conta". Os data neste campo são considerados arbitrários, pois podem conter qualquer sequência de bytes. Cada programa define a estrutura dos dados armazenados neste campo.

  • Program accounts: Este campo contém código de programa executável ou o endereço de uma program data account que armazena o código de programa executável.
  • Data accounts: Este campo geralmente armazena dados de estado, destinados a serem lidos.

A leitura de dados de uma conta Solana envolve duas etapas:

  1. Buscar a conta usando seu endereço
  2. Desserializar o campo data da conta de bytes brutos para a estrutura de dados apropriada, conforme definido pelo programa que possui a conta.

Proprietário

Este campo contém o ID do programa que é proprietário da conta.

Cada conta Solana tem um programa designado como seu proprietário. O proprietário da conta é o único programa que pode alterar os data da conta ou deduzir lamports, conforme indicado pelas instruções do programa.

(No caso de um program account, o proprietário é seu programa carregador.

Executável

Este campo indica se uma conta é uma conta de programa ou uma conta de dados

  • Se true: A conta é uma conta de programa
  • Se false: A conta é uma conta de dados

Época de aluguel

O campo rent_epoch está obsoleto.

No passado, este campo rastreava quando uma conta precisaria pagar rent. No entanto, este mecanismo de cobrança de rent foi descontinuado desde então.

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 contas

Existem duas categorias básicas nas quais as contas se enquadram:

Esta separação significa que o código executável de um programa e seu estado são armazenados em contas separadas. (Semelhante aos sistemas operacionais, que normalmente têm arquivos separados para programas e seus dados.)

Contas de programa

Cada programa é de propriedade de um programa carregador, que é usado para implantar e gerenciar a conta. Quando um novo programa é implantado, uma conta é criada para armazenar seu código executável. Isso é chamado de program account. (Para simplificar, você pode considerar o program account como sendo o próprio programa.)

No diagrama abaixo, você pode ver que um programa carregador é usado para implantar uma conta de programa. O campo data da conta de programa contém o código executável do programa.

Diagrama de uma conta de programa, seus 4 componentes e seu programa carregador.Diagrama de uma conta de programa, seus 4 componentes e seu programa carregador.

Contas de dados do programa

Programas implantados usando o loader-v3 não contêm código de programa em seu campo data. Em vez disso, seu data aponta para uma conta de dados do programa separada, que contém o código do programa. (Veja o diagrama abaixo.)

Uma conta de programa com dados. Os dados apontam para uma conta de dados de programa separadaUma conta de programa com dados. Os dados apontam para uma conta de dados de programa separada

Durante a implantação ou atualizações de programas, contas buffer são usadas para preparar temporariamente o upload.

O exemplo abaixo busca a conta do Token Program. Observe que o campo executable está definido como true, indicando que a conta é um 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.

Contas de dados

Contas de dados não contêm código executável. Em vez disso, elas armazenam informações.

Conta de estado do programa

Os programas usam contas de dados para manter seu estado. Para isso, eles devem primeiro criar uma nova conta de dados. O processo de criação de uma conta de estado do programa é frequentemente abstraído, mas é útil entender o processo subjacente.

Para gerenciar seu estado, um novo programa deve:

  1. Invocar o System Program para criar uma conta. (O System Program então transfere a propriedade para o novo programa.)
  2. Inicializar os dados da conta, conforme definido por suas instruções.

Diagrama de uma conta de dados possuída por uma conta de programaDiagrama de uma conta de dados possuída por uma conta de programa

O exemplo abaixo cria e busca uma conta Token Mint possuída pelo 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.

Contas do sistema

Nem todas as contas recebem um novo proprietário após serem criadas pelo System Program. Contas possuídas pelo System Program são chamadas de contas do sistema. Todas as contas de carteira são contas do sistema, o que permite que elas paguem taxas de transação.

Uma carteira possuída pelo System Program contendo 1.000.000 lamportsUma carteira possuída pelo System Program contendo 1.000.000 lamports

Quando SOL é enviado para um novo endereço pela primeira vez, uma conta é criada nesse endereço, possuída pelo System Program.

No exemplo abaixo, um novo keypair é gerado e financiado com SOL. Após executar o código, você pode ver que o endereço do owner da conta é 11111111111111111111111111111111 (o 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.

Contas Sysvar

As contas Sysvar existem em endereços predefinidos e fornecem acesso aos dados de estado do cluster. Elas são atualizadas dinamicamente com dados sobre o cluster da rede. Veja a lista completa de Contas Sysvar.

O exemplo abaixo busca e desserializa dados da conta 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?

Índice

Editar Página

Gerenciado por

© 2025 Fundação Solana.
Todos os direitos reservados.
Contas | Solana