{"id":"crc-catalog-identify","version":"1.0.0","description":"Identify pinned CRC RevEng algorithms that match every explicit message and check sample.","supported_operations":["which pinned crc algorithm matches these samples","identify catalogue crc from an observed check","intersect crc candidates across several packets","find the reveng crc name for a frame check","narrow a crc variant using message and checksum pairs","lookup a named crc from explicit sample encodings","איתור אלגוריתם מהקטלוג לפי דוגמאות"],"unsupported_operations":["compute a crc when no observed check is supplied","search algorithms outside the pinned reveng catalogue","guess the message encoding when the caller omits it"],"semantics":["Search only the pinned CRC RevEng catalogue subset (data_version crc-reveng-catalogue-2026-10-21). A candidate is kept only when its width equals the sample width and its CRC of the sample message equals check_hex, for every sample.","message_encoding is required on every sample and is one of ascii, utf8, or hex. There is no default encoding, no trimming, no BOM stripping, and no Unicode normalization.","ascii accepts code points U+0000 through U+007F. utf8 uses the UTF-8 bytes of a well-formed string. hex is an even number of hexadecimal digits, case-insensitive, with no spaces or 0x prefix.","check_hex is case-insensitive and must be exactly width/4 hexadecimal digits. Candidates are sorted by canonical catalogue name in ascending UTF-16 code unit order, then cut to candidate_limit.","Omitting candidate_limit means 8, the declared maximum. A smaller positive limit returns the first names in that order and sets truncated when match_count is larger. match_count is the full intersection size.","An empty message is zero bytes and is a valid sample. Zero matches return an empty candidates array, not an error.","Disclaimer: format transform only; provides no confidentiality, integrity, or authenticity."],"limits":{"max_samples":8,"max_sample_bytes":256,"max_total_message_bytes":1024,"max_candidates":8},"pricing":{"status":"unpriced","charge_usd":null},"input_schema":{"type":"object","additionalProperties":false,"required":["samples"],"properties":{"samples":{"type":"array","minItems":1,"maxItems":8,"items":{"type":"object","additionalProperties":false,"required":["message_encoding","message","width","check_hex"],"properties":{"message_encoding":{"type":"string","enum":["ascii","utf8","hex"]},"message":{"type":"string","maxLength":2048},"width":{"type":"integer","enum":[8,16,24,32,64]},"check_hex":{"type":"string","minLength":2,"maxLength":16,"pattern":"^[0-9a-fA-F]+$"}}}},"candidate_limit":{"type":"integer","minimum":1,"maximum":8}}},"output_schema":{"type":"object","additionalProperties":false,"required":["data_version","match_count","returned_count","truncated","candidates"],"properties":{"data_version":{"type":"string","const":"crc-reveng-catalogue-2026-10-21"},"match_count":{"type":"integer","minimum":0,"maximum":64},"returned_count":{"type":"integer","minimum":0,"maximum":8},"truncated":{"type":"boolean"},"candidates":{"type":"array","maxItems":8,"items":{"type":"object","additionalProperties":false,"required":["name","aliases","width","poly_hex","init_hex","refin","refout","xorout_hex","check_hex","residue_hex"],"properties":{"name":{"type":"string","minLength":1,"maxLength":24},"aliases":{"type":"array","maxItems":8,"items":{"type":"string","minLength":1,"maxLength":24}},"width":{"type":"integer","enum":[8,16,24,32,64]},"poly_hex":{"type":"string","pattern":"^[0-9a-f]+$","minLength":2,"maxLength":16},"init_hex":{"type":"string","pattern":"^[0-9a-f]+$","minLength":2,"maxLength":16},"refin":{"type":"boolean"},"refout":{"type":"boolean"},"xorout_hex":{"type":"string","pattern":"^[0-9a-f]+$","minLength":2,"maxLength":16},"check_hex":{"type":"string","pattern":"^[0-9a-f]+$","minLength":2,"maxLength":16},"residue_hex":{"type":"string","pattern":"^[0-9a-f]+$","minLength":2,"maxLength":16}}}}}},"examples":[{"input":{"samples":[{"message_encoding":"ascii","message":"123456789","width":32,"check_hex":"cbf43926"}]},"output":{"data_version":"crc-reveng-catalogue-2026-10-21","match_count":1,"returned_count":1,"truncated":false,"candidates":[{"name":"CRC-32/ISO-HDLC","aliases":["CRC-32","CRC-32/ADCCP","CRC-32/V-42","CRC-32/XZ","PKZIP"],"width":32,"poly_hex":"04c11db7","init_hex":"ffffffff","refin":true,"refout":true,"xorout_hex":"ffffffff","check_hex":"cbf43926","residue_hex":"debb20e3"}]}},{"input":{"samples":[{"message_encoding":"ascii","message":"123456789","width":8,"check_hex":"A1"}]},"output":{"data_version":"crc-reveng-catalogue-2026-10-21","match_count":2,"returned_count":2,"truncated":false,"candidates":[{"name":"CRC-8/I-432-1","aliases":["CRC-8/ITU"],"width":8,"poly_hex":"07","init_hex":"00","refin":false,"refout":false,"xorout_hex":"55","check_hex":"a1","residue_hex":"ac"},{"name":"CRC-8/MAXIM-DOW","aliases":["CRC-8/MAXIM"],"width":8,"poly_hex":"31","init_hex":"00","refin":true,"refout":true,"xorout_hex":"00","check_hex":"a1","residue_hex":"00"}]}},{"input":{"samples":[{"message_encoding":"hex","message":"313233343536373839","width":16,"check_hex":"2189"}]},"output":{"data_version":"crc-reveng-catalogue-2026-10-21","match_count":1,"returned_count":1,"truncated":false,"candidates":[{"name":"CRC-16/KERMIT","aliases":["CRC-16/CCITT","CRC-16/CCITT-TRUE","CRC-16/V-41-LSB"],"width":16,"poly_hex":"1021","init_hex":"0000","refin":true,"refout":true,"xorout_hex":"0000","check_hex":"2189","residue_hex":"0000"}]}}],"execute_url":"/v1/tools/crc-catalog-identify/versions/1.0.0/execute"}