# Send Slv Grpc Geyser to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "slv-grpc-geyser",
    "name": "Slv Grpc Geyser",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/POPPIN-FUMI/slv-grpc-geyser",
    "canonicalUrl": "https://clawhub.ai/POPPIN-FUMI/slv-grpc-geyser",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/slv-grpc-geyser",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=slv-grpc-geyser",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "AGENT.md",
      "README.md",
      "SKILL.md",
      "examples/inventory.yml",
      "scripts/setup.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/slv-grpc-geyser"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/slv-grpc-geyser",
    "downloadUrl": "https://openagent3.xyz/downloads/slv-grpc-geyser",
    "agentUrl": "https://openagent3.xyz/skills/slv-grpc-geyser/agent",
    "manifestUrl": "https://openagent3.xyz/skills/slv-grpc-geyser/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/slv-grpc-geyser/agent.md"
  }
}
```
## Documentation

### SLV gRPC Geyser Skill

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

### Supported Configurations

ConfigDescriptionYellowstone gRPCStandard Geyser gRPC plugin (Triton/rpcpool)Richat gRPCRichat 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 CommandPlaybookDescriptionslv r deploymainnet-rpc/init.ymlFull gRPC Geyser node initializationslv r startmainnet-rpc/start_node.ymlStart nodeslv r stopmainnet-rpc/stop_node.ymlStop nodeslv r restartmainnet-rpc/restart_node.ymlRestart nodeslv r build:solanamainnet-rpc/install_solana.ymlBuild Solana from sourceslv r update:geysermainnet-rpc/update_geyser.ymlUpdate Geyser pluginslv r update:scriptmainnet-rpc/update_startup_config.ymlUpdate start-validator.shslv r setup:firedancermainnet-rpc/setup_firedancer.ymlSetup Firedancer

### Key Playbooks

PlaybookDescriptioninit.ymlFull gRPC Geyser node initializationinit_richat_geyser.ymlRichat Geyser initializationgeyser_build.ymlBuild Yellowstone gRPC from GitHub sourcegeyser_richat_build.ymlBuild Richat plugin from GitHub sourceinstall_richat.ymlInstall Richat pluginupdate_geyser.ymlUpdate Geyser pluginrestart_node.ymlRestart nodestart_node.yml / stop_node.ymlStart/stop nodeupdate_startup_config.ymlUpdate start-validator.sh from templatesetup_firedancer.ymlSetup Firedancerrun_snapshot_finder.ymlFind and download best snapshotrun_restarter.ymlRun restarter script

### 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)

VariableDescriptionDefaultrpc_typeMust be Geyser gRPC or Index RPC + gRPC—validator_typeClient type (agave, jito, firedancer-agave, etc.)—solana_versionSolana/Agave version—yellowstone_grpc_versionYellowstone gRPC version tag—richat_versionRichat plugin version (e.g. richat-v8.1.0)—snapshot_urlSnapshot download URL—port_grpcgRPC listen port10000limit_ledger_sizeLedger size limit100000000

### Jinja Templates

TemplateDescriptionstart-validator.sh.j2Main start script (branches by rpc_type)start-mainnet-rpc-grpc.sh.j2gRPC-specific start scriptgeyser.json.j2Yellowstone gRPC configgeyser-richat.json.j2Richat gRPC configrichat-setting.yml.j2Richat settingsrichat.service.j2Richat systemd servicefiredancer-config.toml.j2Firedancer configfiredancer.service.j2Firedancer systemd servicesolv.service.j2Solv systemd servicegenerate_configs.sh.j2Config generation script

### 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

VariablePromptValidationserver_ip"Target server IP?"Valid IPv4region"Server region?"Stringrpc_type"Geyser gRPC or Index RPC + gRPC?"Geyser gRPC, Index RPC + gRPCvalidator_type"Underlying client?"agave, jito, jito-bam, firedancer-agavesolana_version"Solana version? (default: 3.1.8)"Semveridentity_account"Node identity pubkey?"Base58 pubkeysnapshot_url"Snapshot URL? (auto for ERPC)"URL (cannot be empty for init)

### Plugin Selection (choose ONE)

PluginVersion VariableSourceOutputYellowstone gRPCyellowstone_grpc_versiongithub.com/rpcpool/yellowstone-grpclibyellowstone_grpc_geyser.soRichatrichat_versiongithub.com/lamports-dev/richatlibrichat_plugin_agave.so

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

VariableWhen Requiredjito_versionjito/jito-bam typesfiredancer_versionfiredancer typesshred_receiver_addressjito/jito-bam (auto by region)block_engine_urljito/jito-bam (auto by region)

### Optional Variables

VariableDefaultWhen Requiredssh_usersolvAlwaysport_grpc10000Alwaysport_rpc8899 (ERPC: 7211)Alwayslimit_ledger_size100000000Alwaysdynamic_port_range8000-8025Alwaysallowed_ssh_ips—Strongly recommended (UFW)allowed_ips—Optional (UFW)

### Optional: Reference RPC

VariableDescriptionDefaultreference_rpc_urlReference RPC endpoint for slot sync comparison (e.g., ERPC)—

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>"}'
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: POPPIN-FUMI
- Version: 0.10.2
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/slv-grpc-geyser)
- [Send to Agent page](https://openagent3.xyz/skills/slv-grpc-geyser/agent)
- [JSON manifest](https://openagent3.xyz/skills/slv-grpc-geyser/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/slv-grpc-geyser/agent.md)
- [Download page](https://openagent3.xyz/downloads/slv-grpc-geyser)