[
{"fn": "generateRecoveryCodes", "name": "one code from bytes 0..9: 80 bits as 16 Crockford characters", "args": [[0, 1, 2, 3, 4, 5, 6, 7, 8, 9], 1], "expect": ["000g-40r4-0m30-e209"]},
{"fn": "generateRecoveryCodes", "name": "all zero bytes are all zeros", "args": [[0, 0, 0, 0, 0, 0, 0, 0, 0, 0], 1], "expect": ["0000-0000-0000-0000"]},
{"fn": "generateRecoveryCodes", "name": "all 0xff bytes are the last letter throughout", "args": [[255, 255, 255, 255, 255, 255, 255, 255, 255, 255], 1], "expect": ["zzzz-zzzz-zzzz-zzzz"]},
{"fn": "generateRecoveryCodes", "name": "three codes take consecutive 10-byte slices in order", "args": [[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29], 3], "expect": ["000g-40r4-0m30-e209", "185g-r38e-1w81-24gk", "2gah-c5rr-34d1-p70x"]},
{"fn": "generateRecoveryCodes", "name": "extra entropy past count*10 bytes is ignored", "args": [[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29], 2], "expect": ["000g-40r4-0m30-e209", "185g-r38e-1w81-24gk"]},
{"fn": "generateRecoveryCodes", "name": "a mixed byte pattern", "args": [[222, 173, 190, 239, 1, 35, 69, 103, 137, 171], 1], "expect": ["vtpv-xvr1-4d2p-f2db"]},
{"fn": "generateRecoveryCodes", "name": "too few bytes for the count", "args": [[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 1, 1, 1, 1, 1, 1, 1, 1, 1], 2], "expectError": "entropy must hold at least 10 bytes per code: 20 needed, 19 given"},
{"fn": "generateRecoveryCodes", "name": "a count of 0", "args": [[0, 1, 2, 3, 4, 5, 6, 7, 8, 9], 0], "expectError": "count must be a whole number from 1 to 50"},
{"fn": "generateRecoveryCodes", "name": "a count over 50", "args": [[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164, 165, 166, 167, 168, 169, 170, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 223, 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237, 238, 239, 240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 251, 252, 253, 254, 255, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164, 165, 166, 167, 168, 169, 170, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 223, 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237, 238, 239, 240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 251, 252, 253, 254, 255], 51], "expectError": "count must be a whole number from 1 to 50"},
{"fn": "generateRecoveryCodes", "name": "a byte over 255", "args": [[256, 0, 0, 0, 0, 0, 0, 0, 0, 0], 1], "expectError": "entropy must be a list of integers from 0 to 255"},
{"fn": "generateRecoveryCodes", "name": "a negative byte", "args": [[-1, 0, 0, 0, 0, 0, 0, 0, 0, 0], 1], "expectError": "entropy must be a list of integers from 0 to 255"},
{"fn": "normaliseRecoveryCode", "name": "a generated code loses its hyphens", "args": ["vtpv-xvr1-4d2p-f2db"], "expect": "vtpvxvr14d2pf2db"},
{"fn": "normaliseRecoveryCode", "name": "upper case and spaces as typed", "args": [" VTPV XVR1 4D2P F2DB "], "expect": "vtpvxvr14d2pf2db"},
{"fn": "normaliseRecoveryCode", "name": "i and l read as 1, o read as 0", "args": ["IL0O-abcd-efgh-jkmn"], "expect": "1100abcdefghjkmn"},
{"fn": "normaliseRecoveryCode", "name": "u is not in the alphabet", "args": ["uuuu-abcd-efgh-jkmn"], "expect": null},
{"fn": "normaliseRecoveryCode", "name": "15 characters is too short", "args": ["abcd-efgh-jkmn-pqr"], "expect": null},
{"fn": "normaliseRecoveryCode", "name": "17 characters is too long", "args": ["abcd-efgh-jkmn-pqrst"], "expect": null},
{"fn": "normaliseRecoveryCode", "name": "the empty string", "args": [""], "expect": null},
{"fn": "normaliseRecoveryCode", "name": "a full-width letter is not ASCII and is refused", "args": ["abcd-efgh-jkmn-pqrs"], "expect": null},
{"fn": "normaliseRecoveryCode", "name": "a trailing newline is not whitespace we drop", "args": ["abcd-efgh-jkmn-pqrs\n"], "expect": null},
{"fn": "hashRecoveryCode", "name": "the stored hash of a generated code", "args": ["vtpv-xvr1-4d2p-f2db"], "expect": "ea9c4071abd35fa50aa34307961d4a3f2fb25f307daa10c1f78ce462ca3bb6e1"},
{"fn": "hashRecoveryCode", "name": "typed differently, the same hash", "args": ["VTPV XVR1 4D2P F2DB"], "expect": "ea9c4071abd35fa50aa34307961d4a3f2fb25f307daa10c1f78ce462ca3bb6e1"},
{"fn": "hashRecoveryCode", "name": "all zeros", "args": ["0000-0000-0000-0000"], "expect": "90a768aff01cf5e1d699927179a2c82455a9428eca6669681709a10660672071"},
{"fn": "hashRecoveryCode", "name": "o and l typed for 0 and 1 hash as the digits", "args": ["oooo-llll-0000-1111"], "expect": "84e30ba19fdce78656ac4fcaffe366f58a528c5739becb836ea1745575477ff4"},
{"fn": "hashRecoveryCode", "name": "the code from bytes 0..9", "args": ["000g-40r4-0m30-e209"], "expect": "02734a8cb7d9e671c0e80b3eee14dc9ad421b0bb87d15a6fef52f8f121aab497"},
{"fn": "hashRecoveryCode", "name": "a code of the wrong length", "args": ["abcd-efgh"], "expectError": "not a recovery code"},
{"fn": "hashRecoveryCode", "name": "a code with u in it", "args": ["uuuu-abcd-efgh-jkmn"], "expectError": "not a recovery code"},
{"fn": "hashRecoveryCode", "name": "the empty string", "args": [""], "expectError": "not a recovery code"},
{"fn": "consumeRecoveryCode", "name": "the first code matches and is removed", "args": ["000g-40r4-0m30-e209", ["02734a8cb7d9e671c0e80b3eee14dc9ad421b0bb87d15a6fef52f8f121aab497", "d6f24e147c01ca863e9fdc7b35bef9398eadd1bafd254fd933fc8dcb6d4ba605", "b80588adecc76b1a8269a92c3877d2d3dccdade4ecc8bf1581eadc97ded65bd0"]], "expect": {"valid": true, "index": 0, "remaining": ["d6f24e147c01ca863e9fdc7b35bef9398eadd1bafd254fd933fc8dcb6d4ba605", "b80588adecc76b1a8269a92c3877d2d3dccdade4ecc8bf1581eadc97ded65bd0"]}},
{"fn": "consumeRecoveryCode", "name": "the middle code, typed in capitals with spaces", "args": ["185G R38E 1W81 24GK", ["02734a8cb7d9e671c0e80b3eee14dc9ad421b0bb87d15a6fef52f8f121aab497", "d6f24e147c01ca863e9fdc7b35bef9398eadd1bafd254fd933fc8dcb6d4ba605", "b80588adecc76b1a8269a92c3877d2d3dccdade4ecc8bf1581eadc97ded65bd0"]], "expect": {"valid": true, "index": 1, "remaining": ["02734a8cb7d9e671c0e80b3eee14dc9ad421b0bb87d15a6fef52f8f121aab497", "b80588adecc76b1a8269a92c3877d2d3dccdade4ecc8bf1581eadc97ded65bd0"]}},
{"fn": "consumeRecoveryCode", "name": "the last code leaves the first two", "args": ["2gah-c5rr-34d1-p70x", ["02734a8cb7d9e671c0e80b3eee14dc9ad421b0bb87d15a6fef52f8f121aab497", "d6f24e147c01ca863e9fdc7b35bef9398eadd1bafd254fd933fc8dcb6d4ba605", "b80588adecc76b1a8269a92c3877d2d3dccdade4ecc8bf1581eadc97ded65bd0"]], "expect": {"valid": true, "index": 2, "remaining": ["02734a8cb7d9e671c0e80b3eee14dc9ad421b0bb87d15a6fef52f8f121aab497", "d6f24e147c01ca863e9fdc7b35bef9398eadd1bafd254fd933fc8dcb6d4ba605"]}},
{"fn": "consumeRecoveryCode", "name": "a code already used is not in the set", "args": ["000g-40r4-0m30-e209", ["d6f24e147c01ca863e9fdc7b35bef9398eadd1bafd254fd933fc8dcb6d4ba605", "b80588adecc76b1a8269a92c3877d2d3dccdade4ecc8bf1581eadc97ded65bd0"]], "expect": {"valid": false, "index": null, "remaining": ["d6f24e147c01ca863e9fdc7b35bef9398eadd1bafd254fd933fc8dcb6d4ba605", "b80588adecc76b1a8269a92c3877d2d3dccdade4ecc8bf1581eadc97ded65bd0"]}},
{"fn": "consumeRecoveryCode", "name": "the last remaining code empties the set", "args": ["2gah-c5rr-34d1-p70x", ["b80588adecc76b1a8269a92c3877d2d3dccdade4ecc8bf1581eadc97ded65bd0"]], "expect": {"valid": true, "index": 0, "remaining": []}},
{"fn": "consumeRecoveryCode", "name": "no codes left", "args": ["000g-40r4-0m30-e209", []], "expect": {"valid": false, "index": null, "remaining": []}},
{"fn": "consumeRecoveryCode", "name": "a malformed code is refused, not thrown", "args": ["not-a-code", ["02734a8cb7d9e671c0e80b3eee14dc9ad421b0bb87d15a6fef52f8f121aab497", "d6f24e147c01ca863e9fdc7b35bef9398eadd1bafd254fd933fc8dcb6d4ba605", "b80588adecc76b1a8269a92c3877d2d3dccdade4ecc8bf1581eadc97ded65bd0"]], "expect": {"valid": false, "index": null, "remaining": ["02734a8cb7d9e671c0e80b3eee14dc9ad421b0bb87d15a6fef52f8f121aab497", "d6f24e147c01ca863e9fdc7b35bef9398eadd1bafd254fd933fc8dcb6d4ba605", "b80588adecc76b1a8269a92c3877d2d3dccdade4ecc8bf1581eadc97ded65bd0"]}},
{"fn": "consumeRecoveryCode", "name": "a duplicate stored hash: only the first is consumed", "args": ["185g-r38e-1w81-24gk", ["d6f24e147c01ca863e9fdc7b35bef9398eadd1bafd254fd933fc8dcb6d4ba605", "d6f24e147c01ca863e9fdc7b35bef9398eadd1bafd254fd933fc8dcb6d4ba605"]], "expect": {"valid": true, "index": 0, "remaining": ["d6f24e147c01ca863e9fdc7b35bef9398eadd1bafd254fd933fc8dcb6d4ba605"]}},
{"fn": "consumeRecoveryCode", "name": "a stored hash in upper case is refused", "args": ["000g-40r4-0m30-e209", ["02734A8CB7D9E671C0E80B3EEE14DC9AD421B0BB87D15A6FEF52F8F121AAB497"]], "expectError": "hashes must be a list of 64 lowercase hex characters each"},
{"fn": "consumeRecoveryCode", "name": "a stored hash of the wrong length is refused", "args": ["000g-40r4-0m30-e209", ["abc"]], "expectError": "hashes must be a list of 64 lowercase hex characters each"},
{"fn": "consumeRecoveryCode", "name": "a stored hash with a trailing newline is refused", "args": ["000g-40r4-0m30-e209", ["02734a8cb7d9e671c0e80b3eee14dc9ad421b0bb87d15a6fef52f8f121aab497\n"]], "expectError": "hashes must be a list of 64 lowercase hex characters each"}
]