mcpField
N
nansen-wallet

nansen-wallet

github.com/nansen-ai其他144124 次安装今天更新
代码仓库

关于 nansen-wallet

nansen-wallet 是使用 Nansen CLI 管理钱包的技能，涵盖创建、查看、发送、导出和删除。它规定由用户提供创建密码，并支持从操作系统钥匙串或备用凭据文件自动读取密码。

主要功能

  1. 01创建、列出和查看钱包
  2. 02在 EVM 或 Solana 上发送原生代币
  3. 03通过 dry-run 预览转账
  4. 04导出或删除钱包
  5. 05从钥匙串或凭据文件读取密码

适用场景

  1. 01使用用户提供的密码创建钱包
  2. 02广播前预览代币转账
  3. 03将钱包密码迁移至安全存储

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/nansen-ai/nansen-cli --skill nansen-wallet

安装后在 Claude Code 中输入/nansen-wallet确认已加载。

详细介绍

钱包

身份验证设置

# Save API key (non-interactive)
nansen login --api-key <key>
# Or via env var:
NANSEN_API_KEY=<key> nansen login

# Verify
nansen research profiler labels --address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --chain ethereum

创建钱包（Agent 两步流程）

创建钱包需要人类用户提供密码。Agent 绝不能自行生成或存储密码。

第 1 步（Agent → 人类）： 请用户提供钱包密码（至少 12 个字符）。

第 2 步（Agent 执行）： 使用用户提供的密码运行创建命令。

NANSEN_WALLET_PASSWORD="<password_from_user>" nansen wallet create

创建后，CLI 会自动保存密码：

  • OS 钥匙串（macOS Keychain、Linux secret-tool、Windows Credential Manager）——安全，优先使用
  • ~/.nansen/wallets/.credentials 文件——当没有可用的钥匙串时使用的不安全备用方式（例如容器、CI）

所有后续钱包操作都会自动获取密码——无需环境变量或人工输入。

如果使用 .credentials 文件备用方式，CLI 会在每次操作时打印警告。之后如需迁移到安全存储，请运行 nansen wallet secure。

密码自动解析顺序
  1. NANSEN_WALLET_PASSWORD 环境变量（如果已设置）
  2. OS 钥匙串（创建钱包时自动保存）
  3. ~/.nansen/wallets/.credentials 文件（不安全的备用方式，会显示警告）
  4. 结构化 JSON 错误及说明（以上方式均不可用时）
Agent 必须遵守的规则
  • 绝不能自行生成密码——始终向人类用户询问
  • 绝不能将密码存储在文件、内存、日志或对话历史记录中
  • 绝不能使用 --human 标志——该标志会启用交互式提示，Agent 无法处理
  • 创建钱包后，后续操作无需密码——钥匙串会处理
  • 如果收到 PASSWORD_REQUIRED 错误，请再次询问用户提供密码

创建

# Ask the user for a password first, then:
NANSEN_WALLET_PASSWORD="<password_from_user>" nansen wallet create
# Or with a custom name:
NANSEN_WALLET_PASSWORD="<password_from_user>" nansen wallet create --name trading

列出和查看

nansen wallet list
nansen wallet show <name>
nansen wallet default <name>

发送

# Send native token (SOL, ETH) — password auto-resolved from keychain
nansen wallet send --to <addr> --amount 1.5 --chain solana

# Send entire balance
nansen wallet send --to <addr> --chain evm --max

# Dry run (preview, no broadcast)
nansen wallet send --to <addr> --amount 1.0 --chain evm --dry-run

导出和删除

# Password auto-resolved from keychain
nansen wallet export <name>
nansen wallet delete <name>

忘记密码

# Remove saved password from all stores (keychain + .credentials file)
nansen wallet forget-password

迁移到安全存储

nansen wallet secure

有关详细的迁移步骤（从 ~/.nansen/.env、.credentials 或仅使用环境变量的配置迁移），请参阅 nansen-wallet-migration 技能。

标志

标志用途
--to收款地址
--amount发送金额
--chainevm 或 solana
--max发送全部余额
--dry-run预览但不广播
--human启用交互式提示（仅供人类在终端中使用——Agent 绝不能使用此标志）
--unsafe-no-password跳过加密（密钥以明文存储——不推荐）

环境变量

变量用途
NANSEN_WALLET_PASSWORD钱包加密密码——仅在首次运行 wallet create 时需要。之后由 OS 钥匙串处理。
NANSEN_API_KEYAPI 密钥（也可通过 nansen login --api-key <key> 设置）
NANSEN_EVM_RPC自定义 EVM RPC 端点
NANSEN_SOLANA_RPC自定义 Solana RPC 端点

评论

支持 Markdown