@twin.org/crypto-cli 0.0.1-next.3 → 0.0.1-next.31

package/dist/cjs/index.cjs

@@ -24,7 +24,7 @@ function buildCommandAddress() {
         .option(core.I18n.formatMessage("commands.address.options.start.param"), core.I18n.formatMessage("commands.address.options.start.description"), "0")
         .option(core.I18n.formatMessage("commands.address.options.count.param"), core.I18n.formatMessage("commands.address.options.count.description"), "10")
         .option(core.I18n.formatMessage("commands.address.options.account.param"), core.I18n.formatMessage("commands.address.options.account.description"), "0")
-        .option(core.I18n.formatMessage("commands.address.options.hrp.param"), core.I18n.formatMessage("commands.address.options.hrp.description"), "iota")
+        .option(core.I18n.formatMessage("commands.address.options.hrp.param"), core.I18n.formatMessage("commands.address.options.hrp.description"))
         .option(core.I18n.formatMessage("commands.address.options.coin.param"), core.I18n.formatMessage("commands.address.options.coin.description"), "4218")
         .addOption(new commander.Option(core.I18n.formatMessage("commands.address.options.key-type.param"), core.I18n.formatMessage("commands.address.options.key-type.description"))
         .choices(["Ed25519", "Secp256k1"])
@@ -49,7 +49,7 @@ function buildCommandAddress() {
  * @param opts.start The start index for the address generation.
  * @param opts.count The number of addresses to generate.
  * @param opts.account The account index for the address generation.
- * @param opts.hrp The human readable part for the address.
+ * @param opts.hrp The human readable part for the addresses if generating bech32 format.
  * @param opts.coin The coin type for the address.
  * @param opts.keyType The key type for the address.
  * @param opts.keyFormat The output format of the key.
@@ -67,7 +67,9 @@ async function actionCommandAddress(opts) {
     cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.address.labels.start"), start);
     cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.address.labels.count"), count);
     cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.address.labels.account"), account);
-    cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.address.labels.hrp"), hrp);
+    if (core.Is.stringValue(hrp)) {
+        cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.address.labels.hrp"), hrp);
+    }
     cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.address.labels.coin"), coin);
     cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.address.labels.key-type"), keyType);
     cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.address.labels.key-format"), keyFormat);
@@ -76,9 +78,15 @@ async function actionCommandAddress(opts) {
     cliCore.CLIDisplay.break();
     const addressDictionary = {};
     for (let i = start; i < start + count; i++) {
-        const addressKeyPair = crypto.Bip44.addressBech32(seed, keyType === "Ed25519" ? crypto.KeyType.Ed25519 : crypto.KeyType.Secp256k1, hrp, coin, account, false, i);
+        let addressKeyPair;
+        if (core.Is.stringValue(hrp)) {
+            addressKeyPair = crypto.Bip44.addressBech32(seed, keyType === "Ed25519" ? crypto.KeyType.Ed25519 : crypto.KeyType.Secp256k1, hrp, coin, account, false, i);
+        }
+        else {
+            addressKeyPair = crypto.Bip44.address(seed, keyType === "Ed25519" ? crypto.KeyType.Ed25519 : crypto.KeyType.Secp256k1, coin, account, false, i);
+        }
         addressDictionary[i] = {
-            bech32: addressKeyPair.address,
+            address: addressKeyPair.address,
             privateKey: keyFormat === "hex"
                 ? core.Converter.bytesToHex(addressKeyPair.privateKey, true)
                 : core.Converter.bytesToBase64(addressKeyPair.privateKey),
@@ -88,7 +96,7 @@ async function actionCommandAddress(opts) {
         };
         if (opts.console) {
             cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.address.labels.index"), i);
-            cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.address.labels.address"), addressDictionary[i].bech32);
+            cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.address.labels.address"), addressDictionary[i].address);
             cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.address.labels.private-key"), addressDictionary[i].privateKey);
             cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.address.labels.public-key"), addressDictionary[i].publicKey);
             cliCore.CLIDisplay.break();
@@ -100,7 +108,7 @@ async function actionCommandAddress(opts) {
     if (core.Is.stringValue(opts?.env)) {
         const output = [];
         for (const addressIndex in addressDictionary) {
-            output.push(`ADDRESS_${addressIndex}_BECH32="${addressDictionary[addressIndex].bech32}"`);
+            output.push(`ADDRESS_${addressIndex}="${addressDictionary[addressIndex].address}"`);
             output.push(`ADDRESS_${addressIndex}_PRIVATE_KEY="${addressDictionary[addressIndex].privateKey}"`);
             output.push(`ADDRESS_${addressIndex}_PUBLIC_KEY="${addressDictionary[addressIndex].publicKey}"`);
         }
@@ -126,7 +134,8 @@ function buildCommandMnemonic() {
         .default("256"))
         .addOption(new commander.Option(core.I18n.formatMessage("commands.mnemonic.options.seed-format.param"), core.I18n.formatMessage("commands.mnemonic.options.seed-format.description"))
         .choices(["hex", "base64"])
-        .default("hex"));
+        .default("hex"))
+        .addOption(new commander.Option(core.I18n.formatMessage("commands.mnemonic.options.env-prefix.param"), core.I18n.formatMessage("commands.mnemonic.options.env-prefix.description")));
     cliCore.CLIOptions.output(command, {
         noConsole: true,
         json: true,
@@ -147,17 +156,21 @@ async function actionCommandMnemonic(opts) {
     const strength = cliCore.CLIParam.integer("strength", opts.strength, false, 128, 256);
     const mnemonic = crypto.Bip39.randomMnemonic(strength);
     const seed = crypto.Bip39.mnemonicToSeed(mnemonic);
+    const envPrefix = core.Is.stringValue(opts.envPrefix) ? opts.envPrefix : "";
     const seedFormatted = opts.seedFormat === "hex" ? core.Converter.bytesToHex(seed, true) : core.Converter.bytesToBase64(seed);
     if (opts.console) {
         cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.mnemonic.labels.mnemonic"), mnemonic);
         cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.mnemonic.labels.seed"), seedFormatted);
+        if (core.Is.stringValue(opts.envPrefix)) {
+            cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.mnemonic.labels.envPrefix"), envPrefix);
+        }
         cliCore.CLIDisplay.break();
     }
     if (core.Is.stringValue(opts?.json)) {
         await cliCore.CLIUtils.writeJsonFile(opts.json, { mnemonic, seed: seedFormatted }, opts.mergeJson);
     }
     if (core.Is.stringValue(opts?.env)) {
-        await cliCore.CLIUtils.writeEnvFile(opts.env, [`MNEMONIC="${mnemonic}"`, `SEED="${seedFormatted}"`], opts.mergeEnv);
+        await cliCore.CLIUtils.writeEnvFile(opts.env, [`${envPrefix}MNEMONIC="${mnemonic}"`, `${envPrefix}SEED="${seedFormatted}"`], opts.mergeEnv);
     }
     cliCore.CLIDisplay.done();
 }
@@ -172,16 +185,19 @@ class CLI extends cliCore.CLIBase {
      * Run the app.
      * @param argv The process arguments.
      * @param localesDirectory The directory for the locales, default to relative to the script.
+     * @param options Additional options.
+     * @param options.overrideOutputWidth Override the output width.
      * @returns The exit code.
      */
-    async run(argv, localesDirectory) {
+    async run(argv, localesDirectory, options) {
         return this.execute({
             title: "TWIN Crypto",
             appName: "twin-crypto",
-            version: "0.0.1-next.3",
+            version: "0.0.1-next.31",
             icon: "🌍",
-            supportsEnvFiles: true
-        }, localesDirectory ?? path.join(path.dirname(node_url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))), "../locales"), argv);
+            supportsEnvFiles: true,
+            overrideOutputWidth: options?.overrideOutputWidth
+        }, localesDirectory ?? path.join(path.dirname(node_url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))), "../locales"), argv);
     }
     /**
      * Get the commands for the CLI.

package/dist/esm/index.mjs

@@ -21,7 +21,7 @@ function buildCommandAddress() {
         .option(I18n.formatMessage("commands.address.options.start.param"), I18n.formatMessage("commands.address.options.start.description"), "0")
         .option(I18n.formatMessage("commands.address.options.count.param"), I18n.formatMessage("commands.address.options.count.description"), "10")
         .option(I18n.formatMessage("commands.address.options.account.param"), I18n.formatMessage("commands.address.options.account.description"), "0")
-        .option(I18n.formatMessage("commands.address.options.hrp.param"), I18n.formatMessage("commands.address.options.hrp.description"), "iota")
+        .option(I18n.formatMessage("commands.address.options.hrp.param"), I18n.formatMessage("commands.address.options.hrp.description"))
         .option(I18n.formatMessage("commands.address.options.coin.param"), I18n.formatMessage("commands.address.options.coin.description"), "4218")
         .addOption(new Option(I18n.formatMessage("commands.address.options.key-type.param"), I18n.formatMessage("commands.address.options.key-type.description"))
         .choices(["Ed25519", "Secp256k1"])
@@ -46,7 +46,7 @@ function buildCommandAddress() {
  * @param opts.start The start index for the address generation.
  * @param opts.count The number of addresses to generate.
  * @param opts.account The account index for the address generation.
- * @param opts.hrp The human readable part for the address.
+ * @param opts.hrp The human readable part for the addresses if generating bech32 format.
  * @param opts.coin The coin type for the address.
  * @param opts.keyType The key type for the address.
  * @param opts.keyFormat The output format of the key.
@@ -64,7 +64,9 @@ async function actionCommandAddress(opts) {
     CLIDisplay.value(I18n.formatMessage("commands.address.labels.start"), start);
     CLIDisplay.value(I18n.formatMessage("commands.address.labels.count"), count);
     CLIDisplay.value(I18n.formatMessage("commands.address.labels.account"), account);
-    CLIDisplay.value(I18n.formatMessage("commands.address.labels.hrp"), hrp);
+    if (Is.stringValue(hrp)) {
+        CLIDisplay.value(I18n.formatMessage("commands.address.labels.hrp"), hrp);
+    }
     CLIDisplay.value(I18n.formatMessage("commands.address.labels.coin"), coin);
     CLIDisplay.value(I18n.formatMessage("commands.address.labels.key-type"), keyType);
     CLIDisplay.value(I18n.formatMessage("commands.address.labels.key-format"), keyFormat);
@@ -73,9 +75,15 @@ async function actionCommandAddress(opts) {
     CLIDisplay.break();
     const addressDictionary = {};
     for (let i = start; i < start + count; i++) {
-        const addressKeyPair = Bip44.addressBech32(seed, keyType === "Ed25519" ? KeyType.Ed25519 : KeyType.Secp256k1, hrp, coin, account, false, i);
+        let addressKeyPair;
+        if (Is.stringValue(hrp)) {
+            addressKeyPair = Bip44.addressBech32(seed, keyType === "Ed25519" ? KeyType.Ed25519 : KeyType.Secp256k1, hrp, coin, account, false, i);
+        }
+        else {
+            addressKeyPair = Bip44.address(seed, keyType === "Ed25519" ? KeyType.Ed25519 : KeyType.Secp256k1, coin, account, false, i);
+        }
         addressDictionary[i] = {
-            bech32: addressKeyPair.address,
+            address: addressKeyPair.address,
             privateKey: keyFormat === "hex"
                 ? Converter.bytesToHex(addressKeyPair.privateKey, true)
                 : Converter.bytesToBase64(addressKeyPair.privateKey),
@@ -85,7 +93,7 @@ async function actionCommandAddress(opts) {
         };
         if (opts.console) {
             CLIDisplay.value(I18n.formatMessage("commands.address.labels.index"), i);
-            CLIDisplay.value(I18n.formatMessage("commands.address.labels.address"), addressDictionary[i].bech32);
+            CLIDisplay.value(I18n.formatMessage("commands.address.labels.address"), addressDictionary[i].address);
             CLIDisplay.value(I18n.formatMessage("commands.address.labels.private-key"), addressDictionary[i].privateKey);
             CLIDisplay.value(I18n.formatMessage("commands.address.labels.public-key"), addressDictionary[i].publicKey);
             CLIDisplay.break();
@@ -97,7 +105,7 @@ async function actionCommandAddress(opts) {
     if (Is.stringValue(opts?.env)) {
         const output = [];
         for (const addressIndex in addressDictionary) {
-            output.push(`ADDRESS_${addressIndex}_BECH32="${addressDictionary[addressIndex].bech32}"`);
+            output.push(`ADDRESS_${addressIndex}="${addressDictionary[addressIndex].address}"`);
             output.push(`ADDRESS_${addressIndex}_PRIVATE_KEY="${addressDictionary[addressIndex].privateKey}"`);
             output.push(`ADDRESS_${addressIndex}_PUBLIC_KEY="${addressDictionary[addressIndex].publicKey}"`);
         }
@@ -123,7 +131,8 @@ function buildCommandMnemonic() {
         .default("256"))
         .addOption(new Option(I18n.formatMessage("commands.mnemonic.options.seed-format.param"), I18n.formatMessage("commands.mnemonic.options.seed-format.description"))
         .choices(["hex", "base64"])
-        .default("hex"));
+        .default("hex"))
+        .addOption(new Option(I18n.formatMessage("commands.mnemonic.options.env-prefix.param"), I18n.formatMessage("commands.mnemonic.options.env-prefix.description")));
     CLIOptions.output(command, {
         noConsole: true,
         json: true,
@@ -144,17 +153,21 @@ async function actionCommandMnemonic(opts) {
     const strength = CLIParam.integer("strength", opts.strength, false, 128, 256);
     const mnemonic = Bip39.randomMnemonic(strength);
     const seed = Bip39.mnemonicToSeed(mnemonic);
+    const envPrefix = Is.stringValue(opts.envPrefix) ? opts.envPrefix : "";
     const seedFormatted = opts.seedFormat === "hex" ? Converter.bytesToHex(seed, true) : Converter.bytesToBase64(seed);
     if (opts.console) {
         CLIDisplay.value(I18n.formatMessage("commands.mnemonic.labels.mnemonic"), mnemonic);
         CLIDisplay.value(I18n.formatMessage("commands.mnemonic.labels.seed"), seedFormatted);
+        if (Is.stringValue(opts.envPrefix)) {
+            CLIDisplay.value(I18n.formatMessage("commands.mnemonic.labels.envPrefix"), envPrefix);
+        }
         CLIDisplay.break();
     }
     if (Is.stringValue(opts?.json)) {
         await CLIUtils.writeJsonFile(opts.json, { mnemonic, seed: seedFormatted }, opts.mergeJson);
     }
     if (Is.stringValue(opts?.env)) {
-        await CLIUtils.writeEnvFile(opts.env, [`MNEMONIC="${mnemonic}"`, `SEED="${seedFormatted}"`], opts.mergeEnv);
+        await CLIUtils.writeEnvFile(opts.env, [`${envPrefix}MNEMONIC="${mnemonic}"`, `${envPrefix}SEED="${seedFormatted}"`], opts.mergeEnv);
     }
     CLIDisplay.done();
 }
@@ -169,15 +182,18 @@ class CLI extends CLIBase {
      * Run the app.
      * @param argv The process arguments.
      * @param localesDirectory The directory for the locales, default to relative to the script.
+     * @param options Additional options.
+     * @param options.overrideOutputWidth Override the output width.
      * @returns The exit code.
      */
-    async run(argv, localesDirectory) {
+    async run(argv, localesDirectory, options) {
         return this.execute({
             title: "TWIN Crypto",
             appName: "twin-crypto",
-            version: "0.0.1-next.3",
+            version: "0.0.1-next.31",
             icon: "🌍",
-            supportsEnvFiles: true
+            supportsEnvFiles: true,
+            overrideOutputWidth: options?.overrideOutputWidth
         }, localesDirectory ?? path.join(path.dirname(fileURLToPath(import.meta.url)), "../locales"), argv);
     }
     /**

package/dist/locales/en.json

@@ -1,312 +1,331 @@
 {
-  "error": {
-    "commands": {
-      "address": {
-        "seedMissingEnv": "The seed does not appear to be hex or base64, assuming it is an environment variable, but there is no environment variable with the name \"{env}\" set.",
-        "seedInvalidEnv": "The seed does not appear to be hex or base64, assuming it is an environment variable, but there the environment variable is neither hex or base64. \"{envValue}\"",
-        "seedInvalidFormat": "The seed does not appear to be hex, base64 or an environment variable. \"{seed}\""
-      },
-      "common": {
-        "missingEnv": "The \"{option}\" option is configured as an environment variable, but there is no environment variable with the name \"{value}\" set.",
-        "optionInvalidHex": "The \"{option}\" does not appear to be hex. \"{value}\"",
-        "optionInvalidBase64": "The \"{option}\" does not appear to be base64. \"{value}\"",
-        "optionInvalidHexBase64": "The \"{option}\" does not appear to be hex or base64. \"{value}\"",
-        "optionInvalidBech32": "The \"{option}\" does not appear to be bech32. \"{value}\"",
-        "optionMinValue": "The \"{option}\" option must be greater than or equal to {minValue}, it is {value}.",
-        "optionMaxValue": "The \"{option}\" option must be less than or equal to {maxValue}, it is {value}."
-      }
-    },
-    "validation": {
-      "beEmpty": "{fieldName} must be empty",
-      "beNotEmpty": "{fieldName} must not be empty",
-      "beText": "{fieldName} must be text",
-      "beTextValue": "{fieldName} must contain some text",
-      "beTextMinMax": "{fieldName} must be longer than {minLength} and shorter than {maxLength} characters",
-      "beTextMin": "{fieldName} must be longer than {minLength} characters",
-      "beTextMax": "{fieldName} must be shorter than {maxLength} characters",
-      "beNumber": "{fieldName} must be a number",
-      "beNumberMinMax": "{fieldName} must be >= {minValue} and <= {maxValue}",
-      "beNumberMin": "{fieldName} must be >= {minValue}",
-      "beNumberMax": "{fieldName} must be <= {maxValue}",
-      "beWholeNumber": "{fieldName} must be a whole number",
-      "beWholeNumberMinMax": "{fieldName} must be a whole number >= {minValue} and <= {maxValue}",
-      "beWholeNumberMin": "{fieldName} must be a whole number >= {minValue}",
-      "beWholeNumberMax": "{fieldName} must be a whole number <= {maxValue}",
-      "beBigInteger": "{fieldName} must be a bigint",
-      "beBigIntegerMinMax": "{fieldName} must be a bigint >= {minValue} and <= {maxValue}",
-      "beBigIntegerMin": "{fieldName} must be a bigint >= {minValue}",
-      "beBigIntegerMax": "{fieldName} must be a bigint <= {maxValue}",
-      "beBoolean": "{fieldName} must be true or false",
-      "beDate": "{fieldName} must be a date",
-      "beDateTime": "{fieldName} must be a date/time",
-      "beTime": "{fieldName} must be a time",
-      "beTimestampMilliseconds": "{fieldName} must be a timestamp in milliseconds",
-      "beTimestampSeconds": "{fieldName} must be a timestamp in seconds",
-      "beObject": "{fieldName} must be an object",
-      "beArray": "{fieldName} must be an array",
-      "beArrayValue": "{fieldName} must be an array with at least one item",
-      "beIncluded": "{fieldName} is unrecognised",
-      "beByteArray": "{fieldName} must be a byte array",
-      "beUrn": "{fieldName} must be a correctly formatted urn",
-      "beUrl": "{fieldName} must be a correctly formatted url",
-      "beJSON": "{fieldName} must be correctly formatted JSON",
-      "beEmail": "{fieldName} must be a correctly formatted e-mail address",
-      "failed": "Validation failed",
-      "failedObject": "Validation of \"{objectName}\" failed"
-    },
-    "guard": {
-      "undefined": "Property \"{property}\" must be defined, it is \"{value}\"",
-      "string": "Property \"{property}\" must be a string, it is \"{value}\"",
-      "stringEmpty": "Property \"{property}\" must have a value, it is empty",
-      "stringBase64": "Property \"{property}\" must be a base64 encoded string, it is \"{value}\"",
-      "stringBase64Url": "Property \"{property}\" must be a base64 url encoded string, it is \"{value}\"",
-      "stringHex": "Property \"{property}\" must be a hex string, it is \"{value}\"",
-      "stringHexLength": "Property \"{property}\" must be a hex string of length \"{options}\", it is \"{value}\"",
-      "number": "Property \"{property}\" must be a number, it is \"{value}\"",
-      "integer": "Property \"{property}\" must be an integer, it is \"{value}\"",
-      "bigint": "Property \"{property}\" must be a bigint, it is \"{value}\"",
-      "boolean": "Property \"{property}\" must be a boolean, it is \"{value}\"",
-      "date": "Property \"{property}\" must be a date, it is \"{value}\"",
-      "timestampMilliseconds": "Property \"{property}\" must be a timestamp in milliseconds, it is \"{value}\"",
-      "timestampSeconds": "Property \"{property}\" must be a timestamp in seconds, it is \"{value}\"",
-      "objectUndefined": "Property \"{property}\" must be an object, it is \"undefined\"",
-      "object": "Property \"{property}\" must be an object, it is \"{value}\"",
-      "objectValue": "Property \"{property}\" must be an object, with at least one property, it is \"{value}\"",
-      "array": "Property \"{property}\" must be an array, it is \"{value}\"",
-      "arrayValue": "Property \"{property}\" must be an array with at least one item",
-      "arrayOneOf": "Property \"{property}\" must be one of [{options}], it is \"{value}\"",
-      "uint8Array": "Property \"{property}\" must be a Uint8Array, it is \"{value}\"",
-      "function": "Property \"{property}\" must be a function, it is \"{value}\"",
-      "urn": "Property \"{property}\" must be a Urn formatted string, it is \"{value}\"",
-      "url": "Property \"{property}\" must be a Url formatted string, it is \"{value}\"",
-      "email": "Property \"{property}\" must be string in e-mail format, it is \"{value}\"",
-      "length32Multiple": "Property \"{property}\" should be a multiple of 32, it is {value}",
-      "lengthEntropy": "Property \"{property}\" should be a multiple of 4, >=16 and <= 32, it is {value}",
-      "length3Multiple": "Property \"{property}\" should be a multiple of 3, it is {value}",
-      "greaterThan0": "Property \"{property}\" must be greater than zero, it is {value}"
-    },
-    "objectHelper": {
-      "failedBytesToJSON": "Failed converting bytes to JSON"
-    },
-    "common": {
-      "notImplementedMethod": "The method \"{method}\" has not been implemented",
-      "validation": "Validation failed"
-    },
-    "factory": {
-      "noUnregister": "There is no {typeName} registered with the name \"{name}\"",
-      "noGet": "The requested {typeName} \"{name}\" does not exist in the factory"
-    },
-    "bitString": {
-      "outOfRange": "The index should be >= 0 and less than the length of the bit string"
-    },
-    "bip39": {
-      "missingMnemonicWord": "The mnemonic contains a word not in the wordlist, \"{value}\"",
-      "checksumMismatch": "The checksum does not match \"{newChecksum}\" != \"{checksumBits}\""
-    },
-    "ed25519": {
-      "privateKeyLength": "The private key length is incorrect, it should be \"{requiredSize}\" but is \"{actualSize}\"",
-      "publicKeyLength": "The public key length is incorrect, it should be \"{requiredSize}\" but is \"{actualSize}\""
-    },
-    "secp256k1": {
-      "privateKeyLength": "The private key length is incorrect, it should be \"{requiredSize}\" but is \"{actualSize}\"",
-      "publicKeyLength": "The public key length is incorrect, it should be \"{requiredSize}\" but is \"{actualSize}\""
-    },
-    "x25519": {
-      "invalidPublicKey": "Invalid Ed25519 Public Key"
-    },
-    "blake2b": {
-      "outputLength64": "The output length should be between 1 and 64, it is \"{outputLength}\"",
-      "keyLength64": "The key length should be between 1 and 64, it is \"{keyLength}\""
-    },
-    "sha512": {
-      "bitSize": "Only 224, 256, 384 or 512 bits are supported, it is \"{bitSize}\""
-    },
-    "sha256": {
-      "bitSize": "Only 224 or 256 bits are supported, it is \"{bitSize}\""
-    },
-    "hmacSha256": {
-      "bitSize": "Only 224 or 256 bits are supported, it is \"{bitSize}\""
-    },
-    "hmacSha512": {
-      "bitSize": "Only 224, 256, 384 or 512 bits are supported, it is \"{bitSize}\""
-    },
-    "base32": {
-      "invalidCharacter": "Data contains a character \"{invalidCharacter}\" which is not in the charset"
-    },
-    "base64": {
-      "length4Multiple": "Invalid length should be a multiple of 4, it is \"{value}\""
-    },
-    "bech32": {
-      "decodeFailed": "The address contains decoding failed for address \"{bech32}\"",
-      "invalidChecksum": "The address contains an invalid checksum in address, \"{bech32}\"",
-      "separatorMisused": "The separator character '1' should only be used between hrp and data, \"{bech32}\"",
-      "lowerUpper": "The address my use either lowercase or uppercase, \"{bech32}\"",
-      "dataTooShort": "The address does not contain enough data to decode, \"{bech32}\""
-    },
-    "pbkdf2": {
-      "keyTooLong": "The requested key length \"{keyLength}\" is too long, based on the \"{macLength}\""
-    },
-    "chaCha20Poly1305": {
-      "noAadWithData": "You can not set the aad when there is already data",
-      "noAuthTag": "Can not finalise when the auth tag is not set",
-      "authenticationFailed": "The data could not be authenticated",
-      "authTagDecrypting": "Can not get the auth tag when decrypting",
-      "authTagEncrypting": "Can not set the auth tag when encrypting",
-      "noAuthTagSet": "The auth tag has not been set"
-    },
-    "bip44": {
-      "unsupportedKeyType": "The key type \"{keyType}\" is not supported"
-    },
-    "slip0010": {
-      "invalidSeed": "The seed is invalid \"{seed}\""
-    }
-  },
-  "commands": {
-    "mnemonic": {
-      "summary": "Create a mnemonic.",
-      "description": "Create a mnemonic, will also generate the equivalent seed in hex and base64 format.",
-      "options": {
-        "strength": {
-          "param": "--strength '<'number'>'",
-          "description": "The number of words in the mnemonic, defaults to 256 which produces 24 words."
-        },
-        "seed-format": {
-          "param": "--seed-format '<'format'>'",
-          "description": "The format to output the seed."
-        },
-        "no-console": {
-          "param": "--no-console",
-          "description": "Hides the mnemonic and seed in the console."
-        },
-        "json": {
-          "param": "--json '<'filename'>'",
-          "description": "Creates a JSON file containing the mnemonic and seed."
-        },
-        "env": {
-          "param": "--env '<'filename'>'",
-          "description": "Creates an env file containing the mnemonic and seed."
-        }
-      },
-      "progress": {
-        "writingJsonFile": "Writing JSON file",
-        "writingEnvFile": "Writing env file"
-      },
-      "labels": {
-        "mnemonic": "Mnemonic",
-        "seed": "Seed"
-      }
-    },
-    "address": {
-      "summary": "Create bech32 addresses and keys from the seed.",
-      "description": "Create a number of bech32 addresses and their associated key pairs from the seed.",
-      "options": {
-        "seed": {
-          "param": "--seed '<'seed'>'",
-          "description": "The seed to use for generating the addresses, this can be either hex, base64 or an environment variable name. For an environment variable start the value with a !"
-        },
-        "start": {
-          "param": "--start '<'number'>'",
-          "description": "The index of the first address to create."
-        },
-        "count": {
-          "param": "--count '<'number'>'",
-          "description": "The number of addresses to create, max 100."
-        },
-        "account": {
-          "param": "--account '<'number'>'",
-          "description": "The account used to generate the bech32 addresses."
-        },
-        "hrp": {
-          "param": "--hrp '<'hrp'>'",
-          "description": "The human readable part of the bech32 addresses."
-        },
-        "coin": {
-          "param": "--coin '<'coin'>'",
-          "description": "The coin type used to generate the bech32 addresses."
-        },
-        "key-type": {
-          "param": "--key-type '<'type'>'",
-          "description": "The type of key to generate."
-        },
-        "key-format": {
-          "param": "--key-format '<'format'>'",
-          "description": "The format to output the keys."
-        }
-      },
-      "progress": {
-        "generatingAddresses": "Generating addresses"
-      },
-      "labels": {
-        "seed": "Seed",
-        "start": "Start",
-        "count": "Count",
-        "account": "Account",
-        "hrp": "HRP",
-        "coin": "Coin",
-        "key-type": "Key Type",
-        "key-format": "Key Format",
-        "index": "Index",
-        "address": "Address",
-        "public-key": "Public Key",
-        "private-key": "Private Key"
-      }
-    }
-  },
-  "cli": {
-    "progress": {
-      "done": "Done.",
-      "error": "Error",
-      "loadingEnvFiles": "Loading env files",
-      "pleaseWait": "Please wait...",
-      "writingJsonFile": "Writing JSON file",
-      "writingEnvFile": "Writing env file",
-      "readingJsonFile": "Reading JSON file",
-      "readingEnvFile": "Reading env file"
-    },
-    "options": {
-      "lang": {
-        "param": "--lang '<'lang'>'",
-        "description": "The language to display the output in."
-      },
-      "load-env": {
-        "param": "--load-env [env...]",
-        "description": "Load the env files to initialise any environment variables."
-      },
-      "no-console": {
-        "param": "--no-console",
-        "description": "Hides the output in the console."
-      },
-      "json": {
-        "param": "--json '<'filename'>'",
-        "description": "Creates a JSON file containing the output."
-      },
-      "env": {
-        "param": "--env '<'filename'>'",
-        "description": "Creates an env file containing the output."
-      },
-      "merge-json": {
-        "param": "--merge-json",
-        "description": "If the JSON file already exists merge the data instead of overwriting."
-      },
-      "merge-env": {
-        "param": "--merge-env",
-        "description": "If the env file already exists merge the data instead of overwriting."
-      }
-    }
-  },
-  "errorNames": {
-    "error": "Error",
-    "generalError": "General",
-    "guardError": "Guard",
-    "conflictError": "Conflict",
-    "notFoundError": "Not Found",
-    "notSupportedError": "Not Supported",
-    "alreadyExistsError": "Already Exists",
-    "notImplementedError": "Not Implemented",
-    "validationError": "Validation",
-    "unprocessableError": "Unprocessable"
-  },
-  "validation": {
-    "defaultFieldName": "The field"
-  }
-}
+	"error": {
+		"commands": {
+			"common": {
+				"missingEnv": "The \"{option}\" option is configured as an environment variable, but there is no environment variable with the name \"{value}\" set.",
+				"optionInvalidHex": "The \"{option}\" does not appear to be hex. \"{value}\"",
+				"optionInvalidBase64": "The \"{option}\" does not appear to be base64. \"{value}\"",
+				"optionInvalidHexBase64": "The \"{option}\" does not appear to be hex or base64. \"{value}\"",
+				"optionInvalidBech32": "The \"{option}\" does not appear to be bech32. \"{value}\"",
+				"optionMinValue": "The \"{option}\" option must be greater than or equal to {minValue}, it is {value}.",
+				"optionMaxValue": "The \"{option}\" option must be less than or equal to {maxValue}, it is {value}."
+			},
+			"address": {
+				"seedMissingEnv": "The seed does not appear to be hex or base64, assuming it is an environment variable, but there is no environment variable with the name \"{env}\" set.",
+				"seedInvalidEnv": "The seed does not appear to be hex or base64, assuming it is an environment variable, but there the environment variable is neither hex or base64. \"{envValue}\"",
+				"seedInvalidFormat": "The seed does not appear to be hex, base64 or an environment variable. \"{seed}\""
+			}
+		},
+		"validation": {
+			"beEmpty": "{fieldName} must be empty",
+			"beNotEmpty": "{fieldName} must not be empty",
+			"beText": "{fieldName} must be text",
+			"beTextValue": "{fieldName} must contain some text",
+			"beTextMinMax": "{fieldName} must be longer than {minLength} and shorter than {maxLength} characters",
+			"beTextMin": "{fieldName} must be longer than {minLength} characters",
+			"beTextMax": "{fieldName} must be shorter than {maxLength} characters",
+			"beTextBase58": "{fieldName} must be text formatted using Base58 characters",
+			"beTextBase64": "{fieldName} must be text formatted using Base64 characters",
+			"beTextHex": "{fieldName} must be text formatted using Hex characters",
+			"beTextRegExp": "{fieldName} must be text formatted using the matching pattern {format}",
+			"beNumber": "{fieldName} must be a number",
+			"beNumberMinMax": "{fieldName} must be >= {minValue} and <= {maxValue}",
+			"beNumberMin": "{fieldName} must be >= {minValue}",
+			"beNumberMax": "{fieldName} must be <= {maxValue}",
+			"beWholeNumber": "{fieldName} must be a whole number",
+			"beWholeNumberMinMax": "{fieldName} must be a whole number >= {minValue} and <= {maxValue}",
+			"beWholeNumberMin": "{fieldName} must be a whole number >= {minValue}",
+			"beWholeNumberMax": "{fieldName} must be a whole number <= {maxValue}",
+			"beBigInteger": "{fieldName} must be a bigint",
+			"beBigIntegerMinMax": "{fieldName} must be a bigint >= {minValue} and <= {maxValue}",
+			"beBigIntegerMin": "{fieldName} must be a bigint >= {minValue}",
+			"beBigIntegerMax": "{fieldName} must be a bigint <= {maxValue}",
+			"beBoolean": "{fieldName} must be true or false",
+			"beDate": "{fieldName} must be a date",
+			"beDateTime": "{fieldName} must be a date/time",
+			"beTime": "{fieldName} must be a time",
+			"beTimestampMilliseconds": "{fieldName} must be a timestamp in milliseconds",
+			"beTimestampSeconds": "{fieldName} must be a timestamp in seconds",
+			"beObject": "{fieldName} must be an object",
+			"beArray": "{fieldName} must be an array",
+			"beArrayValue": "{fieldName} must be an array with at least one item",
+			"beIncluded": "{fieldName} is unrecognised",
+			"beByteArray": "{fieldName} must be a byte array",
+			"beUrn": "{fieldName} must be a correctly formatted urn",
+			"beUrl": "{fieldName} must be a correctly formatted url",
+			"beJSON": "{fieldName} must be correctly formatted JSON",
+			"beEmail": "{fieldName} must be a correctly formatted e-mail address",
+			"failed": "Validation failed",
+			"failedObject": "Validation of \"{objectName}\" failed"
+		},
+		"guard": {
+			"undefined": "Property \"{property}\" must be defined, it is \"{value}\"",
+			"string": "Property \"{property}\" must be a string, it is \"{value}\"",
+			"stringEmpty": "Property \"{property}\" must have a value, it is empty",
+			"stringBase64": "Property \"{property}\" must be a base64 encoded string, it is \"{value}\"",
+			"stringBase64Url": "Property \"{property}\" must be a base64 url encoded string, it is \"{value}\"",
+			"stringBase58": "Property \"{property}\" must be a base58 encoded string, it is \"{value}\"",
+			"stringHex": "Property \"{property}\" must be a hex string, it is \"{value}\"",
+			"stringHexLength": "Property \"{property}\" must be a hex string of length \"{options}\", it is \"{value}\"",
+			"stringJson": "Property \"{property}\" must be a JSON string",
+			"number": "Property \"{property}\" must be a number, it is \"{value}\"",
+			"integer": "Property \"{property}\" must be an integer, it is \"{value}\"",
+			"bigint": "Property \"{property}\" must be a bigint, it is \"{value}\"",
+			"boolean": "Property \"{property}\" must be a boolean, it is \"{value}\"",
+			"date": "Property \"{property}\" must be a date, it is \"{value}\"",
+			"timestampMilliseconds": "Property \"{property}\" must be a timestamp in milliseconds, it is \"{value}\"",
+			"timestampSeconds": "Property \"{property}\" must be a timestamp in seconds, it is \"{value}\"",
+			"objectUndefined": "Property \"{property}\" must be an object, it is \"undefined\"",
+			"object": "Property \"{property}\" must be an object, it is \"{value}\"",
+			"objectValue": "Property \"{property}\" must be an object, with at least one property, it is \"{value}\"",
+			"array": "Property \"{property}\" must be an array, it is \"{value}\"",
+			"arrayValue": "Property \"{property}\" must be an array with at least one item",
+			"arrayOneOf": "Property \"{property}\" must be one of [{options}], it is \"{value}\"",
+			"uint8Array": "Property \"{property}\" must be a Uint8Array, it is \"{value}\"",
+			"function": "Property \"{property}\" must be a function, it is \"{value}\"",
+			"urn": "Property \"{property}\" must be a Urn formatted string, it is \"{value}\"",
+			"url": "Property \"{property}\" must be a Url formatted string, it is \"{value}\"",
+			"email": "Property \"{property}\" must be string in e-mail format, it is \"{value}\"",
+			"length32Multiple": "Property \"{property}\" should be a multiple of 32, it is {value}",
+			"lengthEntropy": "Property \"{property}\" should be a multiple of 4, >=16 and <= 32, it is {value}",
+			"length3Multiple": "Property \"{property}\" should be a multiple of 3, it is {value}",
+			"greaterThan0": "Property \"{property}\" must be greater than zero, it is {value}"
+		},
+		"objectHelper": {
+			"failedBytesToJSON": "Failed converting bytes to JSON",
+			"cannotSetArrayIndex": "Cannot set property \"{property}\" using index \"{index}\" as it is not an array",
+			"cannotSetProperty": "Cannot set property \"{property}\" when the target is not an object"
+		},
+		"common": {
+			"notImplementedMethod": "The method \"{method}\" has not been implemented",
+			"validation": "Validation failed"
+		},
+		"factory": {
+			"noUnregister": "There is no {typeName} registered with the name \"{name}\"",
+			"noGet": "The requested {typeName} \"{name}\" does not exist in the factory"
+		},
+		"bitString": {
+			"outOfRange": "The index should be >= 0 and less than the length of the bit string"
+		},
+		"base32": {
+			"invalidCharacter": "Data contains a character \"{invalidCharacter}\" which is not in the charset"
+		},
+		"base64": {
+			"length4Multiple": "Invalid length should be a multiple of 4, it is \"{value}\""
+		},
+		"base58": {
+			"invalidCharacter": "Data contains a character \"{invalidCharacter}\" which is not in the charset"
+		},
+		"bip39": {
+			"missingMnemonicWord": "The mnemonic contains a word not in the wordlist, \"{value}\"",
+			"checksumMismatch": "The checksum does not match \"{newChecksum}\" != \"{checksumBits}\""
+		},
+		"ed25519": {
+			"privateKeyLength": "The private key length is incorrect, it should be \"{requiredSize}\" but is \"{actualSize}\"",
+			"publicKeyLength": "The public key length is incorrect, it should be \"{requiredSize}\" but is \"{actualSize}\""
+		},
+		"secp256k1": {
+			"privateKeyLength": "The private key length is incorrect, it should be \"{requiredSize}\" but is \"{actualSize}\"",
+			"publicKeyLength": "The public key length is incorrect, it should be \"{requiredSize}\" but is \"{actualSize}\""
+		},
+		"x25519": {
+			"invalidPublicKey": "Invalid Ed25519 Public Key"
+		},
+		"blake2b": {
+			"outputLength64": "The output length should be between 1 and 64, it is \"{outputLength}\"",
+			"keyLength64": "The key length should be between 1 and 64, it is \"{keyLength}\""
+		},
+		"sha512": {
+			"bitSize": "Only 224, 256, 384 or 512 bits are supported, it is \"{bitSize}\""
+		},
+		"sha256": {
+			"bitSize": "Only 224 or 256 bits are supported, it is \"{bitSize}\""
+		},
+		"sha3": {
+			"bitSize": "Only 224, 256, 384 or 512 bits are supported, it is \"{bitSize}\""
+		},
+		"hmacSha256": {
+			"bitSize": "Only 224 or 256 bits are supported, it is \"{bitSize}\""
+		},
+		"hmacSha512": {
+			"bitSize": "Only 224, 256, 384 or 512 bits are supported, it is \"{bitSize}\""
+		},
+		"bech32": {
+			"decodeFailed": "The address contains decoding failed for address \"{bech32}\"",
+			"invalidChecksum": "The address contains an invalid checksum in address, \"{bech32}\"",
+			"separatorMisused": "The separator character '1' should only be used between hrp and data, \"{bech32}\"",
+			"lowerUpper": "The address my use either lowercase or uppercase, \"{bech32}\"",
+			"dataTooShort": "The address does not contain enough data to decode, \"{bech32}\""
+		},
+		"pbkdf2": {
+			"keyTooLong": "The requested key length \"{keyLength}\" is too long, based on the \"{macLength}\""
+		},
+		"chaCha20Poly1305": {
+			"noAadWithData": "You can not set the aad when there is already data",
+			"noAuthTag": "Can not finalise when the auth tag is not set",
+			"authenticationFailed": "The data could not be authenticated",
+			"authTagDecrypting": "Can not get the auth tag when decrypting",
+			"authTagEncrypting": "Can not set the auth tag when encrypting",
+			"noAuthTagSet": "The auth tag has not been set"
+		},
+		"bip44": {
+			"unsupportedKeyType": "The key type \"{keyType}\" is not supported"
+		},
+		"slip0010": {
+			"invalidSeed": "The seed is invalid \"{seed}\""
+		}
+	},
+	"cli": {
+		"progress": {
+			"done": "Done.",
+			"error": "Error",
+			"loadingEnvFiles": "Loading env files",
+			"pleaseWait": "Please wait...",
+			"writingJsonFile": "Writing JSON file",
+			"writingEnvFile": "Writing env file",
+			"readingJsonFile": "Reading JSON file",
+			"readingEnvFile": "Reading env file"
+		},
+		"options": {
+			"lang": {
+				"param": "--lang '<'lang'>'",
+				"description": "The language to display the output in."
+			},
+			"load-env": {
+				"param": "--load-env [env...]",
+				"description": "Load the env files to initialise any environment variables."
+			},
+			"no-console": {
+				"param": "--no-console",
+				"description": "Hides the output in the console."
+			},
+			"json": {
+				"param": "--json '<'filename'>'",
+				"description": "Creates a JSON file containing the output."
+			},
+			"env": {
+				"param": "--env '<'filename'>'",
+				"description": "Creates an env file containing the output."
+			},
+			"merge-json": {
+				"param": "--merge-json",
+				"description": "If the JSON file already exists merge the data instead of overwriting."
+			},
+			"merge-env": {
+				"param": "--merge-env",
+				"description": "If the env file already exists merge the data instead of overwriting."
+			}
+		}
+	},
+	"errorNames": {
+		"error": "Error",
+		"generalError": "General",
+		"guardError": "Guard",
+		"conflictError": "Conflict",
+		"notFoundError": "Not Found",
+		"notSupportedError": "Not Supported",
+		"alreadyExistsError": "Already Exists",
+		"notImplementedError": "Not Implemented",
+		"validationError": "Validation",
+		"unprocessableError": "Unprocessable"
+	},
+	"validation": {
+		"defaultFieldName": "The field"
+	},
+	"commands": {
+		"mnemonic": {
+			"summary": "Create a mnemonic.",
+			"description": "Create a mnemonic, will also generate the equivalent seed in hex and base64 format.",
+			"options": {
+				"strength": {
+					"param": "--strength '<'number'>'",
+					"description": "The number of words in the mnemonic, defaults to 256 which produces 24 words."
+				},
+				"seed-format": {
+					"param": "--seed-format '<'format'>'",
+					"description": "The format to output the seed."
+				},
+				"no-console": {
+					"param": "--no-console",
+					"description": "Hides the mnemonic and seed in the console."
+				},
+				"json": {
+					"param": "--json '<'filename'>'",
+					"description": "Creates a JSON file containing the mnemonic and seed."
+				},
+				"env": {
+					"param": "--env '<'filename'>'",
+					"description": "Creates an env file containing the mnemonic and seed."
+				},
+				"env-prefix": {
+					"param": "--env-prefix '<'prefix'>'",
+					"description": "Prefixes the env variables with the value."
+				}
+			},
+			"progress": {
+				"writingJsonFile": "Writing JSON file",
+				"writingEnvFile": "Writing env file"
+			},
+			"labels": {
+				"mnemonic": "Mnemonic",
+				"seed": "Seed",
+				"envPrefix": "Env Prefix"
+			}
+		},
+		"address": {
+			"summary": "Create addresses and keys from the seed.",
+			"description": "Create a number of addresses and their associated key pairs from the seed.",
+			"options": {
+				"seed": {
+					"param": "--seed '<'seed'>'",
+					"description": "The seed to use for generating the addresses, this can be either hex, base64 or an environment variable name. For an environment variable start the value with a !"
+				},
+				"start": {
+					"param": "--start '<'number'>'",
+					"description": "The index of the first address to create."
+				},
+				"count": {
+					"param": "--count '<'number'>'",
+					"description": "The number of addresses to create, max 100."
+				},
+				"account": {
+					"param": "--account '<'number'>'",
+					"description": "The account used to generate the addresses."
+				},
+				"hrp": {
+					"param": "--hrp '<'hrp'>'",
+					"description": "The human readable part for the addresses if generating bech32 format."
+				},
+				"coin": {
+					"param": "--coin '<'coin'>'",
+					"description": "The coin type used to generate the addresses."
+				},
+				"key-type": {
+					"param": "--key-type '<'type'>'",
+					"description": "The type of key to generate."
+				},
+				"key-format": {
+					"param": "--key-format '<'format'>'",
+					"description": "The format to output the keys."
+				}
+			},
+			"progress": {
+				"generatingAddresses": "Generating addresses"
+			},
+			"labels": {
+				"seed": "Seed",
+				"start": "Start",
+				"count": "Count",
+				"account": "Account",
+				"hrp": "HRP",
+				"coin": "Coin",
+				"key-type": "Key Type",
+				"key-format": "Key Format",
+				"index": "Index",
+				"address": "Address",
+				"public-key": "Public Key",
+				"private-key": "Private Key"
+			}
+		}
+	}
+}

package/dist/types/cli.d.ts

@@ -7,7 +7,11 @@ export declare class CLI extends CLIBase {
      * Run the app.
      * @param argv The process arguments.
      * @param localesDirectory The directory for the locales, default to relative to the script.
+     * @param options Additional options.
+     * @param options.overrideOutputWidth Override the output width.
      * @returns The exit code.
      */
-    run(argv: string[], localesDirectory?: string): Promise<number>;
+    run(argv: string[], localesDirectory?: string, options?: {
+        overrideOutputWidth?: number;
+    }): Promise<number>;
 }

package/dist/types/commands/address.d.ts

@@ -12,7 +12,7 @@ export declare function buildCommandAddress(): Command;
  * @param opts.start The start index for the address generation.
  * @param opts.count The number of addresses to generate.
  * @param opts.account The account index for the address generation.
- * @param opts.hrp The human readable part for the address.
+ * @param opts.hrp The human readable part for the addresses if generating bech32 format.
  * @param opts.coin The coin type for the address.
  * @param opts.keyType The key type for the address.
  * @param opts.keyFormat The output format of the key.
@@ -22,7 +22,7 @@ export declare function actionCommandAddress(opts: {
     start: string;
     count: string;
     account: string;
-    hrp: string;
+    hrp?: string;
     coin: string;
     keyType: "Ed25519" | "Secp256k1";
     keyFormat: "hex" | "base64";

package/dist/types/commands/mnemonic.d.ts

@@ -14,4 +14,5 @@ export declare function buildCommandMnemonic(): Command;
 export declare function actionCommandMnemonic(opts: {
     strength: string;
     seedFormat: "hex" | "base64";
+    envPrefix?: string;
 } & CliOutputOptions): Promise<void>;

package/docs/changelog.md

@@ -1,5 +1,5 @@
 # @twin.org/crypto-cli - Changelog
 
-## 0.0.1-next.3
+## 0.0.1-next.31
 
 - Initial Release

package/docs/examples.md

@@ -1,22 +1,21 @@
 # @twin.org/crypto-cli - Examples
 
-## Command Line Tool
+## Running
 
-First install the tool with the following script.
+To install and run the CLI locally use the following commands:
 
 ```shell
-npm install @twin.org/crypto-cli
+npm install @twin.org/crypto-cli -g
+twin-crypto
 ```
 
-## Running
-
-If you run the tool with no command line options:
+or run directly using NPX:
 
 ```shell
-twin-crypto
+npx "@twin.org/crypto-cli"
 ```
 
-You should see output similar to the following
+You should see output similar to the following:
 
 ```shell
 🌍 TWIN Crypto v1.0.0
@@ -230,10 +229,10 @@ twin-crypto address --load-env my.env --seed !SEED --env address.env --merge-env
 The output of this command would produce address.env
 
 ```shell
-ADDRESS_0_BECH32="iota1qqcpqyrnqtzteu7k26dgjvjp3x76tts526prtwrjq99v50pyv6l9xysdcg8"
+ADDRESS_0="iota1qqcpqyrnqtzteu7k26dgjvjp3x76tts526prtwrjq99v50pyv6l9xysdcg8"
 ADDRESS_0_PRIVATE_KEY="0x3b2863db878ce156a46d2142c72baa7807a40a990684604ff86456821228d978"
 ADDRESS_0_PUBLIC_KEY="0x6b6eb9e54b44bfbc65c4a02c6489609fbc9588e640ca44bfdfdb1af4e5874905"
-ADDRESS_1_BECH32="iota1qrqyyyuhfzgrp7ducjapg8pta3w877nu0u5jpe50cxx39qjs08kczw7uj4v"
+ADDRESS_1="iota1qrqyyyuhfzgrp7ducjapg8pta3w877nu0u5jpe50cxx39qjs08kczw7uj4v"
 ADDRESS_1_PRIVATE_KEY="0xc5038b4c0b1dc46769687e77555a7be176e22de4262cf5aabf11290ab7c8d856"
 ADDRESS_1_PUBLIC_KEY="0x603d9b2d25341d142524867536e3ee94d3e02a45fe498ec4c3473b0449446d77"
 ....

package/docs/reference/classes/CLI.md

@@ -22,75 +22,35 @@ The main entry point for the CLI.
 
 ## Methods
 
-### execute()
+### run()
 
-> **execute**(`options`, `localesDirectory`, `argv`): `Promise`\<`number`\>
+> **run**(`argv`, `localesDirectory`?, `options`?): `Promise`\<`number`\>
 
-Execute the command line processing.
+Run the app.
 
 #### Parameters
 
-• **options**: `ICliOptions`
-
-The options for the CLI.
-
-• **localesDirectory**: `string`
-
-The path to load the locales from.
+##### argv
 
-• **argv**: `string`[]
+`string`[]
 
 The process arguments.
 
-#### Returns
-
-`Promise`\<`number`\>
-
-The exit code.
-
-#### Inherited from
-
-`CLIBase.execute`
-
-***
+##### localesDirectory?
 
-### configureRoot()
-
-> `protected` **configureRoot**(`program`): `void`
-
-Configure any options or actions at the root program level.
-
-#### Parameters
+`string`
 
-• **program**: `Command`
-
-The root program command.
-
-#### Returns
-
-`void`
-
-#### Inherited from
-
-`CLIBase.configureRoot`
-
-***
-
-### run()
-
-> **run**(`argv`, `localesDirectory`?): `Promise`\<`number`\>
-
-Run the app.
+The directory for the locales, default to relative to the script.
 
-#### Parameters
+##### options?
 
-• **argv**: `string`[]
+Additional options.
 
-The process arguments.
+###### overrideOutputWidth
 
-• **localesDirectory?**: `string`
+`number`
 
-The directory for the locales, default to relative to the script.
+Override the output width.
 
 #### Returns
 

package/docs/reference/functions/actionCommandAddress.md

@@ -6,7 +6,9 @@ Action the address command.
 
 ## Parameters
 
-• **opts**: `object` & `ICliOutputOptionsConsole` & `ICliOutputOptionsEnv` & `ICliOutputOptionsJson`
+### opts
+
+`object` & `ICliOutputOptionsConsole` & `ICliOutputOptionsEnv` & `ICliOutputOptionsJson`
 
 The options for the command.
 

package/docs/reference/functions/actionCommandMnemonic.md

@@ -6,7 +6,9 @@ Action the mnemonic command.
 
 ## Parameters
 
-• **opts**: `object` & `ICliOutputOptionsConsole` & `ICliOutputOptionsEnv` & `ICliOutputOptionsJson`
+### opts
+
+`object` & `ICliOutputOptionsConsole` & `ICliOutputOptionsEnv` & `ICliOutputOptionsJson`
 
 The options for the command.
 

package/locales/en.json

@@ -32,6 +32,10 @@
 				"env": {
 					"param": "--env '<'filename'>'",
 					"description": "Creates an env file containing the mnemonic and seed."
+				},
+				"env-prefix": {
+					"param": "--env-prefix '<'prefix'>'",
+					"description": "Prefixes the env variables with the value."
 				}
 			},
 			"progress": {
@@ -40,12 +44,13 @@
 			},
 			"labels": {
 				"mnemonic": "Mnemonic",
-				"seed": "Seed"
+				"seed": "Seed",
+				"envPrefix": "Env Prefix"
 			}
 		},
 		"address": {
-			"summary": "Create bech32 addresses and keys from the seed.",
-			"description": "Create a number of bech32 addresses and their associated key pairs from the seed.",
+			"summary": "Create addresses and keys from the seed.",
+			"description": "Create a number of addresses and their associated key pairs from the seed.",
 			"options": {
 				"seed": {
 					"param": "--seed '<'seed'>'",
@@ -61,15 +66,15 @@
 				},
 				"account": {
 					"param": "--account '<'number'>'",
-					"description": "The account used to generate the bech32 addresses."
+					"description": "The account used to generate the addresses."
 				},
 				"hrp": {
 					"param": "--hrp '<'hrp'>'",
-					"description": "The human readable part of the bech32 addresses."
+					"description": "The human readable part for the addresses if generating bech32 format."
 				},
 				"coin": {
 					"param": "--coin '<'coin'>'",
-					"description": "The coin type used to generate the bech32 addresses."
+					"description": "The coin type used to generate the addresses."
 				},
 				"key-type": {
 					"param": "--key-type '<'type'>'",

package/package.json

@@ -1,11 +1,11 @@
 {
 	"name": "@twin.org/crypto-cli",
-	"version": "0.0.1-next.3",
+	"version": "0.0.1-next.31",
 	"description": "A command line interface for interacting with the crypto tools",
 	"repository": {
 		"type": "git",
 		"url": "git+https://github.com/twinfoundation/framework.git",
-		"directory": "packages/crypto-cli"
+		"directory": "apps/crypto-cli"
 	},
 	"author": "martyn.janes@iota.org",
 	"license": "Apache-2.0",
@@ -13,50 +13,21 @@
 	"engines": {
 		"node": ">=20.0.0"
 	},
-	"scripts": {
-		"clean": "rimraf dist coverage",
-		"build": "tspc",
-		"merge-locales": "merge-locales",
-		"test": "vitest --run --config ./vitest.config.ts --no-cache",
-		"coverage": "vitest --run --coverage --config ./vitest.config.ts --no-cache",
-		"bundle:esm": "rollup --config rollup.config.mjs --environment MODULE:esm",
-		"bundle:cjs": "rollup --config rollup.config.mjs --environment MODULE:cjs",
-		"bundle": "npm run bundle:esm && npm run bundle:cjs",
-		"docs:clean": "rimraf docs/reference",
-		"docs:generate": "typedoc",
-		"docs": "npm run docs:clean && npm run docs:generate",
-		"dist": "npm run clean && npm run build && npm run merge-locales && npm run test && npm run bundle && npm run docs"
-	},
 	"dependencies": {
-		"@twin.org/cli-core": "0.0.1-next.3",
-		"@twin.org/core": "0.0.1-next.3",
-		"@twin.org/crypto": "0.0.1-next.3",
+		"@twin.org/cli-core": "0.0.1-next.31",
+		"@twin.org/core": "0.0.1-next.31",
+		"@twin.org/crypto": "0.0.1-next.31",
 		"@twin.org/nameof": "next",
-		"commander": "12.1.0"
-	},
-	"devDependencies": {
-		"@twin.org/merge-locales": "next",
-		"@twin.org/nameof-transformer": "next",
-		"@types/node": "22.5.5",
-		"@vitest/coverage-v8": "2.1.1",
-		"copyfiles": "2.4.1",
-		"rimraf": "6.0.1",
-		"rollup": "4.21.3",
-		"rollup-plugin-typescript2": "0.36.0",
-		"ts-patch": "3.2.1",
-		"typedoc": "0.26.7",
-		"typedoc-plugin-markdown": "4.2.7",
-		"typescript": "5.6.2",
-		"vitest": "2.1.1"
+		"commander": "13.1.0"
 	},
 	"main": "./dist/cjs/index.cjs",
 	"module": "./dist/esm/index.mjs",
 	"types": "./dist/types/index.d.ts",
 	"exports": {
 		".": {
+			"types": "./dist/types/index.d.ts",
 			"require": "./dist/cjs/index.cjs",
-			"import": "./dist/esm/index.mjs",
-			"types": "./dist/types/index.d.ts"
+			"import": "./dist/esm/index.mjs"
 		}
 	},
 	"files": [