{"record":{"id":"e5fc783e35063392","repo":"gchq/CyberChef","slug":"3-custom-lugs-must-be-29-long-and-can-only-includ","errorCode":null,"errorMessage":"Χ3 custom lugs must be 29 long and can only include . or x","messagePattern":"Χ3 custom lugs must be 29 long and can only include \\. or x","errorType":"exception","errorClass":"OperationError","httpStatus":null,"severity":"error","filePath":"src/core/operations/Lorenz.mjs","lineNumber":291,"sourceCode":"        if (x2<1 || x2>31) throw new OperationError(\"Χ2 start must be between 1 and 31\");\n        if (x3<1 || x3>29) throw new OperationError(\"Χ3 start must be between 1 and 29\");\n        if (x4<1 || x4>26) throw new OperationError(\"Χ4 start must be between 1 and 26\");\n        if (x5<1 || x5>23) throw new OperationError(\"Χ5 start must be between 1 and 23\");\n\n        // Initialise chosen wheel pattern\n        let chosenSetting = \"\";\n        if (pattern === \"Custom\") {\n            const re = new RegExp(\"^[.xX]*$\");\n            if (lugs1.length !== 43 || !re.test(lugs1)) throw new OperationError(\"Ψ1 custom lugs must be 43 long and can only include . or x \");\n            if (lugs2.length !== 47 || !re.test(lugs2)) throw new OperationError(\"Ψ2 custom lugs must be 47 long and can only include . or x\");\n            if (lugs3.length !== 51 || !re.test(lugs3)) throw new OperationError(\"Ψ3 custom lugs must be 51 long and can only include . or x\");\n            if (lugs4.length !== 53 || !re.test(lugs4)) throw new OperationError(\"Ψ4 custom lugs must be 53 long and can only include . or x\");\n            if (lugs5.length !== 59 || !re.test(lugs5)) throw new OperationError(\"Ψ5 custom lugs must be 59 long and can only include . or x\");\n            if (lugm37.length !== 37 || !re.test(lugm37)) throw new OperationError(\"M37 custom lugs must be 37 long and can only include . or x\");\n            if (lugm61.length !== 61 || !re.test(lugm61)) throw new OperationError(\"M61 custom lugs must be 61 long and can only include . or x\");\n            if (lugx1.length !== 41 || !re.test(lugx1)) throw new OperationError(\"Χ1 custom lugs must be 41 long and can only include . or x\");\n            if (lugx2.length !== 31 || !re.test(lugx2)) throw new OperationError(\"Χ2 custom lugs must be 31 long and can only include . or x\");\n            if (lugx3.length !== 29 || !re.test(lugx3)) throw new OperationError(\"Χ3 custom lugs must be 29 long and can only include . or x\");\n            if (lugx4.length !== 26 || !re.test(lugx4)) throw new OperationError(\"Χ4 custom lugs must be 26 long and can only include . or x\");\n            if (lugx5.length !== 23 || !re.test(lugx5)) throw new OperationError(\"Χ5 custom lugs must be 23 long and can only include . or x\");\n            chosenSetting = INIT_PATTERNS[\"No Pattern\"];\n            chosenSetting.S[1] = this.readLugs(lugs1);\n            chosenSetting.S[2] = this.readLugs(lugs2);\n            chosenSetting.S[3] = this.readLugs(lugs3);\n            chosenSetting.S[4] = this.readLugs(lugs4);\n            chosenSetting.S[5] = this.readLugs(lugs5);\n            chosenSetting.M[1] = this.readLugs(lugm61);\n            chosenSetting.M[2] = this.readLugs(lugm37);\n            chosenSetting.X[1] = this.readLugs(lugx1);\n            chosenSetting.X[2] = this.readLugs(lugx2);\n            chosenSetting.X[3] = this.readLugs(lugx3);\n            chosenSetting.X[4] = this.readLugs(lugx4);\n            chosenSetting.X[5] = this.readLugs(lugx5);\n        } else {\n            chosenSetting = INIT_PATTERNS[pattern];\n        }","sourceCodeStart":273,"sourceCodeEnd":309,"githubUrl":"https://github.com/gchq/CyberChef/blob/4290ea753912378913b1f3f54e0fc5720afeda5d/src/core/operations/Lorenz.mjs#L273-L309","documentation":"Thrown by the Lorenz SZ operation when 'Wheel Pattern' is 'Custom' and the Χ3 (chi-3) lug string (arg[28], 'Χ3 lugs (29)') is invalid. The Χ3 wheel has 29 cam positions; the supplied string must be exactly 29 characters matching /^[.xX]*$/. Enforced at Lorenz.mjs:291, after the Χ1 and Χ2 checks pass.","triggerScenarios":"pattern='Custom' with lugx3 of length != 29 or containing characters outside {'.', 'x', 'X'}.","commonSituations":"Pasting a 31-char Χ2 pattern into the Χ3 field; transcribed patterns with off-by-one length; non-ASCII lookalikes for 'x' (e.g. Cyrillic х); whitespace introduced by formatting.","solutions":["Set the Χ3 lug string to exactly 29 characters using only '.', 'x', or 'X' (29 is the chi-3 wheel cam count).","Use a preset wheel pattern instead of 'Custom' if you do not need custom Χ3 settings.","Validate length and alphabet before invoking the operation.","Re-verify the source pattern is specifically for the chi-3 wheel."],"exampleFix":"// before\nlugx3 = \"..xx..x.xxx...xx...xx..xx.xx\";   // 30 chars\n\n// after — exactly 29 chars\nlugx3 = \"..xx..x.xxx...xx...xx..xx.xx.\";","handlingStrategy":"validation","validationCode":"const CHI3_LEN = 29;\nconst lugRe = /^[.xX]*$/;\nfunction validChi3(lugx3) {\n  return typeof lugx3 === 'string' && lugx3.length === CHI3_LEN && lugRe.test(lugx3);\n}\nif (!validChi3(args[28])) throw new Error('Χ3 lugs must be 29 chars of . x X');","typeGuard":"function isChi3Lugs(v): v is string {\n  return typeof v === 'string' && v.length === 29 && /^[.xX]*$/.test(v);\n}","tryCatchPattern":null,"preventionTips":["Assert the chi-3 length is exactly 29 before invoking.","Strip non-ASCII lookalikes for 'x' before validation.","Prefer preset patterns unless custom chi-3 is required."],"tags":["lorenz","cipher","validation","input-length","wheel-pattern"],"backgroundTag":null,"analyzedSha":"4290ea753912378913b1f3f54e0fc5720afeda5d","analyzedAt":"2026-08-13T06:05:50.210Z","schemaVersion":2},"datasetVersion":"2026-08-13T09:17:06.757Z"}