Merge pull request #12 from nansen-ai/repo-url-and-x402-handling

Update repo URLs and handle x402 payments

Author: askeluv

.changeset/config.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://unpkg.com/@changesets/config@3.1.1/schema.json",
-  "changelog": ["@changesets/changelog-github", { "repo": "askeluv/nansen-cli" }],
+  "changelog": ["@changesets/changelog-github", { "repo": "nansen-ai/nansen-cli" }],
   "commit": false,
   "fixed": [],
   "linked": [],

.changeset/x402-payment-required.md

@@ -0,0 +1,5 @@
+---
+"nansen-cli": minor
+---
+
+Add x402 payment required handling. HTTP 402 responses now return a `PAYMENT_REQUIRED` error code with decoded payment requirements (network, amount, asset, payTo) from the x402 protocol.

CHANGELOG.md

@@ -4,22 +4,22 @@
 
 ### Minor Changes
 
-- [`7dd9845`](https://github.com/askeluv/nansen-cli/commit/7dd984581e6d3babd16060aa344cdf8495c866e4) Thanks [@askeluv](https://github.com/askeluv)! - Add missing endpoints to align with Python SDK:
+- [`7dd9845`](https://github.com/nansen-ai/nansen-cli/commit/7dd984581e6d3babd16060aa344cdf8495c866e4) Thanks [@askeluv](https://github.com/askeluv)! - Add missing endpoints to align with Python SDK:
 
   - token info: Get detailed token information
   - perp screener: Screen perpetual futures contracts
   - perp leaderboard: Perpetual futures PnL leaderboard
   - points leaderboard: Nansen Points leaderboard
 
-- [`778fb71`](https://github.com/askeluv/nansen-cli/commit/778fb71ed56cf32c06376e5263af36c57c34a18b) Thanks [@askeluv](https://github.com/askeluv)! - Add subcommand-specific help and command aliases
+- [`778fb71`](https://github.com/nansen-ai/nansen-cli/commit/778fb71ed56cf32c06376e5263af36c57c34a18b) Thanks [@askeluv](https://github.com/askeluv)! - Add subcommand-specific help and command aliases
 
   - `nansen <command> <subcommand> --help` now shows detailed help including description, required/optional parameters with defaults, return fields, and working examples
   - `nansen <command> --help` lists all available subcommands
   - Added command aliases for faster typing: `tgm` (token), `sm` (smart-money), `prof` (profiler), `port` (portfolio)
 
 ### Patch Changes
 
-- [#9](https://github.com/askeluv/nansen-cli/pull/9) [`3efc2ce`](https://github.com/askeluv/nansen-cli/commit/3efc2cef3322e192b02a6a4e8955e53f3c7c6ab4) Thanks [@0xlaveen](https://github.com/0xlaveen)! - fix: profiler pnl endpoint, token screener --search, help shows all subcommands
+- [#9](https://github.com/nansen-ai/nansen-cli/pull/9) [`3efc2ce`](https://github.com/nansen-ai/nansen-cli/commit/3efc2cef3322e192b02a6a4e8955e53f3c7c6ab4) Thanks [@0xlaveen](https://github.com/0xlaveen)! - fix: profiler pnl endpoint, token screener --search, help shows all subcommands
 
   - `profiler pnl` now uses correct endpoint `/api/v1/profiler/address/pnl` (was using non-existent `/pnl-and-trade-performance`). Now supports `--date` and `--limit`.
   - `token screener --search PEPE` now filters results by token symbol/name (client-side, API doesn't support server-side search)
@@ -30,7 +30,7 @@
 
 ### Patch Changes
 
-- [`1c3857f`](https://github.com/askeluv/nansen-cli/commit/1c3857fd019703ff1b4620f7feed4152d3234a6a) Thanks [@askeluv](https://github.com/askeluv)! - Fix repository URL in package.json (nansen-ai → askeluv)
+- [`1c3857f`](https://github.com/nansen-ai/nansen-cli/commit/1c3857fd019703ff1b4620f7feed4152d3234a6a) Thanks [@askeluv](https://github.com/askeluv)! - Fix repository URL in package.json (nansen-ai → askeluv)
 
 All notable changes to this project will be documented in this file.
 

package-lock.json

@@ -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.json

@@ -113,7 +113,7 @@ describe('CLI Smoke Tests', () => {
     const output = stdout || stderr;
     const result = JSON.parse(output);
     expect(result.success).toBe(false);
-    expect(result.code).toBe('UNAUTHORIZED');
+    expect(['UNAUTHORIZED', 'PAYMENT_REQUIRED']).toContain(result.code);
   });
 
   // =================== Error Handling ===================

src/__tests__/cli.test.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;
@@ -484,6 +487,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, {