nansen-cli 1.27.0 → 1.28.0

package/src/privy.js

@@ -125,6 +125,15 @@ export class PrivyClient {
     });
   }
 
+  async signSolanaMessage(walletId, messageBuffer) {
+    const messageBase64 = Buffer.from(messageBuffer).toString('base64');
+    return this._request("POST", `/wallets/${walletId}/rpc`, {
+      method: "signMessage",
+      chain_type: "solana",
+      params: { message: messageBase64, encoding: "base64" },
+    });
+  }
+
 }
 
 // ============= Helpers =============

package/src/schema.json

@@ -500,6 +500,19 @@
                   "default": true
                 }
               }
+            },
+            "top-tokens": {
+              "endpoint": "/api/v1/nansen-score/top-tokens",
+              "description": "Top tokens ranked by Nansen Score (public endpoint, any authenticated API key)",
+              "options": {
+                "market-cap": {
+                  "description": "Filter by market cap group",
+                  "enum": ["lowcap", "midcap", "largecap"]
+                },
+                "limit": {
+                  "default": 25
+                }
+              }
             }
           },
           "description": "Token God Mode - deep analytics for any token"
@@ -839,7 +852,7 @@
             },
             "to-chain": {
               "type": "string",
-              "description": "Destination blockchain for cross-chain swap (solana or base). Omit for same-chain."
+              "description": "Destination blockchain for cross-chain swap (solana or base). Omit for same-chain. At least one side must be USDC or a native token (ETH, SOL). Non-native to non-native is not supported — swap to USDC first, then bridge. Minimum ~$5 per cross-chain trade (Li.Fi bridge)."
             },
             "from": {
               "type": "string",
@@ -906,6 +919,138 @@
               "description": "Destination chain (solana or base)"
             }
           }
+        },
+        "limit-order": {
+          "description": "Limit order management (Solana only)",
+          "subcommands": {
+            "create": {
+              "description": "Place a new limit order",
+              "options": {
+                "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 in base units (e.g. lamports)"
+                },
+                "trigger-price": {
+                  "type": "number",
+                  "required": true,
+                  "description": "Trigger price in USD"
+                },
+                "trigger-condition": {
+                  "type": "string",
+                  "required": true,
+                  "description": "Trigger when price is 'above' or 'below' target"
+                },
+                "trigger-mint": {
+                  "type": "string",
+                  "required": true,
+                  "description": "Token whose price triggers the order (e.g. SOL)"
+                },
+                "slippage-bps": {
+                  "type": "number",
+                  "description": "Slippage tolerance in basis points (e.g. 50 = 0.5%)"
+                },
+                "expires": {
+                  "type": "string",
+                  "default": "30d",
+                  "description": "Expiry duration (e.g. 24h, 7d, 30d) or epoch ms"
+                },
+                "wallet": {
+                  "type": "string",
+                  "description": "Wallet name (or \"walletconnect\"/\"wc\")"
+                }
+              },
+              "chains": ["solana"],
+              "prerequisites": [
+                "A Solana wallet must be configured. Run: nansen wallet create"
+              ]
+            },
+            "list": {
+              "description": "List your limit orders",
+              "options": {
+                "state": {
+                  "type": "string",
+                  "description": "Filter by state (active, past)"
+                },
+                "mint": {
+                  "type": "string",
+                  "description": "Filter by token mint address"
+                },
+                "limit": {
+                  "type": "number",
+                  "default": 20,
+                  "description": "Max results per page"
+                },
+                "offset": {
+                  "type": "number",
+                  "default": 0,
+                  "description": "Pagination offset"
+                },
+                "sort": {
+                  "type": "string",
+                  "description": "Sort field"
+                },
+                "dir": {
+                  "type": "string",
+                  "default": "desc",
+                  "description": "Sort direction (asc or desc)"
+                },
+                "wallet": {
+                  "type": "string",
+                  "description": "Wallet name (or \"walletconnect\"/\"wc\")"
+                }
+              },
+              "chains": ["solana"]
+            },
+            "cancel": {
+              "description": "Cancel an open limit order",
+              "options": {
+                "order": {
+                  "type": "string",
+                  "required": true,
+                  "description": "Order ID to cancel"
+                },
+                "wallet": {
+                  "type": "string",
+                  "description": "Wallet name (or \"walletconnect\"/\"wc\")"
+                }
+              },
+              "chains": ["solana"]
+            },
+            "update": {
+              "description": "Update trigger price or slippage on an existing order",
+              "options": {
+                "order": {
+                  "type": "string",
+                  "required": true,
+                  "description": "Order ID to update"
+                },
+                "trigger-price": {
+                  "type": "number",
+                  "description": "New trigger price in USD"
+                },
+                "slippage-bps": {
+                  "type": "number",
+                  "description": "New slippage in basis points (0-10000)"
+                },
+                "wallet": {
+                  "type": "string",
+                  "description": "Wallet name (or \"walletconnect\"/\"wc\")"
+                }
+              },
+              "chains": ["solana"]
+            }
+          }
         }
       }
     },

package/src/telemetry.js

@@ -158,9 +158,13 @@ function buildContext() {
 
 /**
  * Convert a command string like "smart-money netflow" to a path like "/smart-money/netflow".
+ * Agent ("agent …") always maps to "/agent" so prompts are not exploded into path segments.
  */
 function commandToPath(command) {
-  return '/' + command.replace(/\s+/g, '/');
+  if (typeof command === 'string' && /^agent(?:\s+|$)/.test(command.trimStart())) {
+    return '/agent';
+  }
+  return '/' + String(command).replace(/\s+/g, '/');
 }
 
 /**

package/src/trading.js

@@ -994,6 +994,16 @@ EXAMPLES:
   nansen trade quote --chain base --from ETH --to USDC --amount 1000000000000000000
   nansen trade quote --chain base --to-chain solana --from USDC --to USDC --amount 1000000
   nansen trade quote --chain solana --to-chain base --from SOL --to ETH --amount 1000000000
+
+CROSS-CHAIN NOTES (when using --to-chain):
+  Supported combos:
+    native → native (ETH <-> SOL) — requires $5+ per trade
+    USDC → USDC (both directions)
+    USDC → native (USDC → ETH or SOL)
+    native → USDC (ETH/SOL → USDC)
+    non-native → non-native — not supported (use USDC as intermediate)
+  Bridge provider: Li.Fi
+  Typical bridge time: 1-5 minutes
 `, 'MISSING_ARGS');
       }
 
@@ -1157,6 +1167,10 @@ EXAMPLES:
         };
         if (isCrossChain) {
           params.toChainIndex = toChainConfig.index;
+          // Opt out of Relay aggregator: CLI bypasses backend /execute so the
+          // Redis aggregator hint is never set, and /bridge/status defaults to
+          // LiFi — polling a Relay txHash there returns NOT_FOUND.
+          params.disabledAggregators = 'relay';
           if (toWallet) {
             params.toWalletAddress = toWallet;
             log(`  Destination wallet: ${toWallet}`);

package/src/transfer.js

@@ -302,7 +302,7 @@ function modPowBig(base, exp, mod) {
   return result;
 }
 
-async function getTokenInfo(rpcUrl, mint) {
+export async function getTokenInfo(rpcUrl, mint) {
   // Get mint account to determine token program and decimals
   const info = await rpcCall(rpcUrl, 'getAccountInfo', [mint, { encoding: 'jsonParsed' }]);
   if (!info || !info.value) throw new Error(`Token mint ${mint} not found`);

package/src/walletconnect-trading.js

@@ -9,6 +9,7 @@
  */
 
 import { wcExec } from './walletconnect-exec.js';
+import { base58Encode } from './wallet.js';
 
 const SOLANA_MAINNET_CHAIN = 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp';
 
@@ -153,3 +154,27 @@ export async function sendSolanaTransactionViaWalletConnect(txBase58, timeoutMs
 
   throw new Error('Unexpected response from walletconnect Solana sign');
 }
+
+/**
+ * Sign a Solana message via WalletConnect.
+ *
+ * Used for challenge-response authentication (e.g., Jupiter Limit Order V2).
+ * Returns the raw Ed25519 signature as base58.
+ *
+ * @param {Buffer} messageBuffer - Raw message bytes to sign
+ * @param {number} [timeoutMs=120000] - Timeout for user approval
+ * @returns {{ signature: string }} Base58-encoded signature
+ */
+export async function signSolanaMessageViaWalletConnect(messageBuffer, timeoutMs = 120000) {
+  const payload = {
+    message: base58Encode(messageBuffer),
+    chainId: SOLANA_MAINNET_CHAIN,
+  };
+
+  const output = await wcExec('walletconnect', ['sign-message', JSON.stringify(payload)], timeoutMs);
+  const result = parseWcJson(output);
+
+  if (result.signature) return { signature: result.signature };
+
+  throw new Error('Unexpected response from walletconnect sign-message');
+}