moonpay-hardware-wallet

ハードウェアウォレットのサポート

目標

ハードウェアウォレットを MoonPay CLI に接続します。秘密鍵がデバイスの外に出ることはなく、CLI にはキャッシュされたアドレスのみが保存されます。既存のすべてのコマンド（swap、transfer、bridge、buy、balance）は、ハードウェアウォレットでも透過的に動作します。

最初にサポートされるデバイス：Ledger（Nano S、Nano X、Nano S Plus、Stax、Flex）。

前提条件

• Ledger デバイスが USB 経由で接続されていること
• 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
• Bitcoin と Tron は Ledger 経由ではサポートされていません

ヒント

• 接続時に、デバイスのロックを解除し、ホーム画面を表示しておく必要があります
• アプリの切り替えは自動で行われるため、Ethereum アプリや Solana アプリを手動で開く必要はありません
• 署名がタイムアウトした場合は、Ledger の画面に承認待ちのプロンプトが表示されていないか確認してください
• wallet export はハードウェアウォレットでは使用できません（エクスポートする秘密情報がないため）

関連するスキル

• moonpay-auth — CLI をセットアップし、ソフトウェアウォレットを管理する
• moonpay-swap-tokens — トークンをスワップまたはブリッジする
• moonpay-check-wallet — ウォレットの残高を確認する