nansen-cli 1.11.1 → 1.12.0

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 1.12.0
+
+### Minor Changes
+
+- [#207](https://github.com/nansen-ai/nansen-cli/pull/207) [`73ca500`](https://github.com/nansen-ai/nansen-cli/commit/73ca5009c03ad541673165ca6b50f33ff4cc1673) Thanks [@TimNooren](https://github.com/TimNooren)! - Add --unsafe-no-password flag to wallet create for agent-friendly passwordless wallets.
+
+### Patch Changes
+
+- [#212](https://github.com/nansen-ai/nansen-cli/pull/212) [`726c29d`](https://github.com/nansen-ai/nansen-cli/commit/726c29d2676c8a37772299c6237b44890493dfa5) Thanks [@0xlaveen](https://github.com/0xlaveen)! - Clarify empty input handling in parseAddressList with explicit early return
+
+- [#218](https://github.com/nansen-ai/nansen-cli/pull/218) [`8c4dd71`](https://github.com/nansen-ai/nansen-cli/commit/8c4dd71ce215026e149a6b097540c46622f13d3a) Thanks [@TimNooren](https://github.com/TimNooren)! - fix: `nansen changelog --since <version>` now correctly filters changeset-format entries (## x.y.z) in addition to Keep a Changelog entries (## [x.y.z])
+
+- [#209](https://github.com/nansen-ai/nansen-cli/pull/209) [`a6dc1ed`](https://github.com/nansen-ai/nansen-cli/commit/a6dc1ed9dc40ad3506e7debe09746d463a70c14d) Thanks [@0xlaveen](https://github.com/0xlaveen)! - fix: prevent --help from executing destructive commands (logout, schema, cache)
+
+## 1.11.2
+
+### Patch Changes
+
+- [#205](https://github.com/nansen-ai/nansen-cli/pull/205) [`dba24aa`](https://github.com/nansen-ai/nansen-cli/commit/dba24aaa64b2083fdbaa85a002758bfe21d9f4a0) Thanks [@TimNooren](https://github.com/TimNooren)! - Add hot wallet and password handling warnings to wallet create output
+
 ## 1.11.1
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nansen-cli",
-  "version": "1.11.1",
+  "version": "1.12.0",
   "description": "Command-line interface for Nansen API - designed for AI agents",
   "main": "src/index.js",
   "type": "module",
@@ -19,7 +19,8 @@
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
     "test:live": "NANSEN_LIVE_TEST=1 vitest run",
-    "test:trade": "vitest run --config vitest.e2e.config.js",
+    "test:trade": "vitest run --config vitest.e2e.config.js src/__tests__/trade.e2e.test.js",
+    "test:send": "vitest run --config vitest.e2e.config.js src/__tests__/send.e2e.test.js",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
     "changeset": "changeset",
@@ -60,5 +61,11 @@
     "eslint": "^10.0.2",
     "globals": "^17.4.0",
     "vitest": "^4.0.18"
+  },
+  "dependencies": {
+    "@ethereumjs/rlp": "^10.1.1",
+    "@noble/curves": "^2.0.1",
+    "@noble/hashes": "^2.0.1",
+    "@scure/base": "^2.0.0"
   }
-}
+}

package/src/api.js

@@ -582,7 +582,9 @@ export class NansenAPI {
                     // No API key and no payment wallet — guide the user to login rather than
                     // showing a confusing x402 payment dump they can't act on.
                     // TODO: full fix would skip x402 entirely when no apiKey is set — see PR #<this PR number>
-                    message = 'No API key configured. Run: nansen login --api-key <key>. Get your key at https://app.nansen.ai/api';
+                    message = 'No API key configured. Two ways to authenticate:\n' +
+                      '  1. API key: nansen login --api-key <key> (get key at https://app.nansen.ai/api)\n' +
+                      '  2. x402 micropayment: nansen wallet create + fund with USDC (no API key needed)';
                   } else {
                     message = `x402 auto-payment failed: ${x402Err.message}`;
                   }

package/src/cli.js

@@ -439,6 +439,37 @@ async function enrichTransfers(result, apiInstance, chain) {
   return result;
 }
 
+// ============= Address Parsing =============
+
+/**
+ * Parse an --addresses option that may arrive as:
+ *  - a pre-parsed array (arg parser split it)
+ *  - a JSON array string: '["0x…","0x…"]'
+ *  - a comma-separated string: "0x…,0x…"
+ * Non-array JSON values (objects, numbers, booleans) are rejected.
+ */
+export function parseAddressList(raw) {
+  if (Array.isArray(raw)) {
+    return raw.map(a => String(a).trim()).filter(Boolean);
+  }
+  if (!raw) return [];
+
+  const s = String(raw);
+  try {
+    const parsed = JSON.parse(s);
+    if (Array.isArray(parsed)) {
+      return parsed.map(a => String(a).trim()).filter(Boolean);
+    }
+    throw new NansenError(
+      '--addresses must be a comma-separated list or JSON array, got: ' + typeof parsed,
+      ErrorCode.INVALID_PARAMS
+    );
+  } catch (e) {
+    if (e instanceof NansenError) throw e;
+    return s.split(',').map(a => a.trim()).filter(Boolean);
+  }
+}
+
 // ============= Composite Functions =============
 
 export async function batchProfile(api, params = {}) {
@@ -644,7 +675,7 @@ EXAMPLES:
   nansen research profiler balance --address 0x... --chain ethereum
   nansen trade quote --chain base --from ETH --to USDC --amount 1
 
-Research chains: ethereum, solana, base, bnb, arbitrum, polygon, optimism, avalanche, linea, scroll, mantle, ronin, sei, plasma, sonic, monad, hyperevm, iotaevm
+Research chains: ethereum, solana, base, bnb, arbitrum, polygon, optimism, avalanche, linea, scroll, zksync, mantle, ronin, sei, plasma, sonic, unichain, monad, hyperevm, iotaevm
 Trade chains: solana, base
 Labels: Fund, Smart Trader, 30D/90D/180D Smart Trader, Smart HL Perps Trader
 
@@ -780,6 +811,10 @@ export function buildCommands(deps = {}) {
     },
 
     'changelog': async (_args, _apiInstance, _flags, _options) => {
+      if (_flags.help || _flags.h) {
+        log('changelog — Show release history\n\nUsage:\n  nansen changelog [--since <version>]\n\nOptions:\n  --since <version>   Show only entries for versions >= this version\n\nExamples:\n  nansen changelog\n  nansen changelog --since 1.10.0');
+        return;
+      }
       const changelogPath = new URL('../CHANGELOG.md', import.meta.url).pathname;
       let content;
       try {
@@ -795,10 +830,10 @@ export function buildCommands(deps = {}) {
         const filtered = [];
         let include = false;
         for (const line of lines) {
-          // Match ## [x.y.z] headers
-          const match = line.match(/^## \[(\d+\.\d+\.\d+)\]/);
+          // Match ## [x.y.z] (Keep a Changelog format) or ## x.y.z (changeset format)
+          const match = line.match(/^## \[(\d+\.\d+\.\d+)\]|^## (\d+\.\d+\.\d+)\b/);
           if (match) {
-            const ver = match[1];
+            const ver = match[1] || match[2];
             // Compare: include versions >= since, stop at versions < since
             if (compareSemver(ver, since) >= 0) {
               include = true;
@@ -945,7 +980,7 @@ export function buildCommands(deps = {}) {
         'batch': () => {
           let addresses = [];
           if (options.addresses) {
-            addresses = options.addresses.split(',').map(a => a.trim()).filter(Boolean);
+            addresses = parseAddressList(options.addresses);
           } else if (options.file) {
             const content = fs.readFileSync(options.file, 'utf8');
             try {
@@ -976,13 +1011,13 @@ export function buildCommands(deps = {}) {
           return traceCounterparties(apiInstance, { address, chain, depth, width, days, delayMs });
         },
         'compare': () => {
-          const addrs = (options.addresses || '').split(',').map(a => a.trim()).filter(Boolean);
+          const addrs = parseAddressList(options.addresses);
           return compareWallets(apiInstance, { addresses: addrs, chain, days });
         },
         'help': () => ({
           commands: ['balance', 'labels', 'transactions', 'pnl', 'search', 'historical-balances', 'related-wallets', 'counterparties', 'pnl-summary', 'perp-positions', 'perp-trades', 'batch', 'trace', 'compare'],
           description: 'Wallet profiling endpoints',
-          example: 'nansen profiler balance --address 0x123... --chain ethereum'
+          example: 'nansen research profiler compare --addresses "0xABC...,0xDEF..." --chain ethereum'
         })
       };
 
@@ -1294,7 +1329,8 @@ export function generateSubcommandHelp(command, subcommand) {
 
   const exampleValues = { address: '0x...', token: '0x...', query: '"term"', symbol: 'BTC', date: '2024-01-01' };
   const chain = subSchema.options?.chain?.default || 'solana';
-  let example = `nansen ${command} ${subcommand}`;
+  const prefix = DEPRECATED_TO_RESEARCH.has(command) ? `research ${command}` : command;
+  let example = `nansen ${prefix} ${subcommand}`;
   if (subSchema.options) {
     for (const [name, opt] of Object.entries(subSchema.options)) {
       if (opt.required) example += ` --${name} ${exampleValues[name] || '<val>'}`;
@@ -1408,6 +1444,20 @@ export async function runCLI(rawArgs, deps = {}) {
         return { type: 'command-help', command };
       }
     }
+    // Simple commands (logout, schema, cache) — show help instead of executing
+    // Prevents destructive commands like logout from running when user just wants help
+    if (commands[command]) {
+      const simpleHelp = {
+        'logout': 'nansen logout — Remove saved API key from ~/.nansen/config.json',
+        'schema': 'nansen schema [command] [--pretty] — Show JSON schema for all commands (or a specific command)',
+        'cache':  'nansen cache clear — Clear the API response cache',
+      };
+      if (simpleHelp[command]) {
+        output(simpleHelp[command]);
+        notify();
+        return { type: 'command-help', command };
+      }
+    }
     // Commands with handlers (e.g. quote, execute) show their own usage
     if (command === 'help' || !commands[command]) {
       output(BANNER + HELP);

package/src/crypto.js

@@ -1,178 +1,46 @@
 /**
  * Shared cryptographic primitives for EVM transaction signing.
  * Exports keccak256, secp256k1 ECDSA signing, RLP encoding.
- * Zero external dependencies — uses Node.js built-in crypto only.
+ * Uses audited libraries: @noble/hashes, @noble/curves, @ethereumjs/rlp.
  */
 
-import crypto from "crypto";
+import { keccak_256 } from "@noble/hashes/sha3.js";
+import { secp256k1 } from "@noble/curves/secp256k1.js";
+import { RLP } from "@ethereumjs/rlp";
 
 // ============= Keccak-256 =============
 
-// Keccak-256 (NOT SHA3-256; Ethereum uses original Keccak with 0x01 padding).
-// Uses a flat 25-element state array (lanes indexed as state[x + 5*y])
-// with BigInt64 arithmetic.
-
-const RC = [
-  0x0000000000000001n, 0x0000000000008082n, 0x800000000000808an, 0x8000000080008000n,
-  0x000000000000808bn, 0x0000000080000001n, 0x8000000080008081n, 0x8000000000008009n,
-  0x000000000000008an, 0x0000000000000088n, 0x0000000080008009n, 0x000000008000000an,
-  0x000000008000808bn, 0x800000000000008bn, 0x8000000000008089n, 0x8000000000008003n,
-  0x8000000000008002n, 0x8000000000000080n, 0x000000000000800an, 0x800000008000000an,
-  0x8000000080008081n, 0x8000000000008080n, 0x0000000080000001n, 0x8000000080008008n,
-];
-
-const ROT = [
-   0,  1, 62, 28, 27,
-  36, 44,  6, 55, 20,
-   3, 10, 43, 25, 39,
-  41, 45, 15, 21,  8,
-  18,  2, 61, 56, 14,
-];
-
-const M = 0xffffffffffffffffn;
-
-function rot64(v, r) {
-  return r === 0 ? v : ((v << BigInt(r)) | (v >> BigInt(64 - r))) & M;
-}
-
-function keccakF(s) {
-  for (let round = 0; round < 24; round++) {
-    const c0 = s[0] ^ s[5] ^ s[10] ^ s[15] ^ s[20];
-    const c1 = s[1] ^ s[6] ^ s[11] ^ s[16] ^ s[21];
-    const c2 = s[2] ^ s[7] ^ s[12] ^ s[17] ^ s[22];
-    const c3 = s[3] ^ s[8] ^ s[13] ^ s[18] ^ s[23];
-    const c4 = s[4] ^ s[9] ^ s[14] ^ s[19] ^ s[24];
-    const d0 = (c4 ^ rot64(c1, 1)) & M;
-    const d1 = (c0 ^ rot64(c2, 1)) & M;
-    const d2 = (c1 ^ rot64(c3, 1)) & M;
-    const d3 = (c2 ^ rot64(c4, 1)) & M;
-    const d4 = (c3 ^ rot64(c0, 1)) & M;
-    for (let y = 0; y < 25; y += 5) {
-      s[y]     = (s[y]     ^ d0) & M;
-      s[y + 1] = (s[y + 1] ^ d1) & M;
-      s[y + 2] = (s[y + 2] ^ d2) & M;
-      s[y + 3] = (s[y + 3] ^ d3) & M;
-      s[y + 4] = (s[y + 4] ^ d4) & M;
-    }
-    const t = new Array(25);
-    for (let x = 0; x < 5; x++) {
-      for (let y = 0; y < 5; y++) {
-        const src = x + 5 * y;
-        const dst = y + 5 * ((2 * x + 3 * y) % 5);
-        t[dst] = rot64(s[src], ROT[src]);
-      }
-    }
-    for (let y = 0; y < 25; y += 5) {
-      const t0 = t[y], t1 = t[y+1], t2 = t[y+2], t3 = t[y+3], t4 = t[y+4];
-      s[y]   = (t0 ^ ((~t1 & M) & t2)) & M;
-      s[y+1] = (t1 ^ ((~t2 & M) & t3)) & M;
-      s[y+2] = (t2 ^ ((~t3 & M) & t4)) & M;
-      s[y+3] = (t3 ^ ((~t4 & M) & t0)) & M;
-      s[y+4] = (t4 ^ ((~t0 & M) & t1)) & M;
-    }
-    s[0] = (s[0] ^ RC[round]) & M;
-  }
-}
-
 export function keccak256(input) {
-  const rate = 136;
-  const s = new Array(25).fill(0n);
-  const blocks = Math.max(1, Math.ceil((input.length + 1) / rate));
-  const padded = Buffer.alloc(blocks * rate);
-  input.copy(padded);
-  padded[input.length] ^= 0x01;
-  padded[padded.length - 1] ^= 0x80;
-  for (let off = 0; off < padded.length; off += rate) {
-    for (let i = 0; i < 17; i++) {
-      s[i] ^= padded.readBigUInt64LE(off + i * 8);
-    }
-    keccakF(s);
-  }
-  const out = Buffer.alloc(32);
-  for (let i = 0; i < 4; i++) {
-    out.writeBigUInt64LE(s[i] & M, i * 8);
-  }
-  return out;
+  const hash = keccak_256(input);
+  return Buffer.from(hash);
 }
 
 // ============= secp256k1 ECDSA =============
 
-const P = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEFFFFFC2Fn;
-const N = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141n;
-const Gx = 0x79BE667EF9DCBBAC55A06295CE870B07029BFCDB2DCE28D959F2815B16F81798n;
-const Gy = 0x483ADA7726A3C4655DA4FBFC0E1108A8FD17B448A68554199C47D08FFB10D4B8n;
-
-function modInv(a, m) {
-  let [old_r, r] = [((a % m) + m) % m, m];
-  let [old_s, s] = [1n, 0n];
-  while (r !== 0n) {
-    const q = old_r / r;
-    [old_r, r] = [r, old_r - q * r];
-    [old_s, s] = [s, old_s - q * s];
-  }
-  return ((old_s % m) + m) % m;
-}
-
-function ptAdd(x1, y1, x2, y2) {
-  if (x1 === null) return [x2, y2];
-  if (x2 === null) return [x1, y1];
-  if (x1 === x2 && y1 === y2) {
-    const lam = (3n * x1 * x1 * modInv(2n * y1, P)) % P;
-    const x3 = ((lam * lam - 2n * x1) % P + P) % P;
-    return [x3, ((lam * (x1 - x3) - y1) % P + P) % P];
-  }
-  if (x1 === x2) return [null, null];
-  const lam = (((y2 - y1) % P + P) * modInv(((x2 - x1) % P + P) % P, P)) % P;
-  const x3 = ((lam * lam - x1 - x2) % P + P) % P;
-  return [x3, ((lam * (x1 - x3) - y1) % P + P) % P];
-}
-
-function ptMul(k, x, y) {
-  let [rx, ry] = [null, null];
-  let [qx, qy] = [x, y];
-  while (k > 0n) {
-    if (k & 1n) [rx, ry] = ptAdd(rx, ry, qx, qy);
-    [qx, qy] = ptAdd(qx, qy, qx, qy);
-    k >>= 1n;
-  }
-  return [rx, ry];
-}
-
-function rfc6979k(privBuf, hash) {
-  let v = Buffer.alloc(32, 0x01);
-  let k = Buffer.alloc(32, 0x00);
-  k = crypto.createHmac('sha256', k).update(Buffer.concat([v, Buffer.from([0x00]), privBuf, hash])).digest();
-  v = crypto.createHmac('sha256', k).update(v).digest();
-  k = crypto.createHmac('sha256', k).update(Buffer.concat([v, Buffer.from([0x01]), privBuf, hash])).digest();
-  v = crypto.createHmac('sha256', k).update(v).digest();
-  while (true) {
-    v = crypto.createHmac('sha256', k).update(v).digest();
-    const candidate = BigInt('0x' + v.toString('hex'));
-    if (candidate >= 1n && candidate < N) return candidate;
-    k = crypto.createHmac('sha256', k).update(Buffer.concat([v, Buffer.from([0x00])])).digest();
-    v = crypto.createHmac('sha256', k).update(v).digest();
-  }
-}
-
 /**
  * Sign a 32-byte hash with secp256k1 ECDSA.
  * Uses RFC 6979 deterministic k and low-S normalization (EIP-2).
  * Returns { r, s, v } where v is the recovery ID (0 or 1).
  */
 export function signSecp256k1(hash, privateKey) {
-  const z = BigInt('0x' + hash.toString('hex'));
-  const d = BigInt('0x' + privateKey.toString('hex'));
-  const k = rfc6979k(privateKey, hash);
-  const [rx, ry] = ptMul(k, Gx, Gy);
-  const r = rx % N;
-  if (r === 0n) throw new Error('Invalid signature: r=0');
-  let s = (modInv(k, N) * ((z + r * d) % N)) % N;
-  if (s === 0n) throw new Error('Invalid signature: s=0');
-  let v = (ry % 2n === 0n) ? 0 : 1;
-  if (s > N >> 1n) { s = N - s; v ^= 1; }
+  const sigBytes = secp256k1.sign(hash, privateKey, { prehash: false, lowS: true });
+  const sig = secp256k1.Signature.fromBytes(sigBytes);
+  const pubKey = secp256k1.getPublicKey(privateKey, false);
+  const pubKeyHex = Buffer.from(pubKey).toString("hex");
+
+  // Determine recovery bit by trying both values
+  let v = 0;
+  for (const bit of [0, 1]) {
+    const recovered = sig.addRecoveryBit(bit).recoverPublicKey(hash);
+    if (Buffer.from(recovered.toBytes(false)).toString("hex") === pubKeyHex) {
+      v = bit;
+      break;
+    }
+  }
+
   return {
-    r: Buffer.from(r.toString(16).padStart(64, '0'), 'hex'),
-    s: Buffer.from(s.toString(16).padStart(64, '0'), 'hex'),
+    r: Buffer.from(sig.r.toString(16).padStart(64, "0"), "hex"),
+    s: Buffer.from(sig.s.toString(16).padStart(64, "0"), "hex"),
     v,
   };
 }
@@ -182,34 +50,39 @@ export function signSecp256k1(hash, privateKey) {
 export function bigIntToMinBuf(n) {
   if (n === 0n) return Buffer.alloc(0);
   const hex = n.toString(16);
-  return Buffer.from(hex.length % 2 ? '0' + hex : hex, 'hex');
+  return Buffer.from(hex.length % 2 ? "0" + hex : hex, "hex");
 }
 
 export function rlpEncode(input) {
+  return Buffer.from(RLP.encode(toRlpInput(input)));
+}
+
+/**
+ * Convert our legacy input format to what @ethereumjs/rlp expects.
+ * Handles: arrays (recursive), Buffers, hex strings, empty values.
+ */
+function toRlpInput(input) {
   if (Array.isArray(input)) {
-    const encoded = input.map(rlpEncode);
-    const payload = Buffer.concat(encoded);
-    if (payload.length < 56) {
-      return Buffer.concat([Buffer.from([0xc0 + payload.length]), payload]);
-    }
-    const lenBytes = bigIntToMinBuf(BigInt(payload.length));
-    return Buffer.concat([Buffer.from([0xf7 + lenBytes.length]), lenBytes, payload]);
+    return input.map(toRlpInput);
   }
 
-  let data;
   if (Buffer.isBuffer(input)) {
-    data = input;
-  } else {
-    let hex = (typeof input === 'string' ? input : '').replace(/^0x/, '');
-    hex = hex.replace(/^0+/, '');
-    if (hex === '' || hex.length === 0) return Buffer.from([0x80]);
-    if (hex.length % 2) hex = '0' + hex;
-    data = Buffer.from(hex, 'hex');
+    return Uint8Array.from(input);
+  }
+
+  if (input instanceof Uint8Array) {
+    return input;
+  }
+
+  if (typeof input === "string") {
+    let hex = input.replace(/^0x/, "");
+    // Strip leading zeros to match legacy behavior for hex-string values
+    // (chain IDs, nonces, gas prices, etc. passed as hex strings)
+    hex = hex.replace(/^0+/, "");
+    if (hex === "" || hex.length === 0) return Uint8Array.from([]);
+    if (hex.length % 2) hex = "0" + hex;
+    return Uint8Array.from(Buffer.from(hex, "hex"));
   }
 
-  if (data.length === 0) return Buffer.from([0x80]);
-  if (data.length === 1 && data[0] < 0x80) return data;
-  if (data.length < 56) return Buffer.concat([Buffer.from([0x80 + data.length]), data]);
-  const lenBytes = bigIntToMinBuf(BigInt(data.length));
-  return Buffer.concat([Buffer.from([0xb7 + lenBytes.length]), lenBytes, data]);
+  return Uint8Array.from([]);
 }

package/src/schema.json

@@ -1622,7 +1622,7 @@
             },
             "wallet": {
               "type": "string",
-              "description": "Wallet name (or \"walletconnect\"/\"wc\" for WalletConnect, EVM only). A configured wallet is required — run `nansen wallet create` if you haven't set one up yet."
+              "description": "Wallet name (or \"walletconnect\"/\"wc\" for WalletConnect, EVM only). A configured wallet is required \u2014 run `nansen wallet create` if you haven't set one up yet."
             }
           },
           "prerequisites": [
@@ -1692,11 +1692,13 @@
     "avalanche",
     "linea",
     "scroll",
+    "zksync",
     "mantle",
     "ronin",
     "sei",
     "plasma",
     "sonic",
+    "unichain",
     "monad",
     "hyperevm",
     "iotaevm"

package/src/trading.js

@@ -8,7 +8,7 @@
 import crypto from 'crypto';
 import fs from 'fs';
 import path from 'path';
-import { exportWallet, getDefaultAddress, showWallet, listWallets } from './wallet.js';
+import { exportWallet, getDefaultAddress, showWallet, listWallets, getWalletConfig } from './wallet.js';
 import { base58Decode } from './transfer.js';
 import { keccak256, signSecp256k1, rlpEncode } from './crypto.js';
 import { getWalletConnectAddress, sendTransactionViaWalletConnect, sendApprovalViaWalletConnect } from './walletconnect-trading.js';
@@ -957,7 +957,10 @@ EXAMPLES:
         let exported = null;
         if (!isWalletConnect) {
           // Get wallet credentials once (before the loop)
-          const password = process.env.NANSEN_WALLET_PASSWORD || await promptPassword('Enter wallet password: ', deps);
+          const walletConfig = getWalletConfig();
+          const password = walletConfig.passwordHash
+            ? (process.env.NANSEN_WALLET_PASSWORD || await promptPassword('Enter wallet password: ', deps))
+            : null;
 
           let effectiveWalletName = walletName;
           if (!effectiveWalletName) {

package/src/transfer.js

@@ -1,10 +1,10 @@
 /**
  * Nansen CLI - Token Transfer
  * Send native and ERC-20/SPL tokens on EVM and Solana chains.
- * Zero external dependencies — uses Node.js built-in crypto only.
  */
 
 import crypto from 'crypto';
+import { base58 } from '@scure/base';
 import { base58Encode, exportWallet, getWalletConfig, verifyPassword } from './wallet.js';
 import { keccak256, signSecp256k1, rlpEncode } from './crypto.js';
 import { getWalletConnectAddress, sendTransactionViaWalletConnect } from './walletconnect-trading.js';
@@ -34,21 +34,8 @@ const CHAIN_IDS = { ...EVM_CHAIN_IDS, evm: 1 };
 
 // ============= Base58 =============
 
-const BASE58_ALPHABET = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
-
 function base58Decode(str) {
-  let num = 0n;
-  for (const ch of str) {
-    const idx = BASE58_ALPHABET.indexOf(ch);
-    if (idx === -1) throw new Error(`Invalid base58 character: ${ch}`);
-    num = num * 58n + BigInt(idx);
-  }
-  const hex = num.toString(16);
-  const paddedHex = hex.length % 2 ? '0' + hex : hex;
-  const bytes = num === 0n ? [] : [...Buffer.from(paddedHex, 'hex')];
-  let leadingZeros = 0;
-  for (const ch of str) { if (ch === '1') leadingZeros++; else break; }
-  return Buffer.from([...Array(leadingZeros).fill(0), ...bytes]);
+  return Buffer.from(base58.decode(str));
 }
 
 function base58DecodePubkey(str) {
@@ -603,7 +590,7 @@ export async function sendTokens({ to, amount, chain, token = null, wallet = nul
   }
 
   const config = getWalletConfig();
-  if (!verifyPassword(password, config)) throw new Error('Incorrect password');
+  if (config.passwordHash && !verifyPassword(password, config)) throw new Error('Incorrect password');
 
   const walletName = wallet || config.defaultWallet;
   if (!walletName) throw new Error('No wallet specified and no default wallet set');

package/src/wallet.js

@@ -1,13 +1,13 @@
 /**
  * Nansen CLI - Wallet Management
  * Local key generation and storage for EVM and Solana chains.
- * Zero external dependencies — uses Node.js built-in crypto only.
  */
 
 import crypto from 'crypto';
 import fs from 'fs';
 import path from 'path';
 import * as readline from 'readline';
+import { base58 } from '@scure/base';
 
 // ============= Constants =============
 
@@ -32,31 +32,11 @@ import { keccak256 } from './crypto.js';
 
 // ============= Base58 Encoding (for Solana) =============
 
-const BASE58_ALPHABET = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
-
 /**
  * Encode a Buffer to base58 string.
  */
 export function base58Encode(buf) {
-  let num = 0n;
-  for (const byte of buf) {
-    num = num * 256n + BigInt(byte);
-  }
-
-  let str = '';
-  while (num > 0n) {
-    const rem = Number(num % 58n);
-    num = num / 58n;
-    str = BASE58_ALPHABET[rem] + str;
-  }
-
-  // Leading zeros → leading '1's
-  for (const byte of buf) {
-    if (byte === 0) str = '1' + str;
-    else break;
-  }
-
-  return str || '1';
+  return base58.encode(buf instanceof Uint8Array ? buf : Uint8Array.from(buf));
 }
 
 // ============= Encryption =============
@@ -78,6 +58,10 @@ function deriveKey(password, salt) {
  * Returns a JSON-serializable object with all params needed for decryption.
  */
 export function encryptKey(privateKeyHex, password) {
+  if (password === null) {
+    return { data: privateKeyHex, encrypted: false };
+  }
+
   const salt = crypto.randomBytes(SALT_LEN);
   const iv = crypto.randomBytes(IV_LEN);
   const key = deriveKey(password, salt);
@@ -99,10 +83,31 @@ export function encryptKey(privateKeyHex, password) {
 
 /**
  * Decrypt a private key with a password.
- * @returns {string} Private key hex string
- * @throws {Error} If password is wrong
+ * For unencrypted wallets (encrypted: false), password is ignored and
+ * plaintext data is returned directly.
  */
 export function decryptKey(encryptedData, password) {
+  const ENCRYPTED_FIELDS = ['salt', 'iv', 'authTag', 'ciphertext'];
+  const hasEncryptionFields = ENCRYPTED_FIELDS.some(f => f in encryptedData);
+
+  // Unencrypted blob
+  if (encryptedData.encrypted === false) {
+    if (hasEncryptionFields) {
+      throw new Error('Wallet data corrupted or tampered');
+    }
+    return encryptedData.data;
+  }
+
+  // Encrypted blob with missing fields
+  if (!ENCRYPTED_FIELDS.every(f => f in encryptedData)) {
+    throw new Error('Wallet data corrupted or tampered');
+  }
+
+  // Encrypted blob but no password provided
+  if (password === null || password === undefined) {
+    throw new Error('Wallet is encrypted. Set NANSEN_WALLET_PASSWORD.');
+  }
+
   const salt = Buffer.from(encryptedData.salt, 'hex');
   const iv = Buffer.from(encryptedData.iv, 'hex');
   const authTag = Buffer.from(encryptedData.authTag, 'hex');
@@ -234,6 +239,7 @@ function getWalletFile(name) {
  */
 export function verifyPassword(password, config) {
   if (!config.passwordHash) return true; // No password set yet
+  if (password === null || password === undefined) return false;
   const { salt, hash } = config.passwordHash;
   const derived = crypto.scryptSync(password, Buffer.from(salt, 'hex'), 32, {
     N: SCRYPT_N, r: SCRYPT_R, p: SCRYPT_P, maxmem: 256 * 1024 * 1024,
@@ -328,11 +334,22 @@ export function createWallet(name, password) {
     throw new Error(`Wallet "${name}" already exists`);
   }
 
-  // If this is the first wallet, set the password hash
-  if (!config.passwordHash) {
-    config.passwordHash = hashPassword(password);
+  if (password === null) {
+    // Passwordless mode: reject if existing wallets are encrypted
+    if (config.passwordHash) {
+      throw new Error('Existing wallets are password-protected. Set NANSEN_WALLET_PASSWORD.');
+    }
   } else {
-    if (!verifyPassword(password, config)) {
+    // Encrypted mode
+    if (!config.passwordHash) {
+      // First encrypted wallet: reject if passwordless wallets exist
+      const existingWallets = fs.readdirSync(getWalletsDir())
+        .filter(f => f.endsWith('.json') && f !== 'config.json');
+      if (existingWallets.length > 0) {
+        throw new Error('Existing wallets are passwordless. Cannot mix encrypted and unencrypted wallets.');
+      }
+      config.passwordHash = hashPassword(password);
+    } else if (!verifyPassword(password, config)) {
       throw new Error('Incorrect password');
     }
   }
@@ -400,7 +417,7 @@ export function exportWallet(name, password) {
   }
 
   const config = getWalletConfig();
-  if (!verifyPassword(password, config)) {
+  if (config.passwordHash && !verifyPassword(password, config)) {
     throw new Error('Incorrect password');
   }
 
@@ -445,7 +462,7 @@ export function deleteWallet(name, password) {
   }
 
   const config = getWalletConfig();
-  if (!verifyPassword(password, config)) {
+  if (config.passwordHash && !verifyPassword(password, config)) {
     throw new Error('Incorrect password');
   }
 
@@ -490,22 +507,35 @@ export function buildWalletCommands(deps = {}) {
       const handlers = {
         'create': async () => {
           const name = options.name || args[1] || 'default';
-          const password = process.env.NANSEN_WALLET_PASSWORD || await promptPassword('Enter wallet password: ', deps);
-          if (!password || password.length < 12) {
-            log('❌ Password must be at least 12 characters');
+
+          let password;
+          if (flags['unsafe-no-password']) {
+            process.stderr.write('WARNING: --unsafe-no-password is set. Private keys will be stored UNENCRYPTED on disk.\nAnyone with access to this machine can steal your funds.\n');
+            password = null;
+          } else if (!process.env.NANSEN_WALLET_PASSWORD && !process.stdin.isTTY && !deps.promptFn) {
+            log('❌ No password provided. Either:');
+            log('   set NANSEN_WALLET_PASSWORD, or');
+            log('   use --unsafe-no-password (WARNING: Private keys will be stored UNENCRYPTED on disk. Anyone with access to this machine can steal your funds.)');
             exit(1);
             return;
-          }
-
-          // Confirm password for first wallet (skip if set via env var)
-          const config = getWalletConfig();
-          if (!config.passwordHash && !process.env.NANSEN_WALLET_PASSWORD) {
-            const confirm = await promptPassword('Confirm password: ', deps);
-            if (password !== confirm) {
-              log('❌ Passwords do not match');
+          } else {
+            password = process.env.NANSEN_WALLET_PASSWORD || await promptPassword('Enter wallet password: ', deps);
+            if (!password || password.length < 12) {
+              log('❌ Password must be at least 12 characters');
               exit(1);
               return;
             }
+
+            // Confirm password for first wallet (skip if set via env var)
+            const config = getWalletConfig();
+            if (!config.passwordHash && !process.env.NANSEN_WALLET_PASSWORD) {
+              const confirm = await promptPassword('Confirm password: ', deps);
+              if (password !== confirm) {
+                log('❌ Passwords do not match');
+                exit(1);
+                return;
+              }
+            }
           }
 
           try {
@@ -519,6 +549,13 @@ export function buildWalletCommands(deps = {}) {
             log(`    Base (recommended, lower fees): send USDC to ${result.evm}`);
             log(`    Solana: send USDC to ${result.solana}`);
             log('');
+            if (password === null) {
+              log('  ⚠️  This is an UNENCRYPTED hot wallet — private keys are stored in plaintext on disk.');
+            } else {
+              log('  ⚠️  This is a hot wallet and is fundamentally insecure — do not deposit more than you can afford to lose.');
+              log('     Store and handle your password securely, e.g. using a secrets manager or system keychain.');
+            }
+            log('');
             return;
           } catch (err) {
             log(`❌ ${err.message}`);
@@ -570,7 +607,10 @@ export function buildWalletCommands(deps = {}) {
             exit(1);
             return;
           }
-          const password = process.env.NANSEN_WALLET_PASSWORD || await promptPassword('Enter wallet password: ', deps);
+          const config = getWalletConfig();
+          const password = config.passwordHash
+            ? (process.env.NANSEN_WALLET_PASSWORD || await promptPassword('Enter wallet password: ', deps))
+            : null;
           try {
             const result = exportWallet(name, password);
             log(`\n⚠️  Private keys for "${result.name}" — do not share!\n`);
@@ -612,7 +652,10 @@ export function buildWalletCommands(deps = {}) {
             exit(1);
             return;
           }
-          const password = process.env.NANSEN_WALLET_PASSWORD || await promptPassword('Enter wallet password: ', deps);
+          const config = getWalletConfig();
+          const password = config.passwordHash
+            ? (process.env.NANSEN_WALLET_PASSWORD || await promptPassword('Enter wallet password: ', deps))
+            : null;
           try {
             const result = deleteWallet(name, password);
             log(`✓ Wallet "${result.deleted}" deleted`);
@@ -655,7 +698,15 @@ export function buildWalletCommands(deps = {}) {
           }
 
           const isWalletConnect = options.wallet === 'walletconnect' || options.wallet === 'wc';
-          const password = isWalletConnect ? null : (process.env.NANSEN_WALLET_PASSWORD || await promptPassword('Enter wallet password: ', deps));
+          let password;
+          if (isWalletConnect) {
+            password = null;
+          } else {
+            const sendConfig = getWalletConfig();
+            password = sendConfig.passwordHash
+              ? (process.env.NANSEN_WALLET_PASSWORD || await promptPassword('Enter wallet password: ', deps))
+              : null;
+          }
           const dryRun = flags['dry-run'] || flags.dryRun;
 
           try {
@@ -712,7 +763,8 @@ USAGE:
   nansen wallet <command> [options]
 
 COMMANDS:
-  create [--name <label>]    Create a new wallet pair (EVM + Solana)
+  create [--name <label>] [--unsafe-no-password]
+                             Create a new wallet pair (EVM + Solana)
   list                       List all wallets
   show <name>                Show wallet addresses
   export <name>              Export private keys (requires password)
@@ -729,6 +781,7 @@ OPTIONS:
   --token <address>          Token contract/mint address (optional, sends native if omitted)
   --wallet <name>            Wallet to use (optional, uses default if omitted; use "walletconnect" or "wc" for WalletConnect, EVM only)
   --max                      Send entire balance (deducts gas for native transfers)
+  --unsafe-no-password       Skip encryption — private keys stored UNENCRYPTED on disk (create only)
 
 ENVIRONMENT:
   NANSEN_WALLET_PASSWORD     Password for non-interactive use (e.g. CI/scripts)

package/src/x402-svm.js

@@ -1,30 +1,15 @@
 /**
  * Nansen CLI - x402 Solana Auto-Payment
  * Implements SPL TransferChecked transaction building for x402 payments.
- * Zero external dependencies — uses Node.js built-in crypto + wallet.js base58.
  */
 
 import crypto from 'crypto';
+import { base58 } from '@scure/base';
 
-// ============= Base58 Encode (inline from wallet.js PR #26) =============
-const BASE58_ALPHABET_STR = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
+// ============= Base58 Encode =============
 
 export function base58Encode(buf) {
-  let num = 0n;
-  for (const byte of buf) {
-    num = num * 256n + BigInt(byte);
-  }
-  let str = '';
-  while (num > 0n) {
-    const rem = Number(num % 58n);
-    num = num / 58n;
-    str = BASE58_ALPHABET_STR[rem] + str;
-  }
-  for (const byte of buf) {
-    if (byte === 0) str = '1' + str;
-    else break;
-  }
-  return str || '1';
+  return base58.encode(buf instanceof Uint8Array ? buf : Uint8Array.from(buf));
 }
 
 // ============= Constants =============
@@ -41,33 +26,8 @@ const DEFAULT_COMPUTE_UNIT_PRICE_MICROLAMPORTS = 1;
 
 // ============= Base58 Decode =============
 
-const BASE58_ALPHABET = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
-const BASE58_MAP = new Uint8Array(128);
-for (let i = 0; i < BASE58_ALPHABET.length; i++) {
-  BASE58_MAP[BASE58_ALPHABET.charCodeAt(i)] = i;
-}
-
 export function base58Decode(str) {
-  let num = 0n;
-  for (const ch of str) {
-    num = num * 58n + BigInt(BASE58_MAP[ch.charCodeAt(0)]);
-  }
-
-  // Count leading '1's → leading zero bytes
-  let leadingZeros = 0;
-  for (const ch of str) {
-    if (ch === '1') leadingZeros++;
-    else break;
-  }
-
-  if (num === 0n) return Buffer.alloc(leadingZeros || 1);
-
-  // Convert to bytes
-  const hex = num.toString(16);
-  const paddedHex = hex.length % 2 ? '0' + hex : hex;
-  const bytes = Buffer.from(paddedHex, 'hex');
-
-  return Buffer.concat([Buffer.alloc(leadingZeros), bytes]);
+  return Buffer.from(base58.decode(str));
 }
 
 /**

package/src/x402.js

@@ -96,18 +96,23 @@ export async function* createPaymentSignatures(response, url, options = {}) {
   const ranked = rankRequirements(requirements);
   if (ranked.length === 0) return;
 
-  const password = options.password || process.env.NANSEN_WALLET_PASSWORD;
-  if (!password) return;
-
-  let exportWallet, listWallets;
+  let exportWallet, listWallets, getWalletConfig;
   try {
     const walletMod = await import('./wallet.js');
     exportWallet = walletMod.exportWallet;
     listWallets = walletMod.listWallets;
+    getWalletConfig = walletMod.getWalletConfig;
   } catch {
     return;
   }
 
+  const walletConfig = getWalletConfig();
+  const password = walletConfig.passwordHash
+    ? (options.password || process.env.NANSEN_WALLET_PASSWORD || null)
+    : null;
+  // Encrypted wallets need a password -- silently skip if unavailable
+  if (walletConfig.passwordHash && password === null) return;
+
   const wallets = listWallets();
   if (wallets.wallets.length === 0) return;