Documentation
Receiving and decoding raw shreds
Raw UDP is the fastest way to get Solana data and the least forgiving. There is no ordering, no retransmission and no backpressure, so a receiver that works at 5,000 packets a second is a thing you build rather than a thing you install. These pages are how.
If nothing is arriving, start here
Everything we send comes from 64.130.40.90. Inbound UDP from that address has to be allowed on your port. It is the cause of most first-time failures, and it is not something we can fix from our side. Firewall configuration
Getting started
From a paid account to a packet on your machine.
- shredstream.sh documentationThis page lets you choose the correct setup, delivery, and troubleshooting document for a service destination.
- QuickstartThis page lets you activate a paid destination and confirm end-to-end UDP delivery on a Linux server.
- Build a five-minute UDP receiverThis page lets you run a minimal source-filtered UDP receiver and distinguish a verification challenge from stream traffic.
- Account and destinationsThis page lets you configure, verify, renew, and change the destination attached to a service purchase.
- Delivery authenticationThis page lets you complete destination verification and enforce the source-IP authentication used in the UDP delivery path.
- Inspect your first shred packetThis page lets you prove that the paid shred stream reaches your application before you add shred decoding.
- Get supportThis page lets you isolate a destination problem and send support the evidence needed to investigate it.
- Frequently asked questionsThis page lets you resolve common service setup and delivery questions without assuming undocumented behavior.
Delivery
The wire contract, the source address, and getting through your own firewall.
- UDP wire contractThis page lets you design a receiver that conforms to the raw UDP delivery contract without assuming TCP behavior.
- Packet formatThis page lets you recognize verification traffic, retain complete raw shred payloads, and validate service-level packet sizes.
- Source addressesThis page lets you build capture, firewall, and receiver filters around the documented service source address.
- Destination managementThis page lets you manage the complete operational lifecycle of one paid IP and UDP port destination.
- IP allowlistingThis page lets you define and validate the source-specific allowlist used to authenticate inbound service UDP traffic.
- Change a destinationThis page lets you prepare, verify, and validate a replacement IP and UDP port for an existing destination.
- Firewall configurationThis page lets you permit verification and shred traffic from the fixed service source using five common firewall platforms.
- NAT traversalThis page lets you deliver the feed through a static inbound UDP port mapping to a receiver behind NAT.
- MTU configurationThis page lets you verify that the customer network can carry a maximum-size service datagram without avoidable fragmentation.
- Bandwidth requirementsThis page lets you translate the measured feed into capacity checks for one receiver path.
- Service statesThis page lets you determine which destination condition to inspect when verification or delivery does not proceed.
- Delivery guaranteesThis page lets you separate documented delivery behavior from guarantees that the service does not currently specify.
Building a receiver
Sockets, buffers, threads, and detecting the drops you would otherwise never see.
- Receiver requirementsPrepare a host, network path, and operating system for sustained raw shred delivery.
- Set up the UDP receive socketBind and configure a UDP socket that exposes loss instead of hiding it.
- Size the UDP receive bufferTurn an explicit burst tolerance into a verified Linux receive-buffer setting.
- Build a multi-threaded receive pipelineKeep the socket draining while CPU-heavy shred work runs in parallel.
- Detect dropped UDP shredsDistinguish network loss from NIC, kernel, socket-buffer, and application loss.
- Handle packet burstsKeep current shreds flowing when packet arrivals temporarily exceed the average rate.
- Define receiver health checksMake orchestration and operators distinguish a live process from a useful receiver.
- Monitor your receiverBuild metrics and alerts that locate latency and loss in the receiver pipeline.
- Plan receiver capacitySize a receiver and prove it can sustain the feed before production activation.
- Run a minimal viable receiverConfirm end-to-end delivery by printing common shred headers from live datagrams.
- Production receiver checklistApply a repeatable launch gate to a raw UDP shred receiver.
Processing shreds
Signatures, FEC sets, recovery, reassembly, and getting to transactions.
- Solana shred anatomy referenceIdentify every logical region needed to parse, authenticate, recover, and reassemble a shred.
- Parse the shred headerTurn an untrusted UDP datagram into validated metadata without unchecked offsets or guessed variants.
- Verify shred signaturesAuthenticate each parsed shred against the validator scheduled to lead its slot.
- Data shreds and coding shredsRoute each shred type into the correct recovery and reassembly path.
- Group shreds into FEC setsBuild compatible Reed-Solomon shard arrays from reordered and duplicated UDP input.
- Recover missing shreds with Reed-SolomonRecover absent data members without treating unauthenticated parity output as valid ledger data.
- Verify Merkle shredsBind every accepted erasure shard to the root authenticated by the scheduled leader.
- Deduplicate shredsPrevent duplicate work without hiding equivocation, corruption, or retransmitter-only differences.
- Order and buffer data shredsEmit consecutive data-shred ranges that are safe to deshred and decode.
- Reconstruct Solana entriesConvert authenticated ordered data shreds into typed entries at each completion boundary.
- Extract transactions from entriesEmit transaction identities, messages, instructions, and complete account keys without losing version context.
- Reference shred receiver and deshredderProvide one annotated control flow for a production deshredder built against a pinned Agave release.