Add Ledger hardware wallet keychain implementation #182
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Implements a keychain that integrates with Ledger hardware wallets for secure transaction signing with physical device confirmation. Features: - Hardware-secured transaction signing via Ledger device - Support for P-Chain, X-Chain, and C-Chain operations - Compatible with keychain.Keychain and c.EthKeychain interfaces - Automatic key derivation using BIP-44 path (m/44'/9000'/0'/0/n) - Support for both full transaction signing and hash signing - Retry logic for transient USB communication errors The implementation uses github.com/ava-labs/ledger-avalanche-go for hardware wallet communication.
Adds a tree diagram showing the package file structure and descriptions of the core files to help users understand the organization.
This was referenced Oct 10, 2025
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Why this should be merged
This PR adds Ledger hardware wallet integration to the SDK, enabling users to perform secure transaction signing using their Ledger devices for Avalanche transactions. Ledger hardware wallets are widely-used secure key storage devices that provide enterprise-grade key management for blockchain operations by keeping private keys isolated in hardware.
This implementation allows users to:
How this works
The PR adds a new
keychain/ledgerpackage that implements bothkeychain.Keychainandc.EthKeychaininterfaces:ledger_device.go- Device implementation that communicates with Ledger hardware via the Avalanche Ledger appledger_keychain.go- Core keychain implementation that manages address derivation and provides signing capabilities for Avalanche addressesThe implementation includes:
examples/validate-ledger-txs.go- Comprehensive example demonstrating subnet creation, blockchain creation, validator addition, P→C and C→P cross-chain transfers, and C-Chain EVM operationsHow this was tested
Need to be documented in RELEASES.md?