0.1.4 • Public • Published

    Build Status

    BaseHuman is pre-release and the default vocabulary may be changed before v1, breaking compatibility with the current version. The current version can be used to evaluate the library, but should not be used in production at this time.


    BaseHuman uses words instead of digits to encode large numbers in a human-readable and rememberable way. By using words from the user's language, BaseHuman can use bases up to 8192 and encode very large numbers in just a couple words.

    Base-10 Base-32 BaseHuman-8192
    3,212,781,663 bwm7zfr will brussels flower
    2,356,682,812 7gg7h30 are fortune has
    1,892,374,852 8hcwpw0 him stones finely
    2,348,348,959 3zvfh2r my transmit frost

    BaseHuman is perfect for use cases where users need to remember a magic number for a brief period of time and enter it on another screen or app, such as in authenticators.


    This example shows how to convert a javascript number to BaseHuman

    npm install --save basehuman

    Create a BaseHuman encoder using the default base of 8192 and "en" language.

    const BaseHuman = require("basehuman").BaseHuman;
    let bh = new BaseHuman();
    console.log(bh.encode(3212781663));  //outputs 'no washing tags'
    console.log(bh.decode('no washing tags')); //outputs 3212781663


    Using a different base

    BaseHuman allows you to use different bases (larger or smaller vocabularies) for encoding.

    let bh = new BaseHuman({ base : 1024 });

    Using a different language

    BaseHuman will allow you to use different languages

    let bh = new BaseHuman({ language : "es" });

    Using a different separator

    let bh = new BaseHuman({ separator : "-"});
    console.log(bh.encode(3212781663)); //outputs 'no-washing-tags'

    Using a custom vocabulary

    coming soon


    npm i basehuman

    DownloadsWeekly Downloads






    Last publish


    • mattdot