{
  "$schema": "../../schema/test-vector.schema.json",
  "name": "Trace Payload - Basic",
  "spec_ref": "src/10-payload-trace.md",
  "protocol_version": 0,
  "description": "Tests the basic 9-byte TRACE payload structure: tag(4) + auth_code(4) + flags(1).",
  "vectors": [
    {
      "id": "trc-001",
      "description": "Basic trace with tag=1, auth_code=2, flags=0",
      "type": "encode_decode",
      "structured": {
        "header": {
          "version": 0,
          "payload_type": "trace",
          "route_type": "flood"
        },
        "path": {
          "hash_size": 1,
          "hash_count": 0,
          "hashes": []
        },
        "payload": {
          "tag": 1,
          "auth_code": 2,
          "flags": 0
        }
      },
      "binary": "25 00 01000000 02000000 00",
      "notes": "tag=1 LE=01000000, auth_code=2 LE=02000000, flags=0."
    },
    {
      "id": "trc-002",
      "description": "Trace with large tag and auth_code values",
      "type": "encode_decode",
      "structured": {
        "header": {
          "version": 0,
          "payload_type": "trace",
          "route_type": "flood"
        },
        "path": {
          "hash_size": 1,
          "hash_count": 0,
          "hashes": []
        },
        "payload": {
          "tag": 4294967295,
          "auth_code": 305419896,
          "flags": 0
        }
      },
      "binary": "25 00 FFFFFFFF 78563412 00",
      "notes": "tag=0xFFFFFFFF, auth_code=0x12345678 LE=78563412."
    },
    {
      "id": "trc-003",
      "description": "Trace with flags indicating 1-byte path hash size (flags & 0x03 = 0)",
      "type": "encode_decode",
      "structured": {
        "header": {
          "version": 0,
          "payload_type": "trace",
          "route_type": "flood"
        },
        "path": {
          "hash_size": 1,
          "hash_count": 0,
          "hashes": []
        },
        "payload": {
          "tag": 100,
          "auth_code": 200,
          "flags": 0
        }
      },
      "binary": "25 00 64000000 C8000000 00",
      "notes": "flags=0: path_hash_size = 1 << (0 & 3) = 1 byte."
    },
    {
      "id": "trc-004",
      "description": "Trace with flags indicating 2-byte path hash size (flags & 0x03 = 1)",
      "type": "encode_decode",
      "structured": {
        "header": {
          "version": 0,
          "payload_type": "trace",
          "route_type": "flood"
        },
        "path": {
          "hash_size": 1,
          "hash_count": 0,
          "hashes": []
        },
        "payload": {
          "tag": 100,
          "auth_code": 200,
          "flags": 1
        }
      },
      "binary": "25 00 64000000 C8000000 01",
      "notes": "flags=1: path_hash_size = 1 << (1 & 3) = 2 bytes."
    },
    {
      "id": "trc-005",
      "description": "Trace sent via direct routing with path hashes appended to payload",
      "type": "encode_decode",
      "structured": {
        "header": {
          "version": 0,
          "payload_type": "trace",
          "route_type": "direct"
        },
        "path": {
          "hash_size": 1,
          "hash_count": 0,
          "hashes": []
        },
        "payload": {
          "data": "01000000 02000000 00 AABBCC"
        }
      },
      "binary": "26 00 01000000 02000000 00 AABBCC",
      "notes": "Header 0x26 = TRACE(9)+DIRECT(2). path_len=0 (path field used for SNR). Payload: 9-byte header + 3 path hash bytes. Using raw payload since the appended hashes are semantically part of the trace."
    }
  ]
}