nansen-cli 1.9.0 → 1.9.1

package/CHANGELOG.md

@@ -0,0 +1,103 @@
+# Changelog
+
+## 1.9.1
+
+### Patch Changes
+
+- [#110](https://github.com/nansen-ai/nansen-cli/pull/110) [`82aa780`](https://github.com/nansen-ai/nansen-cli/commit/82aa78022bdcd62987b0949e090f19f563699d9a) Thanks [@TimNooren](https://github.com/TimNooren)! - Fix `nansen changelog` always showing "CHANGELOG.md not found". Added a `files` field to `package.json` to explicitly bundle `CHANGELOG.md` with the published package. Also excludes `src/__tests__/` from the package, reducing package size from ~537 kB to ~269 kB.
+
+## 1.9.0
+
+### Minor Changes
+
+- [#98](https://github.com/nansen-ai/nansen-cli/pull/98) [`2f3f556`](https://github.com/nansen-ai/nansen-cli/commit/2f3f556d008a1f8ec40d57a8a2822bedbc6b60cb) Thanks [@Codier](https://github.com/Codier)! - Add symbol shortcuts for common tokens (SOL, ETH, USDC, USDT, etc.) that resolve to canonical addresses per chain. Users can now use `--from SOL --to USDC` instead of raw contract addresses.
+
+- [#32](https://github.com/nansen-ai/nansen-cli/pull/32) [`08a8d21`](https://github.com/nansen-ai/nansen-cli/commit/08a8d21be6e9196661be737545e790af180aebc3) Thanks [@arein](https://github.com/arein)! - Add WalletConnect support for trading, transfers, and x402 auto-payment (EVM only)
+
+### Patch Changes
+
+- [#99](https://github.com/nansen-ai/nansen-cli/pull/99) [`9144cba`](https://github.com/nansen-ai/nansen-cli/commit/9144cba38b06c90d462df97ea6cbcdeaed26fa36) Thanks [@Codier](https://github.com/Codier)! - Show clear error when `--amount` contains a decimal (e.g. `0.005`) instead of base units (lamports, wei). Detected client-side before hitting the API.
+
+- [#100](https://github.com/nansen-ai/nansen-cli/pull/100) [`19559bf`](https://github.com/nansen-ai/nansen-cli/commit/19559bfea6c22f6bd6b8c278ed5e6ae6d64866d5) Thanks [@Codier](https://github.com/Codier)! - Fix `nansen trade help` returning blank output. Now prints subcommands, usage, and examples. Also fixes `errorOutput` ReferenceError in `buildCommands` scope (affected `trade` and `changelog` commands).
+
+- [#93](https://github.com/nansen-ai/nansen-cli/pull/93) [`342c91f`](https://github.com/nansen-ai/nansen-cli/commit/342c91fdeb6d98d6b5c10a58cb9702eb5afe096f) Thanks [@Codier](https://github.com/Codier)! - Warn when `--from` is a wrapped native token (WETH/WBNB) or native sentinel, so AI agents can correct the token before execution fails
+
+## 1.8.0
+
+### Minor Changes
+
+- [#56](https://github.com/nansen-ai/nansen-cli/pull/56) [`d10998a`](https://github.com/nansen-ai/nansen-cli/commit/d10998aa2be19f80e8476d19bfd46029757a7335) Thanks [@askeluv](https://github.com/askeluv)! - Add CHANGELOG.md, `nansen changelog` command, and post-update "what's new" notice
+
+  - Added CHANGELOG.md following Keep a Changelog format with history back to v1.5.0
+  - Added `nansen changelog` command with `--since <version>` filtering
+  - Added one-time upgrade notice on first run after version update (prints to stderr)
+
+- [#77](https://github.com/nansen-ai/nansen-cli/pull/77) [`46e4660`](https://github.com/nansen-ai/nansen-cli/commit/46e4660034d9681405d09a5184f78525c300b8a5) Thanks [@0xlaveen](https://github.com/0xlaveen)! - Add token-ohlcv endpoint for OHLCV candle data
+
+- [#75](https://github.com/nansen-ai/nansen-cli/pull/75) [`287937e`](https://github.com/nansen-ai/nansen-cli/commit/287937e1d307e0b3f25648863d0c5b4a54d215ff) Thanks [@TimNooren](https://github.com/TimNooren)! - Restructure CLI into research/trade/wallet namespaces
+
+  - Commands reorganized: `smart-money`, `profiler`, `token`, `portfolio` now live under `nansen research`
+  - New `nansen trade` namespace for `quote` and `execute`
+  - New `nansen wallet` namespace for wallet management
+  - Old top-level commands still work with deprecation warnings
+
+- [#61](https://github.com/nansen-ai/nansen-cli/pull/61) [`9af0192`](https://github.com/nansen-ai/nansen-cli/commit/9af01921871be1d0537047cb4ad9733e01876646) Thanks [@askeluv](https://github.com/askeluv)! - Add ENS name resolution for profiler commands. Use `.eth` names directly in `--address` flags — resolved automatically via ensideas API with onchain RPC fallback. Works across all profiler subcommands, batch, and trace operations.
+
+All notable changes to the Nansen CLI will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/).
+
+## [1.7.0] - 2026-02-24
+
+### Added
+
+- **Trading commands** — `quote` and `execute` for DEX swaps (EVM + Solana)
+- **Wallet management** — `wallet create`, `list`, `show`, `export`, `default`, `delete`
+- **Wallet send** — transfer tokens on EVM and Solana (`wallet send`)
+- **x402 auto-payment** — automatic payment via Base USDC or Solana SPL USDC
+- Explorer links in transaction output
+- `--dry-run` flag for `wallet send`
+- x402 low balance warning
+- AI Agent Access setup docs and improved onboarding flow
+
+### Fixed
+
+- Solana execute crash with OKX quotes
+- x402 auto-pay retry path (3 reference errors)
+- Gas estimation — use API `quote.gas` as floor
+- Pre-flight simulation moved after approval (industry standard)
+- EVM signing edge cases with pure JS ECDSA
+- Wallet send crashes on amount parsing and silent success
+- Solana confirmation and SPL token transfer account ordering
+- Suppress duplicate JSON output from quote/execute
+- Suppress approval warning for native ETH swaps
+
+### Changed
+
+- Pricing clarity — from $0.01/call, min $0.05 balance
+- Consolidated crypto primitives into shared module
+
+## [1.6.0] - 2026-02-14
+
+### Added
+
+- `token indicators` endpoint
+- `profiler search` — general entity search command
+- `--x402-payment-signature` flag for pre-signed payment headers
+- `X-Client-Type` and `X-Client-Version` tracking headers on all API requests
+
+### Fixed
+
+- Error JSON now outputs to stdout (not stderr) for consistent agent parsing
+- Config loading — environment variables correctly override file config
+
+## [1.5.1] - 2026-02-07
+
+### Added
+
+- Allow API requests without API key when using x402 payment flow
+
+## [1.5.0] - 2026-01-31
+
+_Baseline version. Changes above are relative to this release._

package/README.md

@@ -2,7 +2,7 @@
 
 [![npm version](https://img.shields.io/npm/v/nansen-cli.svg)](https://www.npmjs.com/package/nansen-cli)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Tests](https://img.shields.io/badge/tests-577%20passing-brightgreen.svg)]()
+[![CI](https://github.com/nansen-ai/nansen-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/nansen-ai/nansen-cli/actions/workflows/ci.yml)
 
 > **Built by agents, for agents.** We prioritize the best possible AI agent experience.
 

package/package.json

@@ -1,12 +1,16 @@
 {
   "name": "nansen-cli",
-  "version": "1.9.0",
+  "version": "1.9.1",
   "description": "Command-line interface for Nansen API - designed for AI agents",
   "main": "src/index.js",
   "type": "module",
   "bin": {
     "nansen": "./src/index.js"
   },
+  "files": [
+    "src/*.js",
+    "CHANGELOG.md"
+  ],
   "scripts": {
     "start": "node src/index.js",
     "pretest": "node scripts/check-changeset.js",

package/.changeset/README.md

@@ -1,8 +0,0 @@
-# Changesets
-
-Hello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works
-with multi-package repos, or single-package repos to help you version and publish your code. You can
-find the full documentation for it [in the repository](https://github.com/changesets/changesets)
-
-We have a quick list of common questions to get you started engaging with this project in
-[our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md)

package/AGENTS.md

@@ -1,176 +0,0 @@
-# AGENTS.md — Contributor Guide
-
-Guidance for AI coding agents (Claude Code, Codex, Copilot, etc.) working on this repository. If you're an agent **using** the CLI, see [README.md](README.md).
-
-## Architecture
-
-```
-src/
-├── index.js          # Entry point (shebang, calls runCLI)
-├── cli.js            # Command router, arg parsing, schema, help text
-├── api.js            # NansenAPI client (REST, retry, cache, x402 auto-pay)
-├── wallet.js         # Wallet CRUD (create/list/show/export/delete/send)
-├── trading.js        # Quote + execute swaps (OKX router via API)
-├── transfer.js       # Token/native transfers (EVM + Solana)
-├── x402.js           # x402 payment orchestration (picks network, signs)
-├── x402-evm.js       # EVM payment signing (EIP-3009 transferWithAuthorization)
-├── x402-svm.js       # Solana payment signing (SPL transfer)
-├── crypto.js         # Key encryption/decryption (AES-256-GCM or plaintext)
-└── update-check.js   # Version upgrade notice
-```
-
-### Command routing
-
-`src/index.js` → `runCLI()` in `src/cli.js`
-
-Commands are built by three functions, merged in `runCLI()`:
-- `buildCommands()` in cli.js — analytics commands (smart-money, profiler, token, etc.)
-- `buildWalletCommands()` in wallet.js — wallet subcommands
-- `buildTradingCommands()` in trading.js — quote/execute
-
-Commands listed in `NO_AUTH_COMMANDS` skip API initialization. Everything else instantiates `NansenAPI` with retry, cache, and x402 config.
-
-### Data flow: trade
-
-```
-CLI args → api.js GET /defi/quote → quote response
-         → wallet.js decrypt key → trading.js sign tx → api.js POST /defi/execute → broadcast
-```
-
-### Data flow: x402 auto-pay
-
-```
-api.js (any call) → 402 response with payment requirements
-→ x402.js rankRequirements() → picks cheapest network (EVM first)
-→ x402-evm.js or x402-svm.js → sign USDC payment
-→ api.js retries original request with Payment-Signature header
-```
-
-If EVM payment fails (insufficient funds), the async generator yields a Solana signature as fallback.
-
-### Output convention
-
-Core functions return data objects. The CLI layer formats via `formatOutput()`. Never `console.log` in core functions — use the `log` dependency injection for CLI output.
-
-## Development
-
-```bash
-npm install           # Install dependencies
-npm test              # Run tests (vitest)
-npm run test:watch    # Watch mode
-npm run test:coverage # With coverage
-```
-
-### Running locally
-
-```bash
-node src/index.js <command> [options]
-
-# Examples
-node src/index.js wallet create my-wallet
-node src/index.js smart-money --chain solana --limit 5
-```
-
-## Testing
-
-- **Framework:** Vitest
-- **Test files:** `src/__tests__/*.test.js`
-- **Current:** 577 tests across 13 test files
-- **All new code must have tests**
-- **Mock all RPC/API calls** — never hit real networks in tests
-
-### Test structure
-
-```js
-import { describe, it, expect, vi, beforeEach } from 'vitest';
-
-global.fetch = vi.fn();
-
-describe('featureName', () => {
-  beforeEach(() => {
-    fetch.mockReset();
-  });
-
-  it('should do the thing', async () => {
-    fetch.mockResolvedValueOnce({
-      ok: true,
-      json: async () => ({ jsonrpc: '2.0', result: '0x...', id: 1 })
-    });
-    // test logic
-  });
-});
-```
-
-### Required RPC mocks by code path
-
-**EVM transfers:** `eth_getBalance`, `eth_gasPrice`, `eth_maxPriorityFeePerGas`, `eth_getTransactionCount`, `eth_estimateGas`, `eth_getCode`, `eth_sendRawTransaction`, `eth_getTransactionReceipt`
-
-**Solana transfers:** `getBalance`, `getLatestBlockhash`, `sendTransaction`, `getSignatureStatuses`
-
-**SPL token transfers** (additionally): `getTokenAccountsByOwner`, `getAccountInfo`
-
-**Wallet operations:** No RPC mocks needed (file I/O only). Mock `fs` if testing file paths.
-
-**API calls:** Mock `fetch` to return `{ ok: true, json: () => ({...}) }` or `{ ok: false, status: 402, headers: new Headers({...}) }` for x402 paths.
-
-## Style Guide
-
-- **ESM only** (`import`/`export`). No TypeScript, no transpilation.
-- **No interactive prompts in core functions.** Use env vars: `NANSEN_WALLET_PASSWORD`, `NANSEN_API_KEY`.
-- **Error handling:** `throw new Error('descriptive message')` in core. CLI catches and formats.
-- **Actionable error messages** — tell the user what to do:
-  - ❌ `"Authentication failed"`
-  - ✅ `"Not logged in. Run: nansen login"`
-- **BigInt for token amounts.** Never use floating point. Parse to BigInt with decimals.
-- **Chain branching:** Use `chain === 'solana'` checks, not inheritance/polymorphism.
-- **Minimal dependencies.** Prefer Node.js built-in APIs (crypto, fs, path, http).
-
-## PR Checklist
-
-- [ ] `npm test` passes (all tests)
-- [ ] New code paths have test coverage
-- [ ] No hardcoded secrets, API keys, or private keys
-- [ ] No `console.log` in core functions (use `log` dep injection)
-- [ ] Error messages are actionable (tell user what to do)
-- [ ] CLI help text updated if adding/changing commands
-- [ ] RPC mocks cover all methods in the code path
-- [ ] Wallet flows work both with and without `NANSEN_WALLET_PASSWORD`
-- [ ] Changeset added if changing user-facing behavior (add a `.changeset/<name>.md` file — `npm test` will warn if missing)
-
-## Chains & Networks
-
-**EVM:** Ethereum (chain ID 1), Base (8453). `CHAIN_IDS` in transfer.js only maps these two — other EVM chains will fail for transfers.
-
-**Solana:** mainnet-beta. Supports native SOL, standard SPL tokens, and Token-2022 (Token Extensions).
-
-**RPC endpoints:** Hardcoded in `CHAIN_RPCS` (transfer.js). Nansen API handles RPC for trading.
-
-## Key Constants
-
-| Constant | Value |
-|----------|-------|
-| USDC (Base) | `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913` |
-| USDC (Solana) | `EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v` |
-| x402 payment | $0.05 USDC per API call |
-| Gas buffer | API provides `quote.gas` with 1.5x multiplier — use directly |
-
-## Endpoint Quirks
-
-These are internal details agents should know when writing or debugging tests:
-
-- **`token holders --smart-money`** — Returns `UNSUPPORTED_FILTER` for tokens without smart money tracking. Not all tokens have this data.
-- **`token flow-intelligence`** — May return all-zero flows for illiquid tokens. Normal, not an error.
-- **`token screener --search`** — Client-side filtering. The CLI fetches up to 500 results, then filters locally.
-- **`--fields`** — Applies to the entire response tree, including the `success`/`data` wrapper.
-- **Profiler beta endpoints** use `recordsPerPage` instead of `per_page`. The CLI handles this automatically.
-- **`profiler perp-positions`** — No pagination support; the API ignores the pagination parameter.
-
-## Known Gotchas
-
-1. **EIP-7702 delegated accounts** on Base have contract code. Always use `eth_estimateGas`, never hardcode 21000 gas.
-2. **Solana SPL account ordering:** Writable accounts (destATA) must precede readonly (mint) in the transaction message.
-3. **`getSignatureStatuses`** over `confirmTransaction` — the latter is deprecated and unreliable on public RPCs.
-4. **`--max` native SOL:** Reserve 5000 lamports for fee. On EVM L2s, reserve 3x estimated gas for L1 data posting fees.
-5. **Token-2022:** Use `TOKEN_2022_PROGRAM_ID` and `TransferCheckedInstruction` (not plain `Transfer`).
-6. **CreateATA path:** When recipient doesn't have a token account, the sender creates it. This path in transfer.js has limited test coverage — add tests if modifying.
-7. **`CHAIN_IDS` is incomplete:** Only ethereum and base are mapped. Adding new EVM chain support requires updating this map.

package/CLAUDE.md

@@ -1,217 +0,0 @@
-# CLAUDE.md
-
-AI assistant guide for contributing to nansen-cli.
-
-## What This Is
-
-A CLI for the [Nansen API](https://docs.nansen.ai), designed specifically for AI agents. All output is structured JSON. 30 endpoints across Smart Money, Profiler, Token God Mode, and Portfolio.
-
-## Quick Start
-
-```bash
-npm install
-npm test           # Run mocked tests (no API key needed)
-npm run test:live  # Run against live API (needs NANSEN_API_KEY)
-```
-
-## Project Structure
-
-```
-src/
-├── index.js              # Thin CLI entry point (imports cli.js)
-├── cli.js                # CLI logic: parsing, routing, formatting, schema
-├── api.js                # NansenAPI class, all HTTP calls, validation
-└── __tests__/
-    ├── unit.test.js      # Core logic tests (validation, parsing, formatting)
-    ├── api.test.js       # API method tests with mocked fetch
-    ├── cli.test.js       # CLI integration tests (subprocess)
-    ├── cli.internal.test.js  # CLI unit tests (direct imports for coverage)
-    └── coverage.test.js  # Endpoint coverage verification
-```
-
-**Three files, clear separation:**
-- `index.js` = Entry point (thin wrapper)
-- `cli.js` = CLI layer (parsing, routing, output formatting, schema)
-- `api.js` = API layer (HTTP, validation, config)
-
-## Code Conventions
-
-- **ES modules** (`import`/`export`, not `require`)
-- **Async/await** for all API calls
-- **All output is JSON** (for AI agent consumption)
-- **No external dependencies** (just Node.js built-ins + vitest for tests)
-
-## Adding a New Endpoint
-
-1. **Add API method in `src/api.js`:**
-```javascript
-async newEndpoint(params = {}) {
-  const { chain = 'solana', filters = {}, orderBy, pagination } = params;
-  return this.request('/api/v1/endpoint-path', {
-    chain,
-    filters,
-    order_by: orderBy,
-    pagination
-  });
-}
-```
-
-2. **Add CLI handler in `src/index.js`:**
-```javascript
-// In the appropriate command handler (smart-money, profiler, token, portfolio)
-'new-subcommand': () => api.newEndpoint({ chains, filters, orderBy, pagination }),
-```
-
-3. **Add tests:**
-   - `api.test.js` — Mock the fetch, verify request body
-   - `cli.test.js` — Test CLI invocation
-   - `coverage.test.js` — Add to `DOCUMENTED_ENDPOINTS`
-
-4. **Update `README.md`** with docs
-
-## Testing
-
-```bash
-npm test                    # All tests, mocked
-npm run test:watch          # Watch mode
-npm run test:coverage       # With coverage report
-NANSEN_API_KEY=xxx npm run test:live  # Live API tests
-```
-
-**Test philosophy:**
-- Unit tests don't need API key (use mocked fetch)
-- Live tests are opt-in via `NANSEN_LIVE_TEST=1`
-- Coverage test ensures all documented endpoints have implementations
-
-## Common Patterns
-
-### Address Validation
-```javascript
-// Validates EVM (0x...) or Solana (Base58) addresses
-const validation = validateAddress(address, chain);
-if (!validation.valid) throw new Error(validation.error);
-```
-
-### Date Ranges
-```javascript
-// Most endpoints accept days param, converted to date range
-const to = new Date().toISOString().split('T')[0];
-const from = new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString().split('T')[0];
-```
-
-### Retry Behavior
-- **Enabled by default** with 3 attempts
-- Retries on: 429, 500, 502, 503, 504, network errors
-- Exponential backoff with jitter (1s base, 30s max)
-- Respects `retry-after` headers
-- Disable with `--no-retry` or `options.retry = false`
-- Success responses include `_meta.retriedAttempts` if retried
-
-### Response Format
-```javascript
-// Success
-{ "success": true, "data": { ... } }
-
-// Error
-{ "success": false, "error": "message", "code": "ERROR_CODE", "status": 401, "details": { ... } }
-```
-
-### Schema Discovery
-```bash
-nansen schema                    # Full schema (commands, options, types)
-nansen schema smart-money        # Schema for specific command
-```
-Returns JSON with all commands, subcommands, option types/defaults, return fields, supported chains, and smart money labels. No API key required.
-
-### Field Filtering
-```bash
-nansen research smart-money netflow --fields token_symbol,net_flow_usd,chain
-```
-Reduces response size by including only specified fields. Works with nested data structures.
-
-### Error Codes
-Structured error codes for programmatic handling:
-
-| Code | Description |
-|------|-------------|
-| `UNAUTHORIZED` | Invalid or missing API key (401) |
-| `FORBIDDEN` | Valid key but insufficient permissions (403) |
-| `CREDITS_EXHAUSTED` | Insufficient API credits (403) — do not retry |
-| `RATE_LIMITED` | Too many requests (429) |
-| `INVALID_ADDRESS` | Address format validation failed |
-| `INVALID_TOKEN` | Token address validation failed |
-| `INVALID_CHAIN` | Unsupported or invalid chain |
-| `INVALID_PARAMS` | Generic parameter validation error |
-| `MISSING_PARAM` | Required parameter not provided |
-| `UNSUPPORTED_FILTER` | Filter not supported for this token/chain (400) |
-| `NOT_FOUND` | Resource not found (404) |
-| `TOKEN_NOT_FOUND` | Token doesn't exist |
-| `ADDRESS_NOT_FOUND` | Address has no data |
-| `SERVER_ERROR` | Nansen API internal error (500+) |
-| `SERVICE_UNAVAILABLE` | API temporarily down (503) |
-| `NETWORK_ERROR` | Connection failed |
-| `TIMEOUT` | Request timed out |
-| `UNKNOWN` | Unclassified error |
-
-## API Reference
-
-### Chains
-`ethereum`, `solana`, `base`, `bnb`, `arbitrum`, `polygon`, `optimism`, `avalanche`, `linea`, `scroll`, `zksync`, `mantle`, `ronin`, `sei`, `plasma`, `sonic`, `unichain`, `monad`, `hyperevm`, `iotaevm`
-
-### Smart Money Labels
-`Fund`, `Smart Trader`, `30D Smart Trader`, `90D Smart Trader`, `180D Smart Trader`, `Smart HL Perps Trader`
-
-### Endpoints by Category
-
-**Smart Money (6):** netflow, dex-trades, perp-trades, holdings, dcas, historical-holdings
-
-**Profiler (11):** balance, labels, transactions, pnl, search, historical-balances, related-wallets, counterparties, pnl-summary, perp-positions, perp-trades
-
-**Token God Mode (12):** screener, holders, flows, dex-trades, pnl, who-bought-sold, flow-intelligence, transfers, jup-dca, perp-trades, perp-positions, perp-pnl-leaderboard
-
-**Portfolio (1):** defi-holdings
-
-## Gotchas
-
-- **Perp endpoints** work with Hyperliquid (use `--symbol BTC` not `--token`)
-- **JUP DCA** is Solana-only
-- **Beta endpoints** (`/api/beta/...`) may have different pagination
-- **EVM vs Solana addresses** — validation auto-detects based on chain param
-
-## Publishing (npm)
-
-**DO NOT manually run `npm version` or `npm publish`. CI handles everything.**
-
-1. **Push to main** — CI runs tests
-2. **CI creates a "Version Packages" PR** — bumps version + updates CHANGELOG
-3. **Merge the Version PR** — CI auto-publishes to npm
-
-If you mess up: accidentally bumped version manually? `git revert` and add a changeset instead. CI publish failed? Check GitHub Actions logs, likely needs `NPM_TOKEN` secret refresh.
-
-## Changesets
-
-Every PR that changes user-facing behavior **must** include a changeset file. `npm test` will warn if one is missing. The changeset description ends up in CHANGELOG.md (auto-generated by CI), so write it as a user-facing changelog entry.
-
-**Needs a changeset:** new features, bug fixes, breaking changes, changed CLI output, new/modified commands.
-
-**Does NOT need a changeset:** docs-only, test-only, refactors with no behavior change, CI/tooling.
-
-Add a file to `.changeset/` with a descriptive kebab-case name:
-
-```markdown
----
-"nansen-cli": minor
----
-
-Short description of the change (appears in CHANGELOG)
-```
-
-Use `patch` for bug fixes, `minor` for new features, `major` for breaking changes.
-
-## PR Checklist
-
-- [ ] Tests pass (`npm test`)
-- [ ] New endpoints have tests in all 3 test files
-- [ ] README.md updated if adding user-facing features
-- [ ] Changeset added for user-facing changes (see above)
-- [ ] No new dependencies (keep it lightweight)

package/SKILL.md

@@ -1,230 +0,0 @@
----
-name: nansen-cli
-description: Nansen CLI for onchain analytics, smart money tracking, DEX trading, and perp markets.
-license: MIT
-metadata:
-  author: nansen-ai
-  version: "1.8.0"
-  repository: https://github.com/nansen-ai/nansen-cli
-compatibility: Node.js 18+. Works with Claude Code, Codex, Cursor, Windsurf, and any terminal-native agent.
----
-
-# Nansen CLI
-
-Onchain analytics and DEX trading for AI agents.
-
-## Quick Reference
-
-```bash
-# Search for any token, wallet, or entity
-nansen research search "jupiter" --type token
-
-# Token price (OHLCV)
-nansen research token ohlcv --token <addr> --chain solana --timeframe 1h --limit 24
-
-# Smart Money — what are the pros buying?
-nansen research smart-money netflow --chain solana --limit 10
-
-# Token screener — trending tokens
-nansen research token screener --chain solana --timeframe 24h --smart-money --limit 20
-
-# Trade — quote then execute
-nansen trade quote --chain solana --from <from_token_address> --to <to_token_address> --amount <base_units>
-nansen trade execute --quote <quote-id>
-
-# Create a wallet
-nansen wallet create                                      # interactive
-NANSEN_WALLET_PASSWORD="pass" nansen wallet create        # non-interactive
-
-# Discover all commands, options, and return fields
-nansen schema
-```
-
-## Setup
-
-```bash
-npm install -g nansen-cli
-```
-
-### Auth (pick one)
-
-**x402 Pay-Per-Call (no API key needed):**
-
-```bash
-nansen wallet create    # Generates EVM + Solana keypair
-# Fund the EVM address with USDC on Base (~$0.50 minimum)
-export NANSEN_WALLET_PASSWORD="your-password"  # Skip interactive prompt
-# Done — CLI auto-pays $0.01-$0.05 per call
-```
-
-**API Key:**
-
-```bash
-export NANSEN_API_KEY=your-api-key
-# Or: nansen login --api-key YOUR_KEY
-```
-
-Get a key at [app.nansen.ai/api](https://app.nansen.ai/api).
-
-## Smart Money
-
-```bash
-nansen research smart-money netflow --chain solana --limit 10
-nansen research smart-money dex-trades --chain solana --labels "Smart Trader" --limit 20
-nansen research smart-money holdings --chain solana --limit 10
-nansen research smart-money perp-trades --limit 10            # no --chain (Hyperliquid only)
-nansen research smart-money dcas --limit 10                   # no --chain (Jupiter/Solana only)
-nansen research smart-money historical-holdings --chain solana --token-address <addr>
-```
-
-Labels: `Fund`, `Smart Trader`, `30D Smart Trader`, `90D Smart Trader`, `180D Smart Trader`, `Smart HL Perps Trader`
-
-## Token Analytics
-
-`--chain` required. Use `--token` for the token address.
-
-```bash
-nansen research token screener --chain solana --timeframe 24h --smart-money --limit 20
-nansen research token info --token <addr> --chain solana
-nansen research token indicators --token <addr> --chain solana
-nansen research token ohlcv --token <addr> --chain solana --timeframe 1h --limit 24
-nansen research token holders --token <addr> --chain solana --smart-money
-nansen research token flows --token <addr> --chain solana --days 7
-nansen research token flow-intelligence --token <addr> --chain solana
-nansen research token who-bought-sold --token <addr> --chain solana
-nansen research token dex-trades --token <addr> --chain solana --limit 20
-nansen research token pnl --token <addr> --chain solana --sort total_pnl_usd:desc
-nansen research token transfers --token <addr> --chain solana --enrich
-nansen research token jup-dca --token <addr>                  # no --chain
-nansen research token perp-trades --symbol ETH --days 7       # no --chain, uses --symbol
-nansen research token perp-positions --symbol BTC              # no --chain
-nansen research token perp-pnl-leaderboard --symbol SOL        # no --chain
-```
-
-Native tokens (SOL, ETH) are not supported on most token endpoints — use specific token addresses.
-
-## Wallet Profiler
-
-`--chain` and `--address` required for most commands.
-
-```bash
-nansen research profiler balance --address <addr> --chain solana
-nansen research profiler labels --address <addr> --chain ethereum
-nansen research profiler pnl --address <addr> --chain ethereum --days 30
-nansen research profiler pnl-summary --address <addr> --chain ethereum
-nansen research profiler transactions --address <addr> --chain ethereum --limit 20
-nansen research profiler historical-balances --address <addr> --chain solana --days 30
-nansen research profiler related-wallets --address <addr> --chain ethereum
-nansen research profiler counterparties --address <addr> --chain ethereum
-nansen research profiler perp-positions --address <addr>       # no --chain
-nansen research profiler perp-trades --address <addr>          # no --chain
-nansen research profiler search --query "Vitalik"              # no --chain
-nansen research profiler batch --addresses "0xabc,0xdef" --chain ethereum --include labels,balance,pnl
-nansen research profiler trace --address <addr> --chain ethereum --depth 2 --width 10  # ⚠️ makes N×width API calls
-nansen research profiler compare --addresses "0xabc,0xdef" --chain ethereum
-```
-
-## Search
-
-```bash
-nansen research search "jupiter" --type token
-nansen research search "Vitalik" --type entity --limit 5
-nansen research search "0xd8dA..."                             # by address
-```
-
-## Perps (Hyperliquid)
-
-```bash
-nansen research perp screener --sort volume_usd:desc --limit 20
-nansen research perp leaderboard --days 7 --limit 20
-```
-
-## Portfolio
-
-```bash
-nansen research portfolio defi --wallet <addr>
-nansen research points leaderboard --tier green --limit 20
-```
-
-## Trading
-
-Two-step: quote then execute.
-
-```bash
-# Get quotes from multiple aggregators (Jupiter, OKX, LiFi)
-nansen trade quote --chain solana \
-  --from <from_token_address> \
-  --to <to_token_address> \
-  --amount <base_units>
-
-# Execute the best quote
-nansen trade execute --quote <quote-id>
-```
-
-> ⚠️ Always inspect the quote response (price, slippage, expiry) before executing.
-> Quotes expire — if you wait too long, execute will fail. Get a fresh quote and retry.
-> Trades are irreversible once executed on-chain.
-
-**⚠️ Amounts are in base units (not human-readable):**
-
-| Token | Decimals | 1 unit = |
-|-------|----------|----------|
-| SOL | 9 | 1000000000 lamports |
-| ETH | 18 | 1000000000000000000 wei |
-| USDC | 6 | 1000000 |
-
-Symbol shortcuts (SOL, ETH) don't work yet — use full addresses.
-
-### Common Addresses
-
-**Solana:** SOL `So11111111111111111111111111111111111111112` · USDC `EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v` · JUP `JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN`
-
-**Base:** ETH `0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee` · USDC `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913` · DEGEN `0x4ed4e862860bed51a9570b96d89af5e1b0efefed`
-
-## Wallet Management
-
-```bash
-nansen wallet create          # Create EVM + Solana keypair
-nansen wallet list            # List wallets
-nansen wallet send --to <addr> --amount 1.5 --chain evm    # Send native
-nansen wallet send --to <addr> --chain evm --max            # Send entire balance
-```
-
-## Common Options
-
-| Option | Description |
-|--------|-------------|
-| `--chain` | Required for most commands. See [Supported Chains](#supported-chains) |
-| `--token` | Token address (aliases: `--mint`, `--token-address`) |
-| `--address` | Wallet address |
-| `--limit` | Results per page (default 10) |
-| `--days` | Lookback period in days (default 30) |
-| `--sort` | Sort field:direction (e.g. `value_usd:desc`) |
-| `--smart-money` | Filter to smart money wallets only |
-| `--pretty` | Formatted JSON output |
-| `--table` | ASCII table output |
-| `--stream` | NDJSON (one record per line) |
-| `--fields a,b` | Return only specific fields |
-| `--cache` | Cache responses (300s TTL). **Do not use with `trade` commands** — stale prices/quotes can cause bad trades |
-
-## Schema Introspection
-
-> **Stuck?** Run `nansen schema` or `nansen schema <command>` to discover all available commands, options, and return fields.
-
-```bash
-nansen schema                 # Full JSON schema — all commands, options, return fields
-```
-
-## Supported Chains
-
-**Research:** `solana`, `ethereum`, `base`, `bnb`, `arbitrum`, `polygon`, `optimism`, `avalanche`, `linea`, `scroll`, `mantle`, `ronin`, `sei`, `plasma`, `sonic`, `monad`, `hyperevm`, `iotaevm`
-
-**Trading & x402:** `solana`, `base`
-
-## Gotchas
-
-- Native tokens (SOL, ETH) don't work on most token endpoints — use wrapped addresses
-- Perp commands don't take `--chain` (Hyperliquid only)
-- `--amount` is always in base units, not human-readable
-- Profiler `trace` makes N×width API calls — can burn credits fast
-- x402 auth needs USDC on Base, not Solana

package/TODO.md

@@ -1,42 +0,0 @@
-# TODO
-
-> **Built by agents, for agents.** We prioritize improvements that create the best possible AI agent experience.
-
-## P0 - Trading Agent Support
-
-### Wallet Management
-- [ ] `nansen wallet create` — generate a local wallet (per chain), store key securely on disk
-- [ ] `nansen wallet address` — print the wallet address for funding
-- [ ] `nansen wallet balance` — check wallet balance
-
-### Trading Execution
-- [x] `nansen quote` — get a quote for a DEX swap (chain, tokens, amount)
-- [x] `nansen execute` — sign and submit a trade via Nansen API (takes quote-id)
-- [ ] ⚠️ EVM transaction signing — requires thorough security review before production use
-
-> These commands are required for `nansen-trading-agent` — the autonomous trading sub-agent.
-> Wallet commands should keep the agent self-contained with zero external dependencies.
-
----
-
-## P2 - Nice to Have
-
-### Test Coverage Gaps
-- [ ] Test config priority chain (ENV > ~/.nansen > local) — needs `loadConfig()` exported
-- [ ] Add snapshot tests for `--help` output
-- [ ] Document magic test addresses (e.g. Binance hot wallet)
-- [ ] Test Bitcoin address validation
-- [ ] Test stdin pipe mode for API key input
-
-### Shell Completions
-- [ ] Bash completions
-- [ ] Zsh completions
-- [ ] Fish completions
-
-### Distribution
-- [ ] Homebrew formula (`brew install nansen-cli`)
-- [ ] Docker image
-
----
-
-*Last updated: 2026-02-06*

package/scripts/check-changeset.js

@@ -1,28 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Non-blocking check: warns if the current branch has no new changeset file
- * compared to main. Runs as a pretest hook so agents and humans see a reminder.
- * Always exits 0 — this is a nudge, not a gate.
- */
-
-import { execSync } from "child_process";
-
-try {
-  const branch = execSync("git rev-parse --abbrev-ref HEAD", { encoding: "utf8" }).trim();
-  if (branch === "main") process.exit(0);
-
-  const newChangesets = execSync(
-    "git diff main --name-only --diff-filter=A -- .changeset/*.md",
-    { encoding: "utf8" }
-  ).trim();
-
-  if (!newChangesets) {
-    console.error(
-      "\x1b[33m[changeset] No new changeset file found on this branch. " +
-      "If this PR changes user-facing behavior, add one: npx changeset\x1b[0m"
-    );
-  }
-} catch {
-  // Not a git repo, main doesn't exist, etc. — skip silently.
-}

package/vitest.e2e.config.js

@@ -1,10 +0,0 @@
-import { defineConfig } from 'vitest/config';
-
-export default defineConfig({
-  test: {
-    globals: true,
-    environment: 'node',
-    include: ['src/**/*.e2e.test.js'],
-    testTimeout: 120000,
-  },
-});