7.3 KiB
title
| title |
|---|
| Ledger Nano |
本网页展示了如何通过 Ledger Nano S 或 Nano X 来使用命令行工具与 Solana 交互。 其他解决方案与 Solana 与 Nano 的交互， 请点击这里
开始前的准备
通过 Solana CLI 使用 Ledger Nano
- 确保 Ledger Live 应用程序已关闭
- 将您的 Nano 插入计算机 USB 端口
- 输入 pin 码并在 Nano 上启动 Solana 应用
- 确保屏幕显示“应用程序已准备好”
查看您的钱包 ID
在您的计算机运行：
solana-keygen pubkey usb://ledger
该步骤确认您的 Ledger 设备已经连接正确，并且能够与 Solana CLI 正常交互。 该命令返回你 Ledger 设备唯一的_钱包 ID_. 当有多台 Nano 设备连接到同一台计算机时， 您可以通过钱包 ID 来指定想使用的 Ledger 硬件钱包。 如果您的电脑只使用一个 Nano 设备，那么就无需指明钱包 ID。 关于通过钱包 ID 使用特定 Ledger 的信息，请参阅管理多个硬件钱包。
查看您的钱包地址
您的 Nano 支持任意数量的有效钱包地址和签名者。 要查看任何地址，请使用前面所说的 solana-keygen pubkey 命令，然后接上一个有效的 密钥对URL。
如果需要在自己帐户之间的传输代币，您可以使用多个钱包地址。或在设备上对某一个抵押账号使用不同的键对作为签名授权。
以下所有的命令将显示不同的地址，关联到给定的密钥对路径。 来试一下吧！
solana-keygen pubkey usb://ledger
solana-keygen pubkey usb://ledger?key=0
solana-keygen pubkey usb://ledger?key=1
solana-keygen pubkey usb://ledger?key=2
- 注意：密钥对 URL 参数在 zsh 更多解决方案中将被忽视。
您也可以在 key= 后面输入其他的数值。 这些命令显示的任何地址都是有效的 Solana 钱包地址。 与每个地址相关联的隐私信息都安全地存储在 Nano 上，并对该地址的交易进行签名。 只需给你生成的任何地址的密钥对 URL 进行备注，就可以用来接收代币。
如果您只计划设备上使用一个地址/密钥对， 那么容易记住的一个路径可能是 key=0 的地址。 通过该命令查看它的地址：
solana-keygen pubkey usb://ledger?key=0
现在，你已经有一个(或多个) 钱包地址，你可以公开分享其中的任何一个地址作为代币接收地址，并且使用关联的密钥对 URL 作为该地址发起交易的签名人。
查看钱包余额
无论是哪个钱包，您都可以通过 solana balance 命令来查看帐户余额：
solana balance SOME_WALLET_ADDRESS
例如，如果您的地址是 7cvkjYAkUYs4W8XcXscca7cBrEGFeSUjeZmKoNBvEwyri，那么可以输入以下命令查看余额：
solana balance 7cvkjYAkUYs4W8XcXsca7cBrEGFeSUjeZmKoNBvEwyri
您也可以在Explorer查看任何账户地址的余额，在网页浏览器中将地址粘贴到搜索框来查看余额。
注意：任何余额为 0 SOL的地址（例如您在 Ledger 新创建的地址），将在浏览器器中显示“未找到”。 Solana 对空账户和不存在账户的处理是一样的。 当您的帐户地址中有一些 SOL 代币的时候才会正确显示。
从 Nano 发送 SOL
您需要使用该设备来签署交易，完成从 Nano 地址发送代币（通过生成钱包地址的相同密钥对 URL）。 请确保您的 Nano 已插入电脑，通过 PIN 解锁，并且 Ledger Live 处于未运行状态， 同时 Solana 应用在设备中打开，显示“应用已准备就绪”。
solana transfer 命令用于指定代币发送地址和数量，通过 --keypair 参数来指定发送代币的密钥对（签署交易），同时对应地址的余额将减少。
solana transfer RECIPIENT_ADDRESS AMOUNT --keypair KEYPAIR_URL_OF_SENDER
下面是一个完整的实例。 首先，通过某个密钥对 URL 中查看一个地址。 然后检查该地址的余额。 最后，输入一笔交易来发送 1 SOL到接收地址 7cvkjYAkUYs4W8XcXscca7cBrEGFeSUjeZmKoNBvEwyri。 按下回车键传输命令时，您将看到在 Ledger 设备批准交易细节的提示。 在设备上通过左右键查看交易细节。 如果信息正确，请同时按下"允许"界面的两个按钮，否则请在"拒绝"界面按下这两个按钮。
~$ solana-keygen pubkey usb://ledger?key=42
CjeqzArkZt6xwdnZ9NZSf8D1CNJN1rjeFiyd8q7iLWAV
~$ solana balance CjeqzArkZt6xwdnZ9NZSf8D1CNJN1rjeFiyd8q7iLWAV
1.000005 SOL
~$ solana transfer 7cvkjYAkUYs4W8XcXsca7cBrEGFeSUjeZmKoNBvEwyri 1 --keypair usb://ledger?key=42
等待您在 Ledger 硬件钱包确认 usb://ledger/2JT2Xvy6T8hSmT8g6WdeDbHUgoeGdj6bE2VueCZUJmyN
✅ 已允许
签名：kemu9jDEuPirKNRKiHan7ycybYsZp7pFefAdvWZRq5VRHCLgXTXaFVw3pfh87MQcWX4kQY4TjSBmESrwMApom1V
在设备批准交易后，应用界面会显示交易签名，您需要等待最大的确认数量(32) 才能返回。 这个过程只需要几秒钟，然后交易就能在 Solana 网络确认。 您可以到Explorer交易栏中粘贴该交易签名，来查看这笔交易或任何其他交易的详细信息。
进阶操作
管理多个硬件钱包
有时候通过多个硬件钱包对交易进行签名非常有用。 使用多个钱包签名需要 完全合格的密钥对 URL。 当 URL 不完全合格时，Solana CLI 将提示所有已连接硬件钱包的完全合格的 URL，并要求您选择每个签名使用哪个钱包。
您可以使用界面交互提示而不是使用 Solana CLI 交易栏 命令来生成完全合格的 URL。 例如，试着将 Nano 连接到 USB，输入 PIN 码解锁，并运行以下命令：
solana resolve-signer usb://ledger?key=0/0
您将看到类似这样的输出：
usb://ledger/BsNsvfXqQTtJnagwFWdBS7FBXgnsK8VZ5CmuznN85swK?key=0/0
但 BsNsvfXqQTtJnagwFWdBS7FBXgnsK8VZ5CmuznN85swK 是您的 WALLET_ID.
当 URL 完全合格时，您可以连接多个硬件钱包到同一台计算机，并独立识别其中任何一个私钥对。 除了 <KEYPAIR>，您可以在任何 solana 命令行的地方使用 resolve-signer 命令的输出去解决给定签名的解析路径问题。
疑难解答
Zsh 忽略密钥对 URL 参数
Zsh 中问题标记字符是特殊字符。 如果您无需使用该功能，请在你的 ~/.zshrc 中添加以下文本，将其作为的正常字符处理：
unsetopt nomatch
然后重启您的 shell 窗口，或者运行 ~/.zshrc：
source ~/.zshrc
如果不想禁用 zsh 对问题标记字符的特殊处理，您可以在密钥对 URL 中使用反斜杠专门禁用它。 例如：
solana-keygen pubkey usb://ledger\?key=0
客服支持
查看 钱包支持页面 获取帮助。
阅读更多关于 发送和接收代币 和委托质押的信息。 您可以在任何接受 <KEYPAIR> 选项或参的地方使用 Ledger 密钥对 URL。