Ledger Lux

Overview

This repository contains the Go client library for interacting with Lux apps on Ledger hardware wallets.

This is a Go-first repository with the following structure:

• Top level: Go client library (github.com/luxfi/ledger)
• /rust/: Rust implementation and Ledger app source
• /go-docs/: Additional Go documentation

Installation

go get github.com/luxfi/ledger

Usage

import "github.com/luxfi/ledger"

// Example usage
app, err := ledger.FindLedgerLuxUserApp()
if err != nil {
    log.Fatal(err)
}
defer app.Close()

version, err := app.GetVersion()
if err != nil {
    log.Fatal(err)
}

fmt.Printf("App Version: %s\n", version)

Features

• BIP32/BIP44 key derivation
• P2PKH address generation
• Transaction signing
• Message signing
• Multi-signature support
• Multi-chain: one Ledger app signs for Lux, Hanzo, Zoo, and Pars

Chains

Chain	SLIP-0044	EIP-155 chain_id	CLA	Notes
Lux	9000	96369	0x80	Native P/X chains + EVM C-Chain
Hanzo	60	36963	0xE0	EVM-compat
Zoo	60	200200	0xE0	EVM-compat
Pars	60	7777	0xE0	EVM-compat

EVM-compat chains share derivation path m/44'/60'/... so a single hardware key roams across the family; EIP-155 chain_id provides replay protection. See docs/CHAIN_PATHS.md for the full path map.

path, err := ledger.BIP44PathForName("hanzo", 0, 0, 0)
// path == "m/44'/60'/0'/0/0"

Testing

Tests require a physical Ledger device with the Lux app installed:

go test ./...

Development

Ledger App Development

The Ledger app source code is located in the /rust/ directory. See /rust/README.md for build instructions.

Go Library Development

The Go client library is at the repository root. Standard Go development practices apply:

go mod tidy
go test ./...
go build ./...

License

Apache 2.0 - See LICENSE file for details.