Conexão de Assinante de Borda

Ao conectar-se ao DoubleZero, concordo com os Termos de Uso do DoubleZero. Observe que os dados são apenas para seus propósitos internos e não podem ser retransmitidos (consulte a Seção 2(e)).

Passo 1: Configuração do DoubleZero

1. Concluir a Configuração

Instale o Solana CLI.

Siga as instruções de configuração para instalar e configurar o cliente DoubleZero.

Se você já configurou o DoubleZero anteriormente, certifique-se de ter o Doublezero-Solana CLI mais recente com sudo apt update && sudo apt install doublezero-solana

2. Configurar o Firewall

Permita tráfego GRE, BGP, PIM e de shreds.

iptables:

sudo iptables -A OUTPUT -p gre -j ACCEPT
sudo iptables -A INPUT -i doublezero1 -s 169.254.0.0/16 -d 169.254.0.0/16 -p tcp --dport 179 -j ACCEPT
sudo iptables -A OUTPUT -o doublezero1 -s 169.254.0.0/16 -d 169.254.0.0/16 -p tcp --dport 179 -j ACCEPT
sudo iptables -A OUTPUT -o doublezero1 -p pim -j ACCEPT
sudo iptables -A INPUT -i doublezero1 -p udp --dport 7733 -j ACCEPT
sudo iptables -A INPUT -i doublezero0 -p udp --dport 44880 -j ACCEPT

UFW:

sudo ufw allow proto gre from any to any
sudo ufw allow in on doublezero1 from 169.254.0.0/16 to 169.254.0.0/16 port 179 proto tcp
sudo ufw allow out on doublezero1 from 169.254.0.0/16 to 169.254.0.0/16 port 179 proto tcp
sudo ufw allow out on doublezero1 proto pim from any to any
sudo ufw allow in on doublezero1 to any port 7733 proto udp
sudo ufw allow in on doublezero0 to any port 44880 proto udp

3. Habilitar o Reconciliador

O reconciliador monitora o estado onchain e provisiona automaticamente os túneis quando seu assento é alocado. Ele não é habilitado por padrão.

doublezero enable

Passo 2: Configurar Sua Carteira

1. Criar um Par de Chaves Solana

O CLI doublezero-solana usa um par de chaves Solana padrão para gerenciamento de assentos onchain. Se você não tiver um:

solana-keygen new

Isso grava em ~/.config/solana/id.json. Para usar um caminho diferente, passe --keypair <path> para qualquer comando doublezero-solana.

Imprima o endereço da sua carteira:

solana address

2. Financiar Sua Carteira

Sua carteira precisa de dois tokens:

SOL — para taxas de transação da Solana. Transfira SOL para o endereço da carteira impresso acima.
USDC — para financiamento do assento. O CLI utiliza a Conta de Token Associada (ATA) da sua carteira para o mint USDC da mainnet (EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v).

Passo 3: Comprar um Assento

1. Encontre Seu Dispositivo Mais Próximo

Antes de comprar um assento, identifique o dispositivo com a menor latência a partir da sua máquina:

doublezero latency

Anote o código do dispositivo com o resultado de menor latência (ex.: <Device_Name>). Você usará isso ao comprar um assento.

2. Verificar Preços

Consulte os preços atuais dos dispositivos antes de comprometer fundos. Os preços têm dois componentes: um preço base do metro e um prêmio por dispositivo. Os preços são atualizados a cada época. Você também pode visualizar preços e disponibilidade aqui.

Todos os dispositivos:

doublezero-solana shreds price

Dispositivo específico:

doublezero-solana shreds price --device-code <Device_Name>
doublezero-solana shreds price --device <PUBKEY>

Todos os dispositivos em um metro:

doublezero-solana shreds price --metro <PUBKEY>

Colunas de saída: Device Code, Metro Code, Metro Name, Status, Settled Seats, Available Seats, Base Price (USDC), Premium (USDC), Epoch Price (USDC).

O preço da época é o custo total por época para um assento naquele dispositivo (base + prêmio). Use --wide para exibir chaves públicas completas, ou --json para saída em JSON.

3. Comprar um Assento

Compre um assento com um único comando. Isso inicializa seu assento, financia o escrow e solicita a alocação:

doublezero-solana shreds pay \
  --device-code <Device_Name> \
  --client-ip <Target_IP> \
  --amount <Cost_Of_Seat>

Parâmetros:

Flag	Descrição
`--device <PUBKEY>`	Dispositivo alvo por chave pública (mutuamente exclusivo com `--device-code`)
`--device-code <CODE>`	Dispositivo alvo por código legível (ex.: `<Device_Name>`)
`--client-ip <IP>`	Endereço IPv4 público da sua máquina
`--amount <USDC>`	USDC a financiar (formato decimal, ex.: `100` = 100 USDC). Deve atender o preço mínimo da época.
`--source-token-account <PUBKEY>`	Conta de origem USDC personalizada (padrão é a ATA da sua carteira)
`--accept-partial-epoch`	Ignorar o aviso de época restante (veja abaixo)
`--fee-payer <PATH>`	Usar uma carteira diferente para taxas de transação SOL
`--dry-run`	Simular a transação sem executá-la
`--with-compute-unit-price <PRICE>`	Definir um preço de unidade de computação para inclusão mais rápida durante congestionamento

Assim que seu assento for alocado, o daemon estabelece o túnel GRE automaticamente. Verifique sua conexão com:

doublezero status

Temporização de Época

Os assentos são alocados por época da Solana (~2 dias). Se restar menos de 10% da época atual quando você pagar, o CLI avisa que seu assento será alocado imediatamente, mas cobrirá apenas o restante da época atual. Um pagamento separado será deduzido do seu escrow quando a próxima época começar.

É aconselhável financiar para mais de 1 época por vez para não perder seu assento. Você pode verificar o tempo restante na época atual aqui.

Você pode ignorar este aviso com --accept-partial-epoch.

Mantenha Seu Escrow Financiado

Se o saldo do seu escrow estiver abaixo do preço da época na liquidação, seu assento não será alocado, o túnel será encerrado e você perderá sua permanência acumulada. A permanência determina sua prioridade para épocas futuras — perdê-la significa que você competirá como um novato novamente.

Você pode financiar esta conta a mais para cobrir múltiplas épocas. Cada liquidação deduz o preço de uma época do seu escrow, e o saldo restante é mantido. Por exemplo, financiar 5x o preço por época mantém seu assento ativo por até 5 épocas sem necessidade de refinanciamento.

Para recarregar seu escrow, execute shreds pay novamente a qualquer momento:

doublezero-solana shreds pay \
  --device-code <Device_Name> \
  --client-ip <Target_IP> \
  --amount 500

Observe que o Target_IP deve ser um endereço IPv4 público na máquina que receberá os shreds. Você pode encontrá-lo executando um comando como curl -4 ifconfig.me na máquina de destino.

Monitorar Assentos

Esta seção detalha como visualizar assentos via CLI. Você também pode usar https://data.malbeclabs.com/api/v1/docs para monitorar assentos e auxiliar no gerenciamento da sua conta de escrow.

Visualize seus assentos ativos e saldos de escrow:

Todos os seus assentos:

doublezero-solana shreds list

Filtrar por dispositivo:

doublezero-solana shreds list --device-code <Device_Name>

Filtrar por IP do cliente:

doublezero-solana shreds list --client-ip <Target_IP>

Filtrar por carteira:

doublezero-solana shreds list --withdraw-authority <PUBKEY>

Colunas de saída: Device Code, Client IP, Tenure, Balance (USDC), Est. Epochs Paid.

A coluna "Est. Epochs Paid" mostra quantas épocas seu saldo atual cobre com os preços atuais. Se os preços mudarem, esta estimativa se ajusta.

Sacar Fundos

Encerre seu escrow e reembolse o USDC restante para sua carteira:

doublezero-solana shreds withdraw \
  --device-code <Device_Name> \
  --client-ip <Target_IP>

Você pode identificar o dispositivo por --device <PUBKEY> ou --device-code <CODE>, assim como nos outros comandos.

Para enviar o reembolso para uma conta de token diferente:

doublezero-solana shreds withdraw \
  --device-code <Device_Name> \
  --client-ip <Target_IP> \
  --refund-token-account <PUBKEY>

Sacar significa que você perde seu assento e a permanência acumulada.

Endereços de Shreds (IP vs Porta)

Shreds de Líder e Shreds de Retransmissão de alto stake chegarão pela porta 7733, através da interface doublezero1. A interface doublezero0 é para tráfego unicast. A porta 5765 é um monitor de heartbeat dos publicadores de shreds — isso não conterá shreds.

Para consumo de shreds, o endereço IP identifica o fluxo multicast e a porta identifica o serviço UDP nesse fluxo.
Todos os fluxos de shreds abaixo usam a porta UDP 7733 em doublezero1.

Você pode examinar os IPs de qualquer grupo multicast com:

doublezero multicast group list

Shreds de Líder

edge-solana-shreds: 233.84.178.1:7733

Shreds de Raiz

edge-solana-root: 233.84.178.16:7733

Shreds de Retransmissão

edge-solana-retrans-eu: 233.84.178.12:7733
edge-solana-retrans-apac: 233.84.178.13:7733
edge-solana-retrans-amer: 233.84.178.14:7733

Cabeçalho do Túnel GRE — XDP

O tráfego de shreds entregue pela rede é encapsulado em GRE. Pode ser necessário remover o cabeçalho GRE antes de alimentar os dados no seu pipeline existente (ex.: um deshredder baseado em XDP).

Ferramentas e Painéis

Placar do Edge

O Placar compara a velocidade de entrega de shreds entre o DoubleZero Edge e outros provedores, usando dados em nível de slot para comparar o desempenho em tempo real. Use este painel para ver as taxas de vitória dos shreds do Edge contra outros provedores. Você pode visualizar resultados apenas para shreds de líder, além da comparação completa do feed. Você também pode detalhar por região para ver o desempenho esperado.

Publicadores do Edge

A métrica "Publishing Shreds" no canto superior esquerdo do painel mostra o percentual total de peso de stake de todos os validadores Solana publicando shreds de líder no DoubleZero Edge. Você pode ver detalhes de cada publicador na rede.

Assinantes, Dispositivos e Atividade do Edge

Você pode facilmente pesquisar seu IP de Cliente nesta página para assentos inscritos e visualizar o status. Clique em assinaturas de assentos específicos para ver o histórico de pagamentos e atividade. Você também pode visualizar dispositivos disponíveis na página de Dispositivos e toda a atividade recente na página de Atividade.

Documentação da API de Dados

Para acesso programático aos endpoints de dados, consulte a documentação da API: https://data.malbeclabs.com/api/v1/docs.

Solução de Problemas

Se você encontrar um problema não coberto aqui, entre em contato pelo seu canal existente antes de tentar contorná-lo. Se você não tiver um canal, pesquise no Discord e abra um ticket se necessário.

Certifique-se de que seu Cliente está atualizado:

Execute: sudo apt update && sudo apt install doublezero-solana

Saldo de escrow insuficiente

Se o saldo do seu escrow estiver abaixo do preço da época na liquidação, o assento não será alocado, o túnel será encerrado e a permanência será perdida. Recarregue com shreds pay antes da próxima liquidação.

Assento não alocado após pagamento

Você pode ter pago tarde na época — o assento entra em vigor na próxima época.
Todos os assentos no dispositivo podem estar ocupados por titulares com maior permanência. Verifique os assentos disponíveis com shreds price.
Se você sacou antes da liquidação, o assento não era elegível.

Túnel não está subindo

Verifique se o daemon está em execução: sudo systemctl status doublezerod
Verifique se o reconciliador está habilitado: doublezero enable
Verifique se as regras de firewall estão configuradas (GRE, BGP, PIM, tráfego de shreds em doublezero1, porta 44880 em doublezero0)
Verifique se seu assento está ativo para a época atual: doublezero-solana shreds list
Verifique o status da sua conexão: doublezero status

O IP do cliente do daemon é autodescoberto a partir do IP público do seu host — verifique se ele corresponde ao --client-ip usado nos seus comandos de assento.

Aviso de época

O CLI avisa quando resta menos de 10% da época. Suas opções:

Aceitar com --accept-partial-epoch se você quiser o assento imediatamente
Aguardar a próxima época para obter cobertura de uma época completa

"Amount is below the current price"

O comando pay valida seu valor contra o preço mínimo da época (base do metro + prêmio do dispositivo). Use shreds price para verificar os preços atuais e aumente seu valor.

"Multicast user already exists"

Você já tem uma assinatura ativa por um caminho diferente. Desconecte primeiro com doublezero disconnect, depois tente novamente shreds pay.