@ldgr/cli 0.2.1 → 0.3.0

package/README.md

@@ -1,6 +1,6 @@
 # @ldgr/cli
 
-LDGR's self-custody terminal wallet. Version 0.2.0 creates or imports local wallets, lets you select between them, shows addresses and balances, sends native LDGR or a token, and persistently switches the selected wallet between mainnet and testnet.
+LDGR's self-custody terminal wallet. Version 0.3.0 creates or imports local wallets, lets you select between them, shows addresses and balances, sends native Ledra or a token, and persistently switches the selected wallet between mainnet and testnet.
 
 ```bash
 npm install -g @ldgr/cli
@@ -13,7 +13,8 @@ ldgr address
 ldgr balance
 ldgr send ldgr1… 2.5
 ldgr send-token t1abcdef01234567 ldgr1… 10
+ldgr network show
 ldgr network set testnet
 ```
 
-The default owner-only wallet store lives at `~/.ldgr/wallet.json`. On first use, an existing `~/.config/ldgr/wallet.json` store is validated, copied to the new owner-only location, and removed from its former location. At creation/import you can choose passphrase protection or an **unprotected** wallet, which follows the extension model and relies only on the local file's permissions. `wallet list` shows one-based indexes and marks the active wallet; `wallet select <index>` changes it without exposing a secret. `wallet export <path>` writes a `0600` `ldgr-recovery-key.txt` file containing the raw recovery-key value accepted by the extension; `wallet import <path>` reads the same file. Testnet prints a warning on every wallet command and only uses `https://tst.ldgr.ltd`.
+The default owner-only wallet store lives at `~/.ldgr/wallet.json`. Pass `--wallet <path>` to any command to use a different store. On first use, an existing `~/.config/ldgr/wallet.json` store is validated, copied to the new owner-only location, and removed from its former location; an explicit `--wallet` path is never moved. On Windows, the CLI uses the native `USERPROFILE`/`APPDATA` locations and path separators, and relies on the file's native ACLs instead of POSIX mode bits. At creation/import you can choose passphrase protection or an **unprotected** wallet, which follows the extension model and relies only on the local file's permissions. `wallet list` shows one-based indexes and marks the active wallet; `wallet select <index>` changes it without exposing a secret. `wallet export <path>` writes an owner-only `ldgr-recovery-key.txt` file containing the raw recovery-key value accepted by the extension; `wallet import <path>` reads the same file. `--testnet` is available only when creating or importing a wallet; use `network set testnet` for an existing wallet. Testnet prints a warning on every wallet command and only uses `https://tst.ldgr.ltd`.

package/dist/cli.js

@@ -11,48 +11,14 @@ import {
 import { readFile as readFile2 } from "node:fs/promises";
 
 // src/transfer.ts
-import {
-  canonicalizeLedgerAddress,
-  formatAtomicAmount,
-  parseDecimalAmount
-} from "@ldgr/protocol";
-async function buildTransferSubmission(input) {
-  const recipient = canonicalizeLedgerAddress(input.to, input.wallet.ledgerId);
-  const amount = parseDecimalAmount(input.amount.trim(), input.assetDefinition);
-  if (amount <= 0n)
-    throw new RangeError("Amount must be greater than zero");
-  if (!/^(0|[1-9][0-9]*)$/.test(input.nextNonce))
-    throw new TypeError("Ledger returned an invalid next nonce");
-  const payload = {
-    version: 1,
-    action: "transfer",
-    chain: "ldgr-v1",
-    ledgerId: input.wallet.ledgerId,
-    asset: input.asset,
-    from: input.wallet.address,
-    to: recipient,
-    amount,
-    nonce: BigInt(input.nextNonce),
-    timestamp: BigInt((input.now ?? Date.now)()),
-    publicKey: input.wallet.publicKey
-  };
-  const signature = await input.wallet.sign(payload);
-  return {
-    payload: {
-      ...payload,
-      amount: formatAtomicAmount(amount, input.assetDefinition),
-      nonce: payload.nonce.toString(),
-      timestamp: payload.timestamp.toString()
-    },
-    signature
-  };
-}
+import { buildTransferSubmission } from "@ldgr/wallet-core";
 
 // src/wallet-file.ts
 import { generateLocalWallet, loadLocalWallet } from "@ldgr/client";
-import { canonicalizeLedgerAddress as canonicalizeLedgerAddress2, decodeEd25519RecoveryKey } from "@ldgr/protocol";
+import { canonicalizeLedgerAddress, decodeEd25519RecoveryKey } from "@ldgr/protocol";
 import { lstat, mkdir, open, readFile, rename, unlink } from "node:fs/promises";
-import { dirname, join } from "node:path";
+import { dirname, join, win32 } from "node:path";
+import { homedir } from "node:os";
 var KDF_ITERATIONS = 310000;
 var AES_GCM = "AES-GCM";
 function arrayBuffer(bytes) {
@@ -87,7 +53,7 @@ function parseWalletEntry(value) {
     throw new TypeError("Unsupported wallet file format");
   if (file.network !== networkForLedger(file.ledgerId))
     throw new TypeError("Wallet file network does not match ledgerId");
-  canonicalizeLedgerAddress2(file.address, file.ledgerId);
+  canonicalizeLedgerAddress(file.address, file.ledgerId);
   if (file.protection === "none") {
     if (typeof file.recoveryKey !== "string")
       throw new TypeError("Unsupported wallet file format");
@@ -125,18 +91,31 @@ function serializeWalletStore(store) {
   return `${JSON.stringify(store, null, 2)}
 `;
 }
+function pathJoiner(platform) {
+  return platform === "win32" ? win32.join : join;
+}
+function homeDirectory(input, platform) {
+  if (input.home !== undefined)
+    return input.home;
+  if (platform === "win32")
+    return process.env.USERPROFILE?.trim() || process.env.HOME?.trim() || homedir();
+  return process.env.HOME?.trim() || homedir();
+}
 function defaultWalletPath(input = {}) {
-  const home = input.home ?? process.env.HOME;
+  const platform = input.platform ?? process.platform;
+  const home = homeDirectory(input, platform);
   if (!home)
     throw new Error("Could not determine your home directory; use --wallet <path>");
-  return join(home, ".ldgr", "wallet.json");
+  return pathJoiner(platform)(home, ".ldgr", "wallet.json");
 }
 function legacyDefaultWalletPath(input = {}) {
-  const home = input.home ?? process.env.HOME;
+  const platform = input.platform ?? process.platform;
+  const joinPath = pathJoiner(platform);
+  const home = homeDirectory(input, platform);
   if (!home)
     throw new Error("Could not determine your home directory; use --wallet <path>");
-  const configHome = input.configHome ?? (process.env.XDG_CONFIG_HOME?.trim() || join(home, ".config"));
-  return join(configHome, "ldgr", "wallet.json");
+  const configHome = input.configHome ?? (platform === "win32" ? process.env.APPDATA?.trim() || joinPath(home, "AppData", "Roaming") : process.env.XDG_CONFIG_HOME?.trim() || joinPath(home, ".config"));
+  return joinPath(configHome, "ldgr", "wallet.json");
 }
 async function createEncryptedWalletFile(input) {
   const wallet = await generateLocalWallet({ ledgerId: input.ledgerId });
@@ -204,7 +183,7 @@ async function readWalletStore(path) {
   });
   if (!details.isFile() || details.isSymbolicLink() || details.nlink !== 1)
     throw new Error("Wallet file must be a regular file with no links");
-  if ((details.mode & 63) !== 0)
+  if (process.platform !== "win32" && (details.mode & 63) !== 0)
     throw new Error("Wallet file must be owner-only (chmod 600)");
   let parsed;
   try {
@@ -362,7 +341,7 @@ async function walletFileMetadata(path) {
 
 // src/cli.ts
 var HELP = `
-LDGR CLI 0.2.1 — self-custody wallet
+LDGR CLI 0.3.0 — self-custody wallet
 
 Usage:
   ldgr wallet create [--testnet] [--wallet <path>]
@@ -377,8 +356,7 @@ Usage:
   ldgr network show [--wallet <path>]
   ldgr network set <mainnet|testnet> [--wallet <path>]
 
-The default wallet store is ~/.ldgr/wallet.json. Existing wallets at
-~/.config/ldgr/wallet.json move there safely on first use. A wallet can be
+The default wallet store is ~/.ldgr/wallet.json. A wallet can be
 passphrase-protected or unprotected (local-file permissions only). The CLI
 never accepts recovery-key values or passphrases as arguments or environment
 variables. Use \`ldgr wallet export <path>\` for an extension-compatible

package/dist/transfer.d.ts

@@ -1,14 +1 @@
-import type { LdgrSigner } from "@ldgr/client";
-import { type AssetDefinition } from "@ldgr/protocol";
-export declare function buildTransferSubmission(input: {
-    readonly wallet: LdgrSigner;
-    readonly asset: string;
-    readonly assetDefinition: AssetDefinition;
-    readonly amount: string;
-    readonly to: string;
-    readonly nextNonce: string;
-    readonly now?: () => number;
-}): Promise<{
-    readonly payload: Record<string, unknown>;
-    readonly signature: string;
-}>;
+export { buildTransferSubmission } from "@ldgr/wallet-core";

package/dist/wallet-file.d.ts

@@ -40,8 +40,10 @@ export type WalletFileMetadata = LocalWalletFile & {
 };
 export type DefaultWalletPathInput = {
     readonly home?: string | undefined;
-    /** Test seam for the former XDG default; production reads XDG_CONFIG_HOME. */
+    /** Test seam for the former platform-specific config default. */
     readonly configHome?: string | undefined;
+    /** Test seam for Windows path and environment behavior. */
+    readonly platform?: NodeJS.Platform | undefined;
 };
 export type CreatedEncryptedWallet = {
     readonly file: LocalWalletFile;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ldgr/cli",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "type": "module",
   "bin": {
     "ldgr": "dist/cli.js"
@@ -16,12 +16,13 @@
     "node": ">=20.19.0"
   },
   "dependencies": {
-    "@ldgr/client": "^0.2.1",
-    "@ldgr/protocol": "^0.2.1",
+    "@ldgr/client": "^0.3.0",
+    "@ldgr/protocol": "^0.3.0",
+    "@ldgr/wallet-core": "^0.1.0",
     "@clack/prompts": "^0.11.0"
   },
   "scripts": {
-    "build": "rm -rf dist && bun build src/cli.ts --outdir dist --target node --format esm --packages external && tsc -p tsconfig.build.json",
+    "build": "bun scripts/build.mjs",
     "prepack": "bun run build",
     "start": "bun src/cli.ts",
     "test": "bun test",
@@ -29,6 +30,6 @@
   },
   "devDependencies": {
     "@types/node": "^22.20.1",
-    "typescript": "^5.9.3"
+    "typescript": "^7.0.2"
   }
 }