🚀 Creating a Stream

This guide walks you through creating a ShredStream.com stream from start to finish. By the end, you will have live Solana data arriving at your server — over UDP, or over gRPC if you chose a Decoded Shred Stream in gRPC mode.

1️⃣ Choose a Product and a Duration

From your dashboard, click New Stream. First pick the product — Raw Shred Stream (raw shreds over UDP, for your own receiver) or Decoded Shred Stream (transactions already reassembled, nothing to decode — over UDP or gRPC) — then how long you want your stream to run:

Every option includes one connection (a UDP destination, or a gRPC access token for Decoded Shred Stream) and full access to all features. You can extend your stream at any time — see Pricing for details.

2️⃣ Select a Region

Choose the region closest to your server to minimize network latency. ShredStream.com operates in several regions worldwide (Frankfurt, Amsterdam, New York, Tokyo, and more), and the wizard shows live availability for each of them. Some regions are reserved for the Monthly duration.

The region is chosen when you create the stream. To receive in another region as well, create a second stream there.

3️⃣ Configure Your Connection

For UDP delivery, enter the destination where ShredStream.com should send your data:

• IP address — your server's public IPv4 address
• UDP port — any port in the range 1024–65535

Each stream has exactly one connection. You can change your UDP destination at any time from the stream detail page, and switch a Decoded Shred Stream between UDP and gRPC for free.

4️⃣ Review, Name, and Pay

The final step combines the order summary, stream naming, and payment:

1. Name your stream — give it a descriptive name. You can rename it later.
2. Review the total — payable in SOL on Solana.
3. Review the summary — product, duration, region, connection, and total amount.
4. Confirm and pay — a payment modal will display a QR code and a payment address. Scan the QR code or copy the address and send the exact SOL amount from any wallet or exchange. The SOL amount is locked for a limited time (a countdown is shown); if it expires, refresh the payment to get an updated amount.

Once the payment is detected on-chain, your stream begins provisioning automatically.

If you encounter any issue during payment, reach out on Discord or Telegram.

⏳ What Happens Next

After payment confirms, your stream transitions through two statuses:

Once the status shows Active, data begins arriving at your configured IP and port immediately. In gRPC mode, the stream page now shows your endpoint and access token: connect with the decoded-shredstream client.

✅ Verify Your Stream

1️⃣ Check the Dashboard

Open the stream detail page and confirm that:

• The status is Active
• The connection shows the correct IP and port (UDP) or the endpoint and access token (gRPC)
• The region matches your selection

2️⃣ Test Reception

For UDP delivery, run this quick test on your server to verify datagrams are arriving:

nc -ul 0.0.0.0 8001 | xxd | head -20

Replace 8001 with the port you configured. You should see hex dumps appear as packets arrive. For gRPC delivery, run the decoded-shredstream client with your endpoint and token — see gRPC Delivery.

➡️ Next Steps

• Raw Shred Quickstart — bind a UDP socket and receive raw shred datagrams
• Receiving Decoded Transactions — install decoded-shredstream and iterate transactions in a few lines
• Network Setup — firewall rules and buffer tuning
• Best Practices — optimize for high-throughput production workloads
• Troubleshooting — diagnose and fix common issues if data is not arriving