Elfproef
Implementation of the 11-proof, a mathematical test used by the Dutch government for various digital identification numbers
Description
Explanation
Elfproef is Dutch for 11-proof (elf means 11, proef means test). It was originally designed to prevent people from trying to transfer money to a mistyped account number, specifically where either one digit is incorrect, or 2 digits were swapped.
The principle is very simple. First of all, a given number is split into its individual digits. Secondly, those digits are multiplied by their "weight", a multiplier which is based on the position of the digit. Finally, the sum of all multiplied numbers is calculated.
If the result is divisible by 11 and greater than 0, the 11-proof is valid.
Example
A Dutch social security number (BSN) consists of 9 digits and must suffice the 11-proof with weights [9, 8, 7, 6, 5, 4, 3, 2, -1].
For a given BSN ABCDEFGHI, the outcome of the following formula must be divisble by 11 and greater than 0.
(9 × A) + (8 × B) + (7 × C) + (6 × D) + (5 × E) + (4 × F) + (3 × G) + (2 × H) + (-1 × I)
A valid BSN would be 111222333.
(9 × 1) + (8 × 1) + (7 × 1) + (6 × 2) + (5 × 2) + (4 × 2) + (3 × 3) + (2 × 3) + (-1 × 3) = 66
The result is greater than 0 and divisible by 11:
66 > 0 66 ∧ 66 mod 11 = 0
Usage
Installation
yarn add elfproef -E
Example
import { validateBSN } from 'elfproef';
const BSN = "111222333";
const validBSN = validateBSN(BSN);
console.log(validBSN);
References
- https://nl.wikipedia.org/wiki/Elfproef
- https://nl.wikipedia.org/wiki/Burgerservicenummer
- https://www.rijksoverheid.nl/onderwerpen/privacy-en-persoonsgegevens/vraag-en-antwoord/wat-is-het-burgerservicenummer-bsn
License
This project is licensed under the MIT License.
