nansen-cli 1.45.0 → 1.46.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +64 -0
- package/README.md +29 -4
- package/package.json +1 -1
- package/skills/nansen-trading/SKILL.md +20 -1
- package/skills/nansen-wallet-keychain-migration/SKILL.md +18 -13
- package/skills/nansen-wallet-manager/SKILL.md +15 -1
- package/src/api.js +118 -26
- package/src/bridge.js +187 -68
- package/src/chain-ids.js +1 -2
- package/src/cli.js +314 -94
- package/src/commands/agent.js +5 -2
- package/src/commands/alerts.js +1 -1
- package/src/commands/mcp.js +2 -2
- package/src/commands/research.js +4 -2
- package/src/ens.js +3 -1
- package/src/execute-guard.js +116 -0
- package/src/limit-order.js +9 -1
- package/src/perp.js +20 -9
- package/src/query-options.js +38 -6
- package/src/response-meta.js +1 -1
- package/src/schema.json +124 -22
- package/src/trading.js +545 -16
- package/src/transfer.js +22 -3
- package/src/wallet.js +133 -3
- package/src/walletconnect-trading.js +5 -3
- package/src/walletconnect-x402.js +9 -5
package/src/transfer.js
CHANGED
|
@@ -55,7 +55,18 @@ function parseAmount(amountStr, decimals) {
|
|
|
55
55
|
const parts = str.split('.');
|
|
56
56
|
const whole = parts[0] || '0';
|
|
57
57
|
let frac = (parts[1] || '').padEnd(decimals, '0').slice(0, decimals);
|
|
58
|
-
|
|
58
|
+
const raw = BigInt(whole) * (10n ** BigInt(decimals)) + BigInt(frac);
|
|
59
|
+
// Zero base units would still be signed and broadcast: a native send that
|
|
60
|
+
// pays gas to move nothing, a token transfer of 0, or a limit order created
|
|
61
|
+
// with inputAmount "0". Refuse both a literal zero and a positive amount
|
|
62
|
+
// that truncates to zero at this token's precision.
|
|
63
|
+
if (raw === 0n) {
|
|
64
|
+
if (/^0+(\.0+)?$/.test(str)) throw new Error('Amount must be greater than zero');
|
|
65
|
+
throw new Error(
|
|
66
|
+
`Amount ${str} is below the smallest unit of this token (${decimals} decimals) and would send nothing. Use at least ${decimals === 0 ? '1' : '0.' + '0'.repeat(decimals - 1) + '1'}.`,
|
|
67
|
+
);
|
|
68
|
+
}
|
|
69
|
+
return raw;
|
|
59
70
|
}
|
|
60
71
|
|
|
61
72
|
function formatAmount(rawAmount, decimals) {
|
|
@@ -334,7 +345,16 @@ export async function getTokenInfo(rpcUrl, mint) {
|
|
|
334
345
|
if (!info || !info.value) throw new Error(`Token mint ${mint} not found`);
|
|
335
346
|
const owner = info.value.owner;
|
|
336
347
|
const decimals = info.value.data?.parsed?.info?.decimals;
|
|
337
|
-
|
|
348
|
+
// The decimals scale every human-readable --amount into base units, so a
|
|
349
|
+
// guess is never safe. When the RPC cannot jsonParse the mint (an owner
|
|
350
|
+
// program it does not know, or raw base64 data) the account is not a mint
|
|
351
|
+
// we can size a transfer for — say so instead of assuming 9 decimals.
|
|
352
|
+
if (!Number.isInteger(decimals) || decimals < 0) {
|
|
353
|
+
throw new Error(
|
|
354
|
+
`Could not determine decimals for token mint ${mint}: the RPC did not return parsed token data (owner ${owner ?? 'unknown'}). Check that the address is an SPL token mint, or try a different Solana RPC.`,
|
|
355
|
+
);
|
|
356
|
+
}
|
|
357
|
+
return { tokenProgram: owner, decimals };
|
|
338
358
|
}
|
|
339
359
|
|
|
340
360
|
/**
|
|
@@ -957,7 +977,6 @@ function getExplorerUrl(chain, txHash) {
|
|
|
957
977
|
bnb: 'https://bscscan.com/tx/',
|
|
958
978
|
avalanche: 'https://snowtrace.io/tx/',
|
|
959
979
|
linea: 'https://lineascan.build/tx/',
|
|
960
|
-
scroll: 'https://scrollscan.com/tx/',
|
|
961
980
|
mantle: 'https://mantlescan.xyz/tx/',
|
|
962
981
|
};
|
|
963
982
|
const base = explorers[chain] || explorers.ethereum;
|
package/src/wallet.js
CHANGED
|
@@ -580,6 +580,25 @@ export async function deleteWallet(name, password) {
|
|
|
580
580
|
|
|
581
581
|
// ============= CLI Command Builder =============
|
|
582
582
|
|
|
583
|
+
/**
|
|
584
|
+
* Every `nansen wallet` subcommand the dispatcher below accepts, in the order
|
|
585
|
+
* they are advertised to users. `help` is deliberately absent: it is the
|
|
586
|
+
* fallback, not a capability. The top-level help banner builds its wallet line
|
|
587
|
+
* from this list, and command-surface.test.js checks the handlers, README and
|
|
588
|
+
* src/schema.json against it so the four cannot drift apart.
|
|
589
|
+
*/
|
|
590
|
+
export const WALLET_SUBCOMMANDS = [
|
|
591
|
+
'create',
|
|
592
|
+
'list',
|
|
593
|
+
'show',
|
|
594
|
+
'export',
|
|
595
|
+
'default',
|
|
596
|
+
'delete',
|
|
597
|
+
'send',
|
|
598
|
+
'forget-password',
|
|
599
|
+
'secure',
|
|
600
|
+
];
|
|
601
|
+
|
|
583
602
|
/**
|
|
584
603
|
* Build wallet command handlers for integration into CLI.
|
|
585
604
|
*/
|
|
@@ -759,7 +778,45 @@ export function buildWalletCommands(deps = {}) {
|
|
|
759
778
|
'export': async () => {
|
|
760
779
|
const name = options.name || args[1];
|
|
761
780
|
if (!name) {
|
|
762
|
-
throw new CommandError('Usage: nansen wallet export <name>', 'MISSING_ARGS');
|
|
781
|
+
throw new CommandError('Usage: nansen wallet export <name> [--reveal | --file <path>]', 'MISSING_ARGS');
|
|
782
|
+
}
|
|
783
|
+
|
|
784
|
+
// Bare `--file` parses as flags.file, a repeated or JSON-array `--file`
|
|
785
|
+
// arrives as a non-string, and `--file ""` (an unset shell variable) is
|
|
786
|
+
// an empty path that would only fail at open time — reject all of them
|
|
787
|
+
// before any secret is decrypted.
|
|
788
|
+
const wantsFile = options.file !== undefined || flags.file;
|
|
789
|
+
if (wantsFile && (typeof options.file !== 'string' || options.file === '')) {
|
|
790
|
+
throw new CommandError('--file requires a path: nansen wallet export <name> --file <path>', 'INVALID_INPUT');
|
|
791
|
+
}
|
|
792
|
+
if (wantsFile && flags.reveal) {
|
|
793
|
+
throw new CommandError('Choose one of --reveal or --file <path>, not both.', 'INVALID_INPUT');
|
|
794
|
+
}
|
|
795
|
+
|
|
796
|
+
// Default: redacted. No decryption, no password — secrets never
|
|
797
|
+
// materialize unless the caller explicitly asked for them.
|
|
798
|
+
if (!flags.reveal && !wantsFile) {
|
|
799
|
+
try {
|
|
800
|
+
const result = showWallet(name);
|
|
801
|
+
if (result.provider !== 'local') {
|
|
802
|
+
throw new Error(`${result.provider} wallets don't support key export. Keys are managed by the provider.`);
|
|
803
|
+
}
|
|
804
|
+
log(`\n Wallet "${result.name}" — private keys are NOT shown by default.\n`);
|
|
805
|
+
log(` EVM:`);
|
|
806
|
+
log(` Address: ${result.evm}`);
|
|
807
|
+
log(` Private Key: [REDACTED]`);
|
|
808
|
+
log(` Solana:`);
|
|
809
|
+
log(` Address: ${result.solana}`);
|
|
810
|
+
log(` Private Key: [REDACTED]`);
|
|
811
|
+
log('');
|
|
812
|
+
log(' To export the private keys:');
|
|
813
|
+
log(` nansen wallet export ${result.name} --file <path> safer: writes a file only you can read (0600)`);
|
|
814
|
+
log(` nansen wallet export ${result.name} --reveal prints them in plaintext to stdout`);
|
|
815
|
+
log('');
|
|
816
|
+
return;
|
|
817
|
+
} catch (err) {
|
|
818
|
+
throw new CommandError(`❌ ${err.message}`, 'EXPORT_FAILED');
|
|
819
|
+
}
|
|
763
820
|
}
|
|
764
821
|
|
|
765
822
|
const config = getWalletConfig();
|
|
@@ -769,6 +826,69 @@ export function buildWalletCommands(deps = {}) {
|
|
|
769
826
|
}
|
|
770
827
|
try {
|
|
771
828
|
const result = exportWallet(name, password);
|
|
829
|
+
|
|
830
|
+
if (wantsFile) {
|
|
831
|
+
// Exclusive create first, write second: unlink-on-failure below
|
|
832
|
+
// is only safe on a file THIS invocation created — a blind 'wx'
|
|
833
|
+
// writeFileSync can fail (e.g. EMFILE) without telling us whether
|
|
834
|
+
// the path pre-existed. Failures are thrown as CommandErrors with
|
|
835
|
+
// purpose-specific codes (FILE_EXISTS / FILE_WRITE_FAILED) so agents
|
|
836
|
+
// branch on the code instead of the message; the raw fs error
|
|
837
|
+
// (key-free, but noisy) stays attached as `cause`, out of the envelope.
|
|
838
|
+
let fd;
|
|
839
|
+
try {
|
|
840
|
+
fd = fs.openSync(options.file, 'wx', 0o600);
|
|
841
|
+
} catch (err) {
|
|
842
|
+
if (err.code === 'EEXIST' || err.code === 'EISDIR') {
|
|
843
|
+
// Linux reports an existing directory (or symlink) as EEXIST; macOS
|
|
844
|
+
// can report a directory as EISDIR. Both mean "already there", so
|
|
845
|
+
// neither advises deleting it.
|
|
846
|
+
throw new CommandError(`Path already exists: ${options.file} — refusing to overwrite. Choose a path that does not exist yet.`, 'FILE_EXISTS', null, { cause: err });
|
|
847
|
+
}
|
|
848
|
+
throw new CommandError(`Could not create ${options.file} (${err.code || 'open failed'}). Nothing was written.`, 'FILE_WRITE_FAILED', null, { cause: err });
|
|
849
|
+
}
|
|
850
|
+
// Linear lifecycle: pin the mode, exactly one write attempt,
|
|
851
|
+
// exactly one close attempt (a failed closeSync may still have
|
|
852
|
+
// released the fd, so it is never retried), then a single
|
|
853
|
+
// failure gate.
|
|
854
|
+
let ioErr = null;
|
|
855
|
+
try {
|
|
856
|
+
// The 0o600 passed to openSync is filtered through the process
|
|
857
|
+
// umask (a 0277 umask leaves 0400), so pin the final mode on
|
|
858
|
+
// the fd we own. Runs before any key bytes land, so a failure
|
|
859
|
+
// here takes the same unlink path as a failed write.
|
|
860
|
+
fs.fchmodSync(fd, 0o600);
|
|
861
|
+
fs.writeFileSync(fd, JSON.stringify(result, null, 2) + '\n');
|
|
862
|
+
} catch (err) {
|
|
863
|
+
ioErr = err;
|
|
864
|
+
}
|
|
865
|
+
try {
|
|
866
|
+
fs.closeSync(fd);
|
|
867
|
+
} catch (err) {
|
|
868
|
+
ioErr = ioErr || err;
|
|
869
|
+
}
|
|
870
|
+
if (ioErr) {
|
|
871
|
+
// A failure mid-write or at close (e.g. ENOSPC) can leave a
|
|
872
|
+
// partial file holding key fragments — remove what we created.
|
|
873
|
+
let disk = 'Nothing was left on disk.';
|
|
874
|
+
try {
|
|
875
|
+
fs.unlinkSync(options.file);
|
|
876
|
+
} catch (rmErr) {
|
|
877
|
+
if (rmErr.code !== 'ENOENT') {
|
|
878
|
+
disk = `A partial file may remain at ${options.file} — delete it manually.`;
|
|
879
|
+
}
|
|
880
|
+
}
|
|
881
|
+
throw new CommandError(`Could not write ${options.file} (${ioErr.code || 'write failed'}). ${disk}`, 'FILE_WRITE_FAILED', null, { cause: ioErr });
|
|
882
|
+
}
|
|
883
|
+
log(`\n✓ Private keys for "${result.name}" written to ${options.file} (permissions 0600).`);
|
|
884
|
+
log(' Delete the file as soon as the keys are imported elsewhere.');
|
|
885
|
+
log('');
|
|
886
|
+
return;
|
|
887
|
+
}
|
|
888
|
+
|
|
889
|
+
if (deps.isTTY ?? process.stdout.isTTY) {
|
|
890
|
+
process.stderr.write('⚠️ Printing private keys to an interactive terminal. They will remain in your scrollback and may be captured by screen sharing or terminal logging. Prefer --file <path>.\n');
|
|
891
|
+
}
|
|
772
892
|
log(`\n⚠️ Private keys for "${result.name}" — do not share!\n`);
|
|
773
893
|
log(` EVM:`);
|
|
774
894
|
log(` Address: ${result.evm.address}`);
|
|
@@ -779,6 +899,9 @@ export function buildWalletCommands(deps = {}) {
|
|
|
779
899
|
log('');
|
|
780
900
|
return;
|
|
781
901
|
} catch (err) {
|
|
902
|
+
// --file failures already carry their own code; only exportWallet
|
|
903
|
+
// (decrypt / lookup) failures need the generic wrap.
|
|
904
|
+
if (err instanceof CommandError) throw err;
|
|
782
905
|
throw new CommandError(`❌ ${err.message}`, 'EXPORT_FAILED');
|
|
783
906
|
}
|
|
784
907
|
},
|
|
@@ -1019,7 +1142,10 @@ COMMANDS:
|
|
|
1019
1142
|
Create a new wallet pair (EVM + Solana)
|
|
1020
1143
|
list List all wallets
|
|
1021
1144
|
show <name> Show wallet addresses
|
|
1022
|
-
export <name>
|
|
1145
|
+
export <name> [--reveal | --file <path>]
|
|
1146
|
+
Export private keys (local wallets only, requires password).
|
|
1147
|
+
Redacted by default: --reveal prints plaintext to stdout,
|
|
1148
|
+
--file writes them to a new file only you can read (0600)
|
|
1023
1149
|
default <name> Set the default wallet
|
|
1024
1150
|
delete <name> Delete a wallet
|
|
1025
1151
|
send --to <address> --amount <number> --chain <evm|solana> [--token <address>] [--wallet <name>] [--max] [--dry-run]
|
|
@@ -1037,6 +1163,8 @@ OPTIONS:
|
|
|
1037
1163
|
--token <address> Token contract/mint address (optional, sends native if omitted)
|
|
1038
1164
|
--wallet <name> Wallet to use (optional, uses default if omitted; use "walletconnect" or "wc" for WalletConnect, EVM only)
|
|
1039
1165
|
--max Send entire balance (deducts gas for native transfers)
|
|
1166
|
+
--reveal Export: print private keys in plaintext to stdout (explicit acknowledgement)
|
|
1167
|
+
--file <path> Export: write private keys to <path> (created 0600, refuses to overwrite)
|
|
1040
1168
|
--unsafe-no-password Skip encryption — private keys stored UNENCRYPTED on disk (local only)
|
|
1041
1169
|
--human Enable interactive prompts (for human terminal use only)
|
|
1042
1170
|
|
|
@@ -1060,7 +1188,9 @@ EXAMPLES:
|
|
|
1060
1188
|
NANSEN_WALLET_PASSWORD=mypass nansen wallet create --name trading
|
|
1061
1189
|
nansen wallet create --name agent-wallet --provider privy
|
|
1062
1190
|
nansen wallet list
|
|
1063
|
-
nansen wallet export trading
|
|
1191
|
+
nansen wallet export trading # redacted (addresses only)
|
|
1192
|
+
nansen wallet export trading --file backup.json # keys → 0600 file, nothing on stdout
|
|
1193
|
+
nansen wallet export trading --reveal # keys → stdout (plaintext)
|
|
1064
1194
|
nansen wallet default trading
|
|
1065
1195
|
nansen wallet send --to 0x742d35Cc... --amount 1.5 --chain evm
|
|
1066
1196
|
nansen wallet send --to 9WzDXw... --amount 0.1 --chain solana --token So11...
|
|
@@ -15,10 +15,12 @@ import { encodeApproveCalldata } from './trade-validation.js';
|
|
|
15
15
|
const SOLANA_MAINNET_CHAIN = 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp';
|
|
16
16
|
|
|
17
17
|
/**
|
|
18
|
-
* Extract the first JSON
|
|
19
|
-
* The CLI may print status messages before the JSON result
|
|
18
|
+
* Extract the first JSON object from walletconnect CLI output.
|
|
19
|
+
* The CLI may print status messages before the JSON result, and may
|
|
20
|
+
* pretty-print the result across several lines. Shared with the x402
|
|
21
|
+
* payment path so both read the CLI's output the same way.
|
|
20
22
|
*/
|
|
21
|
-
function parseWcJson(output) {
|
|
23
|
+
export function parseWcJson(output) {
|
|
22
24
|
const lines = output.split('\n');
|
|
23
25
|
const startIdx = lines.findIndex(l => l.trimStart().startsWith('{'));
|
|
24
26
|
if (startIdx === -1) throw new Error('No JSON output from walletconnect');
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
import crypto from 'crypto';
|
|
9
9
|
import { NansenError, ErrorCode } from './api.js';
|
|
10
10
|
import { wcExec } from './walletconnect-exec.js';
|
|
11
|
-
import { getWalletConnectAddress } from './walletconnect-trading.js';
|
|
11
|
+
import { getWalletConnectAddress, parseWcJson } from './walletconnect-trading.js';
|
|
12
12
|
import { evaluatePaymentRequirement, resolvePaymentAmount, resolvePayTo } from './x402-policy.js';
|
|
13
13
|
|
|
14
14
|
/**
|
|
@@ -201,10 +201,14 @@ export async function handleX402Payment(paymentRequirements) {
|
|
|
201
201
|
let signResult;
|
|
202
202
|
try {
|
|
203
203
|
const output = await wcExec('walletconnect', ['sign-typed-data', typedDataJson], 120000);
|
|
204
|
-
// walletconnect may print status messages before the
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
204
|
+
// walletconnect may print status messages before the result and may
|
|
205
|
+
// pretty-print it over several lines. Reading only the first line that
|
|
206
|
+
// starts with "{" used to throw on a multi-line result — after the user
|
|
207
|
+
// had already approved and signed the payment in their wallet.
|
|
208
|
+
signResult = parseWcJson(output);
|
|
209
|
+
if (typeof signResult?.signature !== 'string' || signResult.signature.length === 0) {
|
|
210
|
+
throw new Error('walletconnect sign-typed-data returned no signature');
|
|
211
|
+
}
|
|
208
212
|
} catch (err) {
|
|
209
213
|
throw new NansenError(
|
|
210
214
|
`x402 payment signing failed: ${err.message}`,
|