# Payload envelope

> The binary payload envelope shared by raw HTTP and QUIC streams for transactions and bundles.

<Note>
Supanode issues keys through [Telegram](https://telegram.me/supanode_tgs). Default minimum tip: 0.001 SOL; default rate: 15 sends/s per key per metro. Your key settings can differ. Declared tips are off by default and require enablement and a payment arrangement with Supanode. If your key returns `partner_declared_tips`, use an on-chain transfer instead.
</Note>

Every raw channel carries this payload: [`/binary`](https://supanode.xyz/docs/solana/sender/reference/http/binary), [`/plaintext`](https://supanode.xyz/docs/solana/sender/reference/http/plaintext) and [QUIC](https://supanode.xyz/docs/solana/sender/reference/quic#streams) streams.

A payload whose first byte is not `0x00` is one signed transaction in wire format.

A payload that starts with `0x00` is an envelope:

| Offset | Size | Field |
| --- | --- | --- |
| 0 | 1 | `0x00` |
| 1 | 1 | Flags: `0x01` declared tip present, `0x02` bundle body. No other bits may be set. |
| 2 | 8 | Declared tip in lamports, `u64` little endian. Present only when flags include `0x01`. |
| 2 or 10 | rest | The body. |

Without the `0x02` flag, the body is one transaction. With it, the body is:

| Size | Field |
| --- | --- |
| 1 | Transaction count, 1 to 4 |
| 2 | Length of the next transaction, `u16` little endian, 1 to 4,096 |
| length | The transaction's wire bytes |

The length and transaction pair repeats once per transaction, and no bytes may follow the last one. The largest payload, a declared-tip bundle of four 4,096-byte transactions, is 16,403 bytes.

| Payload | Bytes |
| --- | --- |
| One transaction | `TX` |
| One transaction, declared tip of 1,000,000 lamports | `00 01 40 42 0f 00 00 00 00 00 TX` |
| Bundle of two | `00 02 02 L1 L1 TX1 L2 L2 TX2` |
| Bundle of two, declared tip of 1,000,000 lamports | `00 03 40 42 0f 00 00 00 00 00 02 L1 L1 TX1 L2 L2 TX2` |

Here `L1 L1` is the little endian length of `TX1`. An envelope that breaks these rules is refused as [`malformed`](https://supanode.xyz/docs/solana/sender/reference/errors#malformed) with problem `invalid_envelope`, or as [`bundle_size`](https://supanode.xyz/docs/solana/sender/reference/errors#bundle_size) when the count is 0 or above 4.
