@yerofey/cryptowallet-cli 1.40.0 → 1.41.0

package/README.md

@@ -41,6 +41,20 @@ $ yarn global add @yerofey/cryptowallet-cli
 $ bun add -g @yerofey/cryptowallet-cli
 ```
 
+## Install (on a server)
+
+> Recommended for generating a wallet with long prefixes/suffixes or generating a lot of wallets at once
+
+You can rent a VDS/VPS on [aeza.net](https://aeza.net/?ref=439099) for an hour or a day and run [this](https://gist.github.com/yerofey/c1cbf80bdfacfad668f53d595f890c44) one-liner to install `cw` tool:
+
+```bash
+# install `cw` tool on a server with all dependencies
+bash <(curl -sL https://gist.githubusercontent.com/yerofey/c1cbf80bdfacfad668f53d595f890c44/raw/376e310ed260ca54fec83b04d4d78d7587b83d78/install-cw.sh)
+
+# run `cw` tool
+cw
+```
+
 ## Usage
 
 ```bash
@@ -125,11 +139,13 @@ $ cw -l
 - `EVM` (Ethereum, Base, or any EVM L1/L2/L3, etc.) **default**
 - `BTC` (Bitcoin) [legacy, segwit, bech32, taproot]
 - `ETH` (Ethereum)
+- `XRP` (Ripple) **Beta**
+- `BNB` (BNB) [BEP2, BEP20, ERC20]
 - `SOL` (Solana)
-- `BNB` (Binance Coin) [BEP2, BEP20, ERC20]
-- `BSC` (Binance Smart Chain)
+- `ADA` (Cardano)
 - `DOGE` (Dogecoin) [legacy, segwit, bech32]
 - `TRX` (Tron)
+- `XLM` (Stellar)
 - `SUI` (Sui)
 - `TON` (The Open Network) [W5, V2-V5, simple]
 - `LTC` (Litecoin) [legacy, segwit, bech32]
@@ -252,9 +268,11 @@ Each chain JSON file is structured to provide essential information about the bl
 - `network`: The type of network or protocol the blockchain follows (e.g., EVM for Ethereum-compatible chains).
 - `startsWith`: The set of characters that the wallet address typically starts with.
 - `prefixTest`: A regular expression pattern that tests for valid characters that can appear in the prefix of a wallet address.
+- `rareSymbols`: (Optional) A regular expression pattern that tests for rare symbols that can appear in the wallet address.
 - `apps`: An array of supported wallet applications that can be used with the generated addresses.
 - `flags`: An array of supported features for the wallet generation. Common flags include `m` for mnemonic support, `n` for generating multiple wallets, `p` for prefix support, and `s` for suffix support.
 - `formats`: (Optional) An object defining multiple wallet formats if the blockchain supports more than one format. Each format should specify its unique properties.
+- `beta`: (Optional) A boolean value indicating if the chain is in beta testing. If set to `true`, the chain will be marked as beta in the list of supported chains.
 
 By following this structure, the `cw` tool can understand and support wallet generation for a wide array of blockchains.
 

package/cli.js

@@ -26,6 +26,7 @@ const isDev = process.env.NODE_ENV === 'development';
 
 // check if there is a need for multi-threading
 const isMultiThreaded =
+  !options.mnemonic ||
   options.prefix ||
   options.suffix ||
   options['suffix-sensitive'] ||

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yerofey/cryptowallet-cli",
-  "version": "1.40.0",
+  "version": "1.41.0",
   "description": "Crypto wallet generator CLI tool",
   "type": "module",
   "homepage": "https://github.com/yerofey/cryptowallet-cli",
@@ -28,7 +28,7 @@
       "address": "CWsbNQRxNzAasLd2zfwkEkbBZXKxfoxva14pe8wawUju"
     },
     {
-      "type": "usdt",
+      "type": "trx",
       "address": "TCW9eaRWjpivZvnZ5DwgbWxPRpoZNWbuPe"
     },
     {
@@ -86,6 +86,9 @@
     "sui-wallet",
     "ton",
     "the-open-network",
+    "cardano",
+    "ripple",
+    "stellar",
     "base",
     "litecoin",
     "ltc",
@@ -109,6 +112,7 @@
   ],
   "dependencies": {
     "@binance-chain/javascript-sdk": "^4.2.2",
+    "@emurgo/cardano-serialization-lib-nodejs": "^14.1.1",
     "@harmony-js/account": "^0.1.58",
     "@mysten/sui": "^1.18.0",
     "@solana/web3.js": "^1.98.0",
@@ -118,10 +122,11 @@
     "@yerofey/dogecoin-bip84": "^0.0.5",
     "@yerofey/litecoin-bip84": "^0.0.5",
     "bigint-buffer": "^1.1.5",
-    "bip39": "3.1.0",
+    "bip39": "^3.1.0",
     "bip84": "^0.2.9",
     "bip86": "^0.0.4",
     "bs58": "^6.0.0",
+    "cardano-wallet-js": "^1.4.0",
     "chalk": "5.4.1",
     "clipboardy": "^4.0.0",
     "coininfo": "5.2.1",
@@ -136,9 +141,12 @@
     "ethereum-cryptography": "^3.1.0",
     "ethereum-mnemonic-privatekey-utils": "1.0.5",
     "qrcode-terminal": "^0.12.0",
+    "ripple-keypairs": "^2.0.0",
+    "stellar-hd-wallet": "^0.0.10",
     "tezos-sign": "1.4.1",
     "tonweb": "^0.0.66",
-    "tronweb": "^6.0.1"
+    "tronweb": "^6.0.1",
+    "xrpl": "^4.2.0"
   },
   "devDependencies": {
     "ava": "^6.2.0",

package/src/Method.js

@@ -54,10 +54,9 @@ class Method {
     for (const val of supportedChains) {
       // eslint-disable-next-line no-undef
       const data = await loadJson(
-        `${path.dirname(import.meta.url)}${path.sep}chains${path.sep}${val}.json`.replace(
-          'file://',
-          ''
-        )
+        `${path.dirname(import.meta.url)}${path.sep}chains${
+          path.sep
+        }${val}.json`.replace('file://', '')
       );
 
       let title = data.title || '';
@@ -231,7 +230,9 @@ class Method {
           );
         } else {
           // not supported for multiple wallets
-          log(`ℹ️   It's not supported to display QR code for multiple wallets yet`);
+          log(
+            `ℹ️   It's not supported to display QR code for multiple wallets yet`
+          );
           log();
         }
       }
@@ -266,12 +267,25 @@ class Method {
         for (const item of cw.wallet.addresses) {
           if (cw.wallet.addresses.length > 1) {
             // Display index
-            if (item.index !== undefined && (showAllAddresses || !showAllAddresses && index == 0 || (cw.prefixFoundInWallets.includes(item.address) || cw.suffixFoundInWallets.includes(item.address)))) {
+            if (
+              item.index !== undefined &&
+              (showAllAddresses ||
+                (!showAllAddresses && index == 0) ||
+                cw.prefixFoundInWallets.includes(item.address) ||
+                cw.suffixFoundInWallets.includes(item.address))
+            ) {
               log();
               log(`🆔  ${item.index}`);
               emptyLineAdded = true;
             }
 
+            if (item.breakLine !== undefined && item.breakLine) {
+              log();
+              emptyLineAdded = true;
+            }
+
+            // TODO: fix situation with TON and multiple wallets labels (there are no spaces between them)
+
             // Display address details
             if (item.title) {
               if (!emptyLineAdded) {
@@ -411,12 +425,21 @@ class Method {
             matchingWalletsIndexes.push(index);
             showPrivateKey = true;
           } else {
-            if (showAllAddresses || !showAllAddresses && index == 0) {
+            if (showAllAddresses || (!showAllAddresses && index == 0) || item.show !== undefined && item.show) {
               log(`👛  ${item.address}`);
             }
           }
+          // display public key or xpubkey (if exists)
+          if (item.publicKey !== undefined || item.xpubKey !== undefined) {
+            log(`🗝️   ${item.publicKey ?? item.xpubKey}`);
+          }
           // display private key
-          if (item.privateKey !== undefined && (showAllAddresses || !showAllAddresses && index == 0 || showPrivateKey)) {
+          if (
+            item.privateKey !== undefined &&
+            (showAllAddresses ||
+              (!showAllAddresses && index == 0) ||
+              showPrivateKey)
+          ) {
             log(`🔑  ${item.privateKey}`);
           }
           // copy to clipboard if flag is set
@@ -441,6 +464,16 @@ class Method {
             )
           );
         }
+
+        // beta
+        if (cw.row.beta !== undefined && cw.row.beta) {
+          log();
+          log(
+            yellow(
+              '🔶  This wallet generation method is in Beta - not all features are available and not everything was tested yet'
+            )
+          );
+        }
       } else {
         outputData.wallets = cw.wallet.addresses;
       }
@@ -580,15 +613,37 @@ class Method {
       // apps
       if (cw.row.apps !== undefined) {
         let apps = {
+          backpack: 'Backpack',
+          bitget: 'Bitget Wallet',
           coinbase: 'Coinbase Wallet',
+          daedalus: 'Daedalus',
+          eternl: 'Eternl',
+          jupiter: 'Jupiter',
+          keplr: 'Keplr',
+          ledger: 'Ledger',
+          lobstr: 'Lobstr',
+          magiceden: 'Magic Eden',
           metamask: 'MetaMask',
+          mytonwallet: 'MyTonWallet',
+          nami: 'Nami Wallet',
+          okx: 'OKX Wallet',
+          osmwallet: 'OsmWallet',
           phantom: 'Phantom',
+          plug: 'Plug',
+          rabet: 'Rabet',
+          rainbow: 'Rainbow',
+          solar: 'Solar',
+          stellarx: 'StellarX',
           suiet: 'Suiet',
           suiwallet: 'Sui Wallet',
           tonhub: 'Tonhub',
           tonkeeper: 'Tonkeeper',
           tronlink: 'TronLink',
           trustwallet: 'Trust Wallet',
+          uniswap: 'Uniswap',
+          vespr: 'VESPR',
+          xumm: 'Xumm',
+          yoroi: 'Yoroi',
           'harmony-chrome-ext': 'Harmony Chrome Extension Wallet',
           'binance-chain-wallet': 'Binance Chain Wallet',
         };

package/src/Wallet.js

@@ -37,6 +37,14 @@ import {
 } from '@ton/crypto';
 import { WalletContractV5R1 } from '@ton/ton';
 import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
+import rippleKeypairs from 'ripple-keypairs';
+import {
+  Wallet as RippleWallet,
+  classicAddressToXAddress as RippleClassicAddressToXAddress,
+} from 'xrpl';
+import StellarHDWallet from 'stellar-hd-wallet';
+import { Seed as CardanoSeed } from 'cardano-wallet-js';
+import CardanoWasm from '@emurgo/cardano-serialization-lib-nodejs';
 
 config();
 
@@ -262,7 +270,7 @@ class Wallet {
 
     if (row.length == 0) {
       return {
-        error: 'this blockchain is not found',
+        error: 'this coin or chain is not found',
       };
     }
 
@@ -279,6 +287,119 @@ class Wallet {
           },
         ],
       });
+    } else if (chain == 'ADA') {
+      try {
+        // Validate mnemonic
+        if (mnemonicString !== '' && !bip39.validateMnemonic(mnemonicString)) {
+          return {
+            error: 'mnemonic is not valid',
+          };
+        }
+
+        // Generate a 24-word mnemonic (recommended for Shelley wallets)
+        const mnemonic = mnemonicString || CardanoSeed.generateRecoveryPhrase();
+
+        // Convert mnemonic to a 512-bit seed
+        const entropy = bip39.mnemonicToEntropy(mnemonic);
+
+        // Generate root key from entropy
+        const rootKey = CardanoWasm.Bip32PrivateKey.from_bip39_entropy(
+          Buffer.from(entropy, 'hex'), // correct entropy input
+          Buffer.from('') // empty password
+        );
+
+        // Derive the account key (BIP44: m/1852'/1815'/0')
+        const accountKey = rootKey
+          .derive(1852 | 0x80000000) // Purpose
+          .derive(1815 | 0x80000000) // Coin type (ADA)
+          .derive(0 | 0x80000000); // First account
+
+        const generateCardanoAddress = (chainType, index) => {
+          const addressKey = accountKey
+            .derive(chainType)
+            .derive(index)
+            .to_public()
+            .to_raw_key()
+            .hash();
+          const paymentCredential =
+            CardanoWasm.Credential.from_keyhash(addressKey);
+          const stakeKey = accountKey
+            .derive(2)
+            .derive(0)
+            .to_public()
+            .to_raw_key()
+            .hash();
+          const stakeCredential = CardanoWasm.Credential.from_keyhash(stakeKey);
+          return CardanoWasm.BaseAddress.new(
+            CardanoWasm.NetworkInfo.mainnet().network_id(),
+            paymentCredential,
+            stakeCredential
+          )
+            .to_address()
+            .to_bech32();
+        };
+
+        const utxoPubKey = accountKey
+          .derive(0) // external
+          .derive(0)
+          .to_public();
+        const stakeKey = accountKey
+          .derive(2) // chimeric
+          .derive(0)
+          .to_public();
+
+        const baseAddr = CardanoWasm.BaseAddress.new(
+          CardanoWasm.NetworkInfo.mainnet().network_id(),
+          CardanoWasm.Credential.from_keyhash(utxoPubKey.to_raw_key().hash()),
+          CardanoWasm.Credential.from_keyhash(stakeKey.to_raw_key().hash())
+        );
+
+        // bootstrap address - byron-era addresses with no staking rights
+        const byronAddr = CardanoWasm.ByronAddress.icarus_from_key(
+          utxoPubKey, // Ae2* style icarus address
+          CardanoWasm.NetworkInfo.mainnet().protocol_magic()
+        );
+
+        // Generate Staking Key Hash (BIP44: m/1852'/1815'/0'/2/0)
+        const stakingKey = accountKey
+          .derive(2)
+          .derive(0)
+          .to_public()
+          .to_raw_key()
+          .hash();
+        const stakingKeyHash = Buffer.from(stakingKey.to_bytes()).toString(
+          'hex'
+        );
+
+        // Return wallet details
+        Object.assign(result, {
+          addresses: [
+            {
+              title: 'Shelley-era base address',
+              address: baseAddr.to_address().to_bech32(),
+              // publicKey: utxoPubKey.to_bech32(),
+              privateKey: rootKey.to_bech32(),
+            },
+            {
+              title: 'Byron-era bootstrap address (old style)',
+              address: byronAddr.to_base58(),
+              breakLine: true,
+              show: true,
+            },
+            {
+              title: 'Staking key hash',
+              address: stakingKeyHash,
+              breakLine: true,
+              show: true,
+            },
+          ],
+          mnemonic,
+        });
+      } catch (error) {
+        return {
+          error: `Failed to generate ADA wallet: ${error.message} (${error})`,
+        };
+      }
     } else if (chain == 'BTC') {
       // Validate mnemonic
       if (mnemonicString != '' && !bip39.validateMnemonic(mnemonicString)) {
@@ -578,6 +699,8 @@ class Wallet {
             addresses.push({
               title: 'v4R2 (EQ): best for smart contracts (bounceable)',
               address: bouncableAddress,
+              breakLine: true,
+              show: true,
             });
           } else {
             addresses.push({
@@ -614,6 +737,8 @@ class Wallet {
           addresses.push({
             title: 'W5 - v5R1 (EQ): best for smart contracts (bounceable)',
             address: bouncableAddressV5,
+            breakLine: true,
+            show: true,
           });
           break;
       }
@@ -652,6 +777,105 @@ class Wallet {
           error: `Failed to generate TRX wallet: ${error.message} (${error})`,
         };
       }
+    } else if (chain == 'XLM') {
+      try {
+        // Validate mnemonic
+        if (mnemonicString !== '' && !bip39.validateMnemonic(mnemonicString)) {
+          return {
+            error: 'mnemonic is not valid',
+          };
+        }
+
+        // Generate mnemonic if not provided
+        const mnemonic =
+          mnemonicString ||
+          StellarHDWallet.generateMnemonic({ entropyBits: 128 });
+        // Create a Stellar HD Wallet from the mnemonic
+        const wallet = StellarHDWallet.fromMnemonic(mnemonic);
+
+        // Get the first account (Trust Wallet, Ledger, etc. use `m/44'/148'/0'`)
+        const publicKey = wallet.getPublicKey(0);
+        const secretKey = wallet.getSecret(0);
+        // const keypair = wallet.getKeypair(0); // Full keypair object
+        // const rawKey = wallet.derive(`m/44'/148'/0'`).toString('hex');
+
+        // Return wallet details
+        Object.assign(result, {
+          addresses: [
+            {
+              index: 0,
+              address: publicKey,
+              privateKey: secretKey,
+            },
+          ],
+          mnemonic,
+        });
+      } catch (error) {
+        return {
+          error: `Failed to generate XLM wallet: ${error.message} (${error})`,
+        };
+      }
+    } else if (chain == 'XRP') {
+      try {
+        // Validate mnemonic
+        if (mnemonicString !== '' && !bip39.validateMnemonic(mnemonicString)) {
+          return {
+            error: 'mnemonic is not valid',
+          };
+        }
+
+        // Generate a 12-word mnemonic (or use provided one)
+        const mnemonic = mnemonicString || bip39.generateMnemonic(128);
+
+        // Convert mnemonic to a 512-bit seed
+        const seed = bip39.mnemonicToSeedSync(mnemonic, '');
+
+        // Extract 16 bytes from the seed (XRP entropy requirement)
+        const entropy = seed.slice(0, 16);
+
+        // Encode the entropy as a Base58-encoded XRP seed
+        const base58Seed = rippleKeypairs.generateSeed({
+          entropy,
+          algorithm: 'ecdsa-secp256k1',
+        });
+
+        // Generate a wallet from the seed
+        const wallet = RippleWallet.fromSeed(base58Seed, {
+          algorithm: 'secp256k1',
+        });
+        // console.log('wallet', wallet);
+
+        // dev
+        // const masterKey = rippleKeypairs.deriveKeypair(base58Seed, {
+        //   algorithm: 'ecdsa-secp256k1',
+        //   accountIndex: 0,
+        // });
+        // const address = rippleKeypairs.deriveAddress(masterKey.publicKey);
+        // console.log('masterKey', masterKey);
+        // console.log('address', address);
+
+        // Return wallet details
+        Object.assign(result, {
+          addresses: [
+            {
+              title: 'Classic',
+              address: wallet.address,
+              privateKey: wallet.privateKey,
+            },
+            {
+              title: 'X-address',
+              address: RippleClassicAddressToXAddress(wallet.address, false, false),
+              breakLine: true,
+              show: true,
+            },
+          ],
+          mnemonic,
+        });
+      } catch (error) {
+        return {
+          error: `Failed to generate XRP wallet: ${error.message} (${error})`,
+        };
+      }
     } else if (chain == 'XTZ') {
       // TODO: generate wallet from mnemonic
       const wallet = tezos.generateKeysNoSeed();
@@ -668,7 +892,7 @@ class Wallet {
     } else {
       return {
         error:
-          'your desired blockchain is not supported yet, please open an issue on GitHub: https://github.com/yerofey/cryptowallet-cli/issues',
+          'your desired coin/chain is not supported yet, please open an issue on GitHub: https://github.com/yerofey/cryptowallet-cli/issues',
       };
     }
 
@@ -679,6 +903,13 @@ class Wallet {
       });
     }
 
+    // Add beta flag if needed
+    if (row.beta !== undefined && row.beta == true) {
+      Object.assign(result, {
+        beta: true,
+      });
+    }
+
     return result;
   }
 }

package/src/chains/ADA.json

@@ -0,0 +1,10 @@
+{
+  "title": "Cardano",
+  "startsWith": "addr1q",
+  "prefixTest": "[a-z0-9]",
+  "rareSymbols": "[a-z]",
+  "path": "m/1852'/1815'/0'/0/0",
+  "purpose": "1852'",
+  "apps": ["trustwallet", "vespr", "eternl", "nami", "yoroi", "daedalus", "ledger"],
+  "flags": ["m", "p", "s"]
+}

package/src/chains/ETH.json

@@ -3,6 +3,6 @@
   "network": "EVM",
   "startsWith": "0x",
   "prefixTest": "[0-9a-fA-F]",
-  "apps": ["metamask", "trustwallet"],
+  "apps": ["metamask", "trustwallet", "phantom", "ledger"],
   "flags": ["m", "p", "s"]
 }

package/src/chains/EVM.json

@@ -3,6 +3,6 @@
   "network": "EVM",
   "startsWith": "0x",
   "prefixTest": "[0-9a-fA-F]",
-  "apps": ["metamask", "trustwallet"],
+  "apps": ["metamask", "trustwallet", "phantom", "ledger"],
   "flags": ["m", "p", "s"]
 }

package/src/chains/SOL.json

@@ -3,6 +3,6 @@
   "network": "SVM",
   "startsWith": "",
   "prefixTest": "[1-9a-zA-Z]",
-  "apps": ["phantom", "trustwallet"],
+  "apps": ["phantom", "jupiter", "trustwallet"],
   "flags": ["m", "n", "p", "s"]
 }

package/src/chains/XLM.json

@@ -0,0 +1,9 @@
+{
+  "title": "Stellar",
+  "startsWith": "G",
+  "prefixTest": "[A-Z2-7]",
+  "strictCase": "upper",
+  "addressChars": 56,
+  "apps": ["trustwallet", "rabet", "lobstr", "solar", "stellarx", "ledger"],
+  "flags": ["m", "p", "s"]
+}

package/src/chains/XRP.json

@@ -0,0 +1,10 @@
+{
+  "title": "XRP Ledger: Ripple",
+  "startsWith": "r",
+  "prefixTest": "[a-km-zA-HJ-NP-Z1-9]",
+  "path": "m/44'/144'/0'/0/0",
+  "purpose": "44'",
+  "apps": ["xumm", "osmwallet", "ledger"],
+  "flags": ["m", "p", "s"],
+  "beta": true
+}

package/src/chains/BSC.json

@@ -1,8 +0,0 @@
-{
-  "title": "Binance Smart Chain",
-  "network": "EVM",
-  "startsWith": "0x",
-  "prefixTest": "[0-9a-fA-F]",
-  "apps": ["metamask", "trustwallet"],
-  "flags": ["m", "p", "s"]
-}