nansen-cli 1.4.0 → 1.5.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nansen-cli",
-  "version": "1.4.0",
+  "version": "1.5.1",
   "description": "Command-line interface for Nansen API - designed for AI agents",
   "main": "src/index.js",
   "type": "module",
@@ -34,12 +34,12 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/askeluv/nansen-cli.git"
+    "url": "git+https://github.com/nansen-ai/nansen-cli.git"
   },
   "bugs": {
-    "url": "https://github.com/askeluv/nansen-cli/issues"
+    "url": "https://github.com/nansen-ai/nansen-cli/issues"
   },
-  "homepage": "https://github.com/askeluv/nansen-cli#readme",
+  "homepage": "https://github.com/nansen-ai/nansen-cli#readme",
   "engines": {
     "node": ">=18.0.0"
   },

package/src/api.js

@@ -19,6 +19,7 @@ export const ErrorCode = {
   UNAUTHORIZED: 'UNAUTHORIZED',           // 401 - Invalid or missing API key
   FORBIDDEN: 'FORBIDDEN',                 // 403 - Valid key but insufficient permissions
   CREDITS_EXHAUSTED: 'CREDITS_EXHAUSTED', // 403 - Insufficient API credits
+  PAYMENT_REQUIRED: 'PAYMENT_REQUIRED',   // 402 - x402 payment required
   
   // Rate Limiting
   RATE_LIMITED: 'RATE_LIMITED',           // 429 - Too many requests
@@ -87,6 +88,8 @@ function statusToErrorCode(status, data = {}) {
       return ErrorCode.INVALID_PARAMS;
     case 401:
       return ErrorCode.UNAUTHORIZED;
+    case 402:
+      return ErrorCode.PAYMENT_REQUIRED;
     case 403:
       if (messageLower.includes('credit') || messageLower.includes('insufficient')) return ErrorCode.CREDITS_EXHAUSTED;
       return ErrorCode.FORBIDDEN;
@@ -382,13 +385,7 @@ function parseRetryAfter(headerValue) {
 
 export class NansenAPI {
   constructor(apiKey = config.apiKey, baseUrl = config.baseUrl, options = {}) {
-    if (!apiKey) {
-      throw new NansenError(
-        'API key required. Run `nansen login` or set NANSEN_API_KEY environment variable.',
-        ErrorCode.UNAUTHORIZED
-      );
-    }
-    this.apiKey = apiKey;
+    this.apiKey = apiKey || null;
     this.baseUrl = baseUrl;
     this.retryOptions = { ...DEFAULT_RETRY_OPTIONS, ...options.retry };
     this.cacheOptions = { 
@@ -431,7 +428,7 @@ export class NansenAPI {
           method: 'POST',
           headers: {
             'Content-Type': 'application/json',
-            'apikey': this.apiKey,
+            ...(this.apiKey ? { 'apikey': this.apiKey } : {}),
             ...options.headers
           },
           body: JSON.stringify(NansenAPI.cleanBody(body))
@@ -484,6 +481,16 @@ export class NansenAPI {
           message = message.replace(/\.+$/, '') + '. This filter is not supported for this token/chain combination. Do not retry.';
         } 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) {
+          message = 'Payment required (x402). This endpoint requires on-chain payment.';
+          const paymentHeader = response.headers.get('payment-required');
+          if (paymentHeader) {
+            try {
+              data.paymentRequirements = JSON.parse(atob(paymentHeader));
+            } catch {
+              data.paymentRequiredRaw = paymentHeader;
+            }
+          }
         }
 
         lastError = new NansenError(message, code, response.status, {

package/src/cli.js

@@ -1181,16 +1181,26 @@ export function buildCommands(deps = {}) {
       const handlers = {
         'info': () => apiInstance.tokenInformation({ tokenAddress, chain, timeframe }),
         'screener': async () => {
-          const result = await apiInstance.tokenScreener({ chains, timeframe, filters, orderBy, pagination });
-          // Client-side search filter (API doesn't support server-side search)
           const search = options.search;
-          if (search && result?.data) {
+          // When searching, fetch more results to filter from (API has no server-side search)
+          const searchPagination = search 
+            ? { page: 1, per_page: Math.max(500, pagination?.per_page || 0) }
+            : pagination;
+          const result = await apiInstance.tokenScreener({ chains, timeframe, filters, orderBy, pagination: searchPagination });
+          if (search) {
             const q = search.toLowerCase();
-            const filtered = result.data.filter(t => 
+            const requestedLimit = pagination?.per_page || 100;
+            const filterArr = (arr) => arr.filter(t => 
               (t.token_symbol && t.token_symbol.toLowerCase().includes(q)) ||
-              (t.token_name && t.token_name.toLowerCase().includes(q))
-            );
-            return { ...result, data: filtered };
+              (t.token_name && t.token_name.toLowerCase().includes(q)) ||
+              (t.token_address && t.token_address.toLowerCase() === q)
+            ).slice(0, requestedLimit);
+            // Handle nested response shapes: {data: [...]} or {data: {data: [...]}}
+            if (Array.isArray(result?.data)) {
+              return { ...result, data: filterArr(result.data) };
+            } else if (result?.data?.data && Array.isArray(result.data.data)) {
+              return { ...result, data: { ...result.data, data: filterArr(result.data.data) } };
+            }
           }
           return result;
         },