nansen-cli 1.25.1 → 1.26.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 1.26.0
+
+### Minor Changes
+
+- [#380](https://github.com/nansen-ai/nansen-cli/pull/380) [`12e4e25`](https://github.com/nansen-ai/nansen-cli/commit/12e4e25d50f50ff1ebbae160ba1016abd1cdbb4d) Thanks [@TimNooren](https://github.com/TimNooren)! - Add `--amount-unit percent` to trade commands, allowing trades as a percentage of wallet balance (e.g. `--amount 100 --amount-unit percent` to sell all)
+
+### Patch Changes
+
+- [#382](https://github.com/nansen-ai/nansen-cli/pull/382) [`d9c87ef`](https://github.com/nansen-ai/nansen-cli/commit/d9c87ef9df51a3e9c53ea59674ad9efe9aa33fb7) Thanks [@kome12](https://github.com/kome12)! - fix: default `profiler balance` chain to `'all'` instead of `'ethereum'`
+
+  Previously, `nansen profiler balance --address <addr>` without `--chain` defaulted to `ethereum`, returning empty results for wallets with no ETH mainnet holdings (e.g. Base-only or Solana-only wallets). Now defaults to `'all'`, letting the API auto-route based on address format.
+
 ## 1.25.1
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nansen-cli",
-  "version": "1.25.1",
+  "version": "1.26.0",
   "description": "Command-line interface for Nansen API - designed for AI agents",
   "main": "src/index.js",
   "type": "module",

package/src/api.js

@@ -766,7 +766,7 @@ export class NansenAPI {
   // ============= Profiler Endpoints =============
 
   async addressBalance(params = {}) {
-    const { address, entityName, chain = 'ethereum', hideSpamToken = true, filters = {}, orderBy } = params;
+    const { address, entityName, chain = 'all', hideSpamToken = true, filters = {}, orderBy } = params;
     if (address) {
       const validation = validateAddress(address, chain);
       if (!validation.valid) throw new NansenError(validation.error, validation.code);

package/src/cli.js

@@ -1110,7 +1110,7 @@ export function buildCommands(deps = {}) {
       const subcommand = args[0] || 'help';
       let address = options.address;
       const entityName = options.entity || options['entity-name'];
-      const chain = options.chain || 'ethereum';
+      const chain = options.chain || 'all';
 
       // Resolve ENS names (e.g. vitalik.eth → 0x...)
       let ensName;

package/src/schema.json

@@ -821,11 +821,11 @@
             "amount": {
               "type": "string",
               "required": true,
-              "description": "Amount to swap (base units by default, or token units with --amount-unit token, or USD with --amount-unit usd)"
+              "description": "Amount to swap (base units by default, or token units with --amount-unit token, USD with --amount-unit usd, or percentage of balance with --amount-unit percent)"
             },
             "amount-unit": {
               "type": "string",
-              "description": "\"token\" to specify amount in token units (e.g. 0.5 SOL), \"usd\" to specify amount in USD (e.g. 50), or \"base\" for base units (default). The CLI resolves the current token price and decimals locally; the API always receives base units."
+              "description": "\"token\" to specify amount in token units (e.g. 0.5 SOL), \"usd\" to specify amount in USD (e.g. 50), \"percent\" to sell a percentage of your balance (e.g. 100 for all), or \"base\" for base units (default). The CLI resolves the current token price, decimals, and balance locally; the API always receives base units."
             },
             "wallet": {
               "type": "string",

package/src/trade-validation.js

@@ -210,6 +210,65 @@ export async function validateBalance({ chain, from, amount, amountUnit, walletA
   return { adjustedAmount: amount };
 }
 
+/**
+ * Resolve a percentage amount to a token-unit amount string.
+ * Fetches the wallet's balance of the sell token, calculates the percentage,
+ * and applies a native-token fee buffer when selling >=95%.
+ *
+ * Returns the amount in human-readable token units (e.g. "1.5"),
+ * ready for convertToBaseUnits().
+ */
+export async function resolvePercentAmount({ chain, from, walletAddress, percentage, decimals }) {
+  if (!Number.isFinite(percentage) || percentage <= 0 || percentage > 100) {
+    throw new Error(
+      percentage > 100
+        ? `Cannot sell more than 100% of balance. Got: ${percentage}%`
+        : `Percentage must be between 0 and 100. Got: ${percentage}%`
+    );
+  }
+
+  const normalizedChain = chain.toLowerCase();
+  const isNative = isNativeAddress(from, normalizedChain);
+
+  let balance;
+  if (isNative) {
+    balance = await fetchNativeBalance(normalizedChain, walletAddress);
+  } else {
+    balance = await fetchTokenBalance(normalizedChain, from, walletAddress, decimals);
+  }
+
+  if (balance === null) {
+    throw new Error(`Could not fetch balance for ${from} on ${normalizedChain}. Check your RPC connection.`);
+  }
+  if (balance === 0) {
+    const symbol = isNative ? (NATIVE_SYMBOLS[normalizedChain] || from) : from;
+    throw new Error(`No ${symbol} balance in wallet. You cannot trade a token you don't own.`);
+  }
+
+  // Calculate token amount from percentage.
+  // Use exact balance for 100% to avoid floating-point precision loss.
+  let tokenAmount = percentage === 100 ? balance : balance * (percentage / 100);
+
+  // Native token fee buffer: when selling >=95%, cap at balance - reserve.
+  if (isNative && percentage >= HIGH_PERCENTAGE_THRESHOLD) {
+    const reserve = FEE_BUFFER[normalizedChain] || 0;
+    const maxSellable = parseFloat((balance - reserve).toFixed(NATIVE_DECIMALS[normalizedChain]));
+    if (maxSellable <= 0) {
+      const symbol = NATIVE_SYMBOLS[normalizedChain] || from;
+      throw new Error(`Insufficient ${symbol} balance after reserving gas fees.`);
+    }
+    if (tokenAmount > maxSellable) {
+      const symbol = NATIVE_SYMBOLS[normalizedChain] || from;
+      process.stderr.write(
+        `Warning: Reserving ${reserve} ${symbol} for gas. Adjusted sell amount to ${maxSellable} ${symbol}.\n`
+      );
+      tokenAmount = maxSellable;
+    }
+  }
+
+  return String(parseFloat(tokenAmount.toFixed(decimals)));
+}
+
 /**
  * Fetch an ERC-20 or SPL token balance for a wallet.
  * Returns balance in human-readable token units, or null on RPC failure.

package/src/trading.js

@@ -13,7 +13,7 @@ import { base58Decode } from './transfer.js';
 import { keccak256, signSecp256k1, rlpEncode } from './crypto.js';
 import { getWalletConnectAddress, sendTransactionViaWalletConnect, sendSolanaTransactionViaWalletConnect, sendApprovalViaWalletConnect } from './walletconnect-trading.js';
 import { retrievePassword } from './keychain.js';
-import { validateQuoteInput, validateBalance } from './trade-validation.js';
+import { validateQuoteInput, validateBalance, resolvePercentAmount } from './trade-validation.js';
 import { CHAIN_RPCS } from './rpc-urls.js';
 
 // ============= Constants =============
@@ -975,7 +975,7 @@ OPTIONS:
   --from <symbol|address>   Input token (symbol like SOL, USDC or address)
   --to <symbol|address>     Output token (symbol like USDC, ETH or address)
   --amount <units>          Amount in BASE UNITS (e.g. lamports, wei)
-  --amount-unit <unit>      "token" for token units (e.g. 0.5 SOL), "usd" for USD (e.g. 50)
+  --amount-unit <unit>      "token" for token units, "usd" for USD, "percent" for % of balance
   --wallet <name>           Wallet name (default: default wallet). Use "walletconnect" or "wc" for WalletConnect.
   --to-wallet <address>     Destination wallet address (auto-derived for cross-chain if omitted)
   --slippage <pct>          Slippage as decimal (e.g. 0.03 for 3%). Default: 0.03
@@ -987,6 +987,7 @@ EXAMPLES:
   nansen trade quote --chain solana --from SOL --to USDC --amount 1000000000
   nansen trade quote --chain solana --from SOL --to USDC --amount 0.5 --amount-unit token
   nansen trade quote --chain solana --from SOL --to USDC --amount 50 --amount-unit usd
+  nansen trade quote --chain solana --from SOL --to USDC --amount 100 --amount-unit percent
   nansen trade quote --chain base --from ETH --to USDC --amount 1000000000000000000
   nansen trade quote --chain base --to-chain solana --from USDC --to USDC --amount 1000000
   nansen trade quote --chain solana --to-chain base --from SOL --to ETH --amount 1000000000
@@ -996,8 +997,15 @@ EXAMPLES:
       }
 
       // Validate --amount-unit if provided
-      if (amountUnit && amountUnit !== 'token' && amountUnit !== 'base' && amountUnit !== 'usd') {
-        log(`Error: Unknown --amount-unit "${amountUnit}". Supported values: token, base, usd`);
+      if (amountUnit && amountUnit !== 'token' && amountUnit !== 'base' && amountUnit !== 'usd' && amountUnit !== 'percent') {
+        log(`Error: Unknown --amount-unit "${amountUnit}". Supported values: token, base, usd, percent`);
+        exit(1);
+        return;
+      }
+
+      // --amount-unit percent is only valid for exactIn (sell-side)
+      if (amountUnit === 'percent' && swapMode === 'exactOut') {
+        log('Error: --amount-unit percent is not supported with --swap-mode exactOut. Percentage is relative to your sell-token balance.');
         exit(1);
         return;
       }
@@ -1042,6 +1050,8 @@ EXAMPLES:
           exit(1);
           return;
         }
+      } else if (amountUnit === 'percent') {
+        // Resolved after wallet address is available — see percent resolution block below.
       } else {
         const amountError = validateBaseUnitAmount(amount);
         if (amountError) {
@@ -1096,6 +1106,26 @@ EXAMPLES:
           return;
         }
 
+        // --amount-unit percent: fetch balance, calculate percentage, convert to base units.
+        // Placed after wallet resolution because we need the wallet address to fetch balance.
+        if (amountUnit === 'percent') {
+          try {
+            resolvedDecimals = await resolveTokenDecimals(from, chain);
+            const tokenAmount = await resolvePercentAmount({
+              chain,
+              from,
+              walletAddress,
+              percentage: parseFloat(amount),
+              decimals: resolvedDecimals,
+            });
+            resolvedAmount = convertToBaseUnits(tokenAmount, resolvedDecimals);
+          } catch (err) {
+            log(`Error: ${err.message}`);
+            exit(1);
+            return;
+          }
+        }
+
         // Balance pre-check — catches zero balances and insufficient funds
         // before wasting a quote API call. Runs for --amount-unit token and
         // usd (after USD→token conversion) in exactIn mode. In exactOut the

package/src/transfer.js

@@ -559,8 +559,7 @@ async function broadcastTransaction(signedTx, chain) {
 
 // ============= Public API =============
 
-// Exported for testing
-export { parseAmount, formatAmount, signEd25519, encodeCompactU16, base58Decode, base58DecodePubkey, deriveATA, validateEvmAddress, validateSolanaAddress, bigIntToHex };
+export { parseAmount, formatAmount, signEd25519, encodeCompactU16, base58Decode, base58DecodePubkey, deriveATA, isOnEd25519Curve, validateEvmAddress, validateSolanaAddress, bigIntToHex };
 
 /**
  * Send tokens via Privy server wallet. EVM uses Privy's sendTransaction (handles gas/nonce).

package/src/x402-svm.js

@@ -5,7 +5,7 @@
 
 import crypto from 'crypto';
 import { base58Encode, base58DecodePubkey } from './wallet.js';
-import { encodeCompactU16 } from './transfer.js';
+import { encodeCompactU16, isOnEd25519Curve } from './transfer.js';
 
 // ============= Constants =============
 
@@ -41,65 +41,13 @@ export function deriveATA(ownerBase58, mintBase58, tokenProgramBase58 = TOKEN_PR
       .update(Buffer.concat([owner, tokenProgram, mint, Buffer.from([nonce]), ataProgramKey, Buffer.from('ProgramDerivedAddress')]))
       .digest();
 
-    if (!isOnCurve(hash)) {
+    if (!isOnEd25519Curve(hash)) {
       return base58Encode(hash);
     }
   }
   throw new Error('Could not derive ATA: no valid PDA found');
 }
 
-/**
- * Check if a 32-byte buffer represents a valid ed25519 curve point.
- * Ed25519 curve: -x² + y² = 1 + d*x²*y²  over GF(p) where p = 2^255 - 19
- * 
- * Decode y from the 32 bytes, compute x² = (y² - 1) / (d*y² + 1),
- * then check if x² is a quadratic residue (QR) mod p.
- */
-function isOnCurve(bytes) {
-  const p = (1n << 255n) - 19n;
-  const d = -121665n * modInverse(121666n, p) % p;
-
-  // Read y-coordinate (little-endian, clear top bit which is sign of x)
-  let y = 0n;
-  for (let i = 0; i < 32; i++) {
-    y |= BigInt(bytes[i]) << (BigInt(i) * 8n);
-  }
-  y &= (1n << 255n) - 1n; // Clear top bit
-
-  if (y >= p) return false;
-
-  // y² mod p
-  const y2 = modPow(y, 2n, p);
-  
-  // x² = (y² - 1) * inverse(d*y² + 1) mod p
-  const num = ((y2 - 1n) % p + p) % p;
-  const den = ((d * y2 + 1n) % p + p) % p;
-  const denInv = modInverse(den, p);
-  if (denInv === null) return false;
-  
-  const x2 = (num * denInv) % p;
-  
-  // Check if x² is a quadratic residue: x^((p-1)/2) == 1 mod p
-  if (x2 === 0n) return true;
-  const euler = modPow(x2, (p - 1n) / 2n, p);
-  return euler === 1n;
-}
-
-function modPow(base, exp, mod) {
-  let result = 1n;
-  base = ((base % mod) + mod) % mod;
-  while (exp > 0n) {
-    if (exp & 1n) result = (result * base) % mod;
-    exp >>= 1n;
-    base = (base * base) % mod;
-  }
-  return result;
-}
-
-function modInverse(a, mod) {
-  return modPow(((a % mod) + mod) % mod, mod - 2n, mod);
-}
-
 // ============= MessageV0 Builder =============
 
 /**