CPI para o Programa do Sistema

O Programa do Sistema lida com a criação, atribuição, alocação de contas e transferências de lamports. A maioria dos programas faz CPI para ele para pagamento de aluguel e movimentação de SOL.

Receita

invoke(
  &system_instruction::transfer(from.key, to.key, amount),
  &[from.clone(), to.clone()],
)?;

Quando usar isso:

• Pagando aluguel para novas contas.
• Movendo SOL para tesouraria ou usuários.
• Fechando contas e retornando aluguel.

Exemplo de Trabalho

let rent = Rent::get()?;
let lamports = rent.minimum_balance(space);
invoke(
  &system_instruction::create_account(payer.key, new.key, lamports, space as u64, owner),
  &[payer.clone(), new.clone(), system_program.clone()],
)?;

O que isso demonstra:

• Sysvar de aluguel para saldo mínimo.
• create_account define o programa proprietário.
• O pagador assina a transferência/criação.

Mergulho Profundo

Instruções Comuns

Notas de Rust

use solana_program::system_program;

Armadilhas

• Transferência de PDA sem assinatura - Falha. Correção: invoke_signed.
• Criar em existente - Falha se lamports > 0. Correção: Verificar conta vazia.
• Lamports insuficientes - Transferência/criação falha. Correção: Verificações de saldo.
• Parâmetro de proprietário errado - Conta presa com proprietário errado. Correção: Passe seu ID de programa.
• Aluguel não isento - Subfinanciamento de uma nova conta falha a transação com InsufficientFundsForRent; o runtime impõe a isenção de aluguel na criação. (A coleta/recolhimento de aluguel não está mais ativa, então a falha ocorre de imediato, não depois.) Correção: Financie Rent::get()?.minimum_balance(space).

Alternativas

FAQs

Relacionado

• Criando Contas via CPI - Padrões
• Cofre e Garantia - Custódia
• Padrões de Taxa e Tesouraria - Taxas

Versões do Stack: Esta página foi escrita para Agave 4.1.1, Solana CLI 3.0.10, Anchor 0.32.1, anchor-lang 0.32.1, Rust 1.91.1, @solana/kit 7.0.0, Surfpool 0.12.0, e LiteSVM 0.6.x. 636f64656775696465732e696f7c6367696f3334357c323032363037