@sei-js/ledger is no longer in the sei-js monorepo. Do not install the deprecated version 1.1.6, which npm still serves. The package previously handled Cosmos-side Amino signing, and there is no replacement package for that flow. Cosmos SDK signing is deprecated. See SIP-3 and the Cosmos SDK deprecation notice. This page covers EVM transactions only.Prerequisites
- Install the Ledger app Open the Manager in Ledger Live. Install either the Sei app or the Ethereum app on your Ledger device. The Ethereum app supports any EVM chain, including Sei, but the native Sei app may give the best compatibility.
- Enable blind signing In the settings of the Ethereum or Sei app on the Ledger device, enable Blind signing. This setting lets the device sign arbitrary EVM transactions and contract calls (for example, precompile calls). Without it, the device rejects them.
-
Set up USB permissions (Linux only)
Your process needs a udev rule to communicate with the Ledger over USB HID. Clone the official rules from LedgerHQ/udev-rules. Copy
49-ledger.rulesinto/etc/udev/rules.d/. Runsudo udevadm control --reload-rules. Then disconnect your Ledger and connect it again. -
Install dependencies
Connecting your Ledger
Sending a transfer
This example sends SEI from your Ledger to another address:This signer works with any contract interaction. You can pass it to
ethers.Contract constructors to sign precompile calls, ERC-20 transfers, or any other EVM transaction.Troubleshooting
- Timeouts: If the Ledger times out, increase the HID timeouts or make sure that the device stays awake during signing.
- “Blind signing required” errors: Check that blind signing is enabled in the app settings on the device itself.
- Connection failures: Make sure that no other application, such as Ledger Live, holds the USB connection to your device.