--- title: "Direct Shreds - UDP Forwarding (Raw Shreds)" description: "O UDP Forwarding entrega Raw Shreds por UDP para um endereço IPv4 público e uma porta configurados e está disponível como UDP Forwarding Standard ou UDP Forwarding Premium." canonical: "https://erpc.global/pt/doc/shredstream/udp-forwarding/" locale: "pt" --- # Direct Shreds - UDP Forwarding (Raw Shreds) O UDP Forwarding entrega Raw Shreds por UDP para um único endereço IPv4 público e uma porta que você configura. O UDP Forwarding Standard e o UDP Forwarding Premium diferem na forma como os Shreds chegam até você vindos da região que você escolher: no Standard, a ERPC os encaminha a partir de um nó nessa região; no Premium, é a rede mesh que os encaminha. ## UDP Forwarding Standard **UDP Forwarding Standard** encaminha Raw Shreds por UDP para o endereço IPv4 público e a porta configurados para a sua assinatura. Selecione uma região disponível durante a configuração inicial e salve como destino um endereço IPv4 público válido e não vazio com sua porta. Você pode atualizar o destino depois. A ERPC aplica a configuração do encaminhamento em seu ciclo de atualização de 30 segundos, sem necessidade de ativação por heartbeat. Você também pode alterar a região depois, no painel, quantas vezes precisar. Alterar a região muda o IP de origem, portanto o firewall do lado receptor precisa permitir o novo IP de origem. A entrega é interrompida brevemente enquanto a assinatura passa para a nova região. Se a nova região não tiver capacidade no momento, a alteração não é realizada: nem a região nem o destino mudam. - A partir de um nó na região que você escolher, a ERPC encaminha Raw Shreds por UDP para o destino configurado, de modo que eles chegam até você de um único IP de origem. ## UDP Forwarding Premium **UDP Forwarding Premium** entrega Raw Shreds por UDP, a partir da rede mesh, para o endereço IPv4 público e a porta configurados para a sua assinatura. A rede mesh encaminha, de cada Shred, a cópia que chega primeiro a ela; qualquer IP de origem exibido no painel pode ser o remetente. Com o Premium, os Shreds muitas vezes chegam 1–3 ms antes do que com o Standard. Em 30 de outubro de 2026, um receptor da ERPC em Frankfurt recebeu o Standard e o Premium em paralelo, em uma única medição de 120 segundos. Para cada Shred que chegou por ambos, comparou-se o momento da primeira chegada pelo Standard e pelo Premium. Informe o endereço IPv4 público e a porta do seu próprio host receptor e selecione uma das 7 regiões disponíveis. Depois que você salva um destino, o status mostra “Aplicando”, e a entrega começa assim que as configurações são aplicadas. No firewall do lado receptor, permita cada IP de origem exibido no painel, com uma regra `/32` por IP. Uma mudança de região altera o conjunto de IPs de origem que o seu firewall precisa permitir. A entrega fica interrompida até que a nova região seja aplicada, e os novos IPs de origem aparecem no painel assim que isso acontece. Se a região selecionada não puder aceitar a alteração no momento, essa alteração não é salva, e a região e o destino que você já tinha salvado continuam como estavam. Enquanto uma alteração anterior ainda está sendo aplicada, ou logo depois que uma alteração foi aceita, novas alterações não são aceitas. Os IPs de origem também podem mudar mesmo sem troca de região. Quando isso exige novas regras no firewall, avisamos você por e-mail ou por meio da equipe de suporte. ## O que saber sobre o UDP - O UDP não oferece estabelecimento de conexão, retransmissão nem ordenação dos pacotes; é recomendável que o seu receptor trate os pacotes levando isso em conta. Nota: o endpoint compartilhado de Shreds gRPC funciona sobre TCP, por isso é mais lento que os Shreds via UDP. ## Teste com o Solana Stream SDK - Código de exemplo (`shreds-udp-rs`, Rust): a detecção de novos tokens é apenas um exemplo comum — troque-a pelo que você quiser detectar. https://github.com/ValidatorsDAO/solana-stream/tree/main/temp-release/shreds-udp-rs - Configure o seu receptor com o destino `ip:port` salvo para o UDP Forwarding. - Ainda não usa UDP? Execute o código de exemplo localmente ou no seu próprio servidor para explorar os logs e personalizar os hooks. ## Os pacotes UDP não chegam Primeiro, capture o tráfego na interface de rede do host. ### UDP Forwarding Standard O encaminhamento UDP começa automaticamente após a configuração do destino. Não é necessário ativá-lo por heartbeat; uma resposta `UNIMPLEMENTED` ao heartbeat não significa que o encaminhamento esteja desativado. Substitua os placeholders pelo IP de origem da ERPC exibido para o seu stream e pela porta de destino configurada. Linux (`tcpdump`): ```bash sudo tcpdump -ni any 'udp dst port and src host ' ``` Windows (`Pktmon`, execute como administrador): ```powershell pktmon filter add ERPC-UDP -t UDP -i -p pktmon start --capture --comp nics --log-mode real-time ``` ### UDP Forwarding Premium Substitua os placeholders de IP de origem pelos IPs de origem exibidos no painel, e `` pela porta de destino configurada. Linux (`tcpdump`): ```bash sudo tcpdump -ni any 'udp dst port and (src host or src host )' ``` Mantenha os parênteses: sem eles, o filtro `udp dst port` se aplica apenas ao primeiro IP de origem, e a captura registra todo o tráfego de cada IP de origem após o primeiro, em qualquer protocolo e porta. Use um termo `src host` para cada IP de origem; com um único IP de origem, remova o termo `or` e os parênteses. Windows (`Pktmon`, execute como administrador): ```powershell pktmon filter add ERPC-UDP-1 -t UDP -i -p pktmon filter add ERPC-UDP-2 -t UDP -i -p pktmon start --capture --comp nics --log-mode real-time ``` Adicione uma linha `pktmon filter add` para cada IP de origem, numerando os nomes dos filtros como mostrado; um único filtro que lista vários IPs captura, em vez disso, o tráfego entre esses IPs. Com um único IP de origem, mantenha apenas a primeira linha de filtro. ### Verificações do firewall e do receptor 1. Se a captura continuar em zero, verifique tanto o firewall do sistema operacional quanto os firewalls externos ao sistema operacional. A Hetzner pode filtrar o tráfego no Cloud Firewall ou no Robot Firewall, que atua na porta do switch. Na AWS, verifique o Security Group e a Network ACL da sub-rede. 2. Adicione a regra de permissão do seu plano: - UDP Forwarding Standard: Permita tráfego UDP de entrada vindo de `/32` para a porta de destino ``. Não restrinja a porta de origem, pois a ERPC usa portas de origem UDP dinâmicas. - UDP Forwarding Premium: Permita tráfego UDP de entrada vindo de cada `/32` para a porta de destino ``, com uma regra para cada IP de origem exibido no painel. Não restrinja a porta de origem. 3. Se os pacotes aparecerem na captura, mas não na aplicação, configure o receptor para escutar em `0.0.0.0:` em vez de localhost e, em seguida, verifique o firewall local e as configurações de socket/processo. Se nenhum pacote chegar após a atualização das regras, envie à equipe de suporte a duração da captura, a quantidade de pacotes, o IP de origem, o IP de destino e a porta de destino. Documentação oficial dos provedores: [Hetzner Cloud Firewall](https://docs.hetzner.com/cloud/firewalls/overview/), [Hetzner Robot Firewall](https://docs.hetzner.com/robot/dedicated-server/firewall/), [AWS Security Groups](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-security-groups.html), [AWS Network ACLs](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-network-acls.html) e [Microsoft Pktmon](https://learn.microsoft.com/en-us/windows-server/networking/technologies/pktmon/pktmon). ## Recursos - Todo o código e a documentação README estão no repositório do Solana Stream SDK: https://github.com/ValidatorsDAO/solana-stream