nansen-cli 1.8.0 → 1.9.1

package/CHANGELOG.md

@@ -0,0 +1,103 @@
+# Changelog
+
+## 1.9.1
+
+### Patch Changes
+
+- [#110](https://github.com/nansen-ai/nansen-cli/pull/110) [`82aa780`](https://github.com/nansen-ai/nansen-cli/commit/82aa78022bdcd62987b0949e090f19f563699d9a) Thanks [@TimNooren](https://github.com/TimNooren)! - Fix `nansen changelog` always showing "CHANGELOG.md not found". Added a `files` field to `package.json` to explicitly bundle `CHANGELOG.md` with the published package. Also excludes `src/__tests__/` from the package, reducing package size from ~537 kB to ~269 kB.
+
+## 1.9.0
+
+### Minor Changes
+
+- [#98](https://github.com/nansen-ai/nansen-cli/pull/98) [`2f3f556`](https://github.com/nansen-ai/nansen-cli/commit/2f3f556d008a1f8ec40d57a8a2822bedbc6b60cb) Thanks [@Codier](https://github.com/Codier)! - Add symbol shortcuts for common tokens (SOL, ETH, USDC, USDT, etc.) that resolve to canonical addresses per chain. Users can now use `--from SOL --to USDC` instead of raw contract addresses.
+
+- [#32](https://github.com/nansen-ai/nansen-cli/pull/32) [`08a8d21`](https://github.com/nansen-ai/nansen-cli/commit/08a8d21be6e9196661be737545e790af180aebc3) Thanks [@arein](https://github.com/arein)! - Add WalletConnect support for trading, transfers, and x402 auto-payment (EVM only)
+
+### Patch Changes
+
+- [#99](https://github.com/nansen-ai/nansen-cli/pull/99) [`9144cba`](https://github.com/nansen-ai/nansen-cli/commit/9144cba38b06c90d462df97ea6cbcdeaed26fa36) Thanks [@Codier](https://github.com/Codier)! - Show clear error when `--amount` contains a decimal (e.g. `0.005`) instead of base units (lamports, wei). Detected client-side before hitting the API.
+
+- [#100](https://github.com/nansen-ai/nansen-cli/pull/100) [`19559bf`](https://github.com/nansen-ai/nansen-cli/commit/19559bfea6c22f6bd6b8c278ed5e6ae6d64866d5) Thanks [@Codier](https://github.com/Codier)! - Fix `nansen trade help` returning blank output. Now prints subcommands, usage, and examples. Also fixes `errorOutput` ReferenceError in `buildCommands` scope (affected `trade` and `changelog` commands).
+
+- [#93](https://github.com/nansen-ai/nansen-cli/pull/93) [`342c91f`](https://github.com/nansen-ai/nansen-cli/commit/342c91fdeb6d98d6b5c10a58cb9702eb5afe096f) Thanks [@Codier](https://github.com/Codier)! - Warn when `--from` is a wrapped native token (WETH/WBNB) or native sentinel, so AI agents can correct the token before execution fails
+
+## 1.8.0
+
+### Minor Changes
+
+- [#56](https://github.com/nansen-ai/nansen-cli/pull/56) [`d10998a`](https://github.com/nansen-ai/nansen-cli/commit/d10998aa2be19f80e8476d19bfd46029757a7335) Thanks [@askeluv](https://github.com/askeluv)! - Add CHANGELOG.md, `nansen changelog` command, and post-update "what's new" notice
+
+  - Added CHANGELOG.md following Keep a Changelog format with history back to v1.5.0
+  - Added `nansen changelog` command with `--since <version>` filtering
+  - Added one-time upgrade notice on first run after version update (prints to stderr)
+
+- [#77](https://github.com/nansen-ai/nansen-cli/pull/77) [`46e4660`](https://github.com/nansen-ai/nansen-cli/commit/46e4660034d9681405d09a5184f78525c300b8a5) Thanks [@0xlaveen](https://github.com/0xlaveen)! - Add token-ohlcv endpoint for OHLCV candle data
+
+- [#75](https://github.com/nansen-ai/nansen-cli/pull/75) [`287937e`](https://github.com/nansen-ai/nansen-cli/commit/287937e1d307e0b3f25648863d0c5b4a54d215ff) Thanks [@TimNooren](https://github.com/TimNooren)! - Restructure CLI into research/trade/wallet namespaces
+
+  - Commands reorganized: `smart-money`, `profiler`, `token`, `portfolio` now live under `nansen research`
+  - New `nansen trade` namespace for `quote` and `execute`
+  - New `nansen wallet` namespace for wallet management
+  - Old top-level commands still work with deprecation warnings
+
+- [#61](https://github.com/nansen-ai/nansen-cli/pull/61) [`9af0192`](https://github.com/nansen-ai/nansen-cli/commit/9af01921871be1d0537047cb4ad9733e01876646) Thanks [@askeluv](https://github.com/askeluv)! - Add ENS name resolution for profiler commands. Use `.eth` names directly in `--address` flags — resolved automatically via ensideas API with onchain RPC fallback. Works across all profiler subcommands, batch, and trace operations.
+
+All notable changes to the Nansen CLI will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/).
+
+## [1.7.0] - 2026-02-24
+
+### Added
+
+- **Trading commands** — `quote` and `execute` for DEX swaps (EVM + Solana)
+- **Wallet management** — `wallet create`, `list`, `show`, `export`, `default`, `delete`
+- **Wallet send** — transfer tokens on EVM and Solana (`wallet send`)
+- **x402 auto-payment** — automatic payment via Base USDC or Solana SPL USDC
+- Explorer links in transaction output
+- `--dry-run` flag for `wallet send`
+- x402 low balance warning
+- AI Agent Access setup docs and improved onboarding flow
+
+### Fixed
+
+- Solana execute crash with OKX quotes
+- x402 auto-pay retry path (3 reference errors)
+- Gas estimation — use API `quote.gas` as floor
+- Pre-flight simulation moved after approval (industry standard)
+- EVM signing edge cases with pure JS ECDSA
+- Wallet send crashes on amount parsing and silent success
+- Solana confirmation and SPL token transfer account ordering
+- Suppress duplicate JSON output from quote/execute
+- Suppress approval warning for native ETH swaps
+
+### Changed
+
+- Pricing clarity — from $0.01/call, min $0.05 balance
+- Consolidated crypto primitives into shared module
+
+## [1.6.0] - 2026-02-14
+
+### Added
+
+- `token indicators` endpoint
+- `profiler search` — general entity search command
+- `--x402-payment-signature` flag for pre-signed payment headers
+- `X-Client-Type` and `X-Client-Version` tracking headers on all API requests
+
+### Fixed
+
+- Error JSON now outputs to stdout (not stderr) for consistent agent parsing
+- Config loading — environment variables correctly override file config
+
+## [1.5.1] - 2026-02-07
+
+### Added
+
+- Allow API requests without API key when using x402 payment flow
+
+## [1.5.0] - 2026-01-31
+
+_Baseline version. Changes above are relative to this release._

package/README.md

@@ -2,7 +2,7 @@
 
 [![npm version](https://img.shields.io/npm/v/nansen-cli.svg)](https://www.npmjs.com/package/nansen-cli)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Tests](https://img.shields.io/badge/tests-577%20passing-brightgreen.svg)]()
+[![CI](https://github.com/nansen-ai/nansen-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/nansen-ai/nansen-cli/actions/workflows/ci.yml)
 
 > **Built by agents, for agents.** We prioritize the best possible AI agent experience.
 

package/package.json

@@ -1,12 +1,16 @@
 {
   "name": "nansen-cli",
-  "version": "1.8.0",
+  "version": "1.9.1",
   "description": "Command-line interface for Nansen API - designed for AI agents",
   "main": "src/index.js",
   "type": "module",
   "bin": {
     "nansen": "./src/index.js"
   },
+  "files": [
+    "src/*.js",
+    "CHANGELOG.md"
+  ],
   "scripts": {
     "start": "node src/index.js",
     "pretest": "node scripts/check-changeset.js",

package/src/api.js

@@ -505,8 +505,11 @@ export class NansenAPI {
         } else if (code === ErrorCode.CREDITS_EXHAUSTED) {
           message = message.replace(/\.+$/, '') + '. No retry will help. Check your Nansen dashboard for credit balance.';
         } else if (code === ErrorCode.PAYMENT_REQUIRED) {
-          // Try x402 auto-payment with fallback across payment networks
-          if (!this.defaultHeaders['Payment-Signature']) {
+          // Try x402 auto-payment: local wallet (with network fallback), then WalletConnect
+          const hasManualSignature = !!(this.defaultHeaders['Payment-Signature'] || options.headers?.['Payment-Signature']);
+
+          if (!hasManualSignature) {
+            // 1. Try local wallet with fallback across payment networks
             try {
               const { createPaymentSignatures } = await import('./x402.js');
               for await (const { signature, network } of createPaymentSignatures(response, url)) {
@@ -537,17 +540,54 @@ export class NansenAPI {
                 }
                 // This payment option was rejected, try next
               }
-            } catch { /* x402 auto-pay unavailable, fall through */ }
-          }
-          message = 'Payment required. To access this endpoint:\n  • Set an API key: nansen login --api-key <key>  (get one at https://app.nansen.ai/api)\n  • Or pay per call: nansen wallet create, fund with USDC on Base or Solana (from $0.01/call, min $0.05 balance)\n  • Docs: https://docs.x402.org';
-          const paymentHeader = response.headers.get('payment-required');
-          if (paymentHeader) {
-            try {
-              data.paymentRequirements = JSON.parse(atob(paymentHeader));
-            } catch {
-              data.paymentRequiredRaw = paymentHeader;
+            } catch { /* local wallet unavailable, try WalletConnect */ }
+
+            // 2. Fall back to WalletConnect (walletconnect-x402.js)
+            // (local wallet returns early on success above, so we always reach here if it failed)
+            {
+              let paymentRequirements;
+              const paymentHeader = response.headers.get('payment-required');
+              if (paymentHeader) {
+                try {
+                  paymentRequirements = JSON.parse(atob(paymentHeader));
+                } catch {
+                  data.paymentRequiredRaw = paymentHeader;
+                }
+              }
+              if (!paymentRequirements && data.paymentRequirements) {
+                paymentRequirements = data.paymentRequirements;
+              }
+
+              if (paymentRequirements) {
+                try {
+                  const { handleX402Payment } = await import('./walletconnect-x402.js');
+                  const paymentSignature = await handleX402Payment(paymentRequirements);
+                  const paidResponse = await fetch(url, {
+                    method: 'POST',
+                    headers: {
+                      'Content-Type': 'application/json',
+                      'X-Client-Type': 'nansen-cli',
+                      'X-Client-Version': packageVersion,
+                      'Payment-Signature': paymentSignature,
+                      ...this.defaultHeaders,
+                      ...options.headers,
+                    },
+                    body: JSON.stringify(NansenAPI.cleanBody(body)),
+                  });
+                  if (paidResponse.ok) {
+                    return await paidResponse.json();
+                  }
+                } catch (x402Err) {
+                  message = `x402 auto-payment failed: ${x402Err.message}`;
+                }
+                data.paymentRequirements = paymentRequirements;
+              }
             }
           }
+
+          if (!message || message === data.message) {
+            message = 'Payment required (x402). Sign the paymentRequirements below per https://docs.x402.org and pass the result with --x402-payment-signature <value>.';
+          }
         }
 
         lastError = new NansenError(message, code, response.status, {

package/src/chain-ids.js

@@ -0,0 +1,19 @@
+/**
+ * Canonical EVM chain name → numeric chain ID mapping.
+ *
+ * Single source of truth — import from here instead of defining inline.
+ */
+
+export const EVM_CHAIN_IDS = {
+  ethereum: 1,
+  base: 8453,
+  optimism: 10,
+  arbitrum: 42161,
+  polygon: 137,
+  avalanche: 43114,
+  bnb: 56,
+  linea: 59144,
+  scroll: 534352,
+  zksync: 324,
+  mantle: 5000,
+};

package/src/cli.js

@@ -144,14 +144,15 @@ export const SCHEMA = {
             chain: { type: 'string', default: 'ethereum', description: 'Blockchain' },
             from: { type: 'string', required: true, description: 'Token to sell (address or symbol)' },
             to: { type: 'string', required: true, description: 'Token to buy (address or symbol)' },
-            amount: { type: 'string', required: true, description: 'Amount to swap' }
+            amount: { type: 'string', required: true, description: 'Amount to swap' },
+            wallet: { type: 'string', description: 'Wallet name, or "walletconnect"/"wc" for WalletConnect (EVM only)' }
           }
         },
         'execute': {
           description: 'Sign and broadcast a quoted trade',
           options: {
             chain: { type: 'string', default: 'ethereum', description: 'Blockchain' },
-            wallet: { type: 'string', description: 'Wallet name or address' }
+            wallet: { type: 'string', description: 'Wallet name, or "walletconnect"/"wc" for WalletConnect (EVM only)' }
           }
         }
       }
@@ -838,6 +839,7 @@ export function buildCommands(deps = {}) {
     api = null,
     promptFn = prompt,
     log = console.log,
+    errorOutput = console.error,
     NansenAPIClass = NansenAPI,
     saveConfigFn = saveConfig,
     deleteConfigFn = deleteConfig,
@@ -905,7 +907,7 @@ export function buildCommands(deps = {}) {
       try {
         content = fs.readFileSync(changelogPath, 'utf8');
       } catch {
-        errorOutput('CHANGELOG.md not found. Visit https://github.com/nansen-ai/nansen-cli/blob/main/CHANGELOG.md');
+        log('CHANGELOG.md not found. Visit https://github.com/nansen-ai/nansen-cli/blob/main/CHANGELOG.md');
         return;
       }
       const since = options.since;
@@ -1307,14 +1309,31 @@ export function buildCommands(deps = {}) {
   cmds['trade'] = async (args, apiInstance, flags, options) => {
     const sub = args[0];
     if (!sub || sub === 'help') {
-      return {
-        commands: ['quote', 'execute'],
-        description: 'DEX trading commands',
-        example: 'nansen trade quote --chain ethereum --from ETH --to USDC --amount 1'
-      };
+      log(`nansen trade — DEX trading commands
+
+SUBCOMMANDS:
+  quote       Get a swap quote (price, route, fees)
+  execute     Sign and broadcast a quoted swap
+
+USAGE:
+  nansen trade quote --chain <chain> --from <token> --to <token> --amount <units>
+  nansen trade execute --quote <quoteId>
+
+EXAMPLES:
+  nansen trade quote --chain solana --from SOL --to USDC --amount 1000000000
+  nansen trade quote --chain base --from ETH --to USDC --amount 1000000000000000000
+  nansen trade execute --quote 1708900000000-abc123
+
+SYMBOLS:
+  Common tokens resolve automatically: SOL, ETH, BNB, USDC, USDT, WETH, WBNB
+  Raw addresses are also accepted.`);
+      return;
     }
     if (!tradingCmds[sub]) {
-      return { error: `Unknown trade subcommand: ${sub}`, available: ['quote', 'execute'] };
+      log(`Unknown trade subcommand: ${sub}`);
+      log(`Available: quote, execute`);
+      log(`Run 'nansen trade help' for usage.`);
+      return;
     }
     return tradingCmds[sub](args.slice(1), apiInstance, flags, options);
   };