nansen-cli 1.9.1 → 1.9.3

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 1.9.3
+
+### Patch Changes
+
+- [#118](https://github.com/nansen-ai/nansen-cli/pull/118) [`0bd4c3c`](https://github.com/nansen-ai/nansen-cli/commit/0bd4c3c1946e575e2c2db5e02d17f266e79752a4) Thanks [@TimNooren](https://github.com/TimNooren)! - Show warning when trade quote price impact exceeds 5%, and show pin command to avoid fallback to worse quotes
+
+## 1.9.2
+
+### Patch Changes
+
+- [#116](https://github.com/nansen-ai/nansen-cli/pull/116) [`7a2b729`](https://github.com/nansen-ai/nansen-cli/commit/7a2b7293c2e731ae1d5375b15df9c05c5611a9cb) Thanks [@TimNooren](https://github.com/TimNooren)! - Fix usage examples for `nansen trade quote` to show correct command name instead of deprecated `nansen quote`
+
+- [#114](https://github.com/nansen-ai/nansen-cli/pull/114) [`37d8c0b`](https://github.com/nansen-ai/nansen-cli/commit/37d8c0b87797145a15b087caa5eb474673217580) Thanks [@TimNooren](https://github.com/TimNooren)! - Show API key URL in non-interactive login error message
+
+- [#117](https://github.com/nansen-ai/nansen-cli/pull/117) [`55ad922`](https://github.com/nansen-ai/nansen-cli/commit/55ad922826a7a2411889edeede42fbfc7b70d7a5) Thanks [@TimNooren](https://github.com/TimNooren)! - Add --wallet and WalletConnect documentation to `nansen trade help` output
+
 ## 1.9.1
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nansen-cli",
-  "version": "1.9.1",
+  "version": "1.9.3",
   "description": "Command-line interface for Nansen API - designed for AI agents",
   "main": "src/index.js",
   "type": "module",
@@ -18,7 +18,7 @@
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
     "test:live": "NANSEN_LIVE_TEST=1 vitest run",
-    "test:swap": "vitest run --config vitest.e2e.config.js",
+    "test:trade": "vitest run --config vitest.e2e.config.js",
     "changeset": "changeset",
     "changeset:version": "changeset version",
     "changeset:publish": "changeset publish"

package/src/cli.js

@@ -858,7 +858,7 @@ export function buildCommands(deps = {}) {
           // Non-interactive mode: check env var fallback
           apiKey = process.env.NANSEN_API_KEY;
           if (!apiKey) {
-            log('❌ No API key provided. Use: nansen login --api-key <key>\n   Or set NANSEN_API_KEY environment variable.');
+            log('❌ No API key provided. Use: nansen login --api-key <key>\n   Or set NANSEN_API_KEY environment variable.\n   Get your API key at: https://app.nansen.ai/api');
             exit(1);
             return;
           }
@@ -1316,14 +1316,19 @@ SUBCOMMANDS:
   execute     Sign and broadcast a quoted swap
 
 USAGE:
-  nansen trade quote --chain <chain> --from <token> --to <token> --amount <units>
-  nansen trade execute --quote <quoteId>
+  nansen trade quote --chain <chain> --from <token> --to <token> --amount <units> [--wallet <name>]
+  nansen trade execute --quote <quoteId> [--wallet <name>]
 
 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 quote --chain base --from ETH --to USDC --amount 1000000000000000000 --wallet walletconnect
   nansen trade execute --quote 1708900000000-abc123
 
+WALLET:
+  --wallet <name>   Use a named wallet, or "walletconnect" / "wc" for WalletConnect (EVM only).
+                    Defaults to the default local wallet if omitted.
+
 SYMBOLS:
   Common tokens resolve automatically: SOL, ETH, BNB, USDC, USDT, WETH, WBNB
   Raw addresses are also accepted.`);

package/src/trading.js

@@ -742,7 +742,7 @@ export function validateBaseUnitAmount(amount) {
   return null;
 }
 
-function formatQuote(quote, index) {
+export function formatQuote(quote, index) {
   const lines = [];
   const label = index !== undefined ? `  Quote #${index + 1}` : '  Best Quote';
   lines.push(`${label} (${quote.aggregator || 'unknown'})`);
@@ -750,10 +750,21 @@ function formatQuote(quote, index) {
   lines.push(`    Output:       ${quote.outAmount} → ${quote.outputMint?.slice(0, 12)}...`);
   if (quote.inUsdValue)  lines.push(`    In USD:       $${quote.inUsdValue}`);
   if (quote.outUsdValue) lines.push(`    Out USD:      $${quote.outUsdValue}`);
-  if (quote.priceImpactPct) lines.push(`    Price Impact: ${quote.priceImpactPct}%`);
+  if (quote.priceImpactPct) {
+    const impactAbs = Math.abs(parseFloat(quote.priceImpactPct));
+    if (impactAbs <= 5) {
+      lines.push(`    Price Impact: ${impactAbs}%`);
+    }
+  }
   if (quote.tradingFeeInUsd) lines.push(`    Trading Fee:  $${quote.tradingFeeInUsd}`);
   if (quote.networkFeeInUsd) lines.push(`    Network Fee:  $${quote.networkFeeInUsd}`);
   if (quote.approvalAddress && !isNativeToken(quote.inputMint)) lines.push(`    ⚠ Requires token approval to: ${quote.approvalAddress}`);
+  if (quote.priceImpactPct) {
+    const impactAbs = Math.abs(parseFloat(quote.priceImpactPct));
+    if (impactAbs > 5) {
+      lines.push(`    ⚠ Price impact is ${impactAbs}%! You may lose significant value.`);
+    }
+  }
   return lines.join('\n');
 }
 
@@ -781,7 +792,7 @@ export function buildTradingCommands(deps = {}) {
 
       if (!chain || !from || !to || !amount) {
         errorOutput(`
-Usage: nansen quote --chain <chain> --from <token> --to <token> --amount <baseUnits>
+Usage: nansen trade quote --chain <chain> --from <token> --to <token> --amount <baseUnits>
 
 OPTIONS:
   --chain <chain>           Chain: solana, ethereum, base, bsc
@@ -795,9 +806,9 @@ OPTIONS:
   --swap-mode <mode>        exactIn (default) or exactOut
 
 EXAMPLES:
-  nansen quote --chain solana --from SOL --to USDC --amount 1000000000
-  nansen quote --chain base --from ETH --to USDC --amount 1000000000000000000
-  nansen quote --chain solana --from So11111111111111111111111111111111111111112 --to EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --amount 1000000000
+  nansen trade quote --chain solana --from SOL --to USDC --amount 1000000000
+  nansen trade quote --chain base --from ETH --to USDC --amount 1000000000000000000
+  nansen trade quote --chain solana --from So11111111111111111111111111111111111111112 --to EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --amount 1000000000
 `);
         exit(1);
         return;
@@ -877,6 +888,9 @@ EXAMPLES:
         const quoteId = saveQuote(response, chain, isWalletConnect ? 'walletconnect' : 'local');
         errorOutput(`\n  Quote ID: ${quoteId}`);
         errorOutput(`  Execute:  nansen trade execute --quote ${quoteId}`);
+        if (response.quotes.length > 1) {
+          errorOutput(`  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.`);