mcpField
N
nansen-wallet-clustering

nansen-wallet-clustering

github.com/nansen-ai数据与数据库144382 次安装今天更新
代码仓库

关于 nansen-wallet-clustering

nansen-wallet-clustering 是一项通过 Nansen CLI 归属钱包并调查钱包关联的 skill。它规定分步流程、置信度标准及扩展地址集合的限制。

主要功能

  1. 01查询钱包身份标签
  2. 02发现关联钱包
  3. 03分析交易对手
  4. 04归属置信度与停止规则
  5. 05认证与支付防护

适用场景

  1. 01调查钱包可能由哪个实体控制
  2. 02检查种子钱包与关联钱包的联系
  3. 03扩展集群前评估归属证据

MCP 相关

README 提到现有 OAuth/MCP `nansen:read` 语义保持不变；此 skill 通过 `nansen` CLI 指引研究操作。

安装

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

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

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

附带文件REFERENCE.md

详细介绍

身份验证

浏览器登录会请求 nansen:api，以获取相当于 API 密钥的账户 API 权限；现有 OAuth/MCP nansen:read 语义及单独的钱包授权保持不变。

在执行任何研究命令或循环之前，必须明确选择 API 密钥或已保存的浏览器会话。先运行 nansen auth status。其中缓存的／未经验证的元数据不能证明凭据有效或存储已解锁。仅缓存的访问令牌过期，并不意味着会话不可用：在已获授权的研究任务期间，CLI 通常会自动续期所选会话，无需再次征求同意或单独检查账户。如果选择了匿名访问、身份验证状态无效、续期／清理受阻或状态不明，或实际身份验证失败（包括刷新授权被拒绝或已过期），请停止。遵循 CLI 的错误提示；如果排查需要，请使用免费的 nansen account 检查。不要取消设置失效的密钥、清除会话或切换到匿名访问后重试。

如需在文档所述平台范围内重新通过浏览器授权，请使用 nansen login，或配置常规 API 密钥。NANSEN_API_KEY 会覆盖已保存的会话。OpenClaw 的可选 primaryEnv 映射会保留已配置的 API 密钥注入；它不是必需密钥门槛，也不能证明已通过身份验证。正常的额度和权益仍然适用。登录不会购买额度。CLI 2.0.0 在 macOS arm64 预览范围内提供浏览器登录。

API 密钥和浏览器会话使用相同的 x402 自动支付行为：受支持的 HTTP 402 质询可能会根据现有的钱包授权、支付政策和消费限额，使用已配置钱包中的资金。每次调用（包括循环中的调用）都可能产生费用。身份验证、授权和会话续期失败绝不会触发支付；登录验证和 nansen account 也绝不会自动支付。匿名 x402 仍可作为单独的付费工作流使用，但需要用户明确同意并完成支付设置。不要以匿名方式运行此研究工作流，也不要在身份验证失败后切换到匿名访问。

钱包归属分析

回答：“谁控制这个钱包？这些钱包之间有关联吗？”

链：0x → --chain ethereum（也支持 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
# 3b. Once a cluster is confirmed: counterparties for up to 10 of its wallets in one call
#     (max --days 90; one ecosystem per request — EVM and Solana cannot be mixed). Rows are
#     contiguous per-wallet blocks ordered by wallet address: raise --limit and page with
#     --page N to reach later wallets.
nansen research profiler counterparties-batch --addresses "addr1,addr2" --chain $CHAIN --days 90 --limit 50
# 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

**扩展：**在种子地址上运行步骤 1–2。发现每个新地址后，先征求用户同意再查询。步骤 3 仅用于种子地址。 **停止条件：**已知协议／CEX · 置信度低 · 已访问过 · 集群 > 10 个钱包。 **置信度：**高 = 首个资助方／共同 Safe 签名者／相同 CEX 充值地址。中 = 协同资金流动／关联钱包 + 标签匹配。排除 = 仅 ENS、单次 CEX 提现、单个部署者。 完整归属规则见 REFERENCE.md。

评论

支持 Markdown