Clonar Cuentas de Mainnet

Inicializa solana-test-validator con datos reales de cuentas de mainnet para que las pruebas locales ejerciten los layouts de programas de producción y el estado de los oráculos.

Receta

Tarjeta de receta de referencia rápida - lista para copiar y pegar.

solana-test-validator --reset \
  --url mainnet-beta \
  --clone <PUBKEY_DE_CUENTA> \
  --clone <ID_DE_PROGRAMA>

Cuándo usar esto:

• Integrando con Raydium, Orca, Pyth u otros programas desplegados.
• Probando rutas de CPI contra bytecode real sin tarifas de mainnet.
• Reproduciendo un error de layout de cuenta de mainnet localmente.
• Validando parsers contra estructuras de mint/metadatos en vivo.

Ejemplo de Trabajo

# Ejemplo: clonar el programa SPL Token y un mint de USDC (verificar pubkeys actuales en la documentación)
TOKEN_PROGRAM=TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
USDC_MINT=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
 
solana-test-validator --reset \
  --url mainnet-beta \
  --clone "$TOKEN_PROGRAM" \
  --clone "$USDC_MINT"
 
solana config set --url http://127.0.0.1:8899
solana account "$USDC_MINT"

Lo que esto demuestra:

• El validador captura instantáneamente los datos de la cuenta al inicio desde el RPC de --url.
• Los programas clonados ejecutan bytecode real de mainnet localmente.
• Tus transacciones pueden hacer CPI a programas clonados como en mainnet.

Análisis Profundo

Cómo Funciona

• En el génesis, el validador obtiene vía RPC los lamports, propietario, datos y el flag de ejecutable de cada pubkey de --clone.
• Las cuentas grandes aumentan el tiempo de inicio y el tamaño del ledger local.
• El estado clonado es estático hasta que tus transacciones locales lo mutan.
• Algunas cuentas dependen de otras - clona el grafo de dependencias cuidadosamente.

Planificación de Clonación

Notas de bash

# Clonar muchas cuentas desde un archivo (una pubkey por línea)
solana-test-validator --reset --url mainnet-beta \
  $(awk '{print "--clone "$1}' accounts.txt)

Errores Comunes

• Datos de clonación obsoletos - las reservas difieren de mainnet en vivo minutos después. Solución: actualiza las clones para pruebas sensibles al precio o usa el fork de Surfpool.
• Cuentas dependientes faltantes - la CPI falla con cuenta faltante. Solución: clona todas las cuentas en la lista de cuentas de la instrucción.
• RPC de mainnet con límite de tasa - la clonación falla al inicio. Solución: usa el RPC del proveedor con clave API en --url.
• Asumir que la clonación se actualiza en vivo - la clonación local no se sincroniza automáticamente con mainnet. Solución: reinicia el validador para volver a obtener los datos.
• Clonar carteras de tokens completas - hinchazón innecesaria. Solución: conjunto mínimo de mnts/ATAs que tu programa toca.

Alternativas

Preguntas Frecuentes

Relacionado

• solana-test-validator - flags de clonación
• Surfpool - flujo de fork
• Cargar Programas y Fixtures - inicialización complementaria
• Integraciones DeFi - objetivos comunes de CPI

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.