mcpField
M
moonpay-hardware-wallet

moonpay-hardware-wallet

github.com/moonpay其他11252 次安装23 周前更新
代码仓库

关于 moonpay-hardware-wallet

moonpay-hardware-wallet 是将 Ledger 硬件钱包连接到 MoonPay CLI 的技能。它缓存地址而不保存私钥，并通过设备上的确认来签署交易。

主要功能

  1. 01通过 USB 添加 Ledger 钱包
  2. 02派生并刷新缓存地址
  3. 03在设备确认后签署交易
  4. 04使用支持的钱包 CLI 命令
  5. 05支持 Ethereum、EVM 链和 Solana

适用场景

  1. 01使用缓存的钱包地址查询余额
  2. 02在 Ledger 上确认代币兑换
  3. 03在设备上签署跨链桥接交易

安装

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

$npx skills add https://github.com/moonpay/skills --skill moonpay-hardware-wallet

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

详细介绍

硬件钱包支持

目标

将硬件钱包连接到 MoonPay CLI。私钥永远不会离开设备，CLI 只存储缓存地址。所有现有命令（swap、transfer、bridge、buy、balance）都能与硬件钱包无缝配合使用。

首个支持的设备：Ledger（Nano S、Nano X、Nano S Plus、Stax、Flex）。

前提条件

  • 通过 USB 连接 Ledger 设备
  • 已安装 Ledger Live（用于固件更新）
  • 设备上已安装 Ethereum 和/或 Solana 应用

命令

添加硬件钱包
# Auto-detect connected device
mp wallet hardware add --name "my-ledger"

# Specify device type explicitly
mp wallet hardware add --name "my-ledger" --device ledger

此命令会连接设备，为所有支持的链（Ethereum、Solana）推导地址，并保存钱包。不会存储任何机密信息，仅存储地址。

刷新地址
mp wallet hardware refresh --wallet "my-ledger"

从已连接的设备重新推导地址。如果你在 Ledger Live 中更改了账户索引，或需要更新缓存地址，请使用此命令。

列出钱包
mp wallet list

硬件钱包会与软件钱包一同显示，并带有 [hardware/ledger] 标签。

使用硬件钱包

添加后，可以像使用其他钱包一样使用 --wallet。CLI 会自动连接设备进行签名。

查看余额（无需设备）
mp token balance list --wallet my-ledger --chain ethereum
mp token balance list --wallet my-ledger --chain solana
兑换代币（在设备上签名）
mp token swap \
  --wallet my-ledger --chain ethereum \
  --from-token 0x0000000000000000000000000000000000000000 \
  --from-amount 0.01 \
  --to-token 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48

CLI 会提示你在 Ledger 上查看并确认交易。

转账代币（在设备上签名）
mp token transfer \
  --wallet my-ledger --chain ethereum \
  --token 0x0000000000000000000000000000000000000000 \
  --amount 0.01 \
  --to 0x1234...
跨链桥接（在设备上签名）
mp token bridge \
  --from-wallet my-ledger --from-chain ethereum \
  --from-token 0x0000000000000000000000000000000000000000 \
  --from-amount 0.01 \
  --to-chain polygon \
  --to-token 0x0000000000000000000000000000000000000000

工作原理

  1. wallet hardware add 通过 USB 连接设备，自动切换 Ledger 应用并推导地址
  2. 地址会缓存在加密保险库中，因此无需设备也能使用只读命令
  3. 对于需要签名的命令，CLI 会连接设备、打开正确的应用，并提示你在设备上批准
  4. 设备会对交易进行签名，私钥永远不会离开硬件
  5. CLI 会广播已签名的交易

支持的链

  • Ethereum（以及所有 EVM 链：Base、Polygon、Arbitrum、Optimism、BNB、Avalanche）
  • Solana
  • Ledger 不支持 Bitcoin 和 Tron

提示

  • 连接时，设备必须已解锁并停留在主屏幕
  • 应用会自动切换，无需手动打开 Ethereum 或 Solana 应用
  • 如果签名超时，请检查 Ledger 屏幕上是否有待处理的审批提示
  • 硬件钱包不支持 wallet export（没有可导出的机密信息）

相关技能

  • moonpay-auth — 设置 CLI 并管理软件钱包
  • moonpay-swap-tokens — 兑换或桥接代币
  • moonpay-check-wallet — 查看钱包余额

评论

支持 Markdown