{
  "id": "wire-format/tls-handshake",
  "family": "wire-format",
  "slug": "tls-handshake",
  "title": "TLS 1.3 handshake message framing",
  "summary": "TLS 1.3 handshake messages are framed within TLS records (content type 0x16). Each handshake message: 1-byte message type (ClientHello 0x01, ServerHello 0x02, EncryptedExtensions 0x08, Certificate 0x0B, CertificateVerify 0x0F, Finished 0x14, ...), 3-byte length (big-endian), then the message body. Multiple handshake messages can share a record.",
  "kind": "wire-format",
  "aliases": [
    "TLS 1.3 handshake message framing"
  ],
  "status": "standard",
  "verification": "verified",
  "tier": "B",
  "source_url": "https://www.rfc-editor.org/",
  "source_version": "retrieved 2026-05-29",
  "retrieved_date": "2026-05-29",
  "ext_type": "wire-format@1",
  "ext": {
    "spec": "RFC 8446",
    "summary": "TLS 1.3 handshake messages are framed within TLS records (content type 0x16). Each handshake message: 1-byte message type (ClientHello 0x01, ServerHello 0x02, EncryptedExtensions 0x08, Certificate 0x0B, CertificateVerify 0x0F, Finished 0x14, ...), 3-byte length (big-endian), then the message body. Multiple handshake messages can share a record.",
    "structure": [
      {
        "field": "Handshake type",
        "size": "1 byte",
        "meaning": "0x01 ClientHello, 0x02 ServerHello, 0x08 EncryptedExtensions, 0x0B Certificate, 0x0D CertificateRequest, 0x0F CertificateVerify, 0x14 Finished, 0x16 KeyUpdate, ... ."
      },
      {
        "field": "Length",
        "size": "3 bytes",
        "meaning": "Length of the handshake message body (big-endian, max 2^24-1)."
      },
      {
        "field": "Body",
        "size": "= Length",
        "meaning": "Message-specific content (ClientHello: version, random, session id, cipher suites, extensions, ...)."
      }
    ],
    "example_hex": "16 03 03 00 05 01 00 00 01 00",
    "example_decoded": "TLS record (handshake, TLS 1.2 legacy version, 5 bytes) wrapping a ClientHello (type 1, length 1, body empty-ish)",
    "notes": [
      "TLS 1.3 handshake messages after ServerHello are encrypted (content type 0x17 application data on the wire, with inner type 0x16).",
      "ClientHello carries: legacy_version 0x0303, random (32 bytes), session_id, cipher_suites, compression_methods (must be [0]), extensions.",
      "Key extensions: supported_versions (0x002B), supported_groups (0x000A), signature_algorithms (0x000D), key_share (0x0033), server_name (0x0000, SNI).",
      "Finished contains a verify_data = HMAC(finished_key, transcript_hash).",
      "0-RTT data is sent in early data (content type 0x17 with inner type 0x17) before the handshake completes."
    ]
  },
  "updated": "2026-05-29"
}
