Agent skill

Nansen Wallet Manager

by nansen-ai in nansen-ai/nansen-cli

Wallet management — create (local or Privy server-side), list, show, export, send, delete.

MITAuto-check: notesBackend & APIs

Install Nansen Wallet Manager

skills CLI
$ npx skills add nansen-ai/nansen-cli --skill nansen-wallet-manager -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install nansen-ai/nansen-cli nansen-wallet-manager --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/nansen-ai/nansen-cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/nansen-wallet-manager .claude/skills/nansen-wallet-manager && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
nansen-wallet-manager
GitHub stars
139
Token cost
~2.1k tokens
SKILL.md length
807 words
Files
1
Skills in repo
32
Repo updated
First seen
Licence
MIT

At a glance

Wallet management — create (local or Privy server-side), list, show, export, send, delete.

  • Works in 4 steps: NANSEN_WALLET_PASSWORD env var (if set) → OS keychain (saved automatically on… → ~/.nansen/wallets/.credentials file… → …
  • Creating wallets
  • SKILL.md covers Authentication, Auth Setup, Wallet Providers and Privy Wallet Creation, plus 9 more sections
  • Needs NANSEN_WALLET_PASSWORD and PRIVY_APP_SECRET

What it does

Nansen Wallet Manager is an agent skill from nansen-ai/nansen-cli. Wallet management — create (local or Privy server-side), list, show, export, send, delete. Use when creating wallets, checking balances, or sending tokens.

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering Backend development. The licence is MIT.

When your agent uses it

  • Creating wallets
  • Checking balances

Example prompts

  • “/nansen-wallet-manager”

Requirements

  • A credential in NANSEN_API_KEY
  • A credential in PRIVY_APP_SECRET
  • Pre-approved tools (allowed-tools): Bash(nansen:*)

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. NANSEN_WALLET_PASSWORD env var (if set)
  2. OS keychain (saved automatically on wallet create)
  3. ~/.nansen/wallets/.credentials file (insecure fallback, with warning)
  4. Structured JSON error with instructions (if none available)

What it can do on your machine

Read from SKILL.md and the folder at commit d097942. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash(nansen:*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • NANSEN_WALLET_PASSWORD
    • PRIVY_APP_SECRET
    • NANSEN_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Nansen Wallet Manager loads about 2.1k tokens when it runs. Until then it costs about 44 tokens; SKILL.md has 807 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~44
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:187
    etailed migration steps (from `~/.nansen/.env`, `.credentials`, or env-var-only setups), see the **nansen-wallet-migrati

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from nansen-ai/nansen-cli at commit d097942, republished under its MIT licence (© nansen-ai). 807 words, ~2,144 tokens.

Download SKILL.mdSave it as .claude/skills/nansen-wallet-manager/SKILL.md (or your agent's skills folder).
name
nansen-wallet-manager
description
Wallet management — create (local or Privy server-side), list, show, export, send, delete. Use when creating wallets, checking balances, or sending tokens.
allowed-tools
Bash(nansen:*)

Authentication

Nansen account API calls accept a selected nansen:api browser session or conventional API key with the same permissions. NANSEN_API_KEY takes precedence; optional primaryEnv preserves configured-key injection. Run nansen auth status for offline selection. Cached access expiry alone permits automatic renewal during an authorized task. Stop on anonymous selection, invalid state, blocked/uncertain renewal or actual auth failure; never drop a credential or fall back to anonymous x402 payment. Browser login does not grant wallet signing, privileged service identity or a persistent MCP integration key. Preserve all confirmation, signing, sanctions and geographic checks below. Browser login is available in CLI 2.0.0 within the macOS arm64 preview scope.

Wallet

Auth Setup

Use a selected nansen:api browser session or conventional API key for Nansen account API calls. Agents should inject NANSEN_API_KEY through their environment or secret manager and use commands directly; no login is needed to persist it. Human terminal users can use explicit nansen login --human for legacy key setup. With an already injected environment key, that explicit mode saves it without prompting and requires the native auth lock binding.

bash
# Free live check of the effective API credential
nansen account

Plain nansen login instead requests fresh browser approval. It does not save an environment key or grant wallet signing/RPC authority. Wallet custody and provider credentials below remain separate.

Wallet Providers

The CLI supports two wallet providers:

Local (default)Privy (server-side)
Key storageEncrypted on diskServer-side via Privy API
Password requiredYes (min 12 chars)No
Export private keysYes (wallet export)No — keys are managed by Privy
Best forHuman users, manual tradingAgents, automated workflows
Flag--provider local (default)--provider privy
Required env varsNANSEN_WALLET_PASSWORDPRIVY_APP_ID + PRIVY_APP_SECRET

Privy Wallet Creation

Privy wallets are server-side wallets managed by the Privy API. No password is needed — keys never touch the local machine.

Prerequisites

The following environment variables must be set:

VarPurpose
PRIVY_APP_IDPrivy application ID
PRIVY_APP_SECRETPrivy application secret
Create a Privy wallet
bash
nansen wallet create --provider privy
# Or with a custom name:
nansen wallet create --name agent-wallet --provider privy
Critical rules for agents (Privy)
  • No password needed — Privy manages keys server-side
  • Cannot export keys — wallet export only works for local wallets
  • All other operations (list, show, send, delete, default) work identically for both providers

Local Wallet Creation (Two-Step Agent Flow)

This section covers local wallet creation. For Privy server-side wallets, see the Privy Wallet Creation section above — no password is needed.

Wallet creation requires a password from the human user. The agent must NOT generate or store the password itself.

Step 1 (Agent → Human): Ask the user to provide a wallet password (minimum 12 characters).

Step 2 (Agent executes): Run the create command with the password the user gave you.

bash
NANSEN_WALLET_PASSWORD="<password_from_user>" nansen wallet create

After creation, the CLI automatically saves the password:

  • OS keychain (macOS Keychain, Linux secret-tool, Windows Credential Manager) — secure, preferred
  • ~/.nansen/wallets/.credentials file — insecure fallback when no keychain is available (e.g. containers, CI)

All future wallet operations retrieve the password automatically — no env var or human input needed.

If the .credentials file fallback is used, the CLI prints a warning on every operation. To migrate to secure storage later, run nansen wallet secure.

Show full SKILL.md (313 more words)Show less
Password resolution order (automatic)
  1. NANSEN_WALLET_PASSWORD env var (if set)
  2. OS keychain (saved automatically on wallet create)
  3. ~/.nansen/wallets/.credentials file (insecure fallback, with warning)
  4. Structured JSON error with instructions (if none available)
Critical rules for agents
  • NEVER generate a password yourself — always ask the human user
  • NEVER store the password in files, memory, logs, or conversation history
  • NEVER use --human flag — that enables interactive prompts which agents cannot handle
  • After wallet creation, you do NOT need the password for future operations — the keychain handles it
  • If you get a PASSWORD_REQUIRED error, ask the user to provide their password again

Create

Privy (server-side, no password)
bash
nansen wallet create --provider privy
# Or with a custom name:
nansen wallet create --name trading --provider privy

Requires PRIVY_APP_ID + PRIVY_APP_SECRET env vars. No password needed.

Local (encrypted on disk, password required)
bash
# 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

List & Show

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

Send

bash
# 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

Export & Delete

bash
# Default is REDACTED — shows addresses only, never private keys
nansen wallet export <name>

# Write private keys to a file only the owner can read (0600, refuses to overwrite)
nansen wallet export <name> --file <path>

# Print private keys in plaintext to stdout (explicit acknowledgement required;
# warns on stderr when stdout is an interactive terminal)
nansen wallet export <name> --reveal

# Password auto-resolved from keychain (needed for --reveal / --file)
nansen wallet delete <name>

Prefer --file over --reveal: plaintext on stdout ends up in terminal scrollback, shell logs, and agent transcripts.

Forget Password

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

Migrate to Secure Storage

bash
nansen wallet secure

For detailed migration steps (from ~/.nansen/.env, .credentials, or env-var-only setups), see the nansen-wallet-migration skill.

Flags

FlagPurpose
--toRecipient address
--amountAmount to send
--chainevm or solana
--maxSend entire balance
--dry-runPreview without broadcasting
--providerWallet provider: local (default, encrypted on disk) or privy (server-side via Privy API)
--revealExport only: print private keys in plaintext to stdout (required acknowledgement)
--fileExport only: write private keys to this path (created 0600, refuses to overwrite)
--humanEnable interactive prompts (human terminal use only — agents must NOT use this)
--unsafe-no-passwordSkip encryption (keys stored in plaintext — NOT recommended)

Environment Variables

VarPurpose
NANSEN_WALLET_PASSWORDWallet encryption password — only needed for initial wallet create. After that, the OS keychain handles it.
NANSEN_API_KEYAPI key (can also be saved via nansen login --human)
PRIVY_APP_IDPrivy application ID (required for --provider privy)
PRIVY_APP_SECRETPrivy application secret (required for --provider privy)
NANSEN_WALLET_PROVIDERDefault provider for wallet create — local or privy
NANSEN_EVM_RPCCustom EVM RPC endpoint
NANSEN_SOLANA_RPCCustom Solana RPC endpoint

© nansen-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/nansen-wallet-manager of nansen-ai/nansen-cli.

Open the folder on GitHubat commit d097942

Compare with similar skills

Nansen Wallet Manager next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Nansen Wallet Manager compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Nansen Wallet Manager this skillnansen-ai/nansen-cli139—~2.1kAutomated safety check: NotesMIT
Configuring Horizoncoollabsio/coolify63k4 repos~898Automated safety check: PassMIT
Fortify Developmentcoollabsio/coolify63k4 repos~1.9kAutomated safety check: PassMIT
Node Backend Development Guidelinesdiet103/claude-code-infrastructure-showcase10k2 repos~2kAutomated safety check: PassMIT
Laravel Best Practicesanonaddy/anonaddy4.9k13 repos~1.2kAutomated safety check: PassMIT
Laravel Actionscoollabsio/coolify63k—~2.4kAutomated safety check: PassApache-2.0

Similar skills

  • Configuring Horizon

    coollabsio/coolify

    A skill your agent uses whenever the user mentions Horizon by name in a Laravel context.

    63k GitHub starsUsed in 4 repos~898 tokens
    Backend & APIsAuto-check passed
  • Fortify Development

    coollabsio/coolify

    ACTIVATE when the user works on authentication in Laravel. An agent skill from coollabsio/coolify.

    63k GitHub starsUsed in 4 repos~1.9k tokens
    Backend & APIsAuto-check passed
  • Node Backend Development Guidelines

    diet103/claude-code-infrastructure-showcase

    Sets layered architecture and coding rules for Node.js, Express and TypeScript microservices, covering routes, controllers, services, repositories, Prisma, Sentry and Zod.

    10k GitHub starsUsed in 2 repos~2k tokens
    Backend & APIsAuto-check passed
  • Laravel Best Practices

    anonaddy/anonaddy

    Apply this skill whenever writing, reviewing, or refactoring Laravel PHP code.

    4.9k GitHub starsUsed in 13 repos~1.2k tokens
    Backend & APIsAuto-check passed
  • Laravel Actions

    coollabsio/coolify

    Build, refactor, and troubleshoot Laravel Actions using lorisleiva/laravel-actions.

    63k GitHub stars~2.4k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Nodejs Backend Patterns

    ever-works/ever-works

    Build production-ready Node.js backend services with Express/Fastify, implementing middleware patterns, error handling, authentication, database integration, and API design best practices.

    162 GitHub starsUsed in 18 repos~4k tokens
    Backend & APIsAuto-check passed

More from nansen-ai/nansen-cli

All 32 skills in this repo
  • Nansen Smart Money Tracker

    nansen-ai/nansen-cli

    Smart money tracking — netflow, trades, holdings, perp trades.

    139 GitHub starsUsed in 2 repos~1.1k tokens
    Auto-check passed
  • Nansen Token Research

    nansen-ai/nansen-cli

    Token deep dive — info, OHLCV, holders, flows, flow intelligence, who bought/sold, DEX trades, PnL, perp trades, perp positions, perp PnL leaderboard.

    139 GitHub starsUsed in 2 repos~1.2k tokens
    Auto-check passed
  • Nansen Wallet Profiler

    nansen-ai/nansen-cli

    Wallet profiler — balance, PnL, labels, transactions, counterparties, related wallets, batch, trace, compare.

    139 GitHub starsUsed in 2 repos~1.5k tokens
    Auto-check passed
  • Nansen Agent Guide

    nansen-ai/nansen-cli

    Routing guide -- when to use nansen agent (AI research) vs direct CLI data commands.

    139 GitHub stars~948 tokensUpdated 2 days ago
    Auto-check passed
  • Nansen Limit Orders

    nansen-ai/nansen-cli

    Guide users through native limit orders on Solana via nansen trade limit-order create|list|cancel|update, and the alert-based settlement-signal fallback for chains without native support.

    139 GitHub stars~2.5k tokensUpdated 2 days ago
    Auto-check passed
  • Nansen Smart Alerts

    nansen-ai/nansen-cli

    Manage smart alerts — list, create, update, toggle, delete. An agent skill from nansen-ai/nansen-cli.

    139 GitHub stars~1.6k tokensUpdated 2 days ago
    Auto-check passed

Categories

Questions about Nansen Wallet Manager

What does Nansen Wallet Manager do?

Wallet management — create (local or Privy server-side), list, show, export, send, delete. Nansen Wallet Manager is an agent skill from nansen-ai/nansen-cli. Wallet management — create (local or Privy server-side), list, show, export, send, delete.

When should I use Nansen Wallet Manager?

Nansen Wallet Manager fits situations like: creating wallets; checking balances.

How do I install Nansen Wallet Manager in Claude Code?

Run `npx skills add nansen-ai/nansen-cli --skill nansen-wallet-manager -a claude-code`. Or copy the skill folder (skills/nansen-wallet-manager in nansen-ai/nansen-cli) into .claude/skills/nansen-wallet-manager in your project. Claude Code loads it when a task matches its description.

How do I install Nansen Wallet Manager in Codex?

Run `npx skills add nansen-ai/nansen-cli --skill nansen-wallet-manager -a codex`. Or copy the skill folder (skills/nansen-wallet-manager in nansen-ai/nansen-cli) into .agents/skills/nansen-wallet-manager in your project. Codex loads it when a task matches its description.

Can I use Nansen Wallet Manager in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add nansen-ai/nansen-cli --skill nansen-wallet-manager -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/nansen-wallet-manager, .gemini/skills/nansen-wallet-manager, .github/skills/nansen-wallet-manager and .opencode/skills/nansen-wallet-manager in your project.

What does Nansen Wallet Manager need to run?

Going by SKILL.md and its folder, Nansen Wallet Manager needs credentials named NANSEN_WALLET_PASSWORD, PRIVY_APP_SECRET and NANSEN_API_KEY. Our summary lists: A credential in NANSEN_API_KEY; A credential in PRIVY_APP_SECRET. Its frontmatter pre-approves these tools: Bash(nansen:*).

Does Nansen Wallet Manager access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Nansen Wallet Manager safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Nansen Wallet Manager use?

Nansen Wallet Manager is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Nansen Wallet Manager use?

About 2.1k tokens (SKILL.md is roughly 8.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Nansen Wallet Manager?

Skills that share tags, products or a category with Nansen Wallet Manager: Configuring Horizon (coollabsio/coolify, 63k stars), Fortify Development (coollabsio/coolify, 63k stars), Node Backend Development Guidelines (diet103/claude-code-infrastructure-showcase, 10k stars) and Laravel Best Practices (anonaddy/anonaddy, 4.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Nansen Wallet Manager?

nansen-ai (a GitHub organization) maintains it in nansen-ai/nansen-cli, which has 139 GitHub stars. The repository holds 32 skills in this directory. The repository was last updated on October 9, 2026.

Source: nansen-ai/nansen-cli on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.