SLV gRPC Geyser Skill

Ansible playbooks and Jinja2 templates for deploying and managing Solana gRPC Geyser streaming nodes.

Supported Configurations

Directory Structure

ansible/
  mainnet-rpc/   — Playbooks (gRPC Geyser uses mainnet-rpc playbooks)
  cmn/           — Shared common playbooks
jinja/
  mainnet-rpc/   — Jinja2 templates
  cmn/           — Shared templates

CLI Command ↔ Playbook Mapping

gRPC Geyser nodes are managed via slv r (RPC) commands with rpc_type set to Geyser gRPC or Index RPC + gRPC.

Key Playbooks

Geyser Build Details

Yellowstone gRPC (geyser_build.yml)

• Clones from https://github.com/rpcpool/yellowstone-grpc
• Builds with cargo build --release
• Produces libyellowstone_grpc_geyser.so
• Config template: jinja/mainnet-rpc/geyser.json.j2

Richat (geyser_richat_build.yml)

• Clones from https://github.com/lamports-dev/richat
• Builds with cargo build --release
• Produces librichat_plugin_agave.so
• Config template: jinja/mainnet-rpc/geyser-richat.json.j2
• Service template: jinja/mainnet-rpc/richat.service.j2
• Settings template: jinja/mainnet-rpc/richat-setting.yml.j2

Key Variables (extra_vars)

Jinja Templates

Geyser Plugin Sources

Both plugins are built from source (no binary downloads):

• Yellowstone gRPC: https://github.com/rpcpool/yellowstone-grpc
• Richat: https://github.com/lamports-dev/richat

Usage

# Deploy a new gRPC Geyser node
ansible-playbook -i inventory mainnet-rpc/init.yml \
  -e '{"rpc_type":"Geyser gRPC","solana_version":"3.1.8","yellowstone_grpc_version":"v6.0.0","snapshot_url":"https://..."}'

# Build/update Richat plugin
ansible-playbook -i inventory mainnet-rpc/geyser_richat_build.yml \
  -e '{"richat_version":"richat-v8.1.0"}'

No versions.yml required — all variables can be passed via extra_vars.

Interactive Deployment Flow

See AGENT.md for the full step-by-step flow and examples/inventory.yml for output format.

Required Variables

Plugin Selection (choose ONE)

Both are built from source (no pre-built binaries). Build time: ~15-30 min.

Only collect the version variable for the selected plugin.

Conditionally Required Variables

Optional Variables

Optional: Reference RPC

ERPC API keys are free at https://erpc.global — enables full slot sync monitoring during deployment and updates.

Pre-flight: Fresh Server Setup

ansible-playbook -i inventory.yml cmn/add_solv.yml \
  -e '{"ansible_user":"ubuntu"}' --become

Deployment Command

All paths relative to skill's ansible/ directory:

cd /path/to/slv-grpc-geyser/ansible/
ansible-playbook -i inventory.yml mainnet-rpc/init.yml \
  -e '{"rpc_type":"Geyser gRPC","solana_version":"<version>","richat_version":"<version>"}'