Slv Grpc Geyser
Ansible playbooks and templates for deploying and managing Solana gRPC Geyser streaming nodes with Yellowstone or Richat plugins.
Rank
62
Safety
84
Downloads
1.7k
Updated
Oct 10, 2026
Version
0.13.15
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.7K downloads reported by the source. Last updated 10/10/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 10, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 10, 2026
- Adoption signal
- 1.7K downloadsadoption · observed Oct 10, 2026
- Latest release
- 0.13.15release · observed Mar 30, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s17e81hsw278gv9pmpy6ys301n83kz2r:slv-grpc-geyser- Install using `clawhub skill install s17e81hsw278gv9pmpy6ys301n83kz2r:slv-grpc-geyser` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/poppin-fumi/slv-grpc-geyser before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-poppin-fumi-slv-grpc-geyser/snapshot"
Documentation
CLAWHUB
148,218 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
# SLV gRPC Geyser Skill Ansible playbooks and Jinja2 templates for deploying and managing Solana gRPC Geyser streaming nodes. ## Supported Configurations | Config | Description | |---|---| | Yellowstone gRPC | Standard Geyser gRPC plugin (Triton/rpcpool) | | Richat gRPC | Richat Geyser plugin (lamports-dev) | ## 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`. | CLI Command | Playbook | Description | |---|---|---| | `slv r deploy` | `mainnet-rpc/init.yml` | Full gRPC Geyser node initialization | | `slv r start` | `mainnet-rpc/start_node.yml` | Start node | | `slv r stop` | `mainnet-rpc/stop_node.yml` | Stop node | | `slv r restart` | `mainnet-rpc/restart_node.yml` | Restart node | | `slv r build:solana` | `mainnet-rpc/install_solana.yml` | Build Solana from source | | `slv r update:geyser` | `mainnet-rpc/update_geyser.yml` | Update Geyser plugin | | `slv r update:script` | `mainnet-rpc/update_startup_config.yml` | Update start-validator.sh | | `slv r setup:firedancer` | `mainnet-rpc/setup_firedancer.yml` | Setup Firedancer | ## Key Playbooks | Playbook | Description | |---|---| | `init.yml` | Full gRPC Geyser node initialization | | `init_richat_geyser.yml` | Richat Geyser initialization | | `geyser_build.yml` | Build Yellowstone gRPC from GitHub source | | `geyser_richat_build.yml` | Build Richat plugin from GitHub source | | `install_richat.yml` | Install Richat plugin | | `update_geyser.yml` | Update Geyser plugin | | `restart_node.yml` | Restart node | | `start_node.yml` / `stop_node.yml` | Start/stop node | | `update_startup_config.yml` | Update start-validator.sh from template | | `setup_firedancer.yml` | Setup Firedancer | | `run_snapshot_finder.yml` | Find and download best snapshot | | `run_restarter.yml` | Run restarter script | ## 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) | Variable | Description | Default | |---|---|---| | `rpc_type` | Must be `Geyser gRPC` or `Index RPC + gRPC` | — | | `validator_type` | Client type (`agave`, `jito`, `firedancer-agave`, etc.) | — | | `solana_version` | Solana/Agave version | —
README.md
# SLV gRPC Geyser Skill
Deploy and manage Solana gRPC Geyser streaming nodes with AI-powered interactive guidance.
## What This Does
This skill gives an AI agent the knowledge and tools to:
- **Deploy** high-performance gRPC Geyser streaming nodes
- **Build** Geyser plugins from source (Yellowstone gRPC, Richat)
- **Manage** node lifecycle — start, stop, restart, update
- **Configure** gRPC ports, plugin settings, and streaming filters
Supported plugins:
- **Yellowstone gRPC** — Standard Geyser gRPC plugin ([rpcpool/yellowstone-grpc](https://github.com/rpcpool/yellowstone-grpc))
- **Richat** — High-throughput Geyser plugin ([lamports-dev/richat](https://github.com/lamports-dev/richat))
## Prerequisites
| Requirement | Version | Notes |
|---|---|---|
| `ansible-core` | >= 2.15 | `pip install ansible-core` |
| SSH access | — | Key-based auth to target server |
## Quick Start
### With OpenClaw
```bash
openclaw skill install slv-grpc-geyser
# "Deploy a gRPC Geyser node with Richat on 203.0.113.10"
```
### Manual Usage
```bash
cp examples/inventory.yml my-inventory.yml
# Edit with your server details
cd ansible/
ansible-playbook -i ../my-inventory.yml mainnet-rpc/init.yml \
-e '{"rpc_type":"Geyser gRPC","solana_version":"3.1.8","richat_version":"richat-v8.1.0"}'
```
## Contents
```
SKILL.md — AI-readable playbook knowledge + deployment flow
AGENT.md — Agent persona and behavior rules
README.md — This file
examples/
inventory.yml — Sample Ansible inventory
ansible/
mainnet-rpc/ — Playbooks (gRPC Geyser uses mainnet-rpc)
cmn/ — Shared playbooks
jinja/
mainnet-rpc/ — Config templates
```
## ERPC Snapshot Network
Servers purchased through [erpc.global](https://erpc.global/en/) automatically get access to ERPC's dedicated snapshot download endpoints — 7 global regions for fast node bootstrapping.
## License
Apache-2.0 — See [ValidatorsDAO/slv](https://github.com/ValidatorsDAO/slv)_meta.json
{
"ownerId": "kn76bbxmyk0pqzf680j907rve581ff0f",
"slug": "slv-grpc-geyser",
"version": "0.13.15",
"publishedAt": 1774892557422
}AGENT.md
# SLV gRPC Geyser Agent
## Identity
You are a **Solana gRPC Geyser streaming node specialist**. You deploy and manage
high-performance Geyser gRPC streaming nodes using Ansible playbooks and the `slv` CLI.
## Core Capabilities
- Deploy gRPC Geyser streaming nodes (Yellowstone gRPC + Richat)
- Build Geyser plugins from source (no binary downloads)
- Manage node lifecycle (start, stop, restart, update)
- Configure Geyser plugin settings (ports, filters, subscriptions)
## Behavior
1. **Security first**: Never expose private keys, tokens, or credentials
2. **Confirm before destructive actions**: Always confirm before stop, restart, or plugin rebuild
3. **Validate inputs**: Check IP format, version format, plugin compatibility
4. **Explain what you're doing**: State which playbook and variables before execution
5. **Interactive variable collection**: Guide users through required variables step by step
## Interactive Init Flow
### Step 0: Pre-flight — User Setup
New servers may not have the `solv` user:
```bash
ansible-playbook -i inventory.yml cmn/add_solv.yml \
-e '{"ansible_user":"ubuntu"}' --become
```
Ask: "Is this a fresh server?"
### Step 1: Server Connection
- `server_ip` — Target server IP address (required, validate IPv4)
- `ssh_user` — SSH username (default: `solv`; `ubuntu`/`root` for fresh servers)
- `ssh_key_path` — Path to SSH private key (default: `~/.ssh/id_rsa`)
- `region` — Server geographic region (e.g., `amsterdam`, `tokyo`) — affects CDN and shred receiver selection
### Step 2: Geyser Plugin
Present options:
- `Yellowstone gRPC` — Standard Geyser gRPC plugin (github.com/rpcpool/yellowstone-grpc)
- `Richat` — Richat Geyser plugin (github.com/lamports-dev/richat) — higher throughput
Based on selection, set the **required** version variable:
- Yellowstone → `yellowstone_grpc_version` (required)
- Richat → `richat_version` (required, e.g., `richat-v8.1.0`)
**Do NOT collect both versions** — only the selected plugin's version is needed.
### Step 3: RPC Type
- `Geyser gRPC` — gRPC streaming only
- `Index RPC + gRPC` — Full-index RPC + gRPC streaming (also needs faithful vars)
### Step 4: Validator Type (underlying client)
- `agave` — Standard Agave
- `jito` — Jito MEV client
- `jito-bam` — Jito with Block Awareness Module (recommended for gRPC Geyser)
- `firedancer-agave` — Firedancer with Agave consensus
### Step 5: Versions
- `solana_version` — Solana/Agave version (required, default: `3.1.8`)
- `jito_version` — **Required** if jito/jito-bam selected
- `firedancer_version` — **Required** if firedancer selected
### Step 6: Keys & Identity
- `identity_account` — Node identity pubkey (required for init)
### Step 7: Snapshot
- `snapshot_url` — Snapshot download URL
- ERPC nodes: auto-detected via nearest snapshot node
- External: user provides URL, or use `run_snapshot_finder.yml`
- **Cannot be empty for init**
### Step 8: gRPC Config
- `port_grpc` — gRPC listen port (default: `10000`)
- `port_rpc` — RPC listen pskill-card.md
## Description: Ansible playbooks and templates for deploying and managing Solana gRPC Geyser streaming nodes with Yellowstone or Richat plugins. This skill is ready for commercial/non-commercial use. ## Publisher: [poppin-fumi](https://clawhub.ai/user/poppin-fumi) ### License/Terms of Use: MIT-0 ## Use Case: Developers and Solana infrastructure operators use this skill to plan, configure, and run Ansible workflows for deploying or maintaining gRPC Geyser streaming nodes, including Yellowstone gRPC or Richat plugin builds. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: Remote administration playbooks can change node state, restart services, or affect production availability. Mitigation: Run dry-run or check mode first, review planned variables and target hosts, and require change approval before production restarts or updates. Risk: Runtime playbooks are resolved from ~/.slv/template/ and may differ from the artifact's reference copies. Mitigation: Review the resolved template directory and playbook path before execution, and install only from trusted SLV template sources. Risk: Automatic prerequisite setup may install packages or use elevated package-manager commands on the operator host. Mitigation: Prefer manually installing pinned prerequisites, and review setup behavior before running automatic installation paths. ## Reference(s): - [ClawHub skill page](https://clawhub.ai/poppin-fumi/skills/slv-grpc-geyser) - [Yellowstone gRPC](https://github.com/rpcpool/yellowstone-grpc) - [Richat](https://github.com/lamports-dev/richat) - [ERPC Snapshot Network](https://erpc.global/en/) ## Skill Output: **Output Type(s):** [Guidance, Shell commands, Configuration] **Output Format:** [Markdown guidance with inline shell commands and YAML inventory examples] **Output Parameters:** [1D] **Other Properties Related to Output:** [Produces deployment guidance and command proposals; users should review before running commands on target hosts.] ## Skill Version(s): 0.13.15 (source: server release metadata) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/poppin-fumi/skills/slv-grpc-geyser",
"sourceUrl": "https://clawhub.ai/poppin-fumi/skills/slv-grpc-geyser",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T04:09:12.947Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-poppin-fumi-slv-grpc-geyser/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-poppin-fumi-slv-grpc-geyser/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-10T04:09:12.947Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.7K downloads",
"href": "https://clawhub.ai/poppin-fumi/slv-grpc-geyser",
"sourceUrl": "https://clawhub.ai/poppin-fumi/slv-grpc-geyser",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T04:09:12.947Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "0.13.15",
"href": "https://clawhub.ai/poppin-fumi/slv-grpc-geyser",
"sourceUrl": "https://clawhub.ai/poppin-fumi/slv-grpc-geyser",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-03-30T17:42:37.422Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-poppin-fumi-slv-grpc-geyser/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-poppin-fumi-slv-grpc-geyser/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 0.13.15",
"description": "Version 0.13.15 of slv-grpc-geyser has no user-facing changes. - No file changes detected in this release. - All behavior and documentation remain the same.",
"href": "https://clawhub.ai/poppin-fumi/slv-grpc-geyser",
"sourceUrl": "https://clawhub.ai/poppin-fumi/slv-grpc-geyser",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-03-30T17:42:37.422Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
