agentCLAWHUBUnverified

Slv Grpc Geyser

Ansible playbooks and templates for deploying and managing Solana gRPC Geyser streaming nodes with Yellowstone or Richat plugins.

OpenClaw

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
  1. Install using `clawhub skill install s17e81hsw278gv9pmpy6ys301n83kz2r:slv-grpc-geyser` in an isolated environment before connecting it to live workloads.
  2. No published capability contract is available yet, so validate auth and request/response behavior manually.
  3. 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 p

skill-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.
Github ReposUpdated 10h agoRank 70

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!

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

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

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

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.

Sponsored

Ads related to Slv Grpc Geyser and adjacent AI workflows.