Cliente Agave
Agave 4.1.1 é o cliente validador Solana da Anza - implementação mainline para votação, replay de ledger e RPC. Execute-o ao operar validador de staking padrão ou nó RPC privado.
Receita
Cartão de receita de referência rápida - pronto para copiar e colar.
agave-install init 4.1.1
agave-validator --ledger /mnt/ledger \
--identity ~/.config/solana/identity.json \
--vote-account <VOTE_ACCOUNT_PUBKEY> \
--rpc-port 8899 \
--full-rpc-api \
--no-voting # omit --no-voting for validators that voteQuando usar:
- Operar validador mainnet-beta com votação.
- Executar RPC dedicado para sua organização.
- Permanecer no canal de release suportado pela Anza.
- Baseline antes de avaliar híbrido Frankendancer.
Exemplo Funcional
#!/usr/bin/env bash
# Inicialização mínima do validador Agave (ajuste caminhos)
LEDGER=/mnt/nvme/ledger
ACCOUNTS=/mnt/nvme/accounts
IDENTITY=~/.config/solana/identity.json
VOTE_ACCOUNT=Vote111111111111111111111111111111111111111
mkdir -p "$LEDGER" "$ACCOUNTS"
agave-validator \
--ledger "$LEDGER" \
--accounts "$ACCOUNTS" \
--identity "$IDENTITY" \
--vote-account "$VOTE_ACCOUNT" \
--known-validator <TRUSTED_ENTRYPOINT> \
--entrypoint entrypoint.mainnet-beta.solana.com:8001 \
--expected-genesis-hash <MAINNET_GENESIS_HASH> \
--full-rpc-api \
--rpc-bind-address 127.0.0.1 \
--rpc-port 8899 \
--dynamic-port-range 8000-8020 \
--limit-ledger-size 50000000O que isso demonstra:
- Ledger e accounts em caminhos NVMe rápidos.
--vote-accounthabilita votação de consenso (omita para RPC-only com--no-voting).- Entrypoints e genesis hash fixam rede na mainnet-beta.
Aprofundamento
Como Funciona
- Agave reexecuta blocos, executa transações no SVM Sealevel.
- Tower BFT rastreia votos na vote account.
- Banking stage agenda transações da entrada TPU.
- RPC serve APIs HTTP/WebSocket quando
--full-rpc-apihabilitado.
Flags Principais
| Flag | Propósito |
|---|---|
--ledger | Caminho do block store |
--accounts | Caminho do accounts DB |
--vote-account | Pubkey de voto on-chain |
--no-voting | Nó RPC sem votação |
--limit-ledger-size | Poda com cap de disco |
Notas bash
agave-validator --ledger /mnt/ledger monitor # watch catchup
solana catchup --our-localhostArmadilhas
- Disco lento - Ledger HDD causa delinquency. Correção: NVMe para ledger + accounts; veja página de hardware.
- Genesis hash errado - Nó recusa entrar no cluster. Correção: Use genesis mainnet oficial da documentação.
- Identidade em laptop quente - Roubo de chave arrisca stake. Correção: Módulo de segurança de hardware para chaves mainnet.
- Ledger sem limite - Crash de disco cheio. Correção:
--limit-ledger-size+ monitoramento. - RPC público sem firewall - Abuso e dreno de recursos. Correção: Vincule RPC a localhost ou proxy com rate limit.
- Deriva de versão - Upgrade de cluster perdido. Correção: Assine release notes Anza; restarts escalonados.
Alternativas
| Alternativa | Use quando | Não use quando |
|---|---|---|
| Híbrido Frankendancer | Performance máxima | Simplicidade de setup inicial |
| Jito-Solana | Infraestrutura MEV | Preferência de operador sem MEV |
| Validador hospedado | Sem equipe de ops | Requisito de autocustódia total |
FAQs
agave vs nomenclatura solana CLI?
Agave é cliente validador; Solana CLI 3.0.10 permanece ferramenta de operador da distribuição Anza.
Nó só RPC?
Execute com --no-voting e omita requisito de vote account - ainda sincroniza ledger completo.
Como upgradar Agave?
Pare validador, agave-install init <version>, reinicie com mesmo caminho de ledger após backup.
Catchup demorado?
Máquina nova ou restore de snapshot - use bootstrap --only-known-rpc ou snapshots oficiais.
Vários validadores por host?
Desencorajado na mainnet - contenção de recursos; hardware separado por vote account.
Requisitos SWQoS?
Stake na vote account melhora agendamento - veja página SWQoS.
Localização de log?
Stderr padrão; redirecione para journald ou arquivo para stack de monitoramento.
Validador devnet?
Mesmas flags com entrypoints e genesis devnet - financie vote account na devnet primeiro.
Pin Agave 4.1.1?
Combine pin de manifest em CLI, validador e test-validator local no CI.
DoubleZero?
Camada de rede opcional para interconexão de validadores - veja página de hardware.
Relacionado
- Validator Basics - visão geral de papéis
- Hardware & Networking - dimensionamento
- Vote Accounts & Staking - setup de voto
- Monitoring & Epoch Ops - ops
Versões da stack: Esta página foi escrita para Agave 4.1.1, Solana CLI 3.0.10, Anchor 0.32.1, anchor-lang 0.32.1, Rust 1.91.1, @solana/kit 7.0.0, Surfpool 0.12.0 e LiteSVM 0.6.x.