Pare validador, agave-install init , reinicie com mesmo caminho de ledger após backup.

Cliente Agave

Q: Nó só RPC?

Execute com --no-voting e omita requisito de vote account - ainda sincroniza ledger completo.

Q: Catchup demorado?

Máquina nova ou restore de snapshot - use bootstrap --only-known-rpc ou snapshots oficiais.

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 vote

Quando 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 50000000

O que isso demonstra:

Ledger e accounts em caminhos NVMe rápidos.
--vote-account habilita 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-api habilitado.

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

Armadilhas

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.

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 vote

Quando 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 50000000

O que isso demonstra:

Ledger e accounts em caminhos NVMe rápidos.
--vote-account habilita 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-api habilitado.

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

Armadilhas

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.

Cliente Agave

Buscar na documentação

Cliente Agave