nansen-cli 1.10.1 → 1.11.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 1.11.0
+
+### Minor Changes
+
+- [#186](https://github.com/nansen-ai/nansen-cli/pull/186) [`feecc50`](https://github.com/nansen-ai/nansen-cli/commit/feecc5080254b55aaef0addb646279d52a468063) Thanks [@TimNooren](https://github.com/TimNooren)! - Trade commands output to stdout instead of stderr; wallet send prints human-readable text instead of JSON
+
+### Patch Changes
+
+- [#166](https://github.com/nansen-ai/nansen-cli/pull/166) [`c1034db`](https://github.com/nansen-ai/nansen-cli/commit/c1034dbb4bf2fc173f377cbc0adbbbe3e67873aa) Thanks [@0xlaveen](https://github.com/0xlaveen)! - fix: pass --page parameter correctly in smart-money, profiler, token, perp, and points commands
+
+- [#137](https://github.com/nansen-ai/nansen-cli/pull/137) [`1214767`](https://github.com/nansen-ai/nansen-cli/commit/12147675aadfd0bd97627cb2f41f1dcc5205b0d7) Thanks [@0xlaveen](https://github.com/0xlaveen)! - Add missing sort/filters options to profiler schema and fix pnl sort/filters forwarding
+
 ## 1.10.1
 
 ### Patch Changes

package/README.md

@@ -3,7 +3,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)
 
-> **Built by agents, for agents.** Command-line interface for the [Nansen API](https://docs.nansen.ai) with structured JSON output.
+> **Built by agents, for agents.** Command-line interface for the [Nansen API](https://docs.nansen.ai), designed for AI agents.
 
 ## Installation
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nansen-cli",
-  "version": "1.10.1",
+  "version": "1.11.0",
   "description": "Command-line interface for Nansen API - designed for AI agents",
   "main": "src/index.js",
   "type": "module",

package/src/api.js

@@ -62,7 +62,7 @@ export class NansenError extends Error {
     this.name = 'NansenError';
     this.code = code;
     this.status = status;
-    this.data = data;
+    this.details = data;
   }
 
   toJSON() {
@@ -70,7 +70,7 @@ export class NansenError extends Error {
       error: this.message,
       code: this.code,
       status: this.status,
-      details: this.data,
+      details: this.details,
     };
   }
 }
@@ -733,7 +733,7 @@ export class NansenAPI {
   }
 
   async addressPnl(params = {}) {
-    const { address, chain = 'ethereum', date, days = 30, pagination } = params;
+    const { address, chain = 'ethereum', date, days = 30, filters = {}, orderBy, pagination } = params;
     if (address) {
       const validation = validateAddress(address, chain);
       if (!validation.valid) throw new NansenError(validation.error, validation.code);
@@ -743,6 +743,8 @@ export class NansenAPI {
       address,
       chain,
       date: dateRange,
+      filters,
+      order_by: orderBy,
       pagination
     });
   }

package/src/cli.js

@@ -24,6 +24,16 @@ const schemaDefinition = require('./schema.json');
 // and should be updated whenever the API changes — do not edit returns arrays here.
 export const SCHEMA = { version: VERSION, ...schemaDefinition };
 
+// ============= Pagination =============
+
+export function buildPagination(options) {
+  if (!options.limit && !options.page) return undefined;
+  return {
+    page: Math.max(1, parseInt(options.page, 10) || 1),
+    per_page: options.limit,
+  };
+}
+
 // ============= Field Filtering =============
 
 /**
@@ -313,13 +323,17 @@ export function formatOutput(data, { pretty = false, table = false, csv = false
 
 // Format error data (returns object, does not exit)
 export function formatError(error) {
-  return {
+  const details = error.details ?? error.data ?? null;
+  const result = {
     success: false,
     error: error.message,
     code: error.code || 'UNKNOWN',
     status: error.status || null,
-    details: error.data || null
   };
+  if (details != null && !(typeof details === 'object' && !Array.isArray(details) && Object.keys(details).length === 0)) {
+    result.details = details;
+  }
+  return result;
 }
 
 /**
@@ -606,7 +620,7 @@ export async function compareWallets(api, params = {}) {
 
 export const BANNER = '';
 
-export const HELP = `Nansen CLI v${VERSION} — structured JSON output for AI agents.
+export const HELP = `Nansen CLI v${VERSION} — designed for AI agents.
 
 USAGE: nansen <command> [subcommand] [options]
 
@@ -855,7 +869,7 @@ export function buildCommands(deps = {}) {
       const chains = options.chains || [chain];
       const filters = options.filters || {};
       const orderBy = parseSort(options.sort, options['order-by']);
-      const pagination = options.limit ? { page: 1, per_page: options.limit } : undefined;
+      const pagination = buildPagination(options);
 
       // Add smart money label filter if specified
       if (options.labels) {
@@ -906,7 +920,7 @@ export function buildCommands(deps = {}) {
       }
       const filters = options.filters || {};
       const orderBy = parseSort(options.sort, options['order-by']);
-      const pagination = options.limit ? { page: 1, per_page: options.limit } : undefined;
+      const pagination = buildPagination(options);
       const days = options.days ? parseInt(options.days) : 30;
 
       const handlers = {
@@ -918,7 +932,7 @@ export function buildCommands(deps = {}) {
         },
         'pnl': () => {
           const date = parseDateOption(options.date, days);
-          return apiInstance.addressPnl({ address, chain, date, days, pagination });
+          return apiInstance.addressPnl({ address, chain, date, days, filters, orderBy, pagination });
         },
         'search': () => apiInstance.entitySearch({ query: options.query }),
         'historical-balances': () => apiInstance.addressHistoricalBalances({ address, chain, filters, orderBy, pagination, days }),
@@ -992,7 +1006,7 @@ export function buildCommands(deps = {}) {
       const timeframe = options.timeframe || '24h';
       const filters = options.filters || {};
       const orderBy = parseSort(options.sort, options['order-by']);
-      const pagination = options.limit ? { page: 1, per_page: options.limit } : undefined;
+      const pagination = buildPagination(options);
       const days = options.days ? parseInt(options.days) : 30;
 
       // Convenience filter for smart money only
@@ -1098,7 +1112,7 @@ export function buildCommands(deps = {}) {
       const subcommand = args[0] || 'help';
       const filters = options.filters || {};
       const orderBy = parseSort(options.sort, options['order-by']);
-      const pagination = options.limit ? { page: 1, per_page: options.limit } : undefined;
+      const pagination = buildPagination(options);
       const days = options.days ? parseInt(options.days) : 30;
 
       const handlers = {
@@ -1130,7 +1144,7 @@ export function buildCommands(deps = {}) {
     'points': async (args, apiInstance, flags, options) => {
       const subcommand = args[0] || 'help';
       const tier = options.tier;
-      const pagination = options.limit ? { page: 1, per_page: options.limit } : undefined;
+      const pagination = buildPagination(options);
 
       const handlers = {
         'leaderboard': () => apiInstance.pointsLeaderboard({ tier, pagination }),

package/src/index.js

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 /**
  * Nansen CLI - Command-line interface for Nansen API
- * Designed for AI agents with structured JSON output
- * 
+ * Designed for AI agents.
+ *
  * Usage: nansen <command> [options]
- * 
- * All output is JSON for easy parsing by AI agents.
+ *
+ * Research commands return JSON; operational commands print human-readable text.
  * Use --pretty for human-readable formatting.
  * 
  * Core logic lives in cli.js for testability.

package/src/schema.json

@@ -33,6 +33,10 @@
                 "filters": {
                   "type": "object",
                   "description": "Additional filters as JSON"
+                },
+                "page": {
+                  "type": "number",
+                  "description": "Page number for paginated results (default: 1)"
                 }
               },
               "returns": [
@@ -70,6 +74,10 @@
                 },
                 "filters": {
                   "type": "object"
+                },
+                "page": {
+                  "type": "number",
+                  "description": "Page number for paginated results (default: 1)"
                 }
               },
               "returns": [
@@ -110,6 +118,10 @@
                 },
                 "filters": {
                   "type": "object"
+                },
+                "page": {
+                  "type": "number",
+                  "description": "Page number for paginated results (default: 1)"
                 }
               },
               "returns": [
@@ -141,6 +153,10 @@
                 },
                 "labels": {
                   "type": "string|array"
+                },
+                "page": {
+                  "type": "number",
+                  "description": "Page number for paginated results (default: 1)"
                 }
               },
               "returns": [
@@ -164,6 +180,10 @@
                 },
                 "filters": {
                   "type": "object"
+                },
+                "page": {
+                  "type": "number",
+                  "description": "Page number for paginated results (default: 1)"
                 }
               },
               "returns": [
@@ -200,6 +220,10 @@
                 },
                 "limit": {
                   "type": "number"
+                },
+                "page": {
+                  "type": "number",
+                  "description": "Page number for paginated results (default: 1)"
                 }
               },
               "returns": [
@@ -290,6 +314,18 @@
                 "days": {
                   "type": "number",
                   "default": 30
+                },
+                "page": {
+                  "type": "number",
+                  "description": "Page number for paginated results (default: 1)"
+                },
+                "sort": {
+                  "type": "string",
+                  "description": "Sort field:direction (e.g., block_timestamp:desc)"
+                },
+                "filters": {
+                  "type": "object",
+                  "description": "Additional filters as JSON"
                 }
               },
               "returns": [
@@ -324,6 +360,18 @@
                 },
                 "limit": {
                   "type": "number"
+                },
+                "page": {
+                  "type": "number",
+                  "description": "Page number for paginated results (default: 1)"
+                },
+                "sort": {
+                  "type": "string",
+                  "description": "Sort field:direction (e.g., pnl_usd_realised:desc)"
+                },
+                "filters": {
+                  "type": "object",
+                  "description": "Additional filters as JSON"
                 }
               },
               "returns": [
@@ -358,6 +406,10 @@
                 },
                 "limit": {
                   "type": "number"
+                },
+                "page": {
+                  "type": "number",
+                  "description": "Page number for paginated results (default: 1)"
                 }
               },
               "returns": [
@@ -381,6 +433,18 @@
                 },
                 "limit": {
                   "type": "number"
+                },
+                "page": {
+                  "type": "number",
+                  "description": "Page number for paginated results (default: 1)"
+                },
+                "sort": {
+                  "type": "string",
+                  "description": "Sort field:direction (e.g., value_usd:desc)"
+                },
+                "filters": {
+                  "type": "object",
+                  "description": "Additional filters as JSON"
                 }
               },
               "returns": [
@@ -405,6 +469,14 @@
                 },
                 "limit": {
                   "type": "number"
+                },
+                "page": {
+                  "type": "number",
+                  "description": "Page number for paginated results (default: 1)"
+                },
+                "sort": {
+                  "type": "string",
+                  "description": "Sort field:direction (e.g., order:desc)"
                 }
               },
               "returns": [
@@ -434,6 +506,18 @@
                 },
                 "limit": {
                   "type": "number"
+                },
+                "page": {
+                  "type": "number",
+                  "description": "Page number for paginated results (default: 1)"
+                },
+                "sort": {
+                  "type": "string",
+                  "description": "Sort field:direction (e.g., total_volume_usd:desc)"
+                },
+                "filters": {
+                  "type": "object",
+                  "description": "Additional filters as JSON"
                 }
               },
               "returns": [
@@ -481,6 +565,18 @@
                 },
                 "limit": {
                   "type": "number"
+                },
+                "page": {
+                  "type": "number",
+                  "description": "Page number for paginated results (default: 1)"
+                },
+                "sort": {
+                  "type": "string",
+                  "description": "Sort field:direction (e.g., position_value_usd:desc)"
+                },
+                "filters": {
+                  "type": "object",
+                  "description": "Additional filters as JSON"
                 }
               },
               "returns": [
@@ -511,6 +607,18 @@
                 },
                 "limit": {
                   "type": "number"
+                },
+                "page": {
+                  "type": "number",
+                  "description": "Page number for paginated results (default: 1)"
+                },
+                "sort": {
+                  "type": "string",
+                  "description": "Sort field:direction (e.g., value_usd:desc)"
+                },
+                "filters": {
+                  "type": "object",
+                  "description": "Additional filters as JSON"
                 }
               },
               "returns": [
@@ -774,6 +882,10 @@
                 "filters": {
                   "type": "object",
                   "description": "Additional filters as JSON"
+                },
+                "page": {
+                  "type": "number",
+                  "description": "Page number for paginated results (default: 1)"
                 }
               },
               "returns": [
@@ -819,6 +931,10 @@
                 "filters": {
                   "type": "object",
                   "description": "Additional filters as JSON"
+                },
+                "page": {
+                  "type": "number",
+                  "description": "Page number for paginated results (default: 1)"
                 }
               },
               "returns": [
@@ -864,6 +980,10 @@
                 "filters": {
                   "type": "object",
                   "description": "Additional filters as JSON"
+                },
+                "page": {
+                  "type": "number",
+                  "description": "Page number for paginated results (default: 1)"
                 }
               },
               "returns": [
@@ -904,6 +1024,10 @@
                 "filters": {
                   "type": "object",
                   "description": "Additional filters as JSON"
+                },
+                "page": {
+                  "type": "number",
+                  "description": "Page number for paginated results (default: 1)"
                 }
               },
               "returns": [
@@ -947,6 +1071,10 @@
                 "filters": {
                   "type": "object",
                   "description": "Additional filters as JSON"
+                },
+                "page": {
+                  "type": "number",
+                  "description": "Page number for paginated results (default: 1)"
                 }
               },
               "returns": [
@@ -999,6 +1127,10 @@
                 "filters": {
                   "type": "object",
                   "description": "Additional filters as JSON"
+                },
+                "page": {
+                  "type": "number",
+                  "description": "Page number for paginated results (default: 1)"
                 }
               },
               "returns": [
@@ -1086,6 +1218,10 @@
                 "filters": {
                   "type": "object",
                   "description": "Additional filters as JSON"
+                },
+                "page": {
+                  "type": "number",
+                  "description": "Page number for paginated results (default: 1)"
                 }
               },
               "returns": [
@@ -1117,6 +1253,10 @@
                 "filters": {
                   "type": "object",
                   "description": "Additional filters as JSON"
+                },
+                "page": {
+                  "type": "number",
+                  "description": "Page number for paginated results (default: 1)"
                 }
               },
               "returns": [
@@ -1159,6 +1299,10 @@
                 "filters": {
                   "type": "object",
                   "description": "Additional filters as JSON"
+                },
+                "page": {
+                  "type": "number",
+                  "description": "Page number for paginated results (default: 1)"
                 }
               },
               "returns": [
@@ -1192,6 +1336,10 @@
                 "filters": {
                   "type": "object",
                   "description": "Additional filters as JSON"
+                },
+                "page": {
+                  "type": "number",
+                  "description": "Page number for paginated results (default: 1)"
                 }
               },
               "returns": [
@@ -1230,6 +1378,10 @@
                 "filters": {
                   "type": "object",
                   "description": "Additional filters as JSON"
+                },
+                "page": {
+                  "type": "number",
+                  "description": "Page number for paginated results (default: 1)"
                 }
               },
               "returns": [
@@ -1280,6 +1432,10 @@
               "type": "number",
               "default": 25,
               "description": "Max results (1-50)"
+            },
+            "page": {
+              "type": "number",
+              "description": "Page number for paginated results (default: 1)"
             }
           },
           "returns": [
@@ -1306,6 +1462,10 @@
                 },
                 "filters": {
                   "type": "object"
+                },
+                "page": {
+                  "type": "number",
+                  "description": "Page number for paginated results (default: 1)"
                 }
               },
               "returns": [
@@ -1336,6 +1496,10 @@
                 },
                 "filters": {
                   "type": "object"
+                },
+                "page": {
+                  "type": "number",
+                  "description": "Page number for paginated results (default: 1)"
                 }
               },
               "returns": [
@@ -1384,6 +1548,10 @@
                 },
                 "limit": {
                   "type": "number"
+                },
+                "page": {
+                  "type": "number",
+                  "description": "Page number for paginated results (default: 1)"
                 }
               },
               "returns": [
@@ -1426,7 +1594,7 @@
             },
             "wallet": {
               "type": "string",
-              "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."
+              "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."
             }
           },
           "prerequisites": [

package/src/trading.js

@@ -756,7 +756,7 @@ export function formatQuote(quote, index) {
  * Build trading command handlers for CLI integration.
  */
 export function buildTradingCommands(deps = {}) {
-  const { errorOutput = console.error, exit = process.exit } = deps;
+  const { log = console.log, exit = process.exit } = deps;
 
   return {
     'quote': async (args, apiInstance, flags, options) => {
@@ -773,7 +773,7 @@ export function buildTradingCommands(deps = {}) {
       const swapMode = options['swap-mode'] || 'exactIn';
 
       if (!chain || !from || !to || !amount) {
-        errorOutput(`
+        log(`
 Usage: nansen trade quote --chain <chain> --from <token> --to <token> --amount <baseUnits>
 
 PREREQUISITE:
@@ -803,7 +803,7 @@ EXAMPLES:
 
       const amountError = validateBaseUnitAmount(amount);
       if (amountError) {
-        errorOutput(`Error: ${amountError}`);
+        log(`Error: ${amountError}`);
         exit(1);
         return;
       }
@@ -817,13 +817,13 @@ EXAMPLES:
         let walletAddress;
         if (isWalletConnect) {
           if (chainType !== 'evm') {
-            errorOutput('WalletConnect is only supported for EVM chains');
+            log('WalletConnect is only supported for EVM chains');
             exit(1);
             return;
           }
           walletAddress = await getWalletConnectAddress();
           if (!walletAddress) {
-            errorOutput('No WalletConnect session active. Run: walletconnect connect');
+            log('No WalletConnect session active. Run: walletconnect connect');
             exit(1);
             return;
           }
@@ -839,16 +839,16 @@ EXAMPLES:
         }
 
         if (!walletAddress) {
-          errorOutput('No wallet found. A wallet address is required for quotes because the trading API builds a transaction specific to the sender.\nCreate one with: nansen wallet create');
+          log('No wallet found. A wallet address is required for quotes because the trading API builds a transaction specific to the sender.\nCreate one with: nansen wallet create');
           exit(1);
           return;
         }
 
-        errorOutput(`\nFetching quote on ${chainConfig.name}...`);
-        errorOutput(`  Wallet: ${walletAddress}`);
+        log(`\nFetching quote on ${chainConfig.name}...`);
+        log(`  Wallet: ${walletAddress}`);
 
         const fromWarning = getWrappedNativeFromWarning(from, chain);
-        if (fromWarning) errorOutput(`  ${fromWarning}`);
+        if (fromWarning) log(`  ${fromWarning}`);
 
         const params = {
           chainIndex: chainConfig.index,
@@ -865,30 +865,30 @@ EXAMPLES:
         const response = await getQuote(params);
 
         if (!response.success || !response.quotes?.length) {
-          errorOutput('No quotes available');
+          log('No quotes available');
           if (response.warnings?.length) {
-            response.warnings.forEach(w => errorOutput(`  Warning: ${w}`));
+            response.warnings.forEach(w => log(`  Warning: ${w}`));
           }
           exit(1);
           return;
         }
 
-        errorOutput('');
-        response.quotes.forEach((q, i) => errorOutput(formatQuote(q, i)));
+        log('');
+        response.quotes.forEach((q, i) => log(formatQuote(q, i)));
 
         const quoteId = saveQuote(response, chain, isWalletConnect ? 'walletconnect' : 'local');
-        errorOutput(`\n  Quote ID: ${quoteId}`);
-        errorOutput(`  Execute:  nansen trade execute --quote ${quoteId}`);
+        log(`\n  Quote ID: ${quoteId}`);
+        log(`  Execute:  nansen trade execute --quote ${quoteId}`);
         if (response.quotes.length > 1) {
-          errorOutput(`  Pin #1:  nansen trade execute --quote ${quoteId} --quote-index 0`);
+          log(`  Pin #1:  nansen trade execute --quote ${quoteId} --quote-index 0`);
         }
 
         if (response.quotes[0]?.approvalAddress && !isNativeToken(response.quotes[0]?.inputMint)) {
-          errorOutput(`\n  Warning: This token swap requires an ERC-20 approval step.`);
-          errorOutput(`    The execute command will handle this automatically.`);
+          log(`\n  Warning: This token swap requires an ERC-20 approval step.`);
+          log(`    The execute command will handle this automatically.`);
         }
 
-        errorOutput('');
+        log('');
         return undefined; // Output already printed above
 
       } catch (err) {
@@ -896,8 +896,8 @@ EXAMPLES:
         if (err.code === 'INVALID_AMOUNT' || /amount/i.test(err.message)) {
           message += '. Amounts must be in base units (e.g., 1000000000 lamports for 1 SOL, 1000000000000000000 wei for 1 ETH)';
         }
-        errorOutput(`Error: ${message}`);
-        if (err.details) errorOutput(`  Details: ${JSON.stringify(err.details)}`);
+        log(`Error: ${message}`);
+        if (err.details) log(`  Details: ${JSON.stringify(err.details)}`);
         exit(1);
       }
     },
@@ -908,7 +908,7 @@ EXAMPLES:
       const noSimulate = flags['no-simulate'] || flags.noSimulate;
 
       if (!quoteId) {
-        errorOutput(`
+        log(`
 Usage: nansen trade execute --quote <quoteId> [options]
 
 OPTIONS:
@@ -931,7 +931,7 @@ EXAMPLES:
 
         const allQuotes = quoteData.response.quotes || [];
         if (!allQuotes.length) {
-          errorOutput('❌ No quote data found');
+          log('❌ No quote data found');
           exit(1);
           return;
         }
@@ -944,8 +944,8 @@ EXAMPLES:
         // Check if any quote in range has transaction data before prompting for password
         const hasAnyTransaction = allQuotes.slice(startIndex, endIndex).some(q => q?.transaction);
         if (!hasAnyTransaction) {
-          errorOutput('❌ No quotes contain transaction data.');
-          errorOutput('  Ensure userWalletAddress was provided when fetching the quote.');
+          log('❌ No quotes contain transaction data.');
+          log('  Ensure userWalletAddress was provided when fetching the quote.');
           exit(1);
           return;
         }
@@ -965,7 +965,7 @@ EXAMPLES:
             effectiveWalletName = list.defaultWallet;
           }
           if (!effectiveWalletName) {
-            errorOutput('No wallet found. Create one with: nansen wallet create');
+            log('No wallet found. Create one with: nansen wallet create');
             exit(1);
             return;
           }
@@ -974,13 +974,13 @@ EXAMPLES:
         } else {
           // Verify WalletConnect session is still active and address matches quote
           if (chainType !== 'evm') {
-            errorOutput('WalletConnect is only supported for EVM chains');
+            log('WalletConnect is only supported for EVM chains');
             exit(1);
             return;
           }
           const wcAddress = await getWalletConnectAddress();
           if (!wcAddress) {
-            errorOutput('No WalletConnect session active. Run: walletconnect connect');
+            log('No WalletConnect session active. Run: walletconnect connect');
             exit(1);
             return;
           }
@@ -988,7 +988,7 @@ EXAMPLES:
           const quoteWallet = quoteData.response?.quotes?.[0]?.transaction?.from
             || quoteData.response?.metadata?.userWalletAddress;
           if (quoteWallet && wcAddress.toLowerCase() !== quoteWallet.toLowerCase()) {
-            errorOutput(`Connected wallet (${wcAddress}) doesn't match quote. Get a new quote with --wallet walletconnect`);
+            log(`Connected wallet (${wcAddress}) doesn't match quote. Get a new quote with --wallet walletconnect`);
             exit(1);
             return;
           }
@@ -1004,17 +1004,17 @@ EXAMPLES:
 
           // Verify transaction data exists
           if (!currentQuote.transaction) {
-            errorOutput(`  ⚠ Quote ${quoteName}: no transaction data, skipping...`);
+            log(`  ⚠ Quote ${quoteName}: no transaction data, skipping...`);
             lastQuoteError = `Quote ${quoteName} has no transaction data`;
             continue;
           }
 
-          errorOutput(`\nExecuting trade on ${chainConfig.name}...`);
+          log(`\nExecuting trade on ${chainConfig.name}...`);
           if (endIndex - startIndex > 1) {
-            errorOutput(`  Trying quote ${qi + 1}/${allQuotes.length} (${quoteName})...`);
+            log(`  Trying quote ${qi + 1}/${allQuotes.length} (${quoteName})...`);
           }
-          errorOutput(formatQuote(currentQuote));
-          errorOutput('');
+          log(formatQuote(currentQuote));
+          log('');
 
           try {
             let signedTransaction;
@@ -1027,7 +1027,7 @@ EXAMPLES:
               if (typeof txBase64 === 'object' && txBase64.data) {
                 txBase64 = base58Decode(txBase64.data).toString('base64');
               }
-              errorOutput('  Signing Solana transaction...');
+              log('  Signing Solana transaction...');
               signedTransaction = signSolanaTransaction(txBase64, exported.solana.privateKey);
               requestId = currentQuote.metadata?.requestId;
 
@@ -1041,15 +1041,15 @@ EXAMPLES:
               if (isNative) {
                 const expectedValue = BigInt(currentQuote.inAmount || currentQuote.inputAmount || '0');
                 if (txValue !== expectedValue) {
-                  errorOutput(`  ❌ Transaction value mismatch for ${quoteName}: tx.value=${txValue}, expected=${expectedValue}`);
-                  if (qi + 1 < endIndex) errorOutput(`  Trying next quote...`);
+                  log(`  ❌ Transaction value mismatch for ${quoteName}: tx.value=${txValue}, expected=${expectedValue}`);
+                  if (qi + 1 < endIndex) log(`  Trying next quote...`);
                   lastQuoteError = `${quoteName} transaction value mismatch`;
                   continue;
                 }
               } else {
                 if (txValue > 0n) {
-                  errorOutput(`  ❌ ERC-20 swap has non-zero tx.value (${txValue}) for ${quoteName} — aborting`);
-                  if (qi + 1 < endIndex) errorOutput(`  Trying next quote...`);
+                  log(`  ❌ ERC-20 swap has non-zero tx.value (${txValue}) for ${quoteName} — aborting`);
+                  if (qi + 1 < endIndex) log(`  Trying next quote...`);
                   lastQuoteError = `${quoteName} unexpected tx.value`;
                   continue;
                 }
@@ -1063,10 +1063,10 @@ EXAMPLES:
                 );
 
                 if (existingAllowance >= inputAmount && existingAllowance > 0n) {
-                  errorOutput(`  ✓ Sufficient allowance exists for ${quoteName}, skipping approval`);
+                  log(`  ✓ Sufficient allowance exists for ${quoteName}, skipping approval`);
                 } else {
-                  errorOutput(`  ⚠ Approval required → ${currentQuote.approvalAddress}`);
-                  errorOutput(`  Sending approval via WalletConnect...`);
+                  log(`  ⚠ Approval required → ${currentQuote.approvalAddress}`);
+                  log(`  Sending approval via WalletConnect...`);
                   try {
                     const approvalResult = await sendApprovalViaWalletConnect(
                       currentQuote.inputMint,
@@ -1076,7 +1076,7 @@ EXAMPLES:
                     let approvalTxHash = approvalResult.txHash;
                     if (!approvalTxHash && approvalResult.signedTransaction) {
                       // Wallet returned a signed tx instead of broadcasting — broadcast via Trading API
-                      errorOutput(`  Broadcasting approval via Trading API...`);
+                      log(`  Broadcasting approval via Trading API...`);
                       const broadcastResult = await executeTransaction({
                         signedTransaction: approvalResult.signedTransaction,
                         chain,
@@ -1088,18 +1088,18 @@ EXAMPLES:
                       approvalTxHash = broadcastResult.txHash;
                     }
                     if (approvalTxHash) {
-                      errorOutput(`  Waiting for approval confirmation...`);
+                      log(`  Waiting for approval confirmation...`);
                       const receipt = await waitForReceipt(chain, approvalTxHash);
-                      errorOutput(`  ✓ Approval confirmed in block ${parseInt(receipt.blockNumber, 16)}: ${approvalTxHash}`);
+                      log(`  ✓ Approval confirmed in block ${parseInt(receipt.blockNumber, 16)}: ${approvalTxHash}`);
                     }
                   } catch (approvalErr) {
-                    errorOutput(`  ❌ Approval failed for ${quoteName}: ${approvalErr.message}`);
-                    if (qi + 1 < endIndex) errorOutput(`  Trying next quote...`);
+                    log(`  ❌ Approval failed for ${quoteName}: ${approvalErr.message}`);
+                    if (qi + 1 < endIndex) log(`  Trying next quote...`);
                     lastQuoteError = `${quoteName} approval failed`;
                     continue;
                   }
                   await new Promise(r => setTimeout(r, 2000));
-                  errorOutput('');
+                  log('');
                 }
               }
 
@@ -1113,8 +1113,8 @@ EXAMPLES:
                   value: txData.value ? '0x' + BigInt(txData.value).toString(16) : '0x0',
                 });
                 if (!sim.success) {
-                  errorOutput(`  ⚠ Simulation failed for ${quoteName}: ${sim.reason}`);
-                  if (qi + 1 < endIndex) errorOutput(`  Trying next quote...`);
+                  log(`  ⚠ Simulation failed for ${quoteName}: ${sim.reason}`);
+                  if (qi + 1 < endIndex) log(`  Trying next quote...`);
                   lastQuoteError = `${quoteName} simulation failed: ${sim.reason}`;
                   continue;
                 }
@@ -1127,7 +1127,7 @@ EXAMPLES:
               const finalGas = apiGas > 0 ? apiGas : txGas;
 
               // Send transaction via WalletConnect
-              errorOutput('  Sending transaction via WalletConnect...');
+              log('  Sending transaction via WalletConnect...');
               let wcResult;
               try {
                 wcResult = await sendTransactionViaWalletConnect({
@@ -1138,24 +1138,24 @@ EXAMPLES:
                   chainId: chainConfig.chainId,
                 });
               } catch (wcErr) {
-                errorOutput(`  ❌ WalletConnect transaction failed for ${quoteName}: ${wcErr.message}`);
-                if (qi + 1 < endIndex) errorOutput(`  Trying next quote...`);
+                log(`  ❌ WalletConnect transaction failed for ${quoteName}: ${wcErr.message}`);
+                if (qi + 1 < endIndex) log(`  Trying next quote...`);
                 lastQuoteError = `${quoteName}: ${wcErr.message}`;
                 continue;
               }
 
               if (wcResult.txHash) {
                 // Wallet broadcast — verify on-chain
-                errorOutput('  Verifying on-chain status...');
+                log('  Verifying on-chain status...');
                 try {
                   await waitForReceipt(chain, wcResult.txHash);
                 } catch (receiptErr) {
-                  errorOutput(`\n  ⚠ Transaction was broadcast but REVERTED on-chain!`);
-                  errorOutput(`    Tx Hash:   ${wcResult.txHash}`);
-                  errorOutput(`    Explorer:  ${chainConfig.explorer}${wcResult.txHash}`);
-                  errorOutput(`    Error:     ${receiptErr.message}`);
+                  log(`\n  ⚠ Transaction was broadcast but REVERTED on-chain!`);
+                  log(`    Tx Hash:   ${wcResult.txHash}`);
+                  log(`    Explorer:  ${chainConfig.explorer}${wcResult.txHash}`);
+                  log(`    Error:     ${receiptErr.message}`);
                   if (qi + 1 < endIndex) {
-                    errorOutput(`  Trying next quote...`);
+                    log(`  Trying next quote...`);
                     lastQuoteError = `${quoteName} reverted on-chain`;
                     continue;
                   }
@@ -1163,11 +1163,11 @@ EXAMPLES:
                   return;
                 }
 
-                errorOutput(`\n  ✓ Transaction successful!`);
-                errorOutput(`    Tx Hash:   ${wcResult.txHash}`);
-                errorOutput(`    Chain:       ${chainConfig.name}`);
-                errorOutput(`    Explorer:    ${chainConfig.explorer}${wcResult.txHash}`);
-                errorOutput('');
+                log(`\n  ✓ Transaction successful!`);
+                log(`    Tx Hash:   ${wcResult.txHash}`);
+                log(`    Chain:       ${chainConfig.name}`);
+                log(`    Explorer:    ${chainConfig.explorer}${wcResult.txHash}`);
+                log('');
                 return undefined; // Success
               }
 
@@ -1191,15 +1191,15 @@ EXAMPLES:
               if (isNative) {
                 const expectedValue = BigInt(currentQuote.inAmount || currentQuote.inputAmount || '0');
                 if (txValue !== expectedValue) {
-                  errorOutput(`  ❌ Transaction value mismatch for ${quoteName}: tx.value=${txValue}, expected=${expectedValue}`);
-                  if (qi + 1 < endIndex) errorOutput(`  Trying next quote...`);
+                  log(`  ❌ Transaction value mismatch for ${quoteName}: tx.value=${txValue}, expected=${expectedValue}`);
+                  if (qi + 1 < endIndex) log(`  Trying next quote...`);
                   lastQuoteError = `${quoteName} transaction value mismatch`;
                   continue;
                 }
               } else {
                 if (txValue > 0n) {
-                  errorOutput(`  ❌ ERC-20 swap has non-zero tx.value (${txValue}) for ${quoteName} — aborting`);
-                  if (qi + 1 < endIndex) errorOutput(`  Trying next quote...`);
+                  log(`  ❌ ERC-20 swap has non-zero tx.value (${txValue}) for ${quoteName} — aborting`);
+                  if (qi + 1 < endIndex) log(`  Trying next quote...`);
                   lastQuoteError = `${quoteName} unexpected tx.value`;
                   continue;
                 }
@@ -1213,10 +1213,10 @@ EXAMPLES:
                 );
 
                 if (existingAllowance >= inputAmount && existingAllowance > 0n) {
-                  errorOutput(`  ✓ Sufficient allowance exists for ${quoteName}, skipping approval`);
+                  log(`  ✓ Sufficient allowance exists for ${quoteName}, skipping approval`);
                 } else {
-                  errorOutput(`  ⚠ Approval required → ${currentQuote.approvalAddress}`);
-                  errorOutput(`  Sending approval tx...`);
+                  log(`  ⚠ Approval required → ${currentQuote.approvalAddress}`);
+                  log(`  Sending approval tx...`);
                   const approvalNonce = await getEvmNonce(chain, walletAddress);
 
                   const approvalGasPrice = currentQuote.transaction?.gasPrice || currentQuote.transaction?.maxFeePerGas || '1000000';
@@ -1236,25 +1236,25 @@ EXAMPLES:
                   });
 
                   if (approvalResult.status !== 'Success') {
-                    errorOutput(`  ❌ Approval failed for ${quoteName}: ${approvalResult.error || 'unknown error'}`);
-                    if (qi + 1 < endIndex) errorOutput(`  Trying next quote...`);
+                    log(`  ❌ Approval failed for ${quoteName}: ${approvalResult.error || 'unknown error'}`);
+                    if (qi + 1 < endIndex) log(`  Trying next quote...`);
                     lastQuoteError = `${quoteName} approval failed`;
                     continue;
                   }
 
-                  errorOutput(`  Waiting for approval confirmation...`);
+                  log(`  Waiting for approval confirmation...`);
                   try {
                     const receipt = await waitForReceipt(chain, approvalResult.txHash);
-                    errorOutput(`  ✓ Approval confirmed in block ${parseInt(receipt.blockNumber, 16)}: ${approvalResult.txHash}`);
+                    log(`  ✓ Approval confirmed in block ${parseInt(receipt.blockNumber, 16)}: ${approvalResult.txHash}`);
                   } catch (receiptErr) {
-                    errorOutput(`  ❌ Approval may not have confirmed: ${receiptErr.message}`);
-                    if (qi + 1 < endIndex) errorOutput(`  Trying next quote...`);
+                    log(`  ❌ Approval may not have confirmed: ${receiptErr.message}`);
+                    if (qi + 1 < endIndex) log(`  Trying next quote...`);
                     lastQuoteError = `${quoteName} approval unconfirmed`;
                     continue;
                   }
                   // Wait for RPC state propagation after approval
                   await new Promise(r => setTimeout(r, 2000));
-                  errorOutput('');
+                  log('');
                 }
               }
 
@@ -1270,8 +1270,8 @@ EXAMPLES:
                   value: txData.value ? '0x' + BigInt(txData.value).toString(16) : '0x0',
                 });
                 if (!sim.success) {
-                  errorOutput(`  ⚠ Simulation failed for ${quoteName}: ${sim.reason}`);
-                  if (qi + 1 < endIndex) errorOutput(`  Trying next quote...`);
+                  log(`  ⚠ Simulation failed for ${quoteName}: ${sim.reason}`);
+                  if (qi + 1 < endIndex) log(`  Trying next quote...`);
                   lastQuoteError = `${quoteName} simulation failed: ${sim.reason}`;
                   continue;
                 }
@@ -1285,17 +1285,17 @@ EXAMPLES:
               const txGas = parseInt(txData.gas || txData.gasLimit || "0");
               const finalGas = apiGas > 0 ? apiGas : txGas;
               if (finalGas !== txGas) {
-                errorOutput(`  ℹ Using API gas ${finalGas} (tx.gas was ${txGas})`);
+                log(`  ℹ Using API gas ${finalGas} (tx.gas was ${txGas})`);
               }
               if (txData.gasLimit) txData.gasLimit = String(finalGas);
               else txData.gas = String(finalGas);
 
-              errorOutput('  Fetching nonce...');
+              log('  Fetching nonce...');
               await new Promise(r => setTimeout(r, 1000));
               const nonce = await getEvmNonce(chain, walletAddress);
-              errorOutput(`  Nonce: ${nonce}`);
+              log(`  Nonce: ${nonce}`);
 
-              errorOutput('  Signing EVM transaction...');
+              log('  Signing EVM transaction...');
               signedTransaction = signEvmTransaction(
                 currentQuote.transaction,
                 exported.evm.privateKey,
@@ -1304,7 +1304,7 @@ EXAMPLES:
               );
             }
 
-            errorOutput('  Broadcasting...');
+            log('  Broadcasting...');
             const execParams = {
               signedTransaction,
               chain,
@@ -1320,64 +1320,64 @@ EXAMPLES:
 
               // For EVM: verify the tx actually succeeded on-chain
               if (chainType === 'evm' && result.txHash) {
-                errorOutput('  Verifying on-chain status...');
+                log('  Verifying on-chain status...');
                 try {
                   await waitForReceipt(chain, result.txHash);
                 } catch (receiptErr) {
-                  errorOutput(`\n  ⚠ Transaction was broadcast but REVERTED on-chain!`);
-                  errorOutput(`    Tx Hash:   ${result.txHash}`);
-                  errorOutput(`    Explorer:  ${explorerUrl}`);
-                  errorOutput(`    Error:     ${receiptErr.message}`);
+                  log(`\n  ⚠ Transaction was broadcast but REVERTED on-chain!`);
+                  log(`    Tx Hash:   ${result.txHash}`);
+                  log(`    Explorer:  ${explorerUrl}`);
+                  log(`    Error:     ${receiptErr.message}`);
                   if (qi + 1 < endIndex) {
-                    errorOutput(`  Trying next quote...`);
+                    log(`  Trying next quote...`);
                     lastQuoteError = `${quoteName} reverted on-chain`;
                     continue;
                   }
-                  errorOutput(`\n  The trading API reported success, but the contract execution failed.`);
-                  errorOutput(`  This can happen due to: stale quotes, insufficient gas, or liquidity changes.`);
+                  log(`\n  The trading API reported success, but the contract execution failed.`);
+                  log(`  This can happen due to: stale quotes, insufficient gas, or liquidity changes.`);
                   exit(1);
                   return;
                 }
               }
 
-              errorOutput(`\n  ✓ Transaction successful!`);
-              errorOutput(`    Status:      ${result.status}`);
-              errorOutput(`    ${result.signature ? 'Signature' : 'Tx Hash'}:   ${txId}`);
-              errorOutput(`    Chain:       ${chainConfig.name} (${result.chainType})`);
-              errorOutput(`    Broadcaster: ${result.broadcaster}`);
-              errorOutput(`    Explorer:    ${explorerUrl}`);
+              log(`\n  ✓ Transaction successful!`);
+              log(`    Status:      ${result.status}`);
+              log(`    ${result.signature ? 'Signature' : 'Tx Hash'}:   ${txId}`);
+              log(`    Chain:       ${chainConfig.name} (${result.chainType})`);
+              log(`    Broadcaster: ${result.broadcaster}`);
+              log(`    Explorer:    ${explorerUrl}`);
 
               if (result.swapEvents?.length) {
-                errorOutput(`    Swaps:`);
+                log(`    Swaps:`);
                 result.swapEvents.forEach(e => {
-                  errorOutput(`      ${e.inputAmount} ${e.inputMint?.slice(0, 8)}... → ${e.outputAmount} ${e.outputMint?.slice(0, 8)}...`);
+                  log(`      ${e.inputAmount} ${e.inputMint?.slice(0, 8)}... → ${e.outputAmount} ${e.outputMint?.slice(0, 8)}...`);
                 });
               }
-              errorOutput('');
+              log('');
               return undefined; // Success — done
             } else {
-              errorOutput(`\n  ✗ Quote ${quoteName} failed: ${result.status}`);
-              if (result.error) errorOutput(`    Error:  ${result.error}`);
+              log(`\n  ✗ Quote ${quoteName} failed: ${result.status}`);
+              if (result.error) log(`    Error:  ${result.error}`);
               lastQuoteError = `${quoteName}: ${result.error || result.status}`;
-              if (qi + 1 < endIndex) errorOutput(`  Trying next quote...`);
+              if (qi + 1 < endIndex) log(`  Trying next quote...`);
             }
 
           } catch (quoteErr) {
-            errorOutput(`  ❌ Quote ${quoteName} failed: ${quoteErr.message}`);
+            log(`  ❌ Quote ${quoteName} failed: ${quoteErr.message}`);
             lastQuoteError = `${quoteName}: ${quoteErr.message}`;
-            if (qi + 1 < endIndex) errorOutput(`  Trying next quote...`);
+            if (qi + 1 < endIndex) log(`  Trying next quote...`);
           }
         }
 
         // All quotes exhausted
-        errorOutput(`\n❌ All quotes failed. Last error: ${lastQuoteError || 'unknown'}`);
-        errorOutput('');
+        log(`\n❌ All quotes failed. Last error: ${lastQuoteError || 'unknown'}`);
+        log('');
         exit(1);
         return undefined;
 
       } catch (err) {
-        errorOutput(`Error: ${err.message}`);
-        if (err.details) errorOutput(`  Details: ${JSON.stringify(err.details)}`);
+        log(`Error: ${err.message}`);
+        if (err.details) log(`  Details: ${JSON.stringify(err.details)}`);
         exit(1);
       }
     },

package/src/wallet.js

@@ -519,7 +519,7 @@ export function buildWalletCommands(deps = {}) {
             log(`    Base (recommended, lower fees): send USDC to ${result.evm}`);
             log(`    Solana: send USDC to ${result.solana}`);
             log('');
-            return result;
+            return;
           } catch (err) {
             log(`❌ ${err.message}`);
             exit(1);
@@ -530,7 +530,7 @@ export function buildWalletCommands(deps = {}) {
           const result = listWallets();
           if (result.wallets.length === 0) {
             log('No wallets found. Create one with: nansen wallet create');
-            return result;
+            return;
           }
           log('');
           for (const w of result.wallets) {
@@ -540,7 +540,6 @@ export function buildWalletCommands(deps = {}) {
             log(`    Solana: ${w.solana}`);
             log('');
           }
-          return result;
         },
 
         'show': async () => {
@@ -557,7 +556,7 @@ export function buildWalletCommands(deps = {}) {
             log(`    EVM:    ${result.evm}`);
             log(`    Solana: ${result.solana}`);
             log(`    Created: ${result.createdAt}\n`);
-            return result;
+            return;
           } catch (err) {
             log(`❌ ${err.message}`);
             exit(1);
@@ -582,7 +581,7 @@ export function buildWalletCommands(deps = {}) {
             log(`    Address:     ${result.solana.address}`);
             log(`    Private Key: ${result.solana.privateKey}`);
             log('');
-            return result;
+            return;
           } catch (err) {
             log(`❌ ${err.message}`);
             exit(1);
@@ -599,7 +598,7 @@ export function buildWalletCommands(deps = {}) {
           try {
             const result = setDefaultWallet(name);
             log(`✓ Default wallet set to "${result.defaultWallet}"`);
-            return result;
+            return;
           } catch (err) {
             log(`❌ ${err.message}`);
             exit(1);
@@ -620,7 +619,7 @@ export function buildWalletCommands(deps = {}) {
             if (result.newDefault) {
               log(`  New default: ${result.newDefault}`);
             }
-            return result;
+            return;
           } catch (err) {
             log(`❌ ${err.message}`);
             exit(1);
@@ -675,37 +674,32 @@ export function buildWalletCommands(deps = {}) {
             if (dryRun) {
               // Build the transaction but don't broadcast
               const result = await sendTokens(sendOpts);
-              const output = {
-                dryRun: true,
-                from: result.from,
-                to: options.to,
-                amount: result.amount || (isMax ? 'max' : String(options.amount)),
-                token: options.token || '(native)',
-                chain: options.chain,
-                ...(result.estimatedFee ? { estimatedFee: result.estimatedFee } : {}),
-              };
-              log(JSON.stringify(output, null, 2));
-              return output;
+              log(`\nDry run — transaction not broadcast\n`);
+              log(`  From:   ${result.from}`);
+              log(`  To:     ${options.to}`);
+              log(`  Amount: ${result.amount || (isMax ? 'max' : String(options.amount))}`);
+              log(`  Token:  ${options.token || '(native)'}`);
+              log(`  Chain:  ${options.chain}`);
+              if (result.estimatedFee) log(`  Fee:    ${result.estimatedFee}`);
+              log('');
+              return;
             }
 
             const result = await sendTokens(sendOpts);
-            
-            const output = {
-              success: true,
-              transactionHash: result.transactionHash,
-              confirmed: result.confirmed,
-              ...(result.blockNumber ? { blockNumber: result.blockNumber } : {}),
-              from: result.from,
-              to: result.to,
-              amount: result.amount,
-              token: result.token,
-              chain: result.chain,
-              explorer: result.explorer,
-            };
-            log(JSON.stringify(output, null, 2));
-            return output;
+            log(`\n✓ Transaction sent\n`);
+            log(`  Tx Hash: ${result.transactionHash}`);
+            log(`  Chain:   ${result.chain}`);
+            log(`  From:    ${result.from}`);
+            log(`  To:      ${result.to}`);
+            log(`  Amount:  ${result.amount}`);
+            log(`  Token:   ${result.token}`);
+            if (result.blockNumber) log(`  Block:   ${result.blockNumber}`);
+            log(`  Status:  ${result.confirmed ? 'confirmed' : 'pending'}`);
+            log(`  Explorer: ${result.explorer}`);
+            log('');
+            return;
           } catch (err) {
-            log(JSON.stringify({ success: false, error: err.message }));
+            log(`Error: ${err.message}`);
             exit(1);
           }
         },
@@ -749,15 +743,14 @@ EXAMPLES:
   nansen wallet send --to 0x742d35Cc... --amount 1.5 --chain evm
   nansen wallet send --to 9WzDXw... --amount 0.1 --chain solana --token So11...
 `);
-          return {
-            commands: ['create', 'list', 'show', 'export', 'default', 'delete', 'send'],
-            description: 'Local wallet management for EVM and Solana',
-          };
+          return;
         },
       };
 
       if (!handlers[subcommand]) {
-        return { error: `Unknown subcommand: ${subcommand}`, available: Object.keys(handlers) };
+        log(`Unknown subcommand: ${subcommand}. Available: ${Object.keys(handlers).join(', ')}`);
+        exit(1);
+        return;
       }
 
       return handlers[subcommand]();