nansen-cli 1.7.0 → 1.9.0

package/src/api.js

@@ -391,6 +391,17 @@ function parseRetryAfter(headerValue) {
   return null;
 }
 
+/**
+ * Build a date range from today back N days
+ * @param {number} days - Number of days back from today
+ * @returns {{from: string, to: string}} Date range with YYYY-MM-DD strings
+ */
+export function buildDateRange(days) {
+  const to = new Date().toISOString().split('T')[0];
+  const from = new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString().split('T')[0];
+  return { from, to };
+}
+
 export class NansenAPI {
   constructor(apiKey = config.apiKey, baseUrl = config.baseUrl, options = {}) {
     this.apiKey = apiKey || null;
@@ -494,8 +505,11 @@ export class NansenAPI {
         } else if (code === ErrorCode.CREDITS_EXHAUSTED) {
           message = message.replace(/\.+$/, '') + '. No retry will help. Check your Nansen dashboard for credit balance.';
         } else if (code === ErrorCode.PAYMENT_REQUIRED) {
-          // Try x402 auto-payment with fallback across payment networks
-          if (!this.defaultHeaders['Payment-Signature']) {
+          // Try x402 auto-payment: local wallet (with network fallback), then WalletConnect
+          const hasManualSignature = !!(this.defaultHeaders['Payment-Signature'] || options.headers?.['Payment-Signature']);
+
+          if (!hasManualSignature) {
+            // 1. Try local wallet with fallback across payment networks
             try {
               const { createPaymentSignatures } = await import('./x402.js');
               for await (const { signature, network } of createPaymentSignatures(response, url)) {
@@ -526,17 +540,54 @@ export class NansenAPI {
                 }
                 // This payment option was rejected, try next
               }
-            } catch { /* x402 auto-pay unavailable, fall through */ }
-          }
-          message = 'Payment required. To access this endpoint:\n  • Set an API key: nansen login --api-key <key>  (get one at https://app.nansen.ai/api)\n  • Or pay per call: nansen wallet create, fund with USDC on Base or Solana (from $0.01/call, min $0.05 balance)\n  • Docs: https://docs.x402.org';
-          const paymentHeader = response.headers.get('payment-required');
-          if (paymentHeader) {
-            try {
-              data.paymentRequirements = JSON.parse(atob(paymentHeader));
-            } catch {
-              data.paymentRequiredRaw = paymentHeader;
+            } catch { /* local wallet unavailable, try WalletConnect */ }
+
+            // 2. Fall back to WalletConnect (walletconnect-x402.js)
+            // (local wallet returns early on success above, so we always reach here if it failed)
+            {
+              let paymentRequirements;
+              const paymentHeader = response.headers.get('payment-required');
+              if (paymentHeader) {
+                try {
+                  paymentRequirements = JSON.parse(atob(paymentHeader));
+                } catch {
+                  data.paymentRequiredRaw = paymentHeader;
+                }
+              }
+              if (!paymentRequirements && data.paymentRequirements) {
+                paymentRequirements = data.paymentRequirements;
+              }
+
+              if (paymentRequirements) {
+                try {
+                  const { handleX402Payment } = await import('./walletconnect-x402.js');
+                  const paymentSignature = await handleX402Payment(paymentRequirements);
+                  const paidResponse = await fetch(url, {
+                    method: 'POST',
+                    headers: {
+                      'Content-Type': 'application/json',
+                      'X-Client-Type': 'nansen-cli',
+                      'X-Client-Version': packageVersion,
+                      'Payment-Signature': paymentSignature,
+                      ...this.defaultHeaders,
+                      ...options.headers,
+                    },
+                    body: JSON.stringify(NansenAPI.cleanBody(body)),
+                  });
+                  if (paidResponse.ok) {
+                    return await paidResponse.json();
+                  }
+                } catch (x402Err) {
+                  message = `x402 auto-payment failed: ${x402Err.message}`;
+                }
+                data.paymentRequirements = paymentRequirements;
+              }
             }
           }
+
+          if (!message || message === data.message) {
+            message = 'Payment required (x402). Sign the paymentRequirements below per https://docs.x402.org and pass the result with --x402-payment-signature <value>.';
+          }
         }
 
         lastError = new NansenError(message, code, response.status, {
@@ -624,11 +675,9 @@ export class NansenAPI {
 
   async smartMoneyHistoricalHoldings(params = {}) {
     const { chains = ['solana'], filters = {}, orderBy, pagination, days = 30 } = params;
-    const to = new Date().toISOString().split('T')[0];
-    const from = new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString().split('T')[0];
     return this.request('/api/v1/smart-money/historical-holdings', {
       chains,
-      date_range: { from, to },
+      date_range: buildDateRange(days),
       filters,
       order_by: orderBy,
       pagination
@@ -671,11 +720,7 @@ export class NansenAPI {
       const validation = validateAddress(address, chain);
       if (!validation.valid) throw new NansenError(validation.error, validation.code);
     }
-    const dateRange = date || (() => {
-      const to = new Date().toISOString().split('T')[0];
-      const from = new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString().split('T')[0];
-      return { from, to };
-    })();
+    const dateRange = date || buildDateRange(days);
     return this.request('/api/v1/profiler/address/transactions', {
       address,
       chain,
@@ -692,13 +737,7 @@ export class NansenAPI {
       const validation = validateAddress(address, chain);
       if (!validation.valid) throw new NansenError(validation.error, validation.code);
     }
-    // Build date range
-    let dateRange = date;
-    if (!dateRange) {
-      const to = new Date().toISOString().split('T')[0];
-      const from = new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString().split('T')[0];
-      dateRange = { from, to };
-    }
+    const dateRange = date || buildDateRange(days);
     return this.request('/api/v1/profiler/address/pnl', {
       address,
       chain,
@@ -734,12 +773,10 @@ export class NansenAPI {
       const validation = validateAddress(address, chain);
       if (!validation.valid) throw new NansenError(validation.error, validation.code);
     }
-    const to = new Date().toISOString().split('T')[0];
-    const from = new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString().split('T')[0];
     return this.request('/api/v1/profiler/address/historical-balances', {
       address,
       chain,
-      date: { from, to },
+      date: buildDateRange(days),
       filters,
       order_by: orderBy,
       pagination
@@ -766,12 +803,10 @@ export class NansenAPI {
       const validation = validateAddress(address, chain);
       if (!validation.valid) throw new NansenError(validation.error, validation.code);
     }
-    const to = new Date().toISOString().split('T')[0];
-    const from = new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString().split('T')[0];
     return this.request('/api/v1/profiler/address/counterparties', {
       address,
       chain,
-      date: { from, to },
+      date: buildDateRange(days),
       filters,
       order_by: orderBy,
       pagination
@@ -784,12 +819,10 @@ export class NansenAPI {
       const validation = validateAddress(address, chain);
       if (!validation.valid) throw new NansenError(validation.error, validation.code);
     }
-    const to = new Date().toISOString().split('T')[0];
-    const from = new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString().split('T')[0];
     return this.request('/api/v1/profiler/address/pnl-summary', {
       address,
       chain,
-      date: { from, to },
+      date: buildDateRange(days),
       order_by: orderBy,
       pagination
     });
@@ -808,11 +841,9 @@ export class NansenAPI {
 
   async addressPerpTrades(params = {}) {
     const { address, filters = {}, orderBy, pagination, days = 30 } = params;
-    const to = new Date().toISOString().split('T')[0];
-    const from = new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString().split('T')[0];
     return this.request('/api/v1/profiler/perp-trades', {
       address,
-      date: { from, to },
+      date: buildDateRange(days),
       filters,
       order_by: orderBy,
       pagination
@@ -854,11 +885,7 @@ export class NansenAPI {
       const validation = validateTokenAddress(tokenAddress, chain);
       if (!validation.valid) throw new NansenError(validation.error, validation.code);
     }
-    const dateRange = date || (() => {
-      const to = new Date().toISOString().split('T')[0];
-      const from = new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString().split('T')[0];
-      return { from, to };
-    })();
+    const dateRange = date || buildDateRange(days);
     return this.request('/api/v1/tgm/flows', {
       token_address: tokenAddress,
       chain,
@@ -875,9 +902,6 @@ export class NansenAPI {
       const validation = validateTokenAddress(tokenAddress, chain);
       if (!validation.valid) throw new NansenError(validation.error, validation.code);
     }
-    const to = new Date().toISOString().split('T')[0];
-    const from = new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString().split('T')[0];
-    
     // Apply smart money filter via filters object
     if (onlySmartMoney) {
       filters.include_smart_money_labels = filters.include_smart_money_labels || 
@@ -887,7 +911,7 @@ export class NansenAPI {
     return this.request('/api/v1/tgm/dex-trades', {
       token_address: tokenAddress,
       chain,
-      date: { from, to },
+      date: buildDateRange(days),
       filters,
       order_by: orderBy,
       pagination
@@ -900,12 +924,10 @@ export class NansenAPI {
       const validation = validateTokenAddress(tokenAddress, chain);
       if (!validation.valid) throw new NansenError(validation.error, validation.code);
     }
-    const to = new Date().toISOString().split('T')[0];
-    const from = new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString().split('T')[0];
     return this.request('/api/v1/tgm/pnl-leaderboard', {
       token_address: tokenAddress,
       chain,
-      date: { from, to },
+      date: buildDateRange(days),
       filters,
       order_by: orderBy,
       pagination
@@ -918,11 +940,7 @@ export class NansenAPI {
       const validation = validateTokenAddress(tokenAddress, chain);
       if (!validation.valid) throw new NansenError(validation.error, validation.code);
     }
-    const dateRange = date || (() => {
-      const to = new Date().toISOString().split('T')[0];
-      const from = new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString().split('T')[0];
-      return { from, to };
-    })();
+    const dateRange = date || buildDateRange(days);
     return this.request('/api/v1/tgm/who-bought-sold', {
       token_address: tokenAddress,
       chain,
@@ -951,12 +969,10 @@ export class NansenAPI {
       const validation = validateTokenAddress(tokenAddress, chain);
       if (!validation.valid) throw new NansenError(validation.error, validation.code);
     }
-    const to = new Date().toISOString().split('T')[0];
-    const from = new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString().split('T')[0];
     return this.request('/api/v1/tgm/transfers', {
       token_address: tokenAddress,
       chain,
-      date: { from, to },
+      date: buildDateRange(days),
       filters,
       order_by: orderBy,
       pagination
@@ -980,11 +996,9 @@ export class NansenAPI {
 
   async tokenPerpTrades(params = {}) {
     const { tokenSymbol, filters = {}, orderBy, pagination, days = 30 } = params;
-    const to = new Date().toISOString().split('T')[0];
-    const from = new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString().split('T')[0];
     return this.request('/api/v1/tgm/perp-trades', {
       token_symbol: tokenSymbol,
-      date: { from, to },
+      date: buildDateRange(days),
       filters,
       order_by: orderBy,
       pagination
@@ -1003,11 +1017,9 @@ export class NansenAPI {
 
   async tokenPerpPnlLeaderboard(params = {}) {
     const { tokenSymbol, filters = {}, orderBy, pagination, days = 30 } = params;
-    const to = new Date().toISOString().split('T')[0];
-    const from = new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString().split('T')[0];
     return this.request('/api/v1/tgm/perp-pnl-leaderboard', {
       token_symbol: tokenSymbol,
-      date: { from, to },
+      date: buildDateRange(days),
       filters,
       order_by: orderBy,
       pagination
@@ -1026,6 +1038,20 @@ export class NansenAPI {
     });
   }
 
+  async tokenOhlcv(params = {}) {
+    const { tokenAddress, chain = 'solana', timeframe, pagination } = params;
+    if (tokenAddress) {
+      const validation = validateTokenAddress(tokenAddress, chain);
+      if (!validation.valid) throw new NansenError(validation.error, validation.code);
+    }
+    return this.request('/api/v1/tgm/token-ohlcv', {
+      token_address: tokenAddress,
+      chain,
+      timeframe,
+      pagination
+    });
+  }
+
   async tokenInformation(params = {}) {
     const { tokenAddress, chain = 'solana', timeframe = '1d' } = params;
     if (tokenAddress) {
@@ -1043,10 +1069,8 @@ export class NansenAPI {
 
   async perpScreener(params = {}) {
     const { filters = {}, orderBy, pagination, days = 30 } = params;
-    const to = new Date().toISOString().split('T')[0];
-    const from = new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString().split('T')[0];
     return this.request('/api/v1/perp-screener', {
-      date: { from, to },
+      date: buildDateRange(days),
       filters,
       order_by: orderBy,
       pagination
@@ -1055,10 +1079,8 @@ export class NansenAPI {
 
   async perpLeaderboard(params = {}) {
     const { filters = {}, orderBy, pagination, days = 30 } = params;
-    const to = new Date().toISOString().split('T')[0];
-    const from = new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString().split('T')[0];
     return this.request('/api/v1/perp-leaderboard', {
-      date: { from, to },
+      date: buildDateRange(days),
       filters,
       order_by: orderBy,
       pagination

package/src/chain-ids.js

@@ -0,0 +1,19 @@
+/**
+ * Canonical EVM chain name → numeric chain ID mapping.
+ *
+ * Single source of truth — import from here instead of defining inline.
+ */
+
+export const EVM_CHAIN_IDS = {
+  ethereum: 1,
+  base: 8453,
+  optimism: 10,
+  arbitrum: 42161,
+  polygon: 137,
+  avalanche: 43114,
+  bnb: 56,
+  linea: 59144,
+  scroll: 534352,
+  zksync: 324,
+  mantle: 5000,
+};