Gestión de Lanzamientos Frontend

La dApp de Solana es la mitad del producto: los lanzamientos de Next.js transportan URLs de RPC, IDs de programa, flags de características y versiones de adaptadores de billetera. Despliegues de frontend desincronizados causan más dolor al usuario que muchos errores en la cadena.

Receta

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

# .env.production
NEXT_PUBLIC_CLUSTER=mainnet-beta
NEXT_PUBLIC_RPC_URL=https://your-mainnet-rpc.example
NEXT_PUBLIC_PROGRAM_ID=Hx7k...
NEXT_PUBLIC_IDL_VERSION=2.4.0

import { createSolanaRpc } from "@solana/kit";
const rpc = createSolanaRpc(process.env.NEXT_PUBLIC_RPC_URL!);

Cuándo usar esto:

• Al enviar cambios de UI independientes de la actualización del programa
• Al rotar el proveedor de RPC sin desplegar el programa
• Estrategia de CDN y caché para la semana de lanzamiento
• Reversión de un incidente de error solo en el cliente
• Pruebas A/B de patrones de UX de transacciones

Ejemplo Funcional

// lib/solana-config.ts - validar al cargar el módulo
const cluster = process.env.NEXT_PUBLIC_CLUSTER;
const programId = process.env.NEXT_PUBLIC_PROGRAM_ID;
const rpcUrl = process.env.NEXT_PUBLIC_RPC_URL;
 
if (!cluster || !programId || !rpcUrl) {
  throw new Error("Variables de entorno de Solana faltantes");
}
 
if (process.env.VERCEL_ENV === "preview" && cluster === "mainnet-beta") {
  throw new Error("Las compilaciones de vista previa no pueden apuntar a mainnet");
}
 
export const solanaConfig = { cluster, programId, rpcUrl };

Lo que esto demuestra:

• Validación de entorno de fallo rápido en el cliente @solana/kit 7.0.0
• Bloqueo de despliegues de vista previa desde el clúster principal
• Módulo de configuración único importado por las rutas de la aplicación y la API

Análisis Profundo

Tren de Lanzamiento

1. Fusionar a main -> despliegue en staging (RPC de devnet)
2. Prueba: conexión de billetera, simulación de flujos principales
3. Promocionar a producción con grupo de entorno de producción
4. Etiquetar dapp-v1.2.3 vinculado a IDL_VERSION

RPC en Frontend

Trampas Comunes

• NEXT_PUBLIC_ expone secretos - Nunca pongas claves de API en el entorno público. Solución: Entorno solo del servidor para la ruta de envío.
• Caché ISR obsoleta - Se sirve un ID de programa antiguo. Solución: Revalidar en el webhook de despliegue.
• Desfase del adaptador de billetera - Rompe la conexión de billetera después de un aumento de dependencia. Solución: Fijar versiones de adaptador en el archivo de bloqueo.
• Actualización de programa sin cliente - Los usuarios acceden a la distribución incorrecta. Solución: Puerta de versión IDL en la UI.
• A/B sin persistencia de cohorte - Ruta de transacción inconsistente. Solución: Cohete hash de billetera (ver página de flags de características).

Alternativas

Preguntas Frecuentes

Relacionado

• Flags de Características y Despliegue Progresivo - habilitación gradual
• Promoción de Devnet a Mainnet - promoción de entornos
• Proveedores y App Router - integración de Next.js

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.