mcpField
N
nansen-wallet-attribution

nansen-wallet-attribution

github.com/nansen-aiData & databases14473 installsUpdated today
Repository

About nansen-wallet-attribution

nansen-wallet-attribution is a skill for investigating who may control a wallet and which wallets may be related. It guides a staged review of labels, related wallets, and counterparties across supported chains, with confidence and stopping criteria.

Key features

  1. 01Look up wallet identity labels
  2. 02Find related wallets
  3. 03Review wallet counterparties
  4. 04Support Ethereum, Base, Arbitrum, Optimism, Polygon, and Solana
  5. 05Apply attribution confidence and stopping rules

Use cases

  1. 01Investigate the likely controller of a wallet
  2. 02Expand a seed wallet into a related-wallet cluster
  3. 03Assess evidence linking wallets while limiting low-confidence leads

Install

Copy the command and run it in a terminal.

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

After installing, type/nansen-wallet-attributionin Claude Code to confirm it loaded.

Bundled filesREFERENCE.md

Details

From the project README

Wallet Attribution

Answers: "Who controls this wallet? Are these wallets related?"

Chain: 0x → --chain ethereum (also base, arbitrum, optimism, polygon). Base58 → --chain solana.

ADDR=<address> CHAIN=<ethereum|solana|base|...>  # detect from address format above
# 1. Identity
nansen research profiler labels --address $ADDR --chain $CHAIN
# 2. Related wallets (paginate with --page N)
nansen research profiler related-wallets --address $ADDR --chain $CHAIN
# 3. Counterparties (paginate with --page N; widen with --days 365 if empty)
nansen research profiler counterparties --address $ADDR --chain $CHAIN --days 90
# 4. Batch profile cluster
nansen research profiler batch --addresses "addr1,addr2" --chain $CHAIN --include labels,balance,pnl
# 5. Compare pairs → shared_counterparties, shared_tokens, balances
nansen research profiler compare --addresses "addr1,addr2" --chain $CHAIN
# 6. Historical balances (fingerprint drained wallets)
nansen research profiler historical-balances --address $ADDR --chain $CHAIN --days 90
# 7. Multi-hop trace (credit-heavy — keep --width ≤3)
nansen research profiler trace --address $ADDR --chain $CHAIN --depth 2 --width 3

Expansion: Run steps 1-2 on seed. For each new address found, ask the human before querying. Reserve step 3 for seed only. Stop when: known protocol/CEX · Low confidence · already visited · cluster > 10 wallets. Confidence: High = first funder / shared Safe signers / same CEX deposit. Medium = coordinated movements / related-wallets + label match. Exclude = ENS only, single CEX withdrawal, single deployer. Full attribution rules in REFERENCE.md.

Comments

Markdown supported