nansen-cli 1.25.0 → 1.26.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # 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
+
+- [#367](https://github.com/nansen-ai/nansen-cli/pull/367) [`9fea10a`](https://github.com/nansen-ai/nansen-cli/commit/9fea10a844acbaccf37a348dfd4efd5c32f76a4a) Thanks [@kome12](https://github.com/kome12)! - add --premium-labels flag to tgm/holders, tgm/pnl-leaderboard, tgm/perp-pnl-leaderboard, and perp-leaderboard endpoints
+
 ## 1.25.0
 
 ### Minor Changes

package/package.json

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

package/skills/nansen-trading/SKILL.md

@@ -85,13 +85,15 @@ nansen trade execute --quote "$quote_id"
 
 ## Amounts
 
-By default, `--amount` accepts **integer base units** (lamports, wei, etc). Use `--amount-unit token` to specify human-readable token amounts instead — the CLI resolves decimals locally and sends base units to the API.
+By default, `--amount` accepts **integer base units** (lamports, wei, etc). Use `--amount-unit token` for human-readable token amounts, or `--amount-unit usd` to specify a USD value — the CLI resolves price and decimals automatically.
 
 ```bash
 # Base units (default)
 nansen trade quote --chain solana --from SOL --to USDC --amount 1000000000
 # Token units (0.5 SOL = 500000000 lamports, resolved automatically)
 nansen trade quote --chain solana --from SOL --to USDC --amount 0.5 --amount-unit token
+# USD amount ($50 worth of SOL, price resolved via Nansen search API)
+nansen trade quote --chain solana --from SOL --to USDC --amount 50 --amount-unit usd
 ```
 
 | Token | Decimals | 1 token = |
@@ -100,25 +102,43 @@ nansen trade quote --chain solana --from SOL --to USDC --amount 0.5 --amount-uni
 | ETH | 18 | `1000000000000000000` |
 | USDC | 6 | `1000000` |
 
-If the user says "$20 worth of X", you must convert USD → token amount, then either pass base units or use `--amount-unit token`. For example, to buy $20 of SOL at $150/SOL: $20 ÷ $150 = 0.1333 SOL → `--amount 0.1333 --amount-unit token`. Use a price lookup (e.g. `nansen research token info`) to get the current price first.
+If the user says "$20 worth of X", use `--amount-unit usd` directly — no manual conversion needed. The CLI fetches the current price and converts for you.
 
 ## Flags
 
+### `trade quote` flags
+
 | Flag | Purpose |
 |------|---------|
 | `--chain` | Source chain: `solana` or `base` |
 | `--to-chain` | Destination chain for cross-chain swap (omit for same-chain) |
 | `--from` | Source token (symbol or address) |
 | `--to` | Destination token (symbol or address, resolved against destination chain) |
-| `--amount` | Amount in base units (integer), or token units with `--amount-unit token` |
-| `--amount-unit` | Set to `token` to specify amount in token units (e.g. 0.5 SOL) |
+| `--amount` | Amount in base units (integer), or token/USD units with `--amount-unit` |
+| `--amount-unit` | `token` for token units (e.g. 0.5 SOL), `usd` for USD (e.g. 50), `base` = default |
 | `--wallet` | Wallet name (default: default wallet) |
 | `--to-wallet` | Destination wallet address (auto-derived for cross-chain if omitted) |
 | `--slippage` | Slippage tolerance as decimal (e.g. 0.03) |
-| `--quote` | Quote ID for execute |
+| `--auto-slippage` | Enable auto slippage calculation |
+| `--max-auto-slippage` | Max auto slippage when `--auto-slippage` is enabled |
+| `--swap-mode` | `exactIn` (default) or `exactOut` |
+
+### `trade execute` flags
+
+| Flag | Purpose |
+|------|---------|
+| `--quote` | Quote ID from `trade quote` |
+| `--wallet` | Wallet name (default: default wallet) |
+| `--quote-index` | Pin a specific quote by index (0-based) when multiple quotes were returned |
 | `--no-simulate` | Skip pre-broadcast simulation |
-| `--tx-hash` | Source tx hash (for bridge-status) |
+
+### `trade bridge-status` flags
+
+| Flag | Purpose |
+|------|---------|
+| `--tx-hash` | Source tx hash |
 | `--from-chain` | Source chain (for bridge-status) |
+| `--to-chain` | Destination chain (for bridge-status) |
 
 ## Environment Variables
 

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);
@@ -971,19 +971,21 @@ export class NansenAPI {
   }
 
   async tokenHolders(params = {}) {
-    const { tokenAddress, chain = 'solana', labelType = 'all_holders', filters = {}, orderBy, pagination } = params;
+    const { tokenAddress, chain = 'solana', labelType = 'all_holders', filters = {}, orderBy, pagination, withLabels } = params;
     if (tokenAddress) {
       const validation = validateTokenAddress(tokenAddress, chain);
       if (!validation.valid) throw new NansenError(validation.error, validation.code);
     }
-    return this.request('/api/v1/tgm/holders', {
+    const body = {
       token_address: tokenAddress,
       chain,
       label_type: labelType,
       filters,
       order_by: orderBy,
       pagination
-    });
+    };
+    if (withLabels !== undefined) body.premium_labels = withLabels;
+    return this.request('/api/v1/tgm/holders', body);
   }
 
   async tokenFlows(params = {}) {
@@ -1027,19 +1029,21 @@ export class NansenAPI {
   }
 
   async tokenPnlLeaderboard(params = {}) {
-    const { tokenAddress, chain = 'solana', filters = {}, orderBy, pagination, days = 30 } = params;
+    const { tokenAddress, chain = 'solana', filters = {}, orderBy, pagination, days = 30, withLabels } = params;
     if (tokenAddress) {
       const validation = validateTokenAddress(tokenAddress, chain);
       if (!validation.valid) throw new NansenError(validation.error, validation.code);
     }
-    return this.request('/api/v1/tgm/pnl-leaderboard', {
+    const body = {
       token_address: tokenAddress,
       chain,
       date: buildDateRange(days),
       filters,
       order_by: orderBy,
       pagination
-    });
+    };
+    if (withLabels !== undefined) body.premium_labels = withLabels;
+    return this.request('/api/v1/tgm/pnl-leaderboard', body);
   }
 
   async tokenWhoBoughtSold(params = {}) {
@@ -1126,14 +1130,16 @@ export class NansenAPI {
   }
 
   async tokenPerpPnlLeaderboard(params = {}) {
-    const { tokenSymbol, filters = {}, orderBy, pagination, days = 30 } = params;
-    return this.request('/api/v1/tgm/perp-pnl-leaderboard', {
+    const { tokenSymbol, filters = {}, orderBy, pagination, days = 30, withLabels } = params;
+    const body = {
       token_symbol: tokenSymbol,
       date: buildDateRange(days),
       filters,
       order_by: orderBy,
       pagination
-    });
+    };
+    if (withLabels !== undefined) body.premium_labels = withLabels;
+    return this.request('/api/v1/tgm/perp-pnl-leaderboard', body);
   }
 
   async tokenIndicators(params = {}) {
@@ -1187,13 +1193,15 @@ export class NansenAPI {
   }
 
   async perpLeaderboard(params = {}) {
-    const { filters = {}, orderBy, pagination, days = 30 } = params;
-    return this.request('/api/v1/perp-leaderboard', {
+    const { filters = {}, orderBy, pagination, days = 30, withLabels } = params;
+    const body = {
       date: buildDateRange(days),
       filters,
       order_by: orderBy,
       pagination
-    });
+    };
+    if (withLabels !== undefined) body.premium_labels = withLabels;
+    return this.request('/api/v1/perp-leaderboard', body);
   }
 
   // ============= Prediction Market Endpoints =============

package/src/cli.js

@@ -30,6 +30,23 @@ export const SCHEMA = { version: VERSION, ...schemaDefinition };
 
 // ============= Pagination =============
 
+/**
+ * Resolve a boolean CLI option that can be passed as either:
+ *   --flag          (flag=true, options key absent)
+ *   --flag true     (options key = 'true')
+ *   --flag false    (options key = 'false')
+ * Returns true/false/undefined (undefined = not supplied).
+ */
+export function resolveBooleanOption(options, flags, key) {
+  if (options[key] !== undefined) {
+    const val = String(options[key]).toLowerCase();
+    if (val === 'true' || val === '1') return true;
+    if (val === 'false' || val === '0') return false;
+  }
+  if (flags[key] !== undefined) return Boolean(flags[key]);
+  return undefined;
+}
+
 export function buildPagination(options) {
   if (!options.limit && !options.page) return undefined;
   return {
@@ -1093,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;
@@ -1237,14 +1254,17 @@ export function buildCommands(deps = {}) {
           }
           return result;
         },
-        'holders': () => apiInstance.tokenHolders({ tokenAddress, chain, labelType: onlySmartMoney ? 'smart_money' : 'all_holders', filters, orderBy, pagination }),
+        'holders': () => apiInstance.tokenHolders({ tokenAddress, chain, labelType: onlySmartMoney ? 'smart_money' : 'all_holders', filters, orderBy, pagination, withLabels: resolveBooleanOption(options, flags, 'premium-labels') }),
         'flows': () => {
           const date = parseDateOption(options.date, days);
           const label = options.label;
           return apiInstance.tokenFlows({ tokenAddress, chain, label, filters, orderBy, pagination, days, date });
         },
         'dex-trades': () => apiInstance.tokenDexTrades({ tokenAddress, chain, onlySmartMoney, filters, orderBy, pagination, days }),
-        'pnl': () => apiInstance.tokenPnlLeaderboard({ tokenAddress, chain, filters, orderBy, pagination, days }),
+        'pnl': () => {
+          const withLabels = resolveBooleanOption(options, flags, 'premium-labels');
+          return apiInstance.tokenPnlLeaderboard({ tokenAddress, chain, filters, orderBy, pagination, days, withLabels });
+        },
         'who-bought-sold': () => {
           const date = parseDateOption(options.date, days);
           const buyOrSell = (options['buy-or-sell'] || 'BUY').toUpperCase();
@@ -1260,7 +1280,10 @@ export function buildCommands(deps = {}) {
         'jup-dca': () => apiInstance.tokenJupDca({ tokenAddress, filters, orderBy, pagination }),
         'perp-trades': () => apiInstance.tokenPerpTrades({ tokenSymbol, filters, orderBy, pagination, days }),
         'perp-positions': () => apiInstance.tokenPerpPositions({ tokenSymbol, filters, orderBy, pagination }),
-        'perp-pnl-leaderboard': () => apiInstance.tokenPerpPnlLeaderboard({ tokenSymbol, filters, orderBy, pagination, days }),
+        'perp-pnl-leaderboard': () => {
+          const withLabels = resolveBooleanOption(options, flags, 'premium-labels');
+          return apiInstance.tokenPerpPnlLeaderboard({ tokenSymbol, filters, orderBy, pagination, days, withLabels });
+        },
         'help': () => ({
           commands: ['info', 'ohlcv', 'screener', 'holders', 'flows', 'dex-trades', 'pnl', 'who-bought-sold', 'flow-intelligence', 'transfers', 'jup-dca', 'perp-trades', 'perp-positions', 'perp-pnl-leaderboard'],
           description: 'Token God Mode endpoints',
@@ -1334,7 +1357,10 @@ export function buildCommands(deps = {}) {
 
       const handlers = {
         'screener': () => apiInstance.perpScreener({ filters, orderBy, pagination, days }),
-        'leaderboard': () => apiInstance.perpLeaderboard({ filters, orderBy, pagination, days }),
+        'leaderboard': () => {
+          const withLabels = resolveBooleanOption(options, flags, 'premium-labels');
+          return apiInstance.perpLeaderboard({ filters, orderBy, pagination, days, withLabels });
+        },
         'help': () => ({
           commands: ['screener', 'leaderboard'],
           description: 'Perpetual futures analytics endpoints',

package/src/schema.json

@@ -283,7 +283,13 @@
                 },
                 "label": {
                   "description": "Holder segment to filter flows by",
-                  "enum": ["top_100_holders", "smart_money", "public_figure", "whale", "exchange"],
+                  "enum": [
+                    "top_100_holders",
+                    "smart_money",
+                    "public_figure",
+                    "whale",
+                    "exchange"
+                  ],
                   "default": "top_100_holders"
                 }
               }
@@ -303,7 +309,10 @@
                 },
                 "buy-or-sell": {
                   "description": "Filter by buy or sell side",
-                  "enum": ["BUY", "SELL"],
+                  "enum": [
+                    "BUY",
+                    "SELL"
+                  ],
                   "default": "BUY"
                 }
               }
@@ -347,6 +356,10 @@
                 },
                 "token": {
                   "required": true
+                },
+                "premium-labels": {
+                  "description": "Include premium Nansen labels in the response (true=premium, false=free-tier). When omitted, uses API default.",
+                  "type": "boolean"
                 }
               }
             },
@@ -362,6 +375,10 @@
                 },
                 "days": {
                   "default": 30
+                },
+                "premium-labels": {
+                  "description": "Include premium Nansen labels in the response (true=premium, false=free-tier). When omitted, uses API default.",
+                  "type": "boolean"
                 }
               }
             },
@@ -374,6 +391,10 @@
                 },
                 "days": {
                   "default": 30
+                },
+                "premium-labels": {
+                  "description": "Include premium Nansen labels in the response (true=premium, false=free-tier). When omitted, uses API default.",
+                  "type": "boolean"
                 }
               }
             },
@@ -515,6 +536,10 @@
               "options": {
                 "days": {
                   "default": 30
+                },
+                "premium-labels": {
+                  "description": "Include premium Nansen labels in the response (true=premium, false=free-tier). When omitted, uses API default.",
+                  "type": "boolean"
                 }
               }
             }
@@ -796,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 =============
 
 /**