Cliente Agave
Agave 4.1.1 es el cliente validador de Solana de Anza: la implementación mainline para votación, reproducción de ledger y RPC. Ejecútalo cuando operes un validador de staking estándar o un nodo RPC privado.
Receta
Tarjeta de receta de referencia rápida, lista para copiar y pegar.
agave-install init 4.1.1
agave-validator --ledger /mnt/ledger \
--identity ~/.config/solana/identity.json \
--vote-account <CLAVE_PÚBLICA_CUENTA_VOTO> \
--rpc-port 8899 \
--full-rpc-api \
--no-voting # omite --no-voting para validadores que votanCuándo usar esto:
- Operar un validador de votación en mainnet-beta.
- Ejecutar RPC dedicado para tu organización.
- Mantenerse en el canal de lanzamiento soportado por Anza.
- Línea base antes de evaluar el híbrido Frankendancer.
Ejemplo de Trabajo
#!/usr/bin/env bash
# Inicio mínimo del validador Agave (ajusta las rutas)
LEDGER=/mnt/nvme/ledger
ACCOUNTS=/mnt/nvme/accounts
IDENTITY=~/.config/solana/identity.json
VOTE_ACCOUNT=Vote111111111111111111111111111111111111111
mkdir -p "$LEDGER" "$ACCOUNTS"
agave-validator \
--ledger "$LEDGER" \
--accounts "$ACCOUNTS" \
--identity "$IDENTITY" \
--vote-account "$VOTE_ACCOUNT" \
--known-validator <PUNTO_DE_ENTRADA_DE_CONFIANZA> \
--entrypoint entrypoint.mainnet-beta.solana.com:8001 \
--expected-genesis-hash <HASH_GENESIS_MAINNET> \
--full-rpc-api \
--rpc-bind-address 127.0.0.1 \
--rpc-port 8899 \
--dynamic-port-range 8000-8020 \
--limit-ledger-size 50000000Lo que esto demuestra:
- Ledger y cuentas en rutas NVMe rápidas.
--vote-accounthabilita la votación de consenso (omitir para RPC-only con--no-voting).- Puntos de entrada y hash de génesis fijan la red a mainnet-beta.
Análisis Profundo
Cómo Funciona
- Agave reproduce bloques, ejecuta transacciones en Sealevel SVM.
- Tower BFT rastrea votos en la cuenta de votos.
- La etapa de banca programa transacciones de la entrada TPU.
- RPC sirve APIs HTTP/WebSocket cuando
--full-rpc-apiestá habilitado.
Banderas Clave
| Bandera | Propósito |
|---|---|
--ledger | Ruta del almacén de bloques |
--accounts | Ruta de la base de datos de cuentas |
--vote-account | Clave pública de voto en cadena |
--no-voting | Nodo RPC sin votación |
--limit-ledger-size | Poda de límite de disco |
Notas de bash
agave-validator --ledger /mnt/ledger monitor # observar la sincronización
solana catchup --our-localhostErrores Comunes
- Disco lento - El ledger en HDD causa morosidad. Solución: NVMe para ledger + cuentas; ver página de hardware.
- Hash de génesis incorrecto - El nodo se niega a unirse al clúster. Solución: Usar el génesis oficial de mainnet de la documentación.
- Identidad en portátil caliente - Riesgo de robo de claves de la participación. Solución: Módulo de seguridad de hardware para claves de mainnet.
- Ledger ilimitado - Fallo por disco lleno. Solución:
--limit-ledger-size+ monitoreo. - RPC público sin firewall - Abuso y consumo de recursos. Solución: Vincular RPC a localhost o proxy con límite de tasa.
- Desfase de versión - Falta de actualización del clúster. Solución: Suscribirse a las notas de lanzamiento de Anza; reinicios escalonados.
Alternativas
| Alternativa | Usar Cuando | No Usar Cuando |
|---|---|---|
| Híbrido Frankendancer | Máximo rendimiento | Simplicidad de configuración inicial |
| Jito-Solana | Infraestructura MEV | Preferencia de operador no-MEV |
| Validador Alojado | Sin equipo de operaciones | Requisito de autocustodia completa |
Preguntas Frecuentes
¿Nomenclatura de CLI de agave vs solana?
Agave es el cliente validador; Solana CLI 3.0.10 sigue siendo la herramienta del operador de la distribución Anza.
¿Nodo solo RPC?
Ejecutar con --no-voting y omitir el requisito de cuenta de voto; aún sincroniza el ledger completo.
¿Cómo actualizar Agave?
Detener el validador, agave-install init <versión>, reiniciar con la misma ruta de ledger después de hacer una copia de seguridad.
¿La sincronización tarda mucho?
Máquina nueva o restauración de instantánea: usar --only-known-rpc para el arranque o instantáneas oficiales.
¿Múltiples validadores por host?
Desaconsejado en mainnet: contención de recursos; hardware separado por cuenta de voto.
¿Requisitos de SWQoS?
La participación en la cuenta de voto mejora la programación; ver la página de SWQoS.
¿Ubicación de los registros?
Salida estándar por defecto; redirigir a journald o archivo para la pila de monitoreo.
¿Validador de Devnet?
Las mismas banderas con puntos de entrada y génesis de devnet; primero financiar la cuenta de voto en devnet.
¿Fijación de Agave 4.1.1?
Coincidir con la fijación del manifiesto en CLI, validador y test-validator local en CI.
¿DoubleZero?
Capa de red opcional para la interconexión de validadores; ver página de hardware.
Relacionado
- Conceptos Básicos del Validador - descripción general de roles
- Hardware y Redes - dimensionamiento
- Cuentas de Voto y Staking - configuración de voto
- Monitoreo y Operaciones de Época - operaciones
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.