Skip to content

Latest commit

 

History

History
26 lines (21 loc) · 1.6 KB

README.md

File metadata and controls

26 lines (21 loc) · 1.6 KB

MasterKeySim

A simulation to determine how many co-conspirators are needed on average to determine a master key bitting through process of elimination. Assumes that no operator key can have any pins that collide with the master bitting.

Known Limitations

  1. The simulation only considers a basic lock system with one operator key and one master key. Things like multi-level-masters or multiple shear lines are not supported.
  2. Maximum Adjacent Cut Specifications (MACS) are only supported in basic form:
    1. MAC spec must be the same for each pin position
    2. No support for first/last cut having some min/max value
  3. There is no input validation on the variables to KeyTest. Program assumes you provide sane values.

No guarantee is made to the accuracy of this calculation. This program is a hypothetical simulation, and not designed to assess any particular brand or model of real world lock/key system. To be used for entertainment purposes only.

Sample Output

Sample output values, no MACs (10,000 test runs each):

  • 6 Pins / 6 Depths / 0 Buffer / Random Masters: 17.013
  • 6 Pins / 6 Depths / 1 Buffer / Random Masters: 10.439
  • 6 Pins / 6 Depths / 1 Buffer / Worst-Case Master: 12.757
  • 7 Pins / 6 Depths / 0 Buffer / Random Masters: 18.108
  • 7 Pins / 6 Depths / 1 Buffer / Random Masters: 10.687
  • 7 Pins / 6 Depths / 1 Buffer / Worst-Case Master: 13.108

(Worst-case master is an all-minimum or all-maximum bitting, since half the buffer is unused.)

See also this StackExchange thread.