PDAs como Autoridades

Los PDAs actúan comúnmente como autoridades de acuñación (mint), autoridades de congelación (freeze), propietarios de bóvedas (vault owners) y custodios de escrows. El programa aplica cuándo el PDA puede firmar a través de la lógica de negocio.

Receta

// Semillas de la autoridad de acuñación PDA: [b"mint_auth", mint.key.as_ref()]

Cuándo recurrir a esto:

• Al lanzar tokens con acuñación controlada por el programa.
• Al mantener fondos de usuarios en escrow hasta que se cumplan las condiciones.
• Cuentas del tesoro para tarifas del protocolo.

Ejemplo de Trabajo

// Conceptual: el programa verifica las condiciones del escrow y luego firma la transferencia de tokens desde el PDA del escrow
pub fn release_escrow(bump: u8, /* accounts */) -> ProgramResult {
    // validar caducidad, firmas, máquina de estados
    // CPI de transfer_checked con semillas invoke_signed &[&[b"escrow", &[bump]]]
    // (spl_token::instruction::transfer está obsoleto y rechaza Token-2022)
    Ok(())
}

Lo que esto demuestra:

• Las reglas de negocio controlan la firma del PDA.
• El PDA de escrow contiene tokens SPL.
• Se verifica la máquina de estados antes de la CPI.

Análisis Profundo

Patrones

Riesgo

Error en el programa = compromiso total de la autoridad.

Notas de Rust

// Nunca expongas un wrapper arbitrario de invoke_signed sin comprobaciones.

Errores Comunes

• Wrapper de CPI arbitrario - Cualquiera activa la firma del PDA. Solución: Vincular a manejadores de instrucciones.
• Escrow sin caducidad - Fondos bloqueados para siempre. Solución: Rutas de tiempo o cancelación.
• PDA de autoridad compartida - Una brecha afecta a todos los usuarios. Solución: Aislamiento de semillas por usuario.
• Autoridad de acuñación no revocada - Riesgo de acuñación infinita. Solución: Revocar después de la configuración.
• Desajuste del propietario de la cuenta de token - El PDA debe ser el propietario de la cuenta de token. Solución: Validar ATA.

Alternativas

Preguntas Frecuentes

Relacionado

• Bóveda y Escrow - Patrones
• CPI a SPL Token - Operaciones de token
• Control de Acceso y Autoridades - Roles

Versiones de la pila: 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.

383k393a3c3q3e393a3o1r3e3k3x383c3e3k1v1z223x1v1t1v1z1t20