SLV RPC Skill

Ansible playbooks and Jinja2 templates for deploying and managing Solana RPC nodes (mainnet, testnet, devnet).

Supported RPC Types

Type	Description
`RPC`	Standard RPC node
`Index RPC`	Full-index RPC node (with Old Faithful/yellowstone-faithful)
`Geyser gRPC`	RPC with Geyser gRPC streaming
`Index RPC + gRPC`	Full-index + gRPC streaming

Directory Structure

ansible/
  mainnet-rpc/   — Mainnet RPC playbooks
  testnet-rpc/   — Testnet RPC playbooks
  devnet-rpc/    — Devnet RPC playbooks
  cmn/           — Shared common playbooks
jinja/
  mainnet-rpc/   — Mainnet Jinja2 templates
  testnet-rpc/   — Testnet Jinja2 templates
  devnet-rpc/    — Devnet Jinja2 templates
  cmn/           — Shared templates

CLI Command ↔ Playbook Mapping

The slv r CLI commands map directly to these playbooks. {net} = mainnet-rpc, testnet-rpc, or devnet-rpc.

CLI Command	Playbook	Description
`slv r deploy`	`{net}/init.yml`	Full RPC node initialization and deployment
`slv r start`	`{net}/start_node.yml`	Start RPC node
`slv r stop`	`{net}/stop_node.yml`	Stop RPC node
`slv r restart`	`{net}/restart_node.yml`	Restart RPC node
`slv r build:solana`	`{net}/install_solana.yml`	Build Solana from source
`slv r install:solana`	`cmn/install_solana.yml`	Install Solana binary (deprecated, prefer build)
`slv r setup:firedancer`	`{net}/setup_firedancer.yml`	Setup Firedancer
`slv r update:firedancer`	`cmn/update_firedancer.yml`	Update Firedancer binary
`slv r update:script`	`{net}/update_startup_config.yml`	Update start-validator.sh from template
`slv r update:geyser`	`{net}/update_geyser.yml`	Update Geyser plugin
`slv r get:snapshot`	`{net}/wget_snapshot.yml`	Download snapshot via aria2c
`slv r cleanup`	`cmn/rm_ledger.yml`	Remove ledger/snapshot files
`slv r list`	(no playbook)	List RPC nodes (CLI only)
`slv r update:allowed-ips`	(no playbook)	Update allowed IPs (CLI only)
`slv r init`	(no playbook)	Interactive wizard (CLI only)

All Playbooks

Mainnet RPC (`mainnet-rpc/`)

Playbook	Description
`init.yml`	Full RPC node initialization
`init_richat_geyser.yml`	Initialize Richat Geyser configuration
`restart_node.yml`	Restart RPC node
`start_node.yml`	Start RPC node
`stop_node.yml`	Stop RPC node
`install_solana.yml`	Build Solana from source
`install_agave.yml`	Build Agave from source
`install_jito.yml`	Build Jito from source
`install_rust.yml`	Install Rust toolchain
`install_package.yml`	Install system packages
`install_richat.yml`	Install Richat gRPC plugin
`install_of1.yml`	Install Old Faithful (yellowstone-faithful)
`install_of1_service.yml`	Setup Old Faithful systemd service
`geyser_build.yml`	Build Yellowstone gRPC from source
`geyser_richat_build.yml`	Build Richat gRPC plugin from source
`update_geyser.yml`	Update Geyser plugin
`update_startup_config.yml`	Update start-validator.sh from template
`update_ubuntu.yml`	Update Ubuntu packages
`setup_firedancer.yml`	Setup Firedancer for RPC
`setup-solv-service.yml`	Setup systemd service
`start-solv-service.yml`	Start systemd service
`setup_ufw.yml`	Configure UFW firewall
`setup_logrotate.yml`	Setup log rotation
`setup_norestart.yml`	Disable auto-restart
`configure_hugetlbfs.yml`	Configure hugepages for Firedancer
`fail2ban_solana_rate_limit.yml`	Setup fail2ban rate limiting
`fail2ban_sshd.yml`	Setup fail2ban for SSH
`allow_ufw.yml`	Add UFW allow rules
`add_solv.yml`	Add solv user
`copy_keys.yml`	Copy node keys
`create-start-validator-sh.yml`	Generate start script from template
`create-symlink.yml`	Create version symlinks
`mount_disks.yml`	Mount and format disks
`optimize_system.yml`	Optimize system settings
`run_restarter.yml`	Run restarter script
`run_snapshot_finder.yml`	Find and download best snapshot

Testnet RPC (`testnet-rpc/`)

Playbook	Description
`init.yml`	Full testnet RPC initialization
`restart_node.yml`	Restart node
`start_node.yml` / `stop_node.yml`	Start/stop node
`install_solana.yml`	Build Solana from source
`install_agave.yml` / `install_jito.yml`	Build client from source
`install_richat.yml`	Install Richat plugin
`geyser_build.yml`	Build Yellowstone gRPC
`geyser_richat_build.yml`	Build Richat plugin from source
`update_geyser.yml`	Update Geyser plugin
`update_firedancer.yml`	Update Firedancer
`update_startup_config.yml`	Update start script
`setup_firedancer.yml`	Setup Firedancer
`setup_solv_service.yml`	Setup systemd service
`create-start-validator-sh.yml`	Generate start script
`wget_snapshot.yml`	Download snapshot

Devnet RPC (`devnet-rpc/`)

Playbook	Description
`init.yml`	Full devnet RPC initialization
`restart_node.yml`	Restart node
`start_node.yml` / `stop_node.yml`	Start/stop node
`install_solana.yml`	Build Solana from source
`install_agave.yml` / `install_jito.yml`	Build client from source
`install_richat.yml`	Install Richat plugin
`geyser_build.yml`	Build Yellowstone gRPC
`geyser_richat_build.yml`	Build Richat plugin from source
`update_geyser.yml`	Update Geyser plugin
`update_startup_config.yml`	Update start script
`setup_firedancer.yml`	Setup Firedancer
`setup_solv_service.yml`	Setup systemd service
`create-start-validator-sh.yml`	Generate start script

Shared Common (`cmn/`)

Playbook	Description
`build_solana.yml`	Build Solana from source (dispatches to build_agave/build_jito)
`build_agave.yml`	Build Agave from GitHub source
`build_jito.yml`	Build Jito from GitHub source
`install_solana.yml`	Install Solana binary (deprecated)
`install_package.yml`	Install system packages
`install_rust.yml`	Install Rust toolchain
`mount_disks.yml` / `mount-disks.yml`	Mount and format disks
`optimize_system.yml`	Optimize system settings
`disable_swap.yml`	Disable swap
`setup_logrotate.yml`	Configure log rotation
`setup_node_exporter.yml`	Setup Prometheus node exporter
`setup_norestart.yml`	Disable auto-restart
`setup_unstaked_identity.yml`	Setup unstaked identity keypair
`restart_solv.yml`	Restart solv service
`start_solv.yml` / `stop_solv.yml`	Start/stop solv service
`start_firedancer.yml` / `stop_firedancer.yml`	Start/stop Firedancer
`copy_restart_sh.yml`	Copy restarter script
`copy_rpc_keys.yml`	Copy RPC keys
`update_ubuntu.yml`	Update Ubuntu packages
`wget_snapshot.yml`	Download snapshot
`add_solv.yml`	Add solv user
`fix_permissions.yml`	Fix file permissions

Key Variables (extra_vars)

Variable	Description	Default
`rpc_type`	RPC node type (`RPC`, `Index RPC`, `Geyser gRPC`, `Index RPC + gRPC`)	`RPC`
`validator_type`	Client type (`agave`, `jito`, `firedancer-agave`, `firedancer-jito`)	—
`solana_version`	Solana/Agave version	—
`jito_version`	Jito version	—
`firedancer_version`	Firedancer version	—
`yellowstone_grpc_version`	Yellowstone gRPC version	—
`richat_version`	Richat plugin version (e.g. `richat-v8.1.0`)	—
`snapshot_url`	Snapshot download URL	—
`tpu_peer_address`	TPU peer address (for Index RPC transaction forwarding)	—
`limit_ledger_size`	Ledger size limit	`200000000` (Index), `100000000` (others)
`dynamic_port_range`	Port range	`8000-8025`
`port_rpc`	RPC port	`8899`
`port_grpc`	gRPC port	`10000`

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

ansible-playbook -i inventory mainnet-rpc/init.yml \
  -e '{"rpc_type":"Index RPC","solana_version":"3.1.8","snapshot_url":"https://..."}'

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

Variable	Prompt	Validation
`server_ip`	"Target server IP?"	Valid IPv4
`network`	"mainnet, testnet, or devnet?"	`mainnet`, `testnet`, `devnet`
`region`	"Server region?"	String
`rpc_type`	"RPC type?"	`RPC`, `Index RPC`, `Geyser gRPC`, `Index RPC + gRPC`
`validator_type`	"Underlying client?"	`agave`, `jito`, `jito-bam`, `firedancer-agave`
`solana_version`	"Solana version? (default: 3.1.8)"	Semver
`identity_account`	"Node identity pubkey?"	Base58 pubkey
`snapshot_url`	"Snapshot URL? (auto for ERPC)"	URL (cannot be empty for init)

Conditionally Required Variables

Variable	Default	When Required
`jito_version`	Matches solana_version	jito/jito-bam types
`firedancer_version`	—	firedancer types
`yellowstone_grpc_version`	—	Yellowstone gRPC plugin
`richat_version`	—	Richat plugin
`of1_version`	—	Index RPC (Old Faithful)
`epoch`	—	Index RPC (faithful service)
`faithful_proxy_target_url`	—	Index RPC

Optional Variables

Variable	Default	When Required
`ssh_user`	`solv`	Always
`port_rpc`	`8899` (ERPC: `7211`)	Always
`limit_ledger_size`	`100000000`	Always
`dynamic_port_range`	`8000-8025`	Always
`port_grpc`	`10000`	gRPC types only
`tpu_peer_address`	—	Index RPC (tx forwarding)
`allowed_ssh_ips`	—	Strongly recommended (UFW)
`allowed_ips`	—	Optional (UFW)
`expected_shred_version`	Epoch-dependent	Testnet only

Optional: Reference RPC

Variable	Description	Default
`reference_rpc_url`	Reference 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-rpc/ansible/
ansible-playbook -i inventory.yml {network}-rpc/init.yml \
  -e '{"rpc_type":"<type>","solana_version":"<version>"}'

Slv Rpc

Safety Notice

Copy this and send it to your AI assistant to learn

SLV RPC Skill

Supported RPC Types

Directory Structure

CLI Command ↔ Playbook Mapping

All Playbooks

Mainnet RPC (`mainnet-rpc/`)

Testnet RPC (`testnet-rpc/`)

Devnet RPC (`devnet-rpc/`)

Shared Common (`cmn/`)

Key Variables (extra_vars)

Geyser Plugin Sources

Usage

Interactive Deployment Flow

Required Variables

Conditionally Required Variables

Optional Variables

Optional: Reference RPC

Pre-flight: Fresh Server Setup

Deployment Command

Source Transparency

Related Skills

Slv Grpc Geyser

Slv Validator

Whistle RPC

Slv Rpc

Safety Notice

Copy this and send it to your AI assistant to learn

SLV RPC Skill

Supported RPC Types

Directory Structure

CLI Command ↔ Playbook Mapping

All Playbooks

Mainnet RPC (mainnet-rpc/)

Testnet RPC (testnet-rpc/)

Devnet RPC (devnet-rpc/)

Shared Common (cmn/)

Key Variables (extra_vars)

Geyser Plugin Sources

Usage

Interactive Deployment Flow

Required Variables

Conditionally Required Variables

Optional Variables

Optional: Reference RPC

Pre-flight: Fresh Server Setup

Deployment Command

Source Transparency

Related Skills

Slv Grpc Geyser

Slv Validator

Whistle RPC

Mainnet RPC (`mainnet-rpc/`)

Testnet RPC (`testnet-rpc/`)

Devnet RPC (`devnet-rpc/`)

Shared Common (`cmn/`)