Ledger

@usebutr/ledger is a Ledger hardware-wallet adapter using WebUSB. It ships per-platform factories for EVM, SVM (Solana), Sui, and Bitcoin. It signs messages and transactions; it does not broadcast or read chain state.

Install

npm install @usebutr/ledger @ledgerhq/hw-transport-webusb

Then add the Ledger app modules you need — each is an optional peer dep loaded on demand:

npm install @ledgerhq/hw-app-eth      # EVM
npm install @ledgerhq/hw-app-solana   # SVM
npm install @ledgerhq/hw-app-sui      # Sui
npm install @ledgerhq/hw-app-btc      # Bitcoin

You only pay for the apps you actually use.

Build the adapter

The unified factory dispatches on options.platform. The discriminant is required — every caller passes it explicitly.

EVM

import { createLedgerAdapter } from "@usebutr/ledger";

const ledger = await createLedgerAdapter({
  platform: "evm",
  chainId: 1, // EIP-155 number, not CAIP-2
  accountCount: 3,
});

Solana

const ledger = await createLedgerAdapter({
  platform: "svm",
  cluster: "mainnet", // "mainnet" | "testnet" | "devnet"
  accountCount: 3,
});

Sui

const ledger = await createLedgerAdapter({
  platform: "sui",
  cluster: "mainnet",
  accountCount: 3,
});

Bitcoin

const ledger = await createLedgerAdapter({
  platform: "bitcoin",
  addressFormat: "bech32", // "legacy" | "p2sh" | "bech32" | "bech32m"
  accountCount: 3,
});

You can also import each per-platform factory directly: createEvmLedgerAdapter, createSvmLedgerAdapter, createSuiLedgerAdapter, createBitcoinLedgerAdapter.

Common options

Per-platform defaults

Register it through the unified provider exactly like WalletConnect:

import { WalletManagerProvider } from "@usebutr/react";
import { autoDiscovery } from "@usebutr/wallets";
import { createLedgerAdapter } from "@usebutr/ledger";

const discovery = autoDiscovery();
const ledger = await createLedgerAdapter({ platform: "sui", accountCount: 3 });
const extra = new Map([[ledger.id, ledger]]);

<WalletManagerProvider
  discovery={discovery}
  connectors={[{ id: ledger.id, name: ledger.name, chainPlatform: ledger.chainPlatform }]}
  createConnector={(id) => extra.get(id) ?? null}
>
  {children}
</WalletManagerProvider>;

On connect() the browser shows the WebUSB permission prompt and the user unlocks the device on the platform's Ledger app (Ethereum, Solana, Sui, or Bitcoin).

Capabilities

LEDGER_CAPABILITIES is hardware-only and identical across EVM, SVM, and Bitcoin. Sui diverges in one spot (no signMessage):

Caveats

• No persistence — the device must be reconnected on reload (no session survives).
• No events — subscribe() is a no-op.
• Multiple accounts via paths — there's no switchAccount; expose more addresses with accountCount and pass a specific account to signMessage / signTransaction. Walking to a non-active path hits the device sequentially.
• Manual chain — call switchChain() to update the adapter's local state; it isn't written to the device.