Mejores prácticas del modelo de cuentas

Diseña diseños de cuentas que escalen, se mantengan seguros y minimicen los costos de alquiler y cómputo en Agave 4.1.1.

Cómo usar esta lista

• Aplica A antes de escribir tu primera struct #[account]
• Revisa B antes de la auditoría de seguridad de lanzamiento a mainnet
• Usa C al optimizar CU y alquiler a escala

A - Diseño del layout

• Una entidad lógica por cuenta. Fragmenta el estado del usuario a través de PDAs, no una cuenta de mapa global.
• Usa InitSpace + max_len para campos variables. Nunca adivines los tamaños de String/Vec en Anchor 0.32.1.
• Incluye un byte version cuando el esquema vaya a evolucionar. Los cambios de campos anexables evitan la ruptura de la deserialización.
• Dimensiona las cuentas a máximos realistas, no infinitos. El alquiler y la CU escalan con los bytes.

B - Seguridad

• Cada cuenta mut tiene verificaciones de propietario y autoridad. Account<T>, has_one, seeds, o constraint explícito.
• Evita UncheckedAccount sin restricciones. Trátalo como culpable hasta que se demuestre que es válido.
• Valida que los firmantes coincidan con las autoridades almacenadas. Signer + has_one juntos, no uno solo.
• Cierra las cuentas cuando finaliza su ciclo de vida. Devuelve el alquiler a los usuarios; evita sumideros de lamports huérfanos.
• Nunca aceptes cuentas de víctima solo por su pubkey. El atacante pasa las cuentas de otros si faltan las restricciones.

C - Operaciones

• Consulta getMinimumBalanceForRentExemption en los clientes. No codifiques en exceso los lamports de alquiler.
• Usa realloc con moderación y un plan de migración. Prefiere nuevos tipos de cuenta para cambios disruptivos.
• Emite eventos al crear/cerrar. Los indexadores dependen de las señales del ciclo de vida.
• Documenta las semillas de PDA en IDL/docs. La derivación del cliente debe coincidir exactamente con las seeds en la cadena.
• Filtra getProgramAccounts por discriminador. Reduce la carga útil de RPC y el trabajo de decodificación del cliente.

Preguntas frecuentes

Relacionado

• Conceptos básicos del modelo de cuentas - patrones prácticos
• Propiedad y permisos de cuentas - reglas de seguridad
• Cuentas de datos y layout - guía de dimensionamiento

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.