@aladas-org/cryptocalc v0.0.32

Cryptocalc 0.0.32

1. Purpose
Cryptocalc is a standalone desktop application which provides straigthforward conversions between a Private Key formats (eg. Hex vs Base64) and the matching Seedphrase. Even though there is already a lot of similar tools online, the purpose is to use these features locally on your computer in order to reduce the risk of having your Private Key informations stealed.
NB: Cryptocalc uses ElectronJS as well as many modern and popular Desktop applications

2. Environment

   • 2.1. NodeJS
   • 2.2. Git

3. Installation
   Import locally the Cryptocalc repository

   • 3.1. Open a command line interpreter Use Windows Menu Start then input cmd Change current disk to where you plan to install (eg. if its D then type D:) Change current directory to where you to install (eg. md tools then cd tools) + 3.2. Import Cryptocalc from github Open the Cryptocalc repository Use the <> Code v green button Copy the displayed .git URL * In the command line interpreter, type git clone followed by the .git URL\ e.g. git clone https://github.com/ALADAS-org/Cryptocalc.git
     • Type cd Cryptocalc
     • Type npm install

4. Release notes

   • 4.1. Features in 0.0.32
     • 4.1.1. Support of Solana blockchain
       NB: If you want to import the Computed Wallet in Guarda, only the Seedphrase allows to retrieve the correct Wallet Address.
   • 4.2. Features in 0.0.28 4.2.1. Fixes in Localization of GUI Labels
     4.2.2. In generated Private Key informations (File/Save)
     - timestamped subfolder now includes Coin (eg. 2024_03_16_15h-43m-21s-9_ETH) - private_key_info.txt now provides: Blockchain, Coin, Wallet address, Blockchain explorer URL and _WIF (if applicable)
   • 4.3. Features in 0.0.27 * 4.3.1. Wallet Address computation
     Click on the Wallet tab to switch to the Wallet Computer feature. This feature is synchronized with the Private Key tab and will compute the Wallet Address from the Private Key (indeed the Private Key (B64) and Seedphrase are duplicated from the Private Key tab. You can use the Explore... button to open a Blockchain Explorer with the computed Wallet Address.
     NB: WIF (Wallet Input Format) is also computed, it is used in Bitcoin, DogeCoin and LiteCoin blockchains.
     Currently supported Blockchains: Ethereum, Bitcoin, Solana, DogeCoin, LiteCoin (only mainnet currently).
5. Cryptocalc User Guide
   Double click on _run.bat: this will open the Cryptocalc desktop standalone application
   • 5.1. Features
     * 5.1.1. Generate a new Private Key from a random Fortune Cookie
     Use Random button to generate a random Fortune Cookie (among a compilation of 12803 fortune cookies) which then will be used as the Seed (with or without the Salt, depending on the checkbox) to generate a new Private Key (64 hexadecimal digits). This value is converted into its Base64 value and then translated in its equivalent (isomorphic) Seedphrase, this is the Seed to Seedphrase waterfall (Seed => Private Key => Seedphrase). There is also the conversion to the Shortened Seedphrase: as only the 4 first characters of each mnemonic are useful (cf. BIP39 specification), in the Shortened Seedphrase each mnemonic is represented only by its 4 first characters (with the first character in Uppercase as a mean to separate mnemonics), notice that as some mnemonics are only 3 characters long, the abbreviation will of course only be whole mnemonic.
     Here is an example below:
     Seedphrase
           goddess also genre east slam borrow amateur pupil merit clinic check zone \       habit jewel biology rebel october power adult wide blush similar omit pyramid Shortened Seedphrase
           GoddAlsoGenrEastSlamBorrAmatPupiMeriClinChecZoneHabiJeweBiolRebeOctoPoweAdulWideBlusSimiOmitPyra
     NB: the Private Key is verified to check if it is a valid ECDSA Private Key. This feature allows to compute the WIF (Wallet Input Format) from the Private Key.
     • 5.1.2. Provide a Seed
       You can key in an arbitrary value in the Seed field. Notice that it will clear the other fields, so you must use the Update button (cf. 5.1.1. Seed to Seedphrase waterfall) to refresh them (this is indicated by a message in the status bar, at the bottom of the window). 5.1.3. Import Seed from a text file
       The text for the Seed field may also be provided with the File/Import menu or with the ellipsis button ... at the right of the Seed field. 5.1.4. Set Seed field with a random Fortune Cookie
       The text for the Seed can be a random Fortune Cookie (among 12803 cf. 5.1.1). 5.1.5. Salt with UIID
       This allows to generate a different Private Key at each Update even if the Seed value is the same, this is achieved by Salting the Seed with a UUID. This behavior can be disabled with the checkbox located just before the UUID value. 5.1.6. Input the Private Key
       You can input a hex value (NB: requires 64 hex digits) for the Private Key (Hex) field. Notice that it will clear the other fields , so you must use the Update button (cf. 5.1.1. Seed to Seedphrase waterfall) to refresh them. 5.1.7. Save Private Key Informations
       With File/Save you can save the Private Key Informations in a timestamped subfolder (eg. 2024_03_07_21h-4m-4s-3_BTC) under _output folder. This subfolder contains private_key_info.txt and a pk_info.json with the displayed informations but there is also the word indices of each mnemonic in the Seedphrase. 5.1.8. Input/Modify the Seedphrase
       You can now modify the Seedphrase but you must provide valid mnemonics (matching the selected language) and provide the expected number of mnemonics (which is currently a constant equal to 24). * 5.1.9. Select Seedphrase Language
       You can select the Language Wordlist (eg. English, French, Deutsh, etc...). Please notice that is not meant to be used with Wallet Manager applications because most will only accept English mnemonics.
       Indeed it's meant to add a scramble step in order to make it harder to steal your Master Key because it must be translated to English to be used with with a Wallet Manager.
     • 5.1.10. Support of Localization
       In Cryptocalc, the Localization (l10n) feature is the translation of GUI Labels to adapt to the locale. A locale name can be composed of a base language, country (territory) of use, and optionnally a codeset (eg. de_CH.UTF-8). The locale is provided as part of your machine's environment. Cryptocalc only uses the 2 letter language part (eg. en). Localization is enabled by a JSon file in the www/js/L10n folder (eg. gui-msg-en.json) . Currently only en and fr are provided, but I would be nice if contributors provide other languages (at the time being, only 16 labels to translate, I will of course cite the contributors name in the license) as I preferred to avoid naive use of a translation tool.
   • 5.2. Use cases
     • 5.2.1. Generate a new Crypto Wallet from a Seedphrase
       With a Wallet Manager like Guarda a Seedphrase is enough to import a new wallet, you just need to choose the coin (e.g. BTC,ETH,DOGE,XRP,ADA,SOL, etc...). * 5.2.2. Import a Computed Wallet from Private Key Informations
       With Guarda you can import the some of the Private Key Informations to retrieve the correct Wallet Address.
       NB: Please notice that depending on the Blockchain, Guarda will not accept the same Private Key Information: it could be the Private Key (with or without 0x prefix), the Seedphrase or even the WIF.
     • 5.2.3. Store Shortened Seedphrase in a NFC SmartRing
       The entry level SmartRings (price range: 7..15$) contains a NTAG213 NFC with 144 bytes useable capacity. This is enough to store the Shortened Seedphrase, with a 24 words Shortened Seedphrase the maximum required capacity is 96 bytes/characters (24*4, cf. 5.1.1) or even less (as some mnemonics have only three characters).
     • 5.2.4. Store Master password
       This is similar to the previous case, but the Shortened Seedphrase (or Private Key (B64) value) can be used as a Master password
       for a Password Manager or for tools like PGP Tool which provides encryption/decryption of your documents.