nansen-cli 1.15.0 → 1.16.1

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 1.16.1
+
+### Patch Changes
+
+- [#249](https://github.com/nansen-ai/nansen-cli/pull/249) [`0c17437`](https://github.com/nansen-ai/nansen-cli/commit/0c17437cf65d8b4f0516ede386adefec57d8ab3d) Thanks [@0xlaveen](https://github.com/0xlaveen)! - Add `pm` to top-level COMMAND_ALIASES so `nansen pm <subcommand>` works (previously only `nansen research pm <subcommand>` resolved the alias)
+
+- [#244](https://github.com/nansen-ai/nansen-cli/pull/244) [`6427a9f`](https://github.com/nansen-ai/nansen-cli/commit/6427a9fdb7295dee94d7aed10cdb0164c46c7d73) Thanks [@Nicolai1205](https://github.com/Nicolai1205)! - Add 7 new agent skills: nansen-token-search, nansen-sm-trend, nansen-wallet-cluster, nansen-wallet-compare, nansen-token-indicators, nansen-cross-chain-flow, nansen-batch-wallet. All validated against live API.
+
+## 1.16.0
+
+### Minor Changes
+
+- [#196](https://github.com/nansen-ai/nansen-cli/pull/196) [`0c286c2`](https://github.com/nansen-ai/nansen-cli/commit/0c286c2d75f977894da8ff18a105aaf21f55f9f2) Thanks [@arein](https://github.com/arein)! - Add Solana WalletConnect support for trading (quote and execute). Solana wallets like Phantom and Solflare can now sign DEX swap transactions via WalletConnect v2.
+
 ## 1.15.0
 
 ### Minor Changes

package/package.json

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

package/src/cli.js

@@ -654,8 +654,8 @@ export async function compareWallets(api, params = {}) {
     shared_counterparties: sharedCpAddrs,
     shared_tokens: sharedTokens,
     balances: [
-      { address: addr1, total_usd: tokens1.reduce((sum, t) => sum + (t.balance_usd || 0), 0) },
-      { address: addr2, total_usd: tokens2.reduce((sum, t) => sum + (t.balance_usd || 0), 0) },
+      { address: addr1, total_usd: tokens1.reduce((sum, t) => sum + (t.value_usd ?? t.balance_usd ?? 0), 0) },
+      { address: addr2, total_usd: tokens2.reduce((sum, t) => sum + (t.value_usd ?? t.balance_usd ?? 0), 0) },
     ],
   };
 }
@@ -1240,6 +1240,9 @@ export function buildCommands(deps = {}) {
     },
 
     'prediction-market': async (args, apiInstance, flags, options) => {
+      if (Date.now() < new Date('2026-03-16T00:00:00Z').getTime()) {
+        process.stderr.write('⚠️  PnL data for prediction markets is temporarily unavailable while we improve accuracy. We\'ll update once resolved.\n');
+      }
       const subcommand = args[0] || 'help';
       const marketId = options['market-id'];
       const address = options.address;
@@ -1345,7 +1348,8 @@ export const COMMAND_ALIASES = {
   'tgm': 'token',           // Token God Mode
   'sm': 'smart-money',      // Smart Money
   'prof': 'profiler',       // Profiler
-  'port': 'portfolio'       // Portfolio
+  'port': 'portfolio',      // Portfolio
+  'pm': 'prediction-market' // Prediction Market
 };
 
 // Aliases used inside the 'research' namespace

package/src/trading.js

@@ -8,10 +8,10 @@
 import crypto from 'crypto';
 import fs from 'fs';
 import path from 'path';
-import { exportWallet, getWalletConfig, showWallet, listWallets } from './wallet.js';
+import { base58Encode, exportWallet, getWalletConfig, showWallet, listWallets } from './wallet.js';
 import { base58Decode } from './transfer.js';
 import { keccak256, signSecp256k1, rlpEncode } from './crypto.js';
-import { getWalletConnectAddress, sendTransactionViaWalletConnect, sendApprovalViaWalletConnect } from './walletconnect-trading.js';
+import { getWalletConnectAddress, sendTransactionViaWalletConnect, sendSolanaTransactionViaWalletConnect, sendApprovalViaWalletConnect } from './walletconnect-trading.js';
 import { retrievePassword } from './keychain.js';
 
 // ============= Constants =============
@@ -746,7 +746,7 @@ OPTIONS:
   --from <symbol|address>   Input token (symbol like SOL, USDC or address)
   --to <symbol|address>     Output token (symbol like USDC, ETH or address)
   --amount <units>          Amount in BASE UNITS (e.g. lamports, wei)
-  --wallet <name>           Wallet name (default: default wallet). Use "walletconnect" or "wc" for WalletConnect (EVM only).
+  --wallet <name>           Wallet name (default: default wallet). Use "walletconnect" or "wc" for WalletConnect.
   --slippage <pct>          Slippage as decimal (e.g. 0.03 for 3%). Default: 0.03
   --auto-slippage           Enable auto slippage calculation
   --max-auto-slippage <pct> Max auto slippage when auto-slippage enabled
@@ -778,12 +778,7 @@ EXAMPLES:
         let walletProvider = 'local';
         let privyWalletIds = null;
         if (isWalletConnect) {
-          if (chainType !== 'evm') {
-            log('WalletConnect is only supported for EVM chains');
-            exit(1);
-            return;
-          }
-          walletAddress = await getWalletConnectAddress();
+          walletAddress = await getWalletConnectAddress(chainType);
           if (!walletAddress) {
             log('No WalletConnect session active. Run: walletconnect connect');
             exit(1);
@@ -970,12 +965,7 @@ EXAMPLES:
           exported = exportWallet(effectiveWalletName, password);
         } else {
           // Verify WalletConnect session is still active and address matches quote
-          if (chainType !== 'evm') {
-            log('WalletConnect is only supported for EVM chains');
-            exit(1);
-            return;
-          }
-          const wcAddress = await getWalletConnectAddress();
+          const wcAddress = await getWalletConnectAddress(chainType);
           if (!wcAddress) {
             log('No WalletConnect session active. Run: walletconnect connect');
             exit(1);
@@ -984,7 +974,9 @@ EXAMPLES:
           // Check address matches the one used during quoting
           const quoteWallet = quoteData.response?.quotes?.[0]?.transaction?.from
             || quoteData.response?.metadata?.userWalletAddress;
-          if (quoteWallet && wcAddress.toLowerCase() !== quoteWallet.toLowerCase()) {
+          if (quoteWallet && (chainType === 'solana'
+            ? wcAddress.trim() !== quoteWallet.trim()
+            : wcAddress.toLowerCase().trim() !== quoteWallet.toLowerCase().trim())) {
             log(`Connected wallet (${wcAddress}) doesn't match quote. Get a new quote with --wallet walletconnect`);
             exit(1);
             return;
@@ -1176,13 +1168,55 @@ EXAMPLES:
               if (typeof txBase64 === 'object' && txBase64.data) {
                 txBase64 = base58Decode(txBase64.data).toString('base64');
               }
-              log('  Signing Solana transaction...');
-              signedTransaction = signSolanaTransaction(txBase64, exported.solana.privateKey);
+
+              if (isWalletConnect) {
+                // Solana via WalletConnect: convert base64 → base58 for WC protocol
+                log('  Signing Solana transaction via WalletConnect...');
+                let txBase58;
+                try {
+                  txBase58 = base58Encode(Buffer.from(txBase64, 'base64'));
+                } catch (err) {
+                  throw new Error(`Failed to encode transaction for WalletConnect: ${err.message}`, { cause: err });
+                }
+                const wcResult = await sendSolanaTransactionViaWalletConnect(txBase58);
+
+                if (wcResult.signedTransaction) {
+                  signedTransaction = base58Decode(wcResult.signedTransaction).toString('base64');
+                } else if (wcResult.signature) {
+                  // Wallet returned raw Ed25519 sig → inject into unsigned tx
+                  let sigBytes;
+                  try {
+                    sigBytes = base58Decode(wcResult.signature);
+                  } catch (err) {
+                    throw new Error(`Invalid base58 signature from WalletConnect: ${err.message}`, { cause: err });
+                  }
+                  if (sigBytes.length !== 64) {
+                    throw new Error(`Invalid Ed25519 signature length: expected 64 bytes, got ${sigBytes.length}`);
+                  }
+                  // Buffer.from() creates a new buffer — safe to mutate in-place
+                  const txBytes = Buffer.from(txBase64, 'base64');
+                  const { value: sigCount, size: sigCountSize } = readCompactU16(txBytes, 0);
+                  if (sigCount < 1) {
+                    throw new Error('Transaction has no signature slots');
+                  }
+                  if (txBytes.length < sigCountSize + 64) {
+                    throw new Error(`Transaction buffer too small for signature: need ${sigCountSize + 64}, got ${txBytes.length}`);
+                  }
+                  // Inject into the first signature slot (feePayer)
+                  sigBytes.copy(txBytes, sigCountSize);
+                  signedTransaction = txBytes.toString('base64');
+                } else {
+                  throw new Error('WalletConnect returned neither signedTransaction nor signature');
+                }
+              } else {
+                log('  Signing Solana transaction...');
+                signedTransaction = signSolanaTransaction(txBase64, exported.solana.privateKey);
+              }
               requestId = currentQuote.metadata?.requestId;
 
             } else if (isWalletConnect) {
               // EVM via WalletConnect: wallet signs and may broadcast
-              const wcAddress = await getWalletConnectAddress();
+              const wcAddress = await getWalletConnectAddress(chainType);
               const isNative = isNativeToken(currentQuote.inputMint);
 
               // Validate transaction.value (same checks as local wallet)

package/src/transfer.js

@@ -703,7 +703,7 @@ export async function sendTokens({ to, amount, chain, token = null, wallet = nul
 
   if (walletconnect) {
     if (chain === 'solana') {
-      throw new Error('WalletConnect is only supported for EVM chains');
+      throw new Error('WalletConnect Solana transfers are not yet supported. Use a local wallet for Solana transfers.');
     }
     return sendTokensViaWalletConnect({ to, amount, chain, token, max, dryRun });
   }

package/src/walletconnect-trading.js

@@ -5,21 +5,62 @@
  * (hardware wallets, mobile wallets) instead of local key storage.
  * Uses the walletconnect CLI binary (subprocess-based, same as x402).
  *
- * EVM only — Solana via WalletConnect is not supported.
+ * Supports EVM chains and Solana (trading only).
  */
 
 import { wcExec } from './walletconnect-exec.js';
 
+const SOLANA_MAINNET_CHAIN = 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp';
+
+/**
+ * Extract the first JSON line from walletconnect CLI output.
+ * The CLI may print status messages before the JSON result.
+ */
+function parseWcJson(output) {
+  const lines = output.split('\n');
+  const startIdx = lines.findIndex(l => l.trimStart().startsWith('{'));
+  if (startIdx === -1) throw new Error('No JSON output from walletconnect');
+
+  // Handle multi-line JSON: collect lines until braces balance
+  let braces = 0;
+  const jsonLines = [];
+  for (let i = startIdx; i < lines.length; i++) {
+    jsonLines.push(lines[i]);
+    for (const ch of lines[i]) {
+      if (ch === '{') braces++;
+      else if (ch === '}') braces--;
+    }
+    if (braces === 0) break;
+  }
+  return JSON.parse(jsonLines.join('\n'));
+}
+
 /**
  * Get the address of the connected WalletConnect wallet.
  * Returns the first account address, or null if not connected / binary missing.
+ *
+ * @param {string} [chainType] - Optional: 'evm' or 'solana'. Filters accounts by chain prefix.
+ *   No arg = first account (backward compat).
  */
-export async function getWalletConnectAddress() {
+export async function getWalletConnectAddress(chainType) {
   try {
     const output = await wcExec('walletconnect', ['whoami', '--json'], 3000);
     const data = JSON.parse(output);
     if (data.connected === false) return null;
-    return data.accounts?.[0]?.address || null;
+    const accounts = data.accounts || [];
+    if (!accounts.length) return null;
+
+    if (chainType === 'solana') {
+      // Match Solana mainnet only — reject devnet/testnet to prevent wrong-network trades
+      const solAccount = accounts.find(a => a.chain === SOLANA_MAINNET_CHAIN);
+      return solAccount?.address || null;
+    }
+    if (chainType === 'evm') {
+      const evmAccount = accounts.find(a => a.chain?.startsWith('eip155:'));
+      return evmAccount?.address || null;
+    }
+    // No filter — return first account address (backward compat)
+    return accounts[0]?.address || null;
   } catch {
     return null;
   }
@@ -50,13 +91,8 @@ export async function sendTransactionViaWalletConnect(txData, timeoutMs = 120000
   };
 
   const output = await wcExec('walletconnect', ['send-transaction', JSON.stringify(payload)], timeoutMs);
+  const result = parseWcJson(output);
 
-  // walletconnect may print status messages before the JSON line — extract JSON only
-  const jsonLine = output.split('\n').find(line => line.startsWith('{'));
-  if (!jsonLine) throw new Error('No JSON output from walletconnect send-transaction');
-  const result = JSON.parse(jsonLine);
-
-  // The CLI returns { transactionHash: "0x..." }
   if (result.transactionHash) return { txHash: result.transactionHash };
   if (result.txHash) return { txHash: result.txHash };
   if (result.signedTransaction) return { signedTransaction: result.signedTransaction };
@@ -89,3 +125,31 @@ export async function sendApprovalViaWalletConnect(tokenAddress, spenderAddress,
     chainId,
   });
 }
+
+/**
+ * Sign a Solana transaction via WalletConnect.
+ *
+ * The wallet signs the transaction and returns either:
+ * - { signedTransaction: "<base58>" } — full signed transaction
+ * - { signature: "<base58>" } — raw Ed25519 signature only
+ *
+ * @param {string} txBase58 - Base58-encoded Solana transaction
+ * @param {number} [timeoutMs=120000] - Timeout for user approval
+ * @returns {{ signedTransaction?: string, signature?: string }}
+ */
+export async function sendSolanaTransactionViaWalletConnect(txBase58, timeoutMs = 120000) {
+  const payload = {
+    transaction: txBase58,
+    chainId: SOLANA_MAINNET_CHAIN,
+  };
+
+  const output = await wcExec('walletconnect', ['send-transaction', JSON.stringify(payload)], timeoutMs);
+  const result = parseWcJson(output);
+
+  if (result.signedTransaction) return { signedTransaction: result.signedTransaction };
+  if (result.signature) return { signature: result.signature };
+  // Some wallets (e.g. Phantom) return 'transaction' instead of 'signedTransaction'
+  if (result.transaction) return { signedTransaction: result.transaction };
+
+  throw new Error('Unexpected response from walletconnect Solana sign');
+}