nansen-cli 1.27.1 → 1.29.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. 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)."
+              "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. Bridge providers (Li.Fi or Relay) are selected automatically based on best price. Sub-dollar swaps are supported via Relay."
             },
             "from": {
               "type": "string",
@@ -867,6 +880,10 @@
             "to-wallet": {
               "type": "string",
               "description": "Destination wallet address for cross-chain swaps. Auto-derived from wallet if omitted."
+            },
+            "aggregator": {
+              "type": "string",
+              "description": "Force a specific aggregator: lifi, relay, jupiter, or okx. Filters the returned quote list client-side; errors if no quote from that aggregator was returned."
             }
           },
           "prerequisites": [
@@ -884,11 +901,15 @@
             "wallet": {
               "type": "string",
               "description": "Wallet name, or \"walletconnect\"/\"wc\" for WalletConnect (EVM only)"
+            },
+            "gasless": {
+              "type": "boolean",
+              "description": "Relay-only: have Relay's solver pay gas + broadcast (user signs only). Requires the selected quote's aggregator to be \"relay\". Not supported via WalletConnect."
             }
           }
         },
         "bridge-status": {
-          "description": "Check cross-chain bridge transaction status",
+          "description": "Check cross-chain bridge transaction status. Aggregator (Li.Fi or Relay) is auto-detected from a local tx record saved at execute time (kept 30 days); pass --aggregator to override when polling from a different machine.",
           "options": {
             "tx-hash": {
               "type": "string",
@@ -904,6 +925,142 @@
               "type": "string",
               "required": true,
               "description": "Destination chain (solana or base)"
+            },
+            "aggregator": {
+              "type": "string",
+              "description": "lifi or relay. Overrides auto-detection — use when polling from a different machine or after the 30-day local record TTL has expired."
+            }
+          }
+        },
+        "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, '/');
 }
 
 /**