Plugins de Geyser

Los plugins de Geyser permiten a los validadores de Agave transmitir actualizaciones de cuentas y transacciones a destinos externos para indexación sin necesidad de consultar JSON-RPC.

Receta

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

{
  "libpath": "/ruta/a/libgeyser_plugin.so",
  "accounts_selector": { "owners": ["TU_PROGRAM_ID"] },
  "transaction_selector": { "mentions": ["TU_PROGRAM_ID"] }
}

agave-validator --geyser-plugin-config geyser.json ...

Cuándo usar esto:

• Validador autoalojado con pipeline de indexación personalizado.
• Acceso al nivel más bajo a actualizaciones de cuentas ordenadas por slot.
• Creación de productos de datos propietarios sobre tu propia participación.
• Filtrado en origen antes de los costos de salida de red.

Ejemplo de Trabajo

# geyser.json (ilustrativo - coincide con el esquema de tu plugin)
cat > geyser.json <<'EOF'
{
  "libpath": "/opt/geyser/libmy_sink.so",
  "kafka": { "bootstrap.servers": "localhost:9092", "topic": "solana-events" },
  "accounts_selector": {
    "owners": ["TU_PROGRAM_ID"]
  }
}
EOF
 
agave-validator \
  --ledger /data/ledger \
  --geyser-plugin-config geyser.json \
  --rpc-port 8899

Lo que esto demuestra:

• El plugin .so se carga en el espacio de proceso del validador.
• Los selectores limitan el "firehose" a los propietarios/menciones relevantes.
• Los consumidores de Kafka/Postgres posteriores procesan eventos normalizados.

Análisis Profundo

Cómo Funciona

• El validador llama a los hooks del plugin en escrituras de cuentas y transacciones confirmadas.
• Las actualizaciones transportan el slot, la versión de escritura y las claves públicas/datos de la cuenta.
• El plugin debe ser rápido: un bloqueo ralentiza el validador si se implementa incorrectamente.
• Yellowstone gRPC es un patrón de distribución popular basado en las interfaces de Geyser.

Responsabilidades del Plugin

Notas de bash

# Verifica que el plugin se carga al inicio del validador - revisa los logs en busca de líneas de inicialización de geyser
tail -f /data/validator.log | grep -i geyser

Trampas Comunes

• Callbacks lentos del plugin: el validador se retrasa en los slots. Solución: transferencia asíncrona a la cola, trabajo mínimo en el hook.
• Sin selector: el "firehose" completo de mainnet satura la red. Solución: filtros estrictos de propietario.
• Desfase de plugin/versión: Agave 4.1.1 requiere una ABI de plugin coincidente. Solución: reconstruye el plugin en las actualizaciones del validador.
• Asumir garantías de entrega: los bloqueos pierden eventos en tránsito sin puntos de control. Solución: almacena el último slot en una cola duradera.
• Ejecutar el plugin solo en RPC público: no controlas los plugins de proveedores alojados. Solución: autoalojamiento o uso de un proveedor de Yellowstone.

Alternativas

Preguntas Frecuentes

Relacionado

• Yellowstone gRPC - streaming remoto
• Construcción de un Indexador - lógica del consumidor
• Conceptos Básicos de Indexación - por qué indexar
• Proveedores RPC - opciones alojadas

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.