Firmar con PDAs

Las PDAs firman las CPIs a través de slices de semillas pasados a CpiContext::new_with_signer. Las semillas deben coincidir con las restricciones de PDA utilizadas en la inicialización.

Receta

let seeds: &[&[u8]] = &[b"vault", &[ctx.bumps.vault]];
let signer: &[&[&[u8]]] = &[seeds];
 
token_interface::transfer_checked(
    CpiContext::new_with_signer(
        ctx.accounts.token_program.to_account_info(),
        accounts,
        signer,
    ),
    amount,
    decimals,
)?;

invoke_signed y new_with_signer ambos toman &[&[&[u8]]]: el slice exterior contiene un grupo de semillas por PDA, y cada grupo es la lista de semillas para esa PDA terminando en su byte de bump.

Cuándo usar esto: Una PDA es la autoridad sobre cuentas de tokens o posee SOL que se está transfiriendo.

Ejemplo de Trabajo

use anchor_lang::prelude::*;
use anchor_spl::token_interface::{
    self, Mint, TokenAccount, TokenInterface, TransferChecked,
};
 
#[account]
pub struct Vault {
    pub authority: Pubkey,
    pub bump: u8,
}
 
#[derive(Accounts)]
pub struct VaultWithdraw<'info> {
    #[account(seeds = [b"vault", vault.authority.as_ref()], bump = vault.bump)]
    pub vault: Account<'info, Vault>,
    #[account(mut, token::mint = mint, token::authority = vault)]
    pub vault_ata: InterfaceAccount<'info, TokenAccount>,
    #[account(mut, token::mint = mint)]
    pub user_ata: InterfaceAccount<'info, TokenAccount>,
    pub mint: InterfaceAccount<'info, Mint>,
    pub token_program: Interface<'info, TokenInterface>,
}
 
pub fn vault_withdraw(ctx: Context<VaultWithdraw>, amount: u64) -> Result<()> {
    // Vincula la Pubkey a una variable local primero. `ctx.accounts.vault.authority` es
    // una Pubkey por valor; llamar a `.as_ref()` en una temporal dentro del array de semillas
    // es un error de préstamo E0716.
    let authority_key = ctx.accounts.vault.authority;
    let bump = ctx.accounts.vault.bump;
    let seeds: &[&[u8]] = &[b"vault", authority_key.as_ref(), &[bump]];
    let signer_seeds: &[&[&[u8]]] = &[seeds];
 
    token_interface::transfer_checked(
        CpiContext::new_with_signer(
            ctx.accounts.token_program.to_account_info(),
            TransferChecked {
                from: ctx.accounts.vault_ata.to_account_info(),
                mint: ctx.accounts.mint.to_account_info(),
                to: ctx.accounts.user_ata.to_account_info(),
                authority: ctx.accounts.vault.to_account_info(),
            },
            signer_seeds,
        ),
        amount,
        ctx.accounts.mint.decimals,
    )?;
    Ok(())
}

Lo que esto demuestra:

• Las semillas del firmante son slices anidados &[&[&[u8]]] - un grupo interno por PDA
• Vincula valores Pubkey a un let antes de .as_ref() en el array de semillas
• El bump debe ser canónico; léelo del campo almacenado
• La información de la cuenta de la PDA es el metadato de autoridad
• transfer_checked / TransferChecked - anchor_spl::token::{transfer, Transfer} están obsoletos, y el spl_token::instruction::transfer que construyen rechaza directamente el ID del programa Token-2022

Análisis Profundo

invoke_signed vs CPI de Anchor

Los ayudantes de CPI de Anchor aceptan with_signer para la misma semántica que invoke_signed nativo.

PDAs Multi-semilla

Incluye cada elemento de semilla en el mismo orden utilizado en #[account(seeds = [...])].

Errores Comunes

• Bump incorrecto en el array de firmantes - La firma de la CPI falla. Solución: Usa el bump almacenado o ctx.bumps.
• Componente de semilla faltante - Desajuste de la dirección derivada. Solución: Copia las semillas de la restricción exactamente.
• Metadato de autoridad no es una cuenta PDA - El programa de tokens rechaza. Solución: Pasa la PDA de la bóveda como autoridad.
• Reutilización incorrecta del buffer de semillas - Problemas de tiempo de vida/préstamo. Solución: Construye el array de semillas por llamada a CPI.
• La PDA firma sin restricción en la cuenta - El atacante sustituye la PDA. Solución: Valida las semillas en la cadena.

Alternativas

Preguntas Frecuentes

Relacionados

• CPIs Firmadas - Patrones de CPI
• Autoridades de PDA - Mints y bóvedas
• Almacenamiento de Bumps - Bump canónico

Versiones de Stack: Esta página fue 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, y LiteSVM 0.6.x.