Skip to main content
The @sei-js/ledger package provides TypeScript helper functions for the SEI Ledger hardware wallet app. It enables address derivation and offline Amino signing for Cosmos-side transactions on Sei.
For EVM-side transaction signing with Ethers.js, see the Ledger Setup (EVM) guide instead.

​
Installation

npm install @sei-js/ledger

​
Hardware Requirements

  • Ledger Nano S Plus, Nano X, or compatible device
  • SEI app installed on the Ledger device (via Ledger Live Manager)
  • USB or Bluetooth connection to your computer

​
Core Functions

​
createTransportAndApp

Creates a transport connection and app instance for communicating with the Ledger device. 
import { createTransportAndApp } from '@sei-js/ledger';

const { transport, app } = await createTransportAndApp();
Returns: Promise<{ transport: Transport, app: SeiApp }>

​
getAddresses

Retrieves both EVM and Cosmos addresses from the Ledger device for a given derivation path. 
import { createTransportAndApp, getAddresses } from '@sei-js/ledger';

const { app } = await createTransportAndApp();
const { evmAddress, nativeAddress } = await getAddresses(app, "m/44'/60'/0'/0/0");

console.log('EVM address:', evmAddress);
console.log('Sei address:', nativeAddress);
Parameters:
ParameterTypeDescription
appSeiAppLedger Sei app instance
pathstringHD derivation path (e.g. "m/44'/60'/0'/0/0")
Returns: Promise<{ evmAddress: string, nativeAddress: string }>

​
SeiLedgerOfflineAminoSigner

A signer class compatible with CosmJS that enables offline Amino signing via Ledger. 
import { SeiLedgerOfflineAminoSigner } from '@sei-js/ledger';

const ledgerSigner = new SeiLedgerOfflineAminoSigner(app, "m/44'/60'/0'/0/0");
Constructor Parameters:
ParameterTypeDescription
appSeiAppLedger Sei app instance
pathstringHD derivation path

​
getAccounts

Retrieves account information from the Ledger device. 
const accounts = await ledgerSigner.getAccounts();
// [{ address: 'sei1...', pubkey: { type: 'tendermint/PubKeySecp256k1', value: '...' } }]

​
signAmino

Signs a transaction document using the Ledger device. The device will prompt for physical confirmation. 
import { StdSignDoc } from '@cosmjs/amino';

const signDoc: StdSignDoc = {
  /* your transaction document */
};
const { signed, signature } = await ledgerSigner.signAmino('sei1...', signDoc);

​
Complete Example: Delegating Tokens

import { coins, SigningStargateClient, StdFee } from '@cosmjs/stargate';
import { createTransportAndApp, getAddresses, SeiLedgerOfflineAminoSigner } from '@sei-js/ledger';

async function delegateWithLedger() {
  const rpcUrl = 'https://rpc-testnet.sei-apis.com/';
  const path = "m/44'/60'/0'/0/0";

  const { app } = await createTransportAndApp();
  const { nativeAddress } = await getAddresses(app, path);
  const ledgerSigner = new SeiLedgerOfflineAminoSigner(app, path);

  const client = await SigningStargateClient.connectWithSigner(rpcUrl, ledgerSigner);

  const msgDelegate = {
    typeUrl: '/cosmos.staking.v1beta1.MsgDelegate',
    value: {
      delegatorAddress: nativeAddress.address,
      validatorAddress: 'seivaloper1...',
      amount: coins(500, 'usei')
    }
  };

  const fee: StdFee = {
    amount: [{ denom: 'usei', amount: '20000' }],
    gas: '200000'
  };

  const result = await client.signAndBroadcast(nativeAddress.address, [msgDelegate], fee, 'Delegation via Ledger');

  console.log('Broadcast result:', result);
}

delegateWithLedger();

​
Security

  • Ensure your Ledger device is genuine and purchased from official sources
  • Always verify transaction details on the Ledger screen before confirming
  • Keep your Ledger firmware and the SEI app updated
  • Store your recovery phrase securely and never share it